mirror of https://gitee.com/openkylin/cups.git
411 lines
9.3 KiB
C
411 lines
9.3 KiB
C
/*
|
||
* "cancel" command for CUPS.
|
||
*
|
||
* Copyright © 2007-2018 by Apple Inc.
|
||
* Copyright © 1997-2006 by Easy Software Products.
|
||
*
|
||
* Licensed under Apache License v2.0. See the file "LICENSE" for more
|
||
* information.
|
||
*/
|
||
|
||
/*
|
||
* Include necessary headers...
|
||
*/
|
||
|
||
#include <cups/cups-private.h>
|
||
|
||
|
||
/*
|
||
* Local functions...
|
||
*/
|
||
|
||
static void usage(void) _CUPS_NORETURN;
|
||
|
||
|
||
/*
|
||
* 'main()' - Parse options and cancel jobs.
|
||
*/
|
||
|
||
int /* O - Exit status */
|
||
main(int argc, /* I - Number of command-line arguments */
|
||
char *argv[]) /* I - Command-line arguments */
|
||
{
|
||
http_t *http; /* HTTP connection to server */
|
||
int i; /* Looping var */
|
||
int job_id; /* Job ID */
|
||
int num_dests; /* Number of destinations */
|
||
cups_dest_t *dests; /* Destinations */
|
||
char *opt, /* Option pointer */
|
||
*dest, /* Destination printer */
|
||
*job, /* Job ID pointer */
|
||
*user; /* Cancel jobs for a user */
|
||
int purge; /* Purge or cancel jobs? */
|
||
char uri[1024]; /* Printer or job URI */
|
||
ipp_t *request; /* IPP request */
|
||
ipp_t *response; /* IPP response */
|
||
ipp_op_t op; /* Operation */
|
||
|
||
|
||
_cupsSetLocale(argv);
|
||
|
||
/*
|
||
* Setup to cancel individual print jobs...
|
||
*/
|
||
|
||
op = IPP_CANCEL_JOB;
|
||
purge = 0;
|
||
dest = NULL;
|
||
user = NULL;
|
||
http = NULL;
|
||
num_dests = 0;
|
||
dests = NULL;
|
||
|
||
|
||
/*
|
||
* Process command-line arguments...
|
||
*/
|
||
|
||
for (i = 1; i < argc; i ++)
|
||
{
|
||
if (!strcmp(argv[i], "--help"))
|
||
usage();
|
||
else if (argv[i][0] == '-' && argv[i][1])
|
||
{
|
||
for (opt = argv[i] + 1; *opt; opt ++)
|
||
{
|
||
switch (*opt)
|
||
{
|
||
case 'E' : /* Encrypt */
|
||
#ifdef HAVE_SSL
|
||
cupsSetEncryption(HTTP_ENCRYPT_REQUIRED);
|
||
|
||
if (http)
|
||
httpEncryption(http, HTTP_ENCRYPT_REQUIRED);
|
||
#else
|
||
_cupsLangPrintf(stderr, _("%s: Sorry, no encryption support."), argv[0]);
|
||
#endif /* HAVE_SSL */
|
||
break;
|
||
|
||
case 'U' : /* Username */
|
||
if (opt[1] != '\0')
|
||
{
|
||
cupsSetUser(opt + 1);
|
||
opt += strlen(opt) - 1;
|
||
}
|
||
else
|
||
{
|
||
i ++;
|
||
if (i >= argc)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: Error - expected username after \"-U\" option."), argv[0]);
|
||
usage();
|
||
}
|
||
|
||
cupsSetUser(argv[i]);
|
||
}
|
||
break;
|
||
|
||
case 'a' : /* Cancel all jobs */
|
||
op = purge ? IPP_PURGE_JOBS : IPP_CANCEL_JOBS;
|
||
break;
|
||
|
||
case 'h' : /* Connect to host */
|
||
if (http != NULL)
|
||
{
|
||
httpClose(http);
|
||
http = NULL;
|
||
}
|
||
|
||
if (opt[1] != '\0')
|
||
{
|
||
cupsSetServer(opt + 1);
|
||
opt += strlen(opt) - 1;
|
||
}
|
||
else
|
||
{
|
||
i ++;
|
||
|
||
if (i >= argc)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: Error - expected hostname after \"-h\" option."), argv[0]);
|
||
usage();
|
||
}
|
||
else
|
||
cupsSetServer(argv[i]);
|
||
}
|
||
break;
|
||
|
||
case 'u' : /* Username */
|
||
op = IPP_CANCEL_MY_JOBS;
|
||
|
||
if (opt[1] != '\0')
|
||
{
|
||
user = opt + 1;
|
||
opt += strlen(opt) - 1;
|
||
}
|
||
else
|
||
{
|
||
i ++;
|
||
|
||
if (i >= argc)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: Error - expected username after \"-u\" option."), argv[0]);
|
||
usage();
|
||
}
|
||
else
|
||
user = argv[i];
|
||
}
|
||
break;
|
||
|
||
case 'x' : /* Purge job(s) */
|
||
purge = 1;
|
||
|
||
if (op == IPP_CANCEL_JOBS)
|
||
op = IPP_PURGE_JOBS;
|
||
break;
|
||
|
||
default :
|
||
_cupsLangPrintf(stderr, _("%s: Error - unknown option \"%c\"."), argv[0], *opt);
|
||
return (1);
|
||
}
|
||
}
|
||
}
|
||
else
|
||
{
|
||
/*
|
||
* Cancel a job or printer...
|
||
*/
|
||
|
||
if (num_dests == 0)
|
||
num_dests = cupsGetDests(&dests);
|
||
|
||
if (!strcmp(argv[i], "-"))
|
||
{
|
||
/*
|
||
* Delete the current job...
|
||
*/
|
||
|
||
dest = "";
|
||
job_id = 0;
|
||
}
|
||
else if (cupsGetDest(argv[i], NULL, num_dests, dests) != NULL)
|
||
{
|
||
/*
|
||
* Delete the current job on the named destination...
|
||
*/
|
||
|
||
dest = argv[i];
|
||
job_id = 0;
|
||
}
|
||
else if ((job = strrchr(argv[i], '-')) != NULL && isdigit(job[1] & 255))
|
||
{
|
||
/*
|
||
* Delete the specified job ID.
|
||
*/
|
||
|
||
dest = NULL;
|
||
op = IPP_CANCEL_JOB;
|
||
job_id = atoi(job + 1);
|
||
}
|
||
else if (isdigit(argv[i][0] & 255))
|
||
{
|
||
/*
|
||
* Delete the specified job ID.
|
||
*/
|
||
|
||
dest = NULL;
|
||
op = IPP_CANCEL_JOB;
|
||
job_id = atoi(argv[i]);
|
||
}
|
||
else
|
||
{
|
||
/*
|
||
* Bad printer name!
|
||
*/
|
||
|
||
_cupsLangPrintf(stderr,
|
||
_("%s: Error - unknown destination \"%s\"."),
|
||
argv[0], argv[i]);
|
||
return (1);
|
||
}
|
||
|
||
/*
|
||
* For Solaris LP compatibility, ignore a destination name after
|
||
* cancelling a specific job ID...
|
||
*/
|
||
|
||
if (job_id && (i + 1) < argc &&
|
||
cupsGetDest(argv[i + 1], NULL, num_dests, dests) != NULL)
|
||
i ++;
|
||
|
||
/*
|
||
* Open a connection to the server...
|
||
*/
|
||
|
||
if (http == NULL)
|
||
if ((http = httpConnectEncrypt(cupsServer(), ippPort(),
|
||
cupsEncryption())) == NULL)
|
||
{
|
||
_cupsLangPrintf(stderr,
|
||
_("%s: Unable to connect to server."), argv[0]);
|
||
return (1);
|
||
}
|
||
|
||
/*
|
||
* Build an IPP request, which requires the following
|
||
* attributes:
|
||
*
|
||
* attributes-charset
|
||
* attributes-natural-language
|
||
* printer-uri + job-id *or* job-uri
|
||
* [requesting-user-name]
|
||
*/
|
||
|
||
request = ippNewRequest(op);
|
||
|
||
if (dest)
|
||
{
|
||
httpAssembleURIf(HTTP_URI_CODING_ALL, uri, sizeof(uri), "ipp", NULL,
|
||
"localhost", 0, "/printers/%s", dest);
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI,
|
||
"printer-uri", NULL, uri);
|
||
ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id",
|
||
job_id);
|
||
}
|
||
else
|
||
{
|
||
sprintf(uri, "ipp://localhost/jobs/%d", job_id);
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "job-uri", NULL,
|
||
uri);
|
||
}
|
||
|
||
if (user)
|
||
{
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME,
|
||
"requesting-user-name", NULL, user);
|
||
ippAddBoolean(request, IPP_TAG_OPERATION, "my-jobs", 1);
|
||
|
||
if (op == IPP_CANCEL_JOBS)
|
||
op = IPP_CANCEL_MY_JOBS;
|
||
}
|
||
else
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME,
|
||
"requesting-user-name", NULL, cupsUser());
|
||
|
||
if (purge)
|
||
ippAddBoolean(request, IPP_TAG_OPERATION, "purge-jobs", (char)purge);
|
||
|
||
/*
|
||
* Do the request and get back a response...
|
||
*/
|
||
|
||
if (op == IPP_CANCEL_JOBS && (!user || _cups_strcasecmp(user, cupsUser())))
|
||
response = cupsDoRequest(http, request, "/admin/");
|
||
else
|
||
response = cupsDoRequest(http, request, "/jobs/");
|
||
|
||
if (response == NULL ||
|
||
response->request.status.status_code > IPP_OK_CONFLICT)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: %s failed: %s"), argv[0],
|
||
op == IPP_PURGE_JOBS ? "purge-jobs" : "cancel-job",
|
||
cupsLastErrorString());
|
||
|
||
if (response)
|
||
ippDelete(response);
|
||
|
||
return (1);
|
||
}
|
||
|
||
ippDelete(response);
|
||
}
|
||
}
|
||
|
||
if (num_dests == 0 && op != IPP_CANCEL_JOB)
|
||
{
|
||
/*
|
||
* Open a connection to the server...
|
||
*/
|
||
|
||
if (http == NULL)
|
||
if ((http = httpConnectEncrypt(cupsServer(), ippPort(),
|
||
cupsEncryption())) == NULL)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: Unable to contact server."), argv[0]);
|
||
return (1);
|
||
}
|
||
|
||
/*
|
||
* Build an IPP request, which requires the following
|
||
* attributes:
|
||
*
|
||
* attributes-charset
|
||
* attributes-natural-language
|
||
* printer-uri + job-id *or* job-uri
|
||
* [requesting-user-name]
|
||
*/
|
||
|
||
request = ippNewRequest(op);
|
||
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI,
|
||
"printer-uri", NULL, "ipp://localhost/printers/");
|
||
|
||
if (user)
|
||
{
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME,
|
||
"requesting-user-name", NULL, user);
|
||
ippAddBoolean(request, IPP_TAG_OPERATION, "my-jobs", 1);
|
||
}
|
||
else
|
||
ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME,
|
||
"requesting-user-name", NULL, cupsUser());
|
||
|
||
ippAddBoolean(request, IPP_TAG_OPERATION, "purge-jobs", (char)purge);
|
||
|
||
/*
|
||
* Do the request and get back a response...
|
||
*/
|
||
|
||
response = cupsDoRequest(http, request, "/admin/");
|
||
|
||
if (response == NULL ||
|
||
response->request.status.status_code > IPP_OK_CONFLICT)
|
||
{
|
||
_cupsLangPrintf(stderr, _("%s: %s failed: %s"), argv[0],
|
||
op == IPP_PURGE_JOBS ? "purge-jobs" : "cancel-job",
|
||
cupsLastErrorString());
|
||
|
||
if (response)
|
||
ippDelete(response);
|
||
|
||
return (1);
|
||
}
|
||
|
||
ippDelete(response);
|
||
}
|
||
|
||
return (0);
|
||
}
|
||
|
||
|
||
/*
|
||
* 'usage()' - Show program usage and exit.
|
||
*/
|
||
|
||
static void
|
||
usage(void)
|
||
{
|
||
_cupsLangPuts(stdout, _("Usage: cancel [options] [id]\n"
|
||
" cancel [options] [destination]\n"
|
||
" cancel [options] [destination-id]"));
|
||
_cupsLangPuts(stdout, _("Options:"));
|
||
_cupsLangPuts(stdout, _("-a Cancel all jobs"));
|
||
_cupsLangPuts(stdout, _("-E Encrypt the connection to the server"));
|
||
_cupsLangPuts(stdout, _("-h server[:port] Connect to the named server and port"));
|
||
_cupsLangPuts(stdout, _("-u owner Specify the owner to use for jobs"));
|
||
_cupsLangPuts(stdout, _("-U username Specify the username to use for authentication"));
|
||
_cupsLangPuts(stdout, _("-x Purge jobs rather than just canceling"));
|
||
|
||
exit(1);
|
||
}
|