NAME
rlpq - remote line printer queue examination program
SYNOPSIS
rlpq [-lmqNV] [-Hprinthost] [-Pprinter] [-Xproxyhost] [--debug]
[--timeout=seconds] [--port=port] [ job # ... ] [ username ... ]
DESCRIPTION
rlpq uses TCP/IP to examine print queues for printers anywhere on a
network. Unlike lpq, it does not require that the remote printers be
explicitly known to the local system (traditionally through
/etc/printcap), and thus is considerably more flexible and requires
less administration.
rlpq can be used anywhere a traditional lpq might be used, and is
backwards compatible with traditional BSD lpq. If rlpq is invoked as
lpq, it preserves all known lpq semantics.
rlpq 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
information 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 rlpq will give up. Use the special value
‘-1’ to wait forever. Default timeout is 3 seconds.
-V, --version
Print version and exit.
Behavior
-l, --long
Produce a more detailed report.
-m, --mine
List only the jobs belonging to you.
-q, --quiet, --silent
Quiet mode - stay quiet (except for fatal errors). When this
flag is set, rlpq’s return value indicates whether there are any
items in the specified queue that meet the specified criteria (a
return value of zero indicates success).
ENVIRONMENT VARIABLES
The following environment variables are used by rlpq:
RLPR_PRINTHOST
Specifies the default host’s queue to examine.
PRINTER or LPDEST
Specifies the default printer to check 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
/etc/rlprrc System-wide printer/host database
SEE ALSO
rlpr(1), rlprm(1), rlprd(8), rlprrc(5)
AUTHOR
meem <meem@gnu.org>
BUGS / LIMITATIONS
Due to the dynamic nature of print queues, it is possible that the
actual state of the queue may have changed between the time the
snapshot was generated and the output was produced.