1gtklp(1) Printing gtklp(1)
2
6 gtklp - print files via CUPS
7
9 gtklp [-P|-d printer] [-c configdir] [-S|-h server] [-p port] [-l] [-D]
10 [-V] [-b] [-i] [-H] [-C] [-U user] [-#|-n n] [-E] [-q priority] [-t|-J
11 jobname] [-o option=value ... ][file(s)]
12 lp [-d printer] [-S|-h server] [-p port] [-D] [-V] [-b] [-U user]
14 [-#|-n n] [-E] [-q priority] [-t|-J jobname] [-P page-list [-H han‐
15 dling] [-X] [-o option=value ... ][file(s)]
16 lpr [-P|-d printer] [-S|-h server] [-p port] [-D] [-V] [-b] [-U user]
18 [-#|-n n] [-E] [-q priority] [-t|-J|-C|-T jobname] [-X] [-o
19 option=value ... ][file(s)]
20
22 GtkLP is an graphical frontend for CUPS, the Common UNIX Printing Sys‐
23 tem.
24 It is used to have an easy (and graphical) access to all of the many
25 options of cups-managed printers.
26
28 The following options are recognized by gtklp:
29 -P printer
31 Use printer as default destination.
32 -d printer
34 This option is equivalent to "-P".
35 -c configdir
37 Use configdir to set an alternative path to the configfiles for
38 GtkLP.
39 -S server
41 The name of the CUPS-Server.
42 -h server
44 The same as -S.
45 -p port
47 The port of CUPS-Server, 631 per default.
48 -l
50 Only list the chosen options as a list of commandline-parameters
51 for lpr.
52 Nice for scripting purposes...
53 -D
55 Debug.
56 -V
58 Displays the version of GtkLP.
59 -b
61 Use builtin defaults instead of saved options
62 -i
64 Ignore data on stdin.
65 Sometimes useful, e.g. for printing from some versions of the
66 Acrobat Reader.
67 -U user
69 The name of the cups-User to use.
70 -# n
72 Make n copies per default.
73 -n n
75 The same as -#.
76 -H
78 Help
79 -C
81 Force console-mode
82 -o option=value
84 Specify extra options, same syntax as lpr
85 -E
87 Forces encryption when connecting to the server.
88 -q priority
90 Specify the priority of the print job, from 1 (lowest) to 100
91 (highest)
92 -t jobname
94 Specify the jobname
95 -J jobname
97 The same as -t.
98 If called as lp, the following options differ from GtkLP`s options:
100 -X Force X-Mode, even if GTKLP_FORCEX is not set to 1
102 -P page-list
104 Specifies which pages to print in the document. The list can
105 contain a list of numbers and ranges (#-#) separated by commas
106 (e.g. 1,3-5,16).
107 -H handling
109 Specifies when the job should be printed. A value of immediate
110 will print the file immediately, a value of hold will hold the job
111 indefinitely, and a time value (HH:MM) will hold the job until the
112 specified time. (does this option work ?)
113 If called as lpr, the following options differ from GtkLP`s options:
115 -X Force X-Mode, even if GTKLP_FORCEX is not set to 1
117 -C jobname
119 Specify the jobname
120 -T jobname
122 The same as -C.
123 -p Specifies that the print file should be formatted with a
125 shaded header with the date, time, job name, and page number.
126 This option is equivalent to "-oprettyprint" and is only use‐
127 ful when printing text files.
128 -l Specifies that the print file is already formatted for the
130 destination and should be sent without filtering. This option is
131 equivalent to "-oraw".
132 Some other options from systemv`s lp and berkeley`s lpr are ignored
135 without error message
136
138 GtkLP looks for config-files under
139 <configdir>
140 then under
141 $HOME/.gtklp/
142 and at last under
143 /etc/gtklp/.
144 To hide Printers from users, use the following pathes:
146 /etc/gtklp/accept/
147 /etc/gtklp/deny/
148 $HOME/.gtklp/
149 Just put an empty file with the name of the printer the user should see
151 by default to accept, put an empty file with the name of the printer
152 the user should never see to deny. If only accept exists, all but the
153 accepted printers are allowed. If only deny exists, all but the denied
154 printers are accepted.
155 All users can deny accepted printers, but they can't unhide denied
156 ones.
157
159 In GtkLP you can define a browser to open the help URL, the CUPS-Home‐
160 page and so on. Just use the your favorite HTML browser. The first $1
161 in command-line will be substituted by the URL.
162 If you can't connect to an X-Server, GtkLP acts as console-lpr.
164 If called as lpr, or lp, GtkLP acts on console and has some other com‐
166 mand-line parameters, see above.
167
169 You can set the following environment variables to influence the behav‐
170 iour of GtkLP:
171 CUPS_SERVER
173 The default CUPS-server to connect to
174 IPP_PORT
176 The default Port of the CUPS-server to connect to
177 PRINTER
179 The default printer to use
180 GTKLP_FORCEX
182 Set to 1 to force X-Mode for lpr and lp
183
185 GtkLP produces the following Error-Codes:
186 0 normal program termination
188 1 small error, wrong parameters, etc.
190 2 Server Problems, server not found, no default printer found, etc.
192 3 BAD error. Fields declared too short, too many printers, etc.
194
196 gtklpq(1), lpr(1), CUPS Software Users Manual
197 http://localhost:631/documentation.html
198
200 This program was written by T. Mueller, 2000, 2001, 2002.
201 It is licensed under the Terms of the GNU GENERAL PUBLIC LICENSE,
202 see also http://www.gnu.org.
203
206 The latest version of GtkLP is always available under
207 http://gtklp.sourceforge.net/
208 Feel also free to contact me.
209 Please mail also, if you like the software !!! ;-)
210Tobias Mueller 1.2.5 gtklp(1)