printutils/lpr.c

   1 /* vi: set sw=4 ts=4: */
   2 /*
   3  * bare bones version of lpr & lpq: BSD printing utilities
   4  *
   5  * Copyright (C) 2008 by Vladimir Dronnikov <dronnikov@gmail.com>
   6  *
   7  * Original idea and code:
   8  *      Walter Harms <WHarms@bfs.de>
   9  *
  10  * Licensed under GPLv2, see file LICENSE in this source tree.
  11  *
  12  * See RFC 1179 for protocol description.
  13  */
  14
  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"
  20 //usage:       "Options:"
  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"
  25 //usage:
  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"
  29 //usage:       "Options:"
  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"
  34
  35 #include "libbb.h"
  36
  37 /*
  38  * LPD returns binary 0 on success.
  39  * Otherwise it returns error message.
  40  */
  41 static void get_response_or_say_and_die(int fd, const char *errmsg)
  42 {
  43         ssize_t sz;
  44         char buf[128];
  45
  46         buf[0] = ' ';
  47         sz = safe_read(fd, buf, 1);
  48         if ('\0' != buf[0]) {
  49                 // request has failed
  50                 // try to make sure last char is '\n', but do not add
  51                 // superfluous one
  52                 sz = full_read(fd, buf + 1, 126);
  53                 bb_error_msg("error while %s%s", errmsg,
  54                                 (sz > 0 ? ". Server said:" : ""));
  55                 if (sz > 0) {
  56                         // sz = (bytes in buf) - 1
  57                         if (buf[sz] != '\n')
  58                                 buf[++sz] = '\n';
  59                         safe_write(STDERR_FILENO, buf, sz + 1);
  60                 }
  61                 xfunc_die();
  62         }
  63 }
  64
  65 int lpqr_main(int argc, char *argv[]) MAIN_EXTERNALLY_VISIBLE;
  66 int lpqr_main(int argc UNUSED_PARAM, char *argv[])
  67 {
  68         enum {
  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
  71
  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
  77
  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
  81         };
  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
  87         char *hostname;
  88         // N.B. IMHO getenv("USER") can be way easily spoofed!
  89         const char *user = xuid2uname(getuid());
  90         unsigned job;
  91         unsigned opts;
  92         int fd;
  93
  94         // parse options
  95         // TODO: set opt_complementary: s,d,f are mutually exclusive
  96         opts = getopt32(argv,
  97                 (/*lp*/'r' == applet_name[2]) ? "P:U:VhC:J:m" : "P:U:sdf"
  98                 , &queue, &user
  99                 , &printer_class, &job_title
 100         );
 101         argv += optind;
 102
 103         // if queue is not specified -> use $PRINTER
 104         if (!(opts & OPT_P))
 105                 queue = getenv("PRINTER");
 106         // if queue is still not specified ->
 107         if (!queue) {
 108                 // ... queue defaults to "lp"
 109                 // server defaults to "localhost"
 110                 queue = "lp";
 111         // if queue is specified ->
 112         } else {
 113                 // queue name is to the left of '@'
 114                 char *s = strchr(queue, '@');
 115                 if (s) {
 116                         // server name is to the right of '@'
 117                         *s = '\0';
 118                         server = s + 1;
 119                 }
 120         }
 121
 122         // do connect
 123         fd = create_and_connect_stream_or_die(server, 515);
 124
 125         //
 126         // LPQ ------------------------
 127         //
 128         if (/*lp*/'q' == applet_name[2]) {
 129                 char cmd;
 130                 // force printing of every job still in queue
 131                 if (opts & LPQ_FORCE) {
 132                         cmd = 1;
 133                         goto command;
 134                 // delete job(s)
 135                 } else if (opts & LPQ_DELETE) {
 136                         fdprintf(fd, "\x5" "%s %s", queue, user);
 137                         while (*argv) {
 138                                 fdprintf(fd, " %s", *argv++);
 139                         }
 140                         bb_putchar('\n');
 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 :)
 145                 } else {
 146                         cmd = (opts & LPQ_SHORT_FMT) ? 3 : 4;
 147  command:
 148                         fdprintf(fd, "%c" "%s\n", cmd, queue);
 149                         bb_copyfd_eof(fd, STDOUT_FILENO);
 150                 }
 151
 152                 return EXIT_SUCCESS;
 153         }
 154
 155         //
 156         // LPR ------------------------
 157         //
 158         if (opts & LPR_V)
 159                 bb_error_msg("connected to server");
 160
 161         job = getpid() % 1000;
 162         hostname = safe_gethostname();
 163
 164         // no files given on command line? -> use stdin
 165         if (!*argv)
 166                 *--argv = (char *)"-";
 167
 168         fdprintf(fd, "\x2" "%s\n", queue);
 169         get_response_or_say_and_die(fd, "setting queue");
 170
 171         // process files
 172         do {
 173                 unsigned cflen;
 174                 int dfd;
 175                 struct stat st;
 176                 char *c;
 177                 char *remote_filename;
 178                 char *controlfile;
 179
 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;
 187                 } else {
 188                         dfd = xopen(*argv, O_RDONLY);
 189                 }
 190
 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);
 196
 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") */
 208                         , hostname, user
 209                         , printer_class /* can be "" */
 210                         , ((opts & LPR_J) ? job_title : *argv)
 211                         , (opts & LPR_h) ? user : ""
 212                         , (opts & LPR_m) ? user : ""
 213                         , remote_filename
 214                 );
 215                 // delete possible "\nX\n" patterns
 216                 c = controlfile;
 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);
 222                                 cflen -= 2;
 223                         } else {
 224                                 c++;
 225                         }
 226                 }
 227
 228                 // send control file
 229                 if (opts & LPR_V)
 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");
 242
 243                 // send data file, with name "dfaXXX"
 244                 if (opts & LPR_V)
 245                         bb_error_msg("sending data file");
 246                 st.st_size = 0; /* paranoia: fstat may theoretically fail */
 247                 fstat(dfd, &st);
 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?!");
 253                 }
 254                 write(fd, "", 1); // send ACK
 255                 get_response_or_say_and_die(fd, "sending data file");
 256
 257                 // delete temporary file if we dumped stdin
 258                 if (*argv == (char*)bb_msg_standard_input)
 259                         unlink(tempfile);
 260
 261                 // cleanup
 262                 close(fd);
 263                 free(remote_filename);
 264                 free(controlfile);
 265
 266                 // say job accepted
 267                 if (opts & LPR_V)
 268                         bb_error_msg("job accepted");
 269
 270                 // next, please!
 271                 job = (job + 1) % 1000;
 272         } while (*++argv);
 273
 274         return EXIT_SUCCESS;
 275 }