2 * "lpadmin" command for CUPS.
4 * Copyright © 2007-2019 by Apple Inc.
5 * Copyright © 1997-2006 by Easy Software Products.
7 * Licensed under Apache License v2.0. See the file "LICENSE" for more
12 * Include necessary headers...
15 #include <cups/cups-private.h>
16 #include <cups/ppd-private.h>
23 static int add_printer_to_class(http_t
*http
, char *printer
, char *pclass
);
24 static int default_printer(http_t
*http
, char *printer
);
25 static int delete_printer(http_t
*http
, char *printer
);
26 static int delete_printer_from_class(http_t
*http
, char *printer
,
28 static int delete_printer_option(http_t
*http
, char *printer
,
30 static int enable_printer(http_t
*http
, char *printer
);
31 static char *get_printer_ppd(const char *uri
, char *buffer
, size_t bufsize
, int *num_options
, cups_option_t
**options
);
32 static cups_ptype_t
get_printer_type(http_t
*http
, char *printer
, char *uri
,
34 static int set_printer_options(http_t
*http
, char *printer
,
35 int num_options
, cups_option_t
*options
,
36 char *file
, int enable
);
37 static void usage(void) _CUPS_NORETURN
;
38 static int validate_name(const char *name
);
42 * 'main()' - Parse options and configure the scheduler.
45 int /* O - Exit status */
46 main(int argc
, /* I - Number of command-line arguments */
47 char *argv
[]) /* I - Command-line arguments */
49 int i
; /* Looping var */
50 http_t
*http
; /* Connection to server */
51 char *printer
, /* Destination printer */
52 *pclass
, /* Printer class name */
53 *opt
, /* Option pointer */
54 *val
; /* Pointer to allow/deny value */
55 int enable
= 0; /* Enable/resume printer? */
56 int num_options
; /* Number of options */
57 cups_option_t
*options
; /* Options */
58 char *file
, /* New PPD file */
59 evefile
[1024] = ""; /* IPP Everywhere PPD */
60 const char *ppd_name
, /* ppd-name value */
61 *device_uri
; /* device-uri value */
72 for (i
= 1; i
< argc
; i
++)
74 if (!strcmp(argv
[i
], "--help"))
76 else if (argv
[i
][0] == '-')
78 for (opt
= argv
[i
] + 1; *opt
; opt
++)
82 case 'c' : /* Add printer to class */
85 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
89 _cupsLangPrintf(stderr
, _("lpadmin: Unable to connect to server: %s"), strerror(errno
));
97 _("lpadmin: Unable to add a printer to the class:\n"
98 " You must specify a printer name first."));
105 opt
+= strlen(opt
) - 1;
113 _cupsLangPuts(stderr
, _("lpadmin: Expected class name after \"-c\" option."));
120 if (!validate_name(pclass
))
122 _cupsLangPuts(stderr
,
123 _("lpadmin: Class name can only contain printable "
128 if (add_printer_to_class(http
, printer
, pclass
))
132 case 'd' : /* Set as default destination */
135 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
139 _cupsLangPrintf(stderr
, _("lpadmin: Unable to connect to server: %s"), strerror(errno
));
147 opt
+= strlen(opt
) - 1;
155 _cupsLangPuts(stderr
, _("lpadmin: Expected printer name after \"-d\" option."));
162 if (!validate_name(printer
))
164 _cupsLangPuts(stderr
, _("lpadmin: Printer name can only contain printable characters."));
168 if (default_printer(http
, printer
))
174 case 'h' : /* Connect to host */
183 cupsSetServer(opt
+ 1);
184 opt
+= strlen(opt
) - 1;
192 _cupsLangPuts(stderr
, _("lpadmin: Expected hostname after \"-h\" option."));
196 cupsSetServer(argv
[i
]);
200 case 'P' : /* Use the specified PPD file */
201 case 'i' : /* Use the specified PPD file */
205 opt
+= strlen(opt
) - 1;
213 _cupsLangPrintf(stderr
, _("lpadmin: Expected PPD after \"-%c\" option."), argv
[i
- 1][1]);
223 * Check to see that the specified file is, in fact, a PPD...
226 cups_file_t
*fp
= cupsFileOpen(file
, "r");
229 if (!cupsFileGets(fp
, line
, sizeof(line
)) || strncmp(line
, "*PPD-Adobe", 10))
231 _cupsLangPuts(stderr
, _("lpadmin: System V interface scripts are no longer supported for security reasons."));
240 case 'E' : /* Enable the printer/enable encryption */
244 cupsSetEncryption(HTTP_ENCRYPTION_REQUIRED
);
247 httpEncryption(http
, HTTP_ENCRYPTION_REQUIRED
);
249 _cupsLangPrintf(stderr
, _("%s: Sorry, no encryption support."), argv
[0]);
250 #endif /* HAVE_SSL */
256 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
260 _cupsLangPrintf(stderr
,
261 _("lpadmin: Unable to connect to server: %s"),
270 case 'm' : /* Use the specified standard script/PPD file */
273 num_options
= cupsAddOption("ppd-name", opt
+ 1, num_options
, &options
);
274 opt
+= strlen(opt
) - 1;
282 _cupsLangPuts(stderr
, _("lpadmin: Expected model after \"-m\" option."));
286 num_options
= cupsAddOption("ppd-name", argv
[i
], num_options
, &options
);
290 case 'o' : /* Set option */
293 num_options
= cupsParseOptions(opt
+ 1, num_options
, &options
);
294 opt
+= strlen(opt
) - 1;
302 _cupsLangPuts(stderr
, _("lpadmin: Expected name=value after \"-o\" option."));
306 num_options
= cupsParseOptions(argv
[i
], num_options
, &options
);
310 case 'p' : /* Add/modify a printer */
314 opt
+= strlen(opt
) - 1;
322 _cupsLangPuts(stderr
, _("lpadmin: Expected printer after \"-p\" option."));
329 if (!validate_name(printer
))
331 _cupsLangPuts(stderr
, _("lpadmin: Printer name can only contain printable characters."));
336 case 'r' : /* Remove printer from class */
339 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
343 _cupsLangPrintf(stderr
,
344 _("lpadmin: Unable to connect to server: %s"),
352 _cupsLangPuts(stderr
,
353 _("lpadmin: Unable to remove a printer from the class:\n"
354 " You must specify a printer name first."));
361 opt
+= strlen(opt
) - 1;
369 _cupsLangPuts(stderr
, _("lpadmin: Expected class after \"-r\" option."));
376 if (!validate_name(pclass
))
378 _cupsLangPuts(stderr
, _("lpadmin: Class name can only contain printable characters."));
382 if (delete_printer_from_class(http
, printer
, pclass
))
386 case 'R' : /* Remove option */
389 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
393 _cupsLangPrintf(stderr
, _("lpadmin: Unable to connect to server: %s"), strerror(errno
));
400 _cupsLangPuts(stderr
,
401 _("lpadmin: Unable to delete option:\n"
402 " You must specify a printer name first."));
409 opt
+= strlen(opt
) - 1;
417 _cupsLangPuts(stderr
, _("lpadmin: Expected name after \"-R\" option."));
424 if (delete_printer_option(http
, printer
, val
))
428 case 'U' : /* Username */
431 cupsSetUser(opt
+ 1);
432 opt
+= strlen(opt
) - 1;
439 _cupsLangPrintf(stderr
, _("%s: Error - expected username after \"-U\" option."), argv
[0]);
443 cupsSetUser(argv
[i
]);
447 case 'u' : /* Allow/deny users */
451 opt
+= strlen(opt
) - 1;
459 _cupsLangPuts(stderr
, _("lpadmin: Expected allow/deny:userlist after \"-u\" option."));
466 if (!_cups_strncasecmp(val
, "allow:", 6))
467 num_options
= cupsAddOption("requesting-user-name-allowed", val
+ 6, num_options
, &options
);
468 else if (!_cups_strncasecmp(val
, "deny:", 5))
469 num_options
= cupsAddOption("requesting-user-name-denied", val
+ 5, num_options
, &options
);
472 _cupsLangPrintf(stderr
, _("lpadmin: Unknown allow/deny option \"%s\"."), val
);
477 case 'v' : /* Set the device-uri attribute */
480 num_options
= cupsAddOption("device-uri", opt
+ 1, num_options
, &options
);
481 opt
+= strlen(opt
) - 1;
489 _cupsLangPuts(stderr
, _("lpadmin: Expected device URI after \"-v\" option."));
493 num_options
= cupsAddOption("device-uri", argv
[i
], num_options
, &options
);
497 case 'x' : /* Delete a printer */
500 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
, cupsEncryption(), 1, 30000, NULL
);
504 _cupsLangPrintf(stderr
,
505 _("lpadmin: Unable to connect to server: %s"),
514 opt
+= strlen(opt
) - 1;
522 _cupsLangPuts(stderr
, _("lpadmin: Expected printer or class after \"-x\" option."));
529 if (!validate_name(printer
))
531 _cupsLangPuts(stderr
, _("lpadmin: Printer name can only contain printable characters."));
535 if (delete_printer(http
, printer
))
541 case 'D' : /* Set the printer-info attribute */
544 num_options
= cupsAddOption("printer-info", opt
+ 1, num_options
, &options
);
545 opt
+= strlen(opt
) - 1;
553 _cupsLangPuts(stderr
, _("lpadmin: Expected description after \"-D\" option."));
557 num_options
= cupsAddOption("printer-info", argv
[i
], num_options
, &options
);
561 case 'I' : /* Set the supported file types (ignored) */
566 _cupsLangPuts(stderr
, _("lpadmin: Expected file type(s) after \"-I\" option."));
570 _cupsLangPuts(stderr
, _("lpadmin: Warning - content type list ignored."));
573 case 'L' : /* Set the printer-location attribute */
576 num_options
= cupsAddOption("printer-location", opt
+ 1, num_options
, &options
);
577 opt
+= strlen(opt
) - 1;
585 _cupsLangPuts(stderr
, _("lpadmin: Expected location after \"-L\" option."));
589 num_options
= cupsAddOption("printer-location", argv
[i
], num_options
, &options
);
594 _cupsLangPrintf(stderr
, _("lpadmin: Unknown option \"%c\"."), *opt
);
601 _cupsLangPrintf(stderr
, _("lpadmin: Unknown argument \"%s\"."), argv
[i
]);
607 * Set options as needed...
610 ppd_name
= cupsGetOption("ppd-name", num_options
, options
);
611 device_uri
= cupsGetOption("device-uri", num_options
, options
);
613 if (ppd_name
&& !strcmp(ppd_name
, "raw"))
616 _cupsLangPuts(stderr
, _("lpadmin: Raw queues are no longer supported on macOS."));
618 _cupsLangPuts(stderr
, _("lpadmin: Raw queues are deprecated and will stop working in a future version of CUPS."));
619 #endif /* __APPLE__ */
621 if (device_uri
&& (!strncmp(device_uri
, "ipp://", 6) || !strncmp(device_uri
, "ipps://", 7)) && strstr(device_uri
, "/printers/"))
622 _cupsLangPuts(stderr
, _("lpadmin: Use the 'everywhere' model for shared printers."));
626 #endif /* __APPLE__ */
628 else if (ppd_name
&& !strcmp(ppd_name
, "everywhere") && device_uri
)
630 if ((file
= get_printer_ppd(device_uri
, evefile
, sizeof(evefile
), &num_options
, &options
)) == NULL
)
633 num_options
= cupsRemoveOption("ppd-name", num_options
, &options
);
635 else if (ppd_name
|| file
)
637 _cupsLangPuts(stderr
, _("lpadmin: Printer drivers are deprecated and will stop working in a future version of CUPS."));
640 if (num_options
|| file
)
644 _cupsLangPuts(stderr
,
645 _("lpadmin: Unable to set the printer options:\n"
646 " You must specify a printer name first."));
652 http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
,
653 cupsEncryption(), 1, 30000, NULL
);
656 _cupsLangPrintf(stderr
, _("lpadmin: Unable to connect to server: %s"),
662 if (set_printer_options(http
, printer
, num_options
, options
, file
, enable
))
665 else if (enable
&& enable_printer(http
, printer
))
682 * 'add_printer_to_class()' - Add a printer to a class.
685 static int /* O - 0 on success, 1 on fail */
686 add_printer_to_class(http_t
*http
, /* I - Server connection */
687 char *printer
, /* I - Printer to add */
688 char *pclass
) /* I - Class to add to */
690 int i
; /* Looping var */
691 ipp_t
*request
, /* IPP Request */
692 *response
; /* IPP Response */
693 ipp_attribute_t
*attr
, /* Current attribute */
694 *members
; /* Members in class */
695 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
699 * Build an IPP_OP_GET_PRINTER_ATTRIBUTES request, which requires the following
703 * attributes-natural-language
705 * requesting-user-name
708 request
= ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES
);
710 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
711 "localhost", 0, "/classes/%s", pclass
);
712 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
713 "printer-uri", NULL
, uri
);
714 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
718 * Do the request and get back a response...
721 response
= cupsDoRequest(http
, request
, "/");
724 * Build a CUPS-Add-Modify-Class request, which requires the following
728 * attributes-natural-language
730 * requesting-user-name
734 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_CLASS
);
736 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
737 "printer-uri", NULL
, uri
);
738 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
742 * See if the printer is already in the class...
745 if (response
!= NULL
&&
746 (members
= ippFindAttribute(response
, "member-names",
747 IPP_TAG_NAME
)) != NULL
)
748 for (i
= 0; i
< members
->num_values
; i
++)
749 if (_cups_strcasecmp(printer
, members
->values
[i
].string
.text
) == 0)
751 _cupsLangPrintf(stderr
,
752 _("lpadmin: Printer %s is already a member of class "
753 "%s."), printer
, pclass
);
760 * OK, the printer isn't part of the class, so add it...
763 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
764 "localhost", 0, "/printers/%s", printer
);
766 if (response
!= NULL
&&
767 (members
= ippFindAttribute(response
, "member-uris",
768 IPP_TAG_URI
)) != NULL
)
771 * Add the printer to the existing list...
774 attr
= ippAddStrings(request
, IPP_TAG_PRINTER
, IPP_TAG_URI
,
775 "member-uris", members
->num_values
+ 1, NULL
, NULL
);
776 for (i
= 0; i
< members
->num_values
; i
++)
777 attr
->values
[i
].string
.text
=
778 _cupsStrAlloc(members
->values
[i
].string
.text
);
780 attr
->values
[i
].string
.text
= _cupsStrAlloc(uri
);
783 ippAddString(request
, IPP_TAG_PRINTER
, IPP_TAG_URI
, "member-uris", NULL
,
787 * Then send the request...
792 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
793 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
795 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
805 * 'default_printer()' - Set the default printing destination.
808 static int /* O - 0 on success, 1 on fail */
809 default_printer(http_t
*http
, /* I - Server connection */
810 char *printer
) /* I - Printer name */
812 ipp_t
*request
; /* IPP Request */
813 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
817 * Build a CUPS-Set-Default request, which requires the following
821 * attributes-natural-language
823 * requesting-user-name
826 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
827 "localhost", 0, "/printers/%s", printer
);
829 request
= ippNewRequest(IPP_OP_CUPS_SET_DEFAULT
);
831 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
832 "printer-uri", NULL
, uri
);
833 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
837 * Do the request and get back a response...
840 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
842 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
844 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
854 * 'delete_printer()' - Delete a printer from the system...
857 static int /* O - 0 on success, 1 on fail */
858 delete_printer(http_t
*http
, /* I - Server connection */
859 char *printer
) /* I - Printer to delete */
861 ipp_t
*request
; /* IPP Request */
862 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
866 * Build a CUPS-Delete-Printer request, which requires the following
870 * attributes-natural-language
872 * requesting-user-name
875 request
= ippNewRequest(IPP_OP_CUPS_DELETE_PRINTER
);
877 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
878 "localhost", 0, "/printers/%s", printer
);
879 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
880 "printer-uri", NULL
, uri
);
881 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
885 * Do the request and get back a response...
888 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
890 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
892 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
902 * 'delete_printer_from_class()' - Delete a printer from a class.
905 static int /* O - 0 on success, 1 on fail */
906 delete_printer_from_class(
907 http_t
*http
, /* I - Server connection */
908 char *printer
, /* I - Printer to remove */
909 char *pclass
) /* I - Class to remove from */
911 int i
, j
, k
; /* Looping vars */
912 ipp_t
*request
, /* IPP Request */
913 *response
; /* IPP Response */
914 ipp_attribute_t
*attr
, /* Current attribute */
915 *members
; /* Members in class */
916 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
920 * Build an IPP_OP_GET_PRINTER_ATTRIBUTES request, which requires the following
924 * attributes-natural-language
926 * requesting-user-name
929 request
= ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES
);
931 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
932 "localhost", 0, "/classes/%s", pclass
);
933 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
934 "printer-uri", NULL
, uri
);
935 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
939 * Do the request and get back a response...
942 if ((response
= cupsDoRequest(http
, request
, "/classes/")) == NULL
||
943 response
->request
.status
.status_code
== IPP_STATUS_ERROR_NOT_FOUND
)
945 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
953 * See if the printer is already in the class...
956 if ((members
= ippFindAttribute(response
, "member-names", IPP_TAG_NAME
)) == NULL
)
958 _cupsLangPuts(stderr
, _("lpadmin: No member names were seen."));
965 for (i
= 0; i
< members
->num_values
; i
++)
966 if (!_cups_strcasecmp(printer
, members
->values
[i
].string
.text
))
969 if (i
>= members
->num_values
)
971 _cupsLangPrintf(stderr
,
972 _("lpadmin: Printer %s is not a member of class %s."),
980 if (members
->num_values
== 1)
983 * Build a CUPS-Delete-Class request, which requires the following
987 * attributes-natural-language
989 * requesting-user-name
992 request
= ippNewRequest(IPP_OP_CUPS_DELETE_CLASS
);
994 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
995 "printer-uri", NULL
, uri
);
996 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
997 "requesting-user-name", NULL
, cupsUser());
1002 * Build a IPP_OP_CUPS_ADD_MODIFY_CLASS request, which requires the following
1005 * attributes-charset
1006 * attributes-natural-language
1008 * requesting-user-name
1012 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_CLASS
);
1014 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
1015 "printer-uri", NULL
, uri
);
1016 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
1017 "requesting-user-name", NULL
, cupsUser());
1020 * Delete the printer from the class...
1023 members
= ippFindAttribute(response
, "member-uris", IPP_TAG_URI
);
1024 attr
= ippAddStrings(request
, IPP_TAG_PRINTER
, IPP_TAG_URI
,
1025 "member-uris", members
->num_values
- 1, NULL
, NULL
);
1027 for (j
= 0, k
= 0; j
< members
->num_values
; j
++)
1029 attr
->values
[k
++].string
.text
=
1030 _cupsStrAlloc(members
->values
[j
].string
.text
);
1034 * Then send the request...
1037 ippDelete(response
);
1039 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
1041 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
1043 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
1053 * 'delete_printer_option()' - Delete a printer option.
1056 static int /* O - 0 on success, 1 on fail */
1057 delete_printer_option(http_t
*http
, /* I - Server connection */
1058 char *printer
, /* I - Printer */
1059 char *option
) /* I - Option to delete */
1061 ipp_t
*request
; /* IPP request */
1062 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
1066 * Build a IPP_OP_CUPS_ADD_MODIFY_PRINTER or IPP_OP_CUPS_ADD_MODIFY_CLASS request, which
1067 * requires the following attributes:
1069 * attributes-charset
1070 * attributes-natural-language
1072 * requesting-user-name
1073 * option with deleteAttr tag
1076 if (get_printer_type(http
, printer
, uri
, sizeof(uri
)) & CUPS_PRINTER_CLASS
)
1077 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_CLASS
);
1079 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_PRINTER
);
1081 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
1082 "printer-uri", NULL
, uri
);
1083 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
1084 "requesting-user-name", NULL
, cupsUser());
1085 ippAddInteger(request
, IPP_TAG_PRINTER
, IPP_TAG_DELETEATTR
, option
, 0);
1088 * Do the request and get back a response...
1091 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
1093 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
1095 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
1105 * 'enable_printer()' - Enable a printer...
1108 static int /* O - 0 on success, 1 on fail */
1109 enable_printer(http_t
*http
, /* I - Server connection */
1110 char *printer
) /* I - Printer to enable */
1112 ipp_t
*request
; /* IPP Request */
1113 char uri
[HTTP_MAX_URI
]; /* URI for printer/class */
1117 * Send IPP_OP_ENABLE_PRINTER and IPP_OP_RESUME_PRINTER requests, which
1118 * require the following attributes:
1120 * attributes-charset
1121 * attributes-natural-language
1123 * requesting-user-name
1126 request
= ippNewRequest(IPP_OP_ENABLE_PRINTER
);
1128 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri", NULL
, uri
);
1129 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name", NULL
, cupsUser());
1131 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
1133 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
1135 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
1140 request
= ippNewRequest(IPP_OP_RESUME_PRINTER
);
1142 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri", NULL
, uri
);
1143 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name", NULL
, cupsUser());
1145 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
1147 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
1149 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
1159 * 'get_printer_ppd()' - Get an IPP Everywhere PPD file for the given URI.
1162 static char * /* O - Filename or NULL */
1164 const char *uri
, /* I - Printer URI */
1165 char *buffer
, /* I - Filename buffer */
1166 size_t bufsize
, /* I - Size of filename buffer */
1167 int *num_options
, /* IO - Number of options */
1168 cups_option_t
**options
) /* IO - Options */
1170 http_t
*http
; /* Connection to printer */
1171 ipp_t
*request
, /* Get-Printer-Attributes request */
1172 *response
; /* Get-Printer-Attributes response */
1173 ipp_attribute_t
*attr
; /* Attribute from response */
1174 char resolved
[1024], /* Resolved URI */
1175 scheme
[32], /* URI scheme */
1176 userpass
[256], /* Username:password */
1177 host
[256], /* Hostname */
1178 resource
[256]; /* Resource path */
1179 int port
; /* Port number */
1180 static const char * const pattrs
[] = /* Attributes to use */
1183 "media-col-database"
1188 * Connect to the printer...
1191 if (strstr(uri
, "._tcp"))
1197 if (!_httpResolveURI(uri
, resolved
, sizeof(resolved
), _HTTP_RESOLVE_DEFAULT
, NULL
, NULL
))
1199 _cupsLangPrintf(stderr
, _("%s: Unable to resolve \"%s\"."), "lpadmin", uri
);
1206 if (httpSeparateURI(HTTP_URI_CODING_ALL
, uri
, scheme
, sizeof(scheme
), userpass
, sizeof(userpass
), host
, sizeof(host
), &port
, resource
, sizeof(resource
)) < HTTP_URI_STATUS_OK
)
1208 _cupsLangPrintf(stderr
, _("%s: Bad printer URI \"%s\"."), "lpadmin", uri
);
1212 http
= httpConnect2(host
, port
, NULL
, AF_UNSPEC
, !strcmp(scheme
, "ipps") ? HTTP_ENCRYPTION_ALWAYS
: HTTP_ENCRYPTION_IF_REQUESTED
, 1, 30000, NULL
);
1215 _cupsLangPrintf(stderr
, _("%s: Unable to connect to \"%s:%d\": %s"), "lpadmin", host
, port
, cupsLastErrorString());
1220 * Send a Get-Printer-Attributes request...
1223 request
= ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES
);
1224 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri", NULL
, uri
);
1225 ippAddStrings(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
, "requested-attributes", sizeof(pattrs
) / sizeof(pattrs
[0]), NULL
, pattrs
);
1226 response
= cupsDoRequest(http
, request
, resource
);
1228 if (cupsLastError() >= IPP_STATUS_REDIRECTION_OTHER_SITE
)
1230 _cupsLangPrintf(stderr
, _("%s: Unable to query printer: %s"), "lpadmin", cupsLastErrorString());
1233 else if (_ppdCreateFromIPP(buffer
, bufsize
, response
))
1235 if (!cupsGetOption("printer-geo-location", *num_options
, *options
) && (attr
= ippFindAttribute(response
, "printer-geo-location", IPP_TAG_URI
)) != NULL
)
1236 *num_options
= cupsAddOption("printer-geo-location", ippGetString(attr
, 0, NULL
), *num_options
, options
);
1238 if (!cupsGetOption("printer-info", *num_options
, *options
) && (attr
= ippFindAttribute(response
, "printer-info", IPP_TAG_TEXT
)) != NULL
)
1239 *num_options
= cupsAddOption("printer-info", ippGetString(attr
, 0, NULL
), *num_options
, options
);
1241 if (!cupsGetOption("printer-location", *num_options
, *options
) && (attr
= ippFindAttribute(response
, "printer-location", IPP_TAG_TEXT
)) != NULL
)
1242 *num_options
= cupsAddOption("printer-location", ippGetString(attr
, 0, NULL
), *num_options
, options
);
1245 _cupsLangPrintf(stderr
, _("%s: Unable to create PPD file: %s"), "lpadmin", strerror(errno
));
1247 ippDelete(response
);
1258 * 'get_printer_type()' - Determine the printer type and URI.
1261 static cups_ptype_t
/* O - printer-type value */
1262 get_printer_type(http_t
*http
, /* I - Server connection */
1263 char *printer
, /* I - Printer name */
1264 char *uri
, /* I - URI buffer */
1265 size_t urisize
) /* I - Size of URI buffer */
1267 ipp_t
*request
, /* IPP request */
1268 *response
; /* IPP response */
1269 ipp_attribute_t
*attr
; /* printer-type attribute */
1270 cups_ptype_t type
; /* printer-type value */
1274 * Build a GET_PRINTER_ATTRIBUTES request, which requires the following
1277 * attributes-charset
1278 * attributes-natural-language
1280 * requested-attributes
1281 * requesting-user-name
1284 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, (int)urisize
, "ipp", NULL
, "localhost", ippPort(), "/printers/%s", printer
);
1286 request
= ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES
);
1287 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
1288 "printer-uri", NULL
, uri
);
1289 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
1290 "requested-attributes", NULL
, "printer-type");
1291 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
1292 "requesting-user-name", NULL
, cupsUser());
1298 response
= cupsDoRequest(http
, request
, "/");
1299 if ((attr
= ippFindAttribute(response
, "printer-type",
1300 IPP_TAG_ENUM
)) != NULL
)
1302 type
= (cups_ptype_t
)attr
->values
[0].integer
;
1304 if (type
& CUPS_PRINTER_CLASS
)
1305 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, (int)urisize
, "ipp", NULL
, "localhost", ippPort(), "/classes/%s", printer
);
1308 type
= CUPS_PRINTER_LOCAL
;
1310 ippDelete(response
);
1317 * 'set_printer_options()' - Set the printer options.
1320 static int /* O - 0 on success, 1 on fail */
1321 set_printer_options(
1322 http_t
*http
, /* I - Server connection */
1323 char *printer
, /* I - Printer */
1324 int num_options
, /* I - Number of options */
1325 cups_option_t
*options
, /* I - Options */
1326 char *file
, /* I - PPD file */
1327 int enable
) /* I - Enable printer? */
1329 ipp_t
*request
; /* IPP Request */
1330 const char *ppdfile
; /* PPD filename */
1331 int ppdchanged
= 0; /* PPD changed? */
1332 ppd_file_t
*ppd
; /* PPD file */
1333 ppd_choice_t
*choice
; /* Marked choice */
1334 char uri
[HTTP_MAX_URI
], /* URI for printer/class */
1335 line
[1024], /* Line from PPD file */
1336 keyword
[1024], /* Keyword from Default line */
1337 *keyptr
, /* Pointer into keyword... */
1338 tempfile
[1024]; /* Temporary filename */
1339 cups_file_t
*in
, /* PPD file */
1340 *out
; /* Temporary file */
1341 const char *ppdname
, /* ppd-name value */
1342 *protocol
, /* Old protocol option */
1343 *customval
, /* Custom option value */
1344 *boolval
; /* Boolean value */
1345 int wrote_ipp_supplies
= 0, /* Wrote cupsIPPSupplies keyword? */
1346 wrote_snmp_supplies
= 0,/* Wrote cupsSNMPSupplies keyword? */
1347 copied_options
= 0; /* Copied options? */
1351 * Build a CUPS-Add-Modify-Printer or CUPS-Add-Modify-Class request,
1352 * which requires the following attributes:
1354 * attributes-charset
1355 * attributes-natural-language
1357 * requesting-user-name
1361 if (get_printer_type(http
, printer
, uri
, sizeof(uri
)) & CUPS_PRINTER_CLASS
)
1362 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_CLASS
);
1364 request
= ippNewRequest(IPP_OP_CUPS_ADD_MODIFY_PRINTER
);
1366 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri", NULL
, uri
);
1367 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name", NULL
, cupsUser());
1370 * Add the options...
1375 else if ((ppdname
= cupsGetOption("ppd-name", num_options
, options
)) != NULL
&& strcmp(ppdname
, "raw") && num_options
> 1)
1377 if ((ppdfile
= cupsGetServerPPD(http
, ppdname
)) != NULL
)
1380 * Copy options array and remove ppd-name from it...
1383 cups_option_t
*temp
= NULL
, *optr
;
1384 int i
, num_temp
= 0;
1385 for (i
= num_options
, optr
= options
; i
> 0; i
--, optr
++)
1386 if (strcmp(optr
->name
, "ppd-name"))
1387 num_temp
= cupsAddOption(optr
->name
, optr
->value
, num_temp
, &temp
);
1391 num_options
= num_temp
;
1395 else if (request
->request
.op
.operation_id
== IPP_OP_CUPS_ADD_MODIFY_PRINTER
)
1396 ppdfile
= cupsGetPPD(printer
);
1400 cupsEncodeOptions2(request
, num_options
, options
, IPP_TAG_OPERATION
);
1404 ippAddInteger(request
, IPP_TAG_PRINTER
, IPP_TAG_ENUM
, "printer-state", IPP_PSTATE_IDLE
);
1405 ippAddBoolean(request
, IPP_TAG_PRINTER
, "printer-is-accepting-jobs", 1);
1408 cupsEncodeOptions2(request
, num_options
, options
, IPP_TAG_PRINTER
);
1410 if ((protocol
= cupsGetOption("protocol", num_options
, options
)) != NULL
)
1412 if (!_cups_strcasecmp(protocol
, "bcp"))
1413 ippAddString(request
, IPP_TAG_PRINTER
, IPP_TAG_NAME
, "port-monitor",
1415 else if (!_cups_strcasecmp(protocol
, "tbcp"))
1416 ippAddString(request
, IPP_TAG_PRINTER
, IPP_TAG_NAME
, "port-monitor",
1423 * Set default options in the PPD file...
1426 if ((ppd
= ppdOpenFile(ppdfile
)) == NULL
)
1428 int linenum
; /* Line number of error */
1429 ppd_status_t status
= ppdLastError(&linenum
);
1432 _cupsLangPrintf(stderr
, _("lpadmin: Unable to open PPD \"%s\": %s on line %d."), ppdfile
, ppdErrorString(status
), linenum
);
1435 ppdMarkDefaults(ppd
);
1436 cupsMarkOptions(ppd
, num_options
, options
);
1438 if ((out
= cupsTempFile2(tempfile
, sizeof(tempfile
))) == NULL
)
1440 _cupsLangPrintError(NULL
, _("lpadmin: Unable to create temporary file"));
1442 if (ppdfile
!= file
)
1445 cupsFreeOptions(num_options
, options
);
1449 if ((in
= cupsFileOpen(ppdfile
, "r")) == NULL
)
1451 _cupsLangPrintf(stderr
,
1452 _("lpadmin: Unable to open PPD file \"%s\" - %s"),
1453 ppdfile
, strerror(errno
));
1455 if (ppdfile
!= file
)
1458 cupsFreeOptions(num_options
, options
);
1464 while (cupsFileGets(in
, line
, sizeof(line
)))
1466 if (!strncmp(line
, "*cupsIPPSupplies:", 17) &&
1467 (boolval
= cupsGetOption("cupsIPPSupplies", num_options
,
1470 wrote_ipp_supplies
= 1;
1471 cupsFilePrintf(out
, "*cupsIPPSupplies: %s\n",
1472 (!_cups_strcasecmp(boolval
, "true") ||
1473 !_cups_strcasecmp(boolval
, "yes") ||
1474 !_cups_strcasecmp(boolval
, "on")) ? "True" : "False");
1476 else if (!strncmp(line
, "*cupsSNMPSupplies:", 18) &&
1477 (boolval
= cupsGetOption("cupsSNMPSupplies", num_options
,
1480 wrote_snmp_supplies
= 1;
1481 cupsFilePrintf(out
, "*cupsSNMPSupplies: %s\n",
1482 (!_cups_strcasecmp(boolval
, "true") ||
1483 !_cups_strcasecmp(boolval
, "yes") ||
1484 !_cups_strcasecmp(boolval
, "on")) ? "True" : "False");
1486 else if (strncmp(line
, "*Default", 8))
1487 cupsFilePrintf(out
, "%s\n", line
);
1491 * Get default option name...
1494 strlcpy(keyword
, line
+ 8, sizeof(keyword
));
1496 for (keyptr
= keyword
; *keyptr
; keyptr
++)
1497 if (*keyptr
== ':' || isspace(*keyptr
& 255))
1501 while (isspace(*keyptr
& 255))
1504 if (!strcmp(keyword
, "PageRegion") ||
1505 !strcmp(keyword
, "PageSize") ||
1506 !strcmp(keyword
, "PaperDimension") ||
1507 !strcmp(keyword
, "ImageableArea"))
1509 if ((choice
= ppdFindMarkedChoice(ppd
, "PageSize")) == NULL
)
1510 choice
= ppdFindMarkedChoice(ppd
, "PageRegion");
1513 choice
= ppdFindMarkedChoice(ppd
, keyword
);
1515 if (choice
&& strcmp(choice
->choice
, keyptr
))
1517 if (strcmp(choice
->choice
, "Custom"))
1519 cupsFilePrintf(out
, "*Default%s: %s\n", keyword
, choice
->choice
);
1522 else if ((customval
= cupsGetOption(keyword
, num_options
,
1525 cupsFilePrintf(out
, "*Default%s: %s\n", keyword
, customval
);
1529 cupsFilePrintf(out
, "%s\n", line
);
1532 cupsFilePrintf(out
, "%s\n", line
);
1536 if (!wrote_ipp_supplies
&&
1537 (boolval
= cupsGetOption("cupsIPPSupplies", num_options
,
1540 cupsFilePrintf(out
, "*cupsIPPSupplies: %s\n",
1541 (!_cups_strcasecmp(boolval
, "true") ||
1542 !_cups_strcasecmp(boolval
, "yes") ||
1543 !_cups_strcasecmp(boolval
, "on")) ? "True" : "False");
1546 if (!wrote_snmp_supplies
&&
1547 (boolval
= cupsGetOption("cupsSNMPSupplies", num_options
,
1550 cupsFilePrintf(out
, "*cupsSNMPSupplies: %s\n",
1551 (!_cups_strcasecmp(boolval
, "true") ||
1552 !_cups_strcasecmp(boolval
, "yes") ||
1553 !_cups_strcasecmp(boolval
, "on")) ? "True" : "False");
1564 ippDelete(cupsDoFileRequest(http
, request
, "/admin/",
1565 ppdchanged
? tempfile
: file
));
1568 * Clean up temp files... (TODO: catch signals in case we CTRL-C during
1572 if (ppdfile
!= file
)
1579 * No PPD file - just set the options...
1582 ippDelete(cupsDoRequest(http
, request
, "/admin/"));
1586 cupsFreeOptions(num_options
, options
);
1589 * Check the response...
1592 if (cupsLastError() > IPP_STATUS_OK_CONFLICTING
)
1594 _cupsLangPrintf(stderr
, _("%s: %s"), "lpadmin", cupsLastErrorString());
1604 * 'usage()' - Show program usage and exit.
1610 _cupsLangPuts(stdout
, _("Usage: lpadmin [options] -d destination\n"
1611 " lpadmin [options] -p destination\n"
1612 " lpadmin [options] -p destination -c class\n"
1613 " lpadmin [options] -p destination -r class\n"
1614 " lpadmin [options] -x destination"));
1615 _cupsLangPuts(stdout
, _("Options:"));
1616 _cupsLangPuts(stdout
, _("-c class Add the named destination to a class"));
1617 _cupsLangPuts(stdout
, _("-d destination Set the named destination as the server default"));
1618 _cupsLangPuts(stdout
, _("-D description Specify the textual description of the printer"));
1619 _cupsLangPuts(stdout
, _("-E Encrypt the connection to the server"));
1620 _cupsLangPuts(stdout
, _("-E Enable and accept jobs on the printer (after -p)"));
1621 _cupsLangPuts(stdout
, _("-h server[:port] Connect to the named server and port"));
1622 _cupsLangPuts(stdout
, _("-i ppd-file Specify a PPD file for the printer"));
1623 _cupsLangPuts(stdout
, _("-L location Specify the textual location of the printer"));
1624 _cupsLangPuts(stdout
, _("-m model Specify a standard model/PPD file for the printer"));
1625 _cupsLangPuts(stdout
, _("-m everywhere Specify the printer is compatible with IPP Everywhere"));
1626 _cupsLangPuts(stdout
, _("-o name-default=value Specify the default value for the named option"));
1627 _cupsLangPuts(stdout
, _("-o Name=Value Specify the default value for the named PPD option "));
1628 _cupsLangPuts(stdout
, _("-o cupsIPPSupplies=false\n"
1629 " Disable supply level reporting via IPP"));
1630 _cupsLangPuts(stdout
, _("-o cupsSNMPSupplies=false\n"
1631 " Disable supply level reporting via SNMP"));
1632 _cupsLangPuts(stdout
, _("-o job-k-limit=N Specify the kilobyte limit for per-user quotas"));
1633 _cupsLangPuts(stdout
, _("-o job-page-limit=N Specify the page limit for per-user quotas"));
1634 _cupsLangPuts(stdout
, _("-o job-quota-period=N Specify the per-user quota period in seconds"));
1635 _cupsLangPuts(stdout
, _("-o printer-error-policy=name\n"
1636 " Specify the printer error policy"));
1637 _cupsLangPuts(stdout
, _("-o printer-is-shared=true\n"
1638 " Share the printer"));
1639 _cupsLangPuts(stdout
, _("-o printer-op-policy=name\n"
1640 " Specify the printer operation policy"));
1641 _cupsLangPuts(stdout
, _("-p destination Specify/add the named destination"));
1642 _cupsLangPuts(stdout
, _("-r class Remove the named destination from a class"));
1643 _cupsLangPuts(stdout
, _("-R name-default Remove the default value for the named option"));
1644 _cupsLangPuts(stdout
, _("-u allow:all Allow all users to print"));
1645 _cupsLangPuts(stdout
, _("-u allow:list Allow the list of users or groups (@name) to print"));
1646 _cupsLangPuts(stdout
, _("-u deny:list Prevent the list of users or groups (@name) to print"));
1647 _cupsLangPuts(stdout
, _("-U username Specify the username to use for authentication"));
1648 _cupsLangPuts(stdout
, _("-v device-uri Specify the device URI for the printer"));
1649 _cupsLangPuts(stdout
, _("-x destination Remove the named destination"));
1656 * 'validate_name()' - Make sure the printer name only contains valid chars.
1659 static int /* O - 0 if name is no good, 1 if name is good */
1660 validate_name(const char *name
) /* I - Name to check */
1662 const char *ptr
; /* Pointer into name */
1666 * Scan the whole name...
1669 for (ptr
= name
; *ptr
; ptr
++)
1672 else if ((*ptr
>= 0 && *ptr
<= ' ') || *ptr
== 127 || *ptr
== '/' || *ptr
== '\\' || *ptr
== '?' || *ptr
== '\'' || *ptr
== '\"' || *ptr
== '#')
1676 * All the characters are good; validate the length, too...
1679 return ((ptr
- name
) < 128);