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

FreeBSD Manual Pages

  
 
  

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
       network.	 Unlike	lprm, it does not require that the remote printers  be
       explicitly known	to the local system (traditionally through /etc/print-
       cap), and thus is considerably more flexible and	requires less adminis-
       tration.

       rlprm  can  be  used  anywhere a	traditional lprm might be used,	and is
       backwards compatible with traditional BSD lprm.	If rlprm is invoked as
       lprm, it	preserves all known lprm semantics,  with  the	exceptions  of
       those semantics 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	infor-
	      mation on	use of this option.

       --port=number
	      Select an	alternate port (instead	of 7290) to connect to,	if us-
	      ing 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  in-
	      cluding  it with the printer name	with the printer@hostname syn-
	      tax.

       -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	speci-
	      fied  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  rl-
	      prm.

       -q, --quiet, --silent
	      Quiet  mode  - stay quiet	(except	for fatal errors).  See	BUGS /
	      LIMITATIONS 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
       possible	to tell	whether	or not the job removal succeeded when  operat-
       ing in silent mode.

       Due  to	limitations  in	 the current lpd protocol, it is not currently
       possible	to emulate the superuser semantics for the  `-'	 option.   In-
       stead, 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.0>

home | help