berkeley/lprm.c

   1 /*
   2  * "lprm" command for CUPS.
   3  *
   4  * Copyright © 2007-2018 by Apple Inc.
   5  * Copyright © 1997-2006 by Easy Software Products.
   6  *
   7  * Licensed under Apache License v2.0.  See the file "LICENSE" for more
   8  * information.
   9  */
  10
  11 /*
  12  * Include necessary headers...
  13  */
  14
  15 #include <cups/cups-private.h>
  16
  17
  18 /*
  19  * Local functions...
  20  */
  21
  22 static void     usage(void) _CUPS_NORETURN;
  23
  24
  25 /*
  26  * 'main()' - Parse options and cancel jobs.
  27  */
  28
  29 int                             /* O - Exit status */
  30 main(int  argc,                 /* I - Number of command-line arguments */
  31      char *argv[])              /* I - Command-line arguments */
  32 {
  33   int           i;              /* Looping var */
  34   int           job_id;         /* Job ID */
  35   const char    *name;          /* Destination printer */
  36   char          *instance,      /* Pointer to instance name */
  37                 *opt;           /* Option pointer */
  38   cups_dest_t   *dest,          /* Destination */
  39                 *defdest;       /* Default destination */
  40   int           did_cancel;     /* Did we cancel something? */
  41
  42
  43   _cupsSetLocale(argv);
  44
  45  /*
  46   * Setup to cancel individual print jobs...
  47   */
  48
  49   did_cancel = 0;
  50   defdest    = cupsGetNamedDest(CUPS_HTTP_DEFAULT, NULL, NULL);
  51   name       = defdest ? defdest->name : NULL;
  52
  53  /*
  54   * Process command-line arguments...
  55   */
  56
  57   for (i = 1; i < argc; i ++)
  58   {
  59     if (!strcmp(argv[i], "--help"))
  60       usage();
  61     else if (argv[i][0] == '-' && argv[i][1] != '\0')
  62     {
  63       for (opt = argv[i] + 1; *opt; opt ++)
  64       {
  65         switch (*opt)
  66         {
  67           case 'E' : /* Encrypt */
  68 #ifdef HAVE_SSL
  69               cupsSetEncryption(HTTP_ENCRYPT_REQUIRED);
  70 #else
  71               _cupsLangPrintf(stderr, _("%s: Sorry, no encryption support."), argv[0]);
  72 #endif /* HAVE_SSL */
  73               break;
  74
  75           case 'P' : /* Cancel jobs on a printer */
  76               if (opt[1] != '\0')
  77               {
  78                 name = opt + 1;
  79                 opt += strlen(opt) - 1;
  80               }
  81               else
  82               {
  83                 i ++;
  84                 name = argv[i];
  85               }
  86
  87               if ((instance = strchr(name, '/')) != NULL)
  88                 *instance = '\0';
  89
  90               if ((dest = cupsGetNamedDest(CUPS_HTTP_DEFAULT, name, NULL)) == NULL)
  91               {
  92                 _cupsLangPrintf(stderr, _("%s: Error - unknown destination \"%s\"."), argv[0], name);
  93                 goto error;
  94               }
  95
  96               cupsFreeDests(1, dest);
  97               break;
  98
  99           case 'U' : /* Username */
 100               if (opt[1] != '\0')
 101               {
 102                 cupsSetUser(opt + 1);
 103                 opt += strlen(opt) - 1;
 104               }
 105               else
 106               {
 107                 i ++;
 108                 if (i >= argc)
 109                 {
 110                   _cupsLangPrintf(stderr, _("%s: Error - expected username after \"-U\" option."), argv[0]);
 111                   usage();
 112                 }
 113
 114                 cupsSetUser(argv[i]);
 115               }
 116               break;
 117
 118           case 'h' : /* Connect to host */
 119               if (opt[1] != '\0')
 120               {
 121                 cupsSetServer(opt + 1);
 122                 opt += strlen(opt) - 1;
 123               }
 124               else
 125               {
 126                 i ++;
 127
 128                 if (i >= argc)
 129                 {
 130                   _cupsLangPrintf(stderr, _("%s: Error - expected hostname after \"-h\" option."), argv[0]);
 131                   usage();
 132                 }
 133                 else
 134                   cupsSetServer(argv[i]);
 135               }
 136
 137               if (defdest)
 138                 cupsFreeDests(1, defdest);
 139
 140               defdest = cupsGetNamedDest(CUPS_HTTP_DEFAULT, NULL, NULL);
 141               name    = defdest ? defdest->name : NULL;
 142               break;
 143
 144           default :
 145               _cupsLangPrintf(stderr, _("%s: Error - unknown option \"%c\"."), argv[0], *opt);
 146               usage();
 147         }
 148       }
 149     }
 150     else
 151     {
 152      /*
 153       * Cancel a job or printer...
 154       */
 155
 156       if ((dest = cupsGetNamedDest(CUPS_HTTP_DEFAULT, argv[i], NULL)) != NULL)
 157         cupsFreeDests(1, dest);
 158
 159       if (dest)
 160       {
 161         name   = argv[i];
 162         job_id = 0;
 163       }
 164       else if (isdigit(argv[i][0] & 255))
 165       {
 166         name   = NULL;
 167         job_id = atoi(argv[i]);
 168       }
 169       else if (!strcmp(argv[i], "-"))
 170       {
 171        /*
 172         * Cancel all jobs
 173         */
 174
 175         job_id = -1;
 176       }
 177       else
 178       {
 179         _cupsLangPrintf(stderr, _("%s: Error - unknown destination \"%s\"."),
 180                         argv[0], argv[i]);
 181         goto error;
 182       }
 183
 184       if (cupsCancelJob2(CUPS_HTTP_DEFAULT, name, job_id, 0) != IPP_OK)
 185       {
 186         _cupsLangPrintf(stderr, "%s: %s", argv[0], cupsLastErrorString());
 187         goto error;
 188       }
 189
 190       did_cancel = 1;
 191     }
 192   }
 193
 194  /*
 195   * If nothing has been canceled yet, cancel the current job on the specified
 196   * (or default) printer...
 197   */
 198
 199   if (!did_cancel && cupsCancelJob2(CUPS_HTTP_DEFAULT, name, 0, 0) != IPP_OK)
 200     {
 201       _cupsLangPrintf(stderr, "%s: %s", argv[0], cupsLastErrorString());
 202       goto error;
 203     }
 204
 205   if (defdest)
 206     cupsFreeDests(1, defdest);
 207
 208   return (0);
 209
 210  /*
 211   * If we get here there was an error, so clean up...
 212   */
 213
 214   error:
 215
 216   if (defdest)
 217     cupsFreeDests(1, defdest);
 218
 219   return (1);
 220 }
 221
 222
 223 /*
 224  * 'usage()' - Show program usage and exit.
 225  */
 226
 227 static void
 228 usage(void)
 229 {
 230   _cupsLangPuts(stdout, _("Usage: lprm [options] [id]\n"
 231                           "       lprm [options] -"));
 232   _cupsLangPuts(stdout, _("Options:"));
 233   _cupsLangPuts(stdout, _("-                       Cancel all jobs"));
 234   _cupsLangPuts(stdout, _("-E                      Encrypt the connection to the server"));
 235   _cupsLangPuts(stdout, _("-h server[:port]        Connect to the named server and port"));
 236   _cupsLangPuts(stdout, _("-P destination          Specify the destination"));
 237   _cupsLangPuts(stdout, _("-U username             Specify the username to use for authentication"));
 238
 239   exit(1);
 240 }