gtklpq(1)

1gtklpq(1)                          Printing                          gtklpq(1)
2
3
4

NAME

6       gtklpq - manage print queues via CUPS
7

SYNOPSIS

9       gtklpq  [-P|-d  printer]  [-S server] [-p port] [-D] [-V] [-U user] [-t
10       timeout] [-g XxY] [-C] [-h] [-E]
11
12       lpq [-P|-d printer] [-S server] [-p port] [-D] [-V] [-U user] [-t time‐
13       out] [-E]
14
15       lprm [-P|-d printer] [-S server] [-p port] [-D] [-V] [-U user] [-E] [-]
16       [job ID(s)]
17
18       reject [-h server] [-p port] [-D] [-V] [-U user] [-E] [-r reason] [des‐
19       tination(s)]
20
21       accept [-h server] [-p port] [-D] [-V] [-U user] [-E] [-r reason] [des‐
22       tination(s)]
23
24       disable [-h server] [-c] [-p port] [-D] [-V] [-U user] [-E] [-r reason]
25       [destination(s)]
26
27       enable [-h server] [-p port] [-D] [-V] [-U user] [-E] [-r reason] [des‐
28       tination(s)]
29

DESCRIPTION

31       GtkLPQ is an graphical frontend for CUPS, the Common UNIX Printing Sys‐
32       tem.
33       It is used to manage CUPS-Printqueues.
34
35       GtkLPQ
36            Graphical Frontend
37
38       lpq
39            Show print queue
40
41       lprm
42            Remove jobs
43
44       disable/enable
45            Disable/enable printer
46
47       reject/accept
48            Reject/Accept printjobs for this printer
49
50       GtkLPQ is part of the GtkLP-package.
51

OPTIONS

53       The following options are recognized by gtklpq:
54
55       -P printer
56            Use printer as default destination.
57
58       -d printer
59            This option is equivalent to "-P".
60
61       -S server
62            The name of the CUPS-Server.
63
64       -p port
65            The port of CUPS-Server, 631 per default.
66
67       -D
68            Debug.
69
70       -V
71            Displays the version of GtkLPQ.
72
73       -U user
74            The name of the cups-User to use.
75
76       -t timeout
77            The intervall in seconds between two queue-updates.
78
79       -g XxY
80            Pop up GtkLPQ at position (X,Y).
81
82       -h
83            Help
84
85       -C
86            Force console-mode.
87
88       -E
89            Forces encryption when connecting to the server.
90
91       If called as lpq, the following options differ from GtkLPQ`s options:
92
93       -X
94            Force X-Mode, even if GTKLP_FORCEX is not set to 1
95
96       If called as lprm, the following options differ from GtkLPQ`s options:
97
98       -
99            Cancel all jobs
100
101       Without any given jobs, lprm removes the current job.
102
103       If  called  as  disable,  the  following  options  differ from GtkLPQ`s
104       options:
105
106       -c
107            Cancel all jobs
108
109       -r reason
110            Give an reason, why you do so
111
112
113       If called  as  reject,  the  following  options  differ  from  GtkLPQ`s
114       options:
115
116       -r reason
117            Give an reason, why you do so
118

PATHS

120       To hide Printers from users, use the following pathes:
121       /etc/gtklp/accept/
122       /etc/gtklp/deny/
123       $HOME/.gtklp/
124
125       Just put an empty file with the name of the printer the user should see
126       by default to accept, put an empty file with the name  of  the  printer
127       the user should never see to deny.
128       The  accept  values  can  be  overwritten  by the user, the deny values
129       can't.
130

SPECIAL

132       If you can`t connect to an X-Server, GtkLPQ acts as console-lpq.
133
134       If called as lpq, enable, disable, accept, or reject,  GtkLPQ  acts  on
135       console  like  these  tools and has some other command-line parameters,
136       see above.
137
138

VARIABLES

140       You can set the following environment variables to influence the behav‐
141       iour of GtkLPQ:
142
143       CUPS_SERVER
144            The default CUPS-server to connect to
145
146       IPP_PORT
147            The default Port of the CUPS-server to connect to
148
149       PRINTER
150            The default printer to use
151
152       GTKLP_FORCEX
153            Set to 1 to force X-Mode for lpr and lp
154

ERROR

156       GtkLPQ produces the follwoing Error-Codes:
157
158       0    normal program termination
159
160       1    small error, wrong parameters, etc.
161
162       2    Server Problems, server not found, no default printer found, etc.
163
164       3    BAD error. Fields declared too short, too many printers, etc.
165

COPYRIGHT

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

CONTACT

177       The latest version of GtkLPQ is always available under
178       http://gtklp.sourceforge.net/
179       It is part of the GtkLP-package.
180       Feel also free to contact me.
181       Please mail also, if you like the software !!! ;-)
182
183
184
185Tobias Mueller                       1.2.5                           gtklpq(1)