1 /* vi: set sw=4 ts=4: */
3 * bare bones version of lpr & lpq: BSD printing utilities
5 * Copyright (C) 2008 by Vladimir Dronnikov <dronnikov@gmail.com>
7 * Original idea and code:
8 * Walter Harms <WHarms@bfs.de>
10 * Licensed under GPLv2, see file LICENSE in this source tree.
12 * See RFC 1179 for protocol description.
15 //usage:#define lpr_trivial_usage
16 //usage: "-P queue[@host[:port]] -U USERNAME -J TITLE -Vmh [FILE]..."
17 /* -C CLASS exists too, not shown.
18 * CLASS is supposed to be printed on banner page, if one is requested */
19 //usage:#define lpr_full_usage "\n\n"
21 //usage: "\n -P lp service to connect to (else uses $PRINTER)"
22 //usage: "\n -m Send mail on completion"
23 //usage: "\n -h Print banner page too"
24 //usage: "\n -V Verbose"
26 //usage:#define lpq_trivial_usage
27 //usage: "[-P queue[@host[:port]]] [-U USERNAME] [-d JOBID]... [-fs]"
28 //usage:#define lpq_full_usage "\n\n"
30 //usage: "\n -P lp service to connect to (else uses $PRINTER)"
31 //usage: "\n -d Delete jobs"
32 //usage: "\n -f Force any waiting job to be printed"
33 //usage: "\n -s Short display"
38 * LPD returns binary 0 on success.
39 * Otherwise it returns error message.
41 static void get_response_or_say_and_die(int fd, const char *errmsg)
47 sz = safe_read(fd, buf, 1);
50 // try to make sure last char is '\n', but do not add
52 sz = full_read(fd, buf + 1, 126);
53 bb_error_msg("error while %s%s", errmsg,
54 (sz > 0 ? ". Server said:" : ""));
56 // sz = (bytes in buf) - 1
59 safe_write(STDERR_FILENO, buf, sz + 1);
65 int lpqr_main(int argc, char *argv[]) MAIN_EXTERNALLY_VISIBLE;
66 int lpqr_main(int argc UNUSED_PARAM, char *argv[])
69 OPT_P = 1 << 0, // -P queue[@host[:port]]. If no -P is given use $PRINTER, then "lp@localhost:515"
70 OPT_U = 1 << 1, // -U username
72 LPR_V = 1 << 2, // -V: be verbose
73 LPR_h = 1 << 3, // -h: want banner printed
74 LPR_C = 1 << 4, // -C class: job "class" (? supposedly printed on banner)
75 LPR_J = 1 << 5, // -J title: the job title for the banner page
76 LPR_m = 1 << 6, // -m: send mail back to user
78 LPQ_SHORT_FMT = 1 << 2, // -s: short listing format
79 LPQ_DELETE = 1 << 3, // -d: delete job(s)
80 LPQ_FORCE = 1 << 4, // -f: force waiting job(s) to be printed
82 char tempfile[sizeof("/tmp/lprXXXXXX")];
83 const char *job_title;
84 const char *printer_class = ""; // printer class, max 32 char
85 const char *queue; // name of printer queue
86 const char *server = "localhost"; // server[:port] of printer queue
88 // N.B. IMHO getenv("USER") can be way easily spoofed!
89 const char *user = xuid2uname(getuid());
95 // TODO: set opt_complementary: s,d,f are mutually exclusive
97 (/*lp*/'r' == applet_name[2]) ? "P:U:VhC:J:m" : "P:U:sdf"
99 , &printer_class, &job_title
103 // if queue is not specified -> use $PRINTER
105 queue = getenv("PRINTER");
106 // if queue is still not specified ->
108 // ... queue defaults to "lp"
109 // server defaults to "localhost"
111 // if queue is specified ->
113 // queue name is to the left of '@'
114 char *s = strchr(queue, '@');
116 // server name is to the right of '@'
123 fd = create_and_connect_stream_or_die(server, 515);
126 // LPQ ------------------------
128 if (/*lp*/'q' == applet_name[2]) {
130 // force printing of every job still in queue
131 if (opts & LPQ_FORCE) {
135 } else if (opts & LPQ_DELETE) {
136 fdprintf(fd, "\x5" "%s %s", queue, user);
138 fdprintf(fd, " %s", *argv++);
141 // dump current jobs status
142 // N.B. periodical polling should be achieved
143 // via "watch -n delay lpq"
144 // They say it's the UNIX-way :)
146 cmd = (opts & LPQ_SHORT_FMT) ? 3 : 4;
148 fdprintf(fd, "%c" "%s\n", cmd, queue);
149 bb_copyfd_eof(fd, STDOUT_FILENO);
156 // LPR ------------------------
159 bb_error_msg("connected to server");
161 job = getpid() % 1000;
162 hostname = safe_gethostname();
164 // no files given on command line? -> use stdin
166 *--argv = (char *)"-";
168 fdprintf(fd, "\x2" "%s\n", queue);
169 get_response_or_say_and_die(fd, "setting queue");
177 char *remote_filename;
180 // if data file is stdin, we need to dump it first
181 if (LONE_DASH(*argv)) {
182 strcpy(tempfile, "/tmp/lprXXXXXX");
183 dfd = xmkstemp(tempfile);
184 bb_copyfd_eof(STDIN_FILENO, dfd);
185 xlseek(dfd, 0, SEEK_SET);
186 *argv = (char*)bb_msg_standard_input;
188 dfd = xopen(*argv, O_RDONLY);
191 /* "The name ... should start with ASCII "cfA",
192 * followed by a three digit job number, followed
193 * by the host name which has constructed the file."
194 * We supply 'c' or 'd' as needed for control/data file. */
195 remote_filename = xasprintf("fA%03u%s", job, hostname);
197 // create control file
198 // TODO: all lines but 2 last are constants! How we can use this fact?
199 controlfile = xasprintf(
200 "H" "%.32s\n" "P" "%.32s\n" /* H HOST, P USER */
201 "C" "%.32s\n" /* C CLASS - printed on banner page (if L cmd is also given) */
202 "J" "%.99s\n" /* J JOBNAME */
203 /* "class name for banner page and job name
204 * for banner page commands must precede L command" */
205 "L" "%.32s\n" /* L USER - print banner page, with given user's name */
206 "M" "%.32s\n" /* M WHOM_TO_MAIL */
207 "l" "d%.31s\n" /* l DATA_FILE_NAME ("dfAxxx") */
209 , printer_class /* can be "" */
210 , ((opts & LPR_J) ? job_title : *argv)
211 , (opts & LPR_h) ? user : ""
212 , (opts & LPR_m) ? user : ""
215 // delete possible "\nX\n" patterns
217 cflen = (unsigned)strlen(controlfile);
218 while ((c = strchr(c, '\n')) != NULL) {
219 if (c[1] && c[2] == '\n') {
220 /* can't use strcpy, results are undefined */
221 memmove(c, c+2, cflen - (c-controlfile) - 1);
230 bb_error_msg("sending control file");
231 /* "Acknowledgement processing must occur as usual
232 * after the command is sent." */
233 fdprintf(fd, "\x2" "%u c%s\n", cflen, remote_filename);
234 get_response_or_say_and_die(fd, "sending control file");
235 /* "Once all of the contents have
236 * been delivered, an octet of zero bits is sent as
237 * an indication that the file being sent is complete.
238 * A second level of acknowledgement processing
239 * must occur at this point." */
240 full_write(fd, controlfile, cflen + 1); /* writes NUL byte too */
241 get_response_or_say_and_die(fd, "sending control file");
243 // send data file, with name "dfaXXX"
245 bb_error_msg("sending data file");
246 st.st_size = 0; /* paranoia: fstat may theoretically fail */
248 fdprintf(fd, "\x3" "%"OFF_FMT"u d%s\n", st.st_size, remote_filename);
249 get_response_or_say_and_die(fd, "sending data file");
250 if (bb_copyfd_size(dfd, fd, st.st_size) != st.st_size) {
251 // We're screwed. We sent less bytes than we advertised.
252 bb_error_msg_and_die("local file changed size?!");
254 write(fd, "", 1); // send ACK
255 get_response_or_say_and_die(fd, "sending data file");
257 // delete temporary file if we dumped stdin
258 if (*argv == (char*)bb_msg_standard_input)
263 free(remote_filename);
268 bb_error_msg("job accepted");
271 job = (job + 1) % 1000;