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.
