rlpdaemon(1M)

NAME

rlpdaemon — daemon for queuing, displaying, removing and altering remote spool requests and writing remote messages

SYNOPSIS

/usr/sbin/rlpdaemon [-i] [-l] [-L logfile]

DESCRIPTION

rlpdaemon is a LP daemon (spool area handler) for remote spool requests. rlpdaemon is normally invoked at boot time from the /sbin/rc file or started by inetd(1M), when necessary. rlpdaemon runs on a system that receives requests to be printed. rlpdaemon transfers files to the spooling area, displays the queue, removes jobs from the queue, or alters jobs in the queue.

rlpdaemon is also used as a server process to write a message on the user's terminal, upon receiving a request from a remote system.

Options

-i: Prevent rlpdaemon from remaining after a request is processed. This is required if rlpdaemon is started from inetd(1M). When rlpdaemon is invoked with this option, error messages and valid requests received from the network are logged to either /var/adm/lp/lpd.log or logfile specified with -L option.
-l: Cause rlpdaemon to log error messages and valid requests received from the network to the file /var/adm/lp/lpd.log. This can be useful for debugging.
-L logfile: Change the file used for writing error messages and valid requests received from the network to the file /var/adm/lp/lpd.log to logfile.

When rlpdaemon is started by inetd(1M), access control is provided via the file /var/adm/inetd.sec to allow or prevent a host from making requests. When rlpdaemon is not started by inetd(1M), all requests must come from one of the machines listed in the file /etc/hosts.equiv or /var/spool/lp/.rhosts. When /var/spool/lp/.rhosts is used for access, the user name should be lp.

The following entry should exist in /etc/services for remote spooling:

printer 515/tcp spooler

Control File Processing

The lp subsystem expects that the control file associated with each request contain the datafile line entry (starting with a lower case letter) indicating the file to be printed, and an associated unlink datafile entry (U entry). The actual filename (N entry) for this datafile line entry can be above or below the datafile line entry. If multiple copies of a file has to be printed, for example n copies, then the datafile line entry should be repeated n times in succession. rlpdaemon may reorder or insert the U entries in the control file such that the datafile line entry and the U entry will be in succession for each file to be printed.

EXAMPLES

To start rlpdaemon from /sbin/rc, invoke the command:

/usr/sbin/rlpdaemon 

To start rlpdaemon from inetd, the following line should be included in the file /etc/inetd.conf:

printer stream tcp nowait root /usr/sbin/rlpdaemon rlpdaemon -i 

WARNINGS

If the remote system is the same as the local system and rlpdaemon was not started by inetd(1M), the local system name must be included in file /etc/hosts.equiv.

AUTHOR

rlpdaemon was developed by the University of California, Berkeley and HP.

FILES

/etc/hosts.equiv 
/etc/services 
/var/spool/lp/* 
/var/adm/lp/* 
/etc/lp/* 
/usr/lib/lp/* 
/var/adm/inetd.sec 