---
name: "gtklpq"
section: "1"
platform: "linux"
package: "gtklp"
version: "1.3.4-3+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gtklpq"
---

# gtklpq(1)

manage print queues via CUPS

## NAME

gtklpq - manage print queues via CUPS

## SYNOPSIS

**gtklpq** \[-P\|-d *printer*\] \[-S *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-t *timeout*\] \[-g *X*x*Y*\] \[-C\] \[-h\] \[-E\]

**lpq** \[-P\|-d *printer*\] \[-S *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-t *timeout*\] \[-E\]

**lprm** \[-P\|-d *printer*\] \[-S *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-E\] \[-\] \[job ID(s)\]

**reject** \[-h *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-E\] \[-r *reason*\] \[destination(s)\]

**accept** \[-h *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-E\] \[-r *reason*\] \[destination(s)\]

**disable** \[-h *server*\] \[-c\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-E\] \[-r *reason*\] \[destination(s)\]

**enable** \[-h *server*\] \[-p *port*\] \[-D\] \[-V\] \[-U *user*\] \[-E\] \[-r *reason*\] \[destination(s)\]

## DESCRIPTION

**GtkLPQ** is an graphical frontend for *CUPS*, the Common UNIX Printing System.\
 It is used to manage CUPS-Printqueues.\

- GtkLPQ

  Graphical Frontend

- lpq

  Show print queue

- lprm

  Remove jobs

- disable/enable

  Disable/enable printer

- reject/accept

  Reject/Accept printjobs for this printer

- **GtkLPQ** is part of the **GtkLP**-package.

  ## OPTIONS

The following options are recognized by **gtklpq**:

- \-P *printer*

  Use *printer* as default destination.

- \-d *printer*

  This option is equivalent to "-P".

- \-S *server*

  The name of the CUPS-Server.

- \-p *port*

  The port of CUPS-Server, 631 per default.

- \-D

  Debug.

- \-V

  Displays the version of **GtkLPQ**.

- \-U *user*

  The name of the cups-User to use.

- \-t *timeout*

  The intervall in seconds between two queue-updates.

- \-g *X*x*Y*

  Pop up GtkLPQ at position (X,Y).

- \-h

  Help

- \-C

  Force console-mode.

- \-E

  Forces encryption when connecting to the server.

- If called as lpq, the following options differ from GtkLPQ\`s options:

  - \-X

  Force X-Mode, even if GTKLP\_FORCEX is not set to 1

- If called as lprm, the following options differ from GtkLPQ\`s options:

  - \-

  Cancel all jobs

- Without any given jobs, lprm removes the current job.

  - If called as disable, the following options differ from GtkLPQ\`s options:

  - \-c

  Cancel all jobs

- \-r reason

  Give an reason, why you do so

- If called as reject, the following options differ from GtkLPQ\`s options:

  - \-r reason

  Give an reason, why you do so

## PATHS

To hide Printers from users, use the following pathes:\
 */etc/gtklp/accept/*\
 */etc/gtklp/deny/*\
 *$HOME/.gtklp/*\

Just put an empty file with the name of the printer the user should see by default to *accept*, put an empty file with the name of the printer the user should never see to *deny*.\
 The *accept* values can be overwritten by the user, the  *deny* values can't.

## SPECIAL

If you can\`t connect to an X-Server, GtkLPQ acts as console-lpq.

If called as lpq, enable, disable, accept, or reject, GtkLPQ acts on console like these tools and has some other command-line parameters, see above.

## VARIABLES

You can set the following environment variables to influence the behaviour of GtkLPQ:

- CUPS\_SERVER

  The default CUPS-server to connect to

- IPP\_PORT

  The default Port of the CUPS-server to connect to

- PRINTER

  The default printer to use

- GTKLP\_FORCEX

  Set to 1 to force X-Mode for lpr and lp

## ERROR

GtkLPQ produces the follwoing Error-Codes:

- 0

  normal program termination\

- 1

  small error, wrong parameters, etc.\

- 2

  Server Problems, server not found, no default printer found, etc.\

- 3

  BAD error. Fields declared too short, too many printers, etc.

## SEE ALSO

[gtklp(1)](/gtklp/1.md), [lprm(1)](/lprm/1.md), [lp(1)](/lp/1.md), CUPS Software Users Manual\
 http://localhost:631/documentation.html

## COPYRIGHT

This program was written by T. Mueller, 2000, 2001, 2002.\
 It is licensed under the Terms of the GNU GENERAL PUBLIC LICENSE, \
 see also http://www.gnu.org.

## CONTACT

The latest version of **GtkLPQ** is always available under\
 http://gtklp.sourceforge.net/\
 It is part of the **GtkLP**-package.\
 Feel also free to contact me.\
 Please mail also, if you like the software !!! ;-)