---
name: "rlpq"
section: "1"
platform: "linux"
package: "rlpr"
version: "2.06-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rlpq"
---

# rlpq(1)

remote line printer queue examination program

## NAME

rlpq - remote line printer queue examination program

## SYNOPSIS

**rlpq** \[-lmqNV\] \[**-H**printhost\] \[**-P**printer\] \[**-X**proxyhost\] \[**--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)](/rlpr/1.md) (that is, either with or without the [**rlprd**(8)](/rlprd/8.md) proxy daemon).  Please see [**rlpr**(1)](/rlpr/1.md) for details, and to see whether you will need to use the [**rlprd**(8)](/rlprd/8.md) 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)](/rlpr/1.md) 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)](/rlpr/1.md), [**rlprm**(1)](/rlprm/1.md), [**rlprd**(8)](/rlprd/8.md), [**rlprrc**(5)](/rlprrc/5.md)

## 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.