Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
rlprm(1)		      UNIX Reference Manual			rlprm(1)

NAME
     rlprm - remove jobs from a remote line printer spooling queue

SYNOPSIS
     rlprm  [-qNV]  [-Hprinthost]  [-Pprinter]	[-Xproxyhost] [--debug] [--time-
     out=seconds] [--port=port] [-] [ job # ... ] [ username ... ]

DESCRIPTION
     rlprm uses TCP/IP to remove jobs you own from printers anywhere on  a  net-
     work.  Unlike lprm, it does not require that the remote printers be explic-
     itly  known  to the local system (traditionally through /etc/printcap), and
     thus is considerably more flexible and requires less administration.

     rlprm can be used anywhere a traditional lprm might be used, and  is  back-
     wards  compatible	with traditional BSD lprm.  If rlprm is invoked as lprm,
     it preserves all known lprm semantics, with the exceptions of those  seman-
     tics mentioned in BUGS / LIMITATIONS below.

     rlprm  can  be  set up, installed, and used in the same two ways as rlpr(1)
     (that is, either with or without the rlprd(8) proxy  daemon).   Please  see
     rlpr(1)  for  details, and to see whether you will need to use the rlprd(8)
     proxy daemon or not.

OPTIONS
   Environment/Setup
     --debug
	    Print gobs of debugging information.

     -N, --no-bind
	    Don't try to bind to  privileged  port  before  connecting	to  lpd.
	    Please  see  the CONFIGURING A PROXY section in rlpr(1) for informa-
	    tion on use of this option.

     --port=number
	    Select an alternate port (instead of 7290) to connect to,  if  using
	    rlprd.  Usually not needed.

     -H, --printhost=host
	    Select the host to print to (used with -P).

	    Instead of using -H, one can specify the hostname directly including
	    it with the printer name with the printer@hostname syntax.

     -P, --printer=printername, --queue=printername
	    Select the printer to print to (used with -H).

     -X, --proxy=proxyhost, --proxyhost=proxyhost
	    Select the proxy host to use, if necessary.

     --timeout=seconds
	    Set  the  inactivity  timer.   If the connection hangs for more than
	    seconds seconds, then rlprm will give up.	Use  the  special  value
	    `-1' to wait forever.  Default timeout is 3 seconds.

     -V, --version
	    Print version and exit.

   Behavior
     -	    Remove  all  of  your jobs.  Note that this option must be specified
	    immediately following the end of all other options.  This option  is
	    a  mutant  supported only for compatibility.  Instead of using this,
	    include your username as the first argument to rlprm.

     -q, --quiet, --silent
	    Quiet mode - stay quiet (except for fatal errors).	See BUGS / LIMI-
	    TATIONS for problems using rlprm in silent-mode operation.

ENVIRONMENT VARIABLES
     The following environment variables are used by rlprm:

     RLPR_PRINTHOST
	    Specifies the default host's queue to remove jobs from.

     PRINTER or LPDEST
	    Specifies the default printer to remove jobs from on the host.
	    First PRINTER is consulted, then LPDEST.

	    Note that one can also  specify  the  host	to  examine  by  setting
	    printer  to  be  printer@hostname.	This may be more convenient than
	    setting RLPR_PRINTHOST, but will confuse the traditional  BSD  print
	    commands.

     RLPR_PROXYHOST
	    Specifies a proxy host to use, if necessary.

FILES
     ~/.rlprrc	       Personal printer/host database
     /etc/hosts.lpd    Host-based security on printhost
     /etc/hosts.equiv  Host-based security on printhost
     /etc/passwd       Personal identification
     /usr/local/etc/rlprrcSystem-wide printer/host database

SEE ALSO
     rlpr(1), rlpq(1), rlprd(8), rlprrc(5)

AUTHOR
     meem <meem@gnu.org>

BUGS / LIMITATIONS
     Due  to limitations in the current lpd protocol, it is not currently possi-
     ble to tell whether or not the job  removal  succeeded  when  operating  in
     silent mode.

     Due  to limitations in the current lpd protocol, it is not currently possi-
     ble to emulate the superuser semantics for the `-' option.   Instead,  only
     root's jobs are removed.

     Due to general niavete in the lpd protocol, rlprm(1) provides a lot of room
     for misbehavior; it is trivial to imagine how it can be used to remove jobs
     that do not belong to you.  Unfortunately, any security added at this point
     is just sugar-coating -- the underlying protocol is flawed.

rlpr 2.04			   1999/10/28				rlprm(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rlprm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help