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.

rlpr 2.04                                          1999/10/28                                            rlpq(1)