4 * Printing utilities for CUPS.
6 * Copyright 2007-2013 by Apple Inc.
7 * Copyright 1997-2006 by Easy Software Products.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
19 * cupsCancelJob() - Cancel a print job on the default server.
20 * cupsCancelJob2() - Cancel or purge a print job.
21 * cupsCreateJob() - Create an empty job for streaming.
22 * cupsFinishDocument() - Finish sending a document.
23 * cupsFreeJobs() - Free memory used by job data.
24 * cupsGetClasses() - Get a list of printer classes from the default
26 * cupsGetDefault() - Get the default printer or class for the default
28 * cupsGetDefault2() - Get the default printer or class for the specified
30 * cupsGetJobs() - Get the jobs from the default server.
31 * cupsGetJobs2() - Get the jobs from the specified server.
32 * cupsGetPPD() - Get the PPD file for a printer on the default
34 * cupsGetPPD2() - Get the PPD file for a printer from the specified
36 * cupsGetPPD3() - Get the PPD file for a printer on the specified
37 * server if it has changed.
38 * cupsGetPrinters() - Get a list of printers from the default server.
39 * cupsGetServerPPD() - Get an available PPD file from the server.
40 * cupsPrintFile() - Print a file to a printer or class on the default
42 * cupsPrintFile2() - Print a file to a printer or class on the
44 * cupsPrintFiles() - Print one or more files to a printer or class on
46 * cupsPrintFiles2() - Print one or more files to a printer or class on
47 * the specified server.
48 * cupsStartDocument() - Add a document to a job created with
50 * cups_get_printer_uri() - Get the printer-uri-supported attribute for the
51 * first printer in a class.
55 * Include necessary headers...
58 #include "cups-private.h"
61 #if defined(WIN32) || defined(__EMX__)
65 #endif /* WIN32 || __EMX__ */
72 static int cups_get_printer_uri(http_t
*http
, const char *name
,
73 char *host
, int hostsize
, int *port
,
74 char *resource
, int resourcesize
,
79 * 'cupsCancelJob()' - Cancel a print job on the default server.
81 * Pass @code CUPS_JOBID_ALL@ to cancel all jobs or @code CUPS_JOBID_CURRENT@
82 * to cancel the current job on the named destination.
84 * Use the @link cupsLastError@ and @link cupsLastErrorString@ functions to get
85 * the cause of any failure.
88 int /* O - 1 on success, 0 on failure */
89 cupsCancelJob(const char *name
, /* I - Name of printer or class */
90 int job_id
) /* I - Job ID, @code CUPS_JOBID_CURRENT@ for the current job, or @code CUPS_JOBID_ALL@ for all jobs */
92 return (cupsCancelJob2(CUPS_HTTP_DEFAULT
, name
, job_id
, 0)
93 < IPP_STATUS_REDIRECTION_OTHER_SITE
);
98 * 'cupsCancelJob2()' - Cancel or purge a print job.
100 * Canceled jobs remain in the job history while purged jobs are removed
101 * from the job history.
103 * Pass @code CUPS_JOBID_ALL@ to cancel all jobs or @code CUPS_JOBID_CURRENT@
104 * to cancel the current job on the named destination.
106 * Use the @link cupsLastError@ and @link cupsLastErrorString@ functions to get
107 * the cause of any failure.
109 * @since CUPS 1.4/OS X 10.6@
112 ipp_status_t
/* O - IPP status */
113 cupsCancelJob2(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
114 const char *name
, /* I - Name of printer or class */
115 int job_id
, /* I - Job ID, @code CUPS_JOBID_CURRENT@ for the current job, or @code CUPS_JOBID_ALL@ for all jobs */
116 int purge
) /* I - 1 to purge, 0 to cancel */
118 char uri
[HTTP_MAX_URI
]; /* Job/printer URI */
119 ipp_t
*request
; /* IPP request */
123 * Range check input...
126 if (job_id
< -1 || (!name
&& job_id
== 0))
128 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
133 * Connect to the default server as needed...
137 if ((http
= _cupsConnect()) == NULL
)
138 return (IPP_STATUS_ERROR_SERVICE_UNAVAILABLE
);
141 * Build an IPP_CANCEL_JOB or IPP_PURGE_JOBS request, which requires the following
145 * attributes-natural-language
146 * job-uri or printer-uri + job-id
147 * requesting-user-name
148 * [purge-job] or [purge-jobs]
151 request
= ippNewRequest(job_id
< 0 ? IPP_OP_PURGE_JOBS
: IPP_OP_CANCEL_JOB
);
155 httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
156 "localhost", ippPort(), "/printers/%s", name
);
158 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri", NULL
,
160 ippAddInteger(request
, IPP_TAG_OPERATION
, IPP_TAG_INTEGER
, "job-id",
165 snprintf(uri
, sizeof(uri
), "ipp://localhost/jobs/%d", job_id
);
167 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "job-uri", NULL
, uri
);
170 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
173 if (purge
&& job_id
>= 0)
174 ippAddBoolean(request
, IPP_TAG_OPERATION
, "purge-job", 1);
175 else if (!purge
&& job_id
< 0)
176 ippAddBoolean(request
, IPP_TAG_OPERATION
, "purge-jobs", 0);
182 ippDelete(cupsDoRequest(http
, request
, "/jobs/"));
184 return (cupsLastError());
189 * 'cupsCreateJob()' - Create an empty job for streaming.
191 * Use this function when you want to stream print data using the
192 * @link cupsStartDocument@, @link cupsWriteRequestData@, and
193 * @link cupsFinishDocument@ functions. If you have one or more files to
194 * print, use the @link cupsPrintFile2@ or @link cupsPrintFiles2@ function
197 * @since CUPS 1.4/OS X 10.6@
200 int /* O - Job ID or 0 on error */
202 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
203 const char *name
, /* I - Destination name */
204 const char *title
, /* I - Title of job */
205 int num_options
, /* I - Number of options */
206 cups_option_t
*options
) /* I - Options */
208 char printer_uri
[1024], /* Printer URI */
209 resource
[1024]; /* Printer resource */
210 ipp_t
*request
, /* Create-Job request */
211 *response
; /* Create-Job response */
212 ipp_attribute_t
*attr
; /* job-id attribute */
213 int job_id
= 0; /* job-id value */
216 DEBUG_printf(("cupsCreateJob(http=%p, name=\"%s\", title=\"%s\", "
217 "num_options=%d, options=%p)",
218 http
, name
, title
, num_options
, options
));
221 * Range check input...
226 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
231 * Build a Create-Job request...
234 if ((request
= ippNewRequest(IPP_OP_CREATE_JOB
)) == NULL
)
236 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(ENOMEM
), 0);
240 httpAssembleURIf(HTTP_URI_CODING_ALL
, printer_uri
, sizeof(printer_uri
), "ipp",
241 NULL
, "localhost", ippPort(), "/printers/%s", name
);
242 snprintf(resource
, sizeof(resource
), "/printers/%s", name
);
244 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri",
246 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
249 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "job-name", NULL
,
251 cupsEncodeOptions2(request
, num_options
, options
, IPP_TAG_OPERATION
);
252 cupsEncodeOptions2(request
, num_options
, options
, IPP_TAG_JOB
);
253 cupsEncodeOptions2(request
, num_options
, options
, IPP_TAG_SUBSCRIPTION
);
256 * Send the request and get the job-id...
259 response
= cupsDoRequest(http
, request
, resource
);
261 if ((attr
= ippFindAttribute(response
, "job-id", IPP_TAG_INTEGER
)) != NULL
)
262 job_id
= attr
->values
[0].integer
;
275 * 'cupsFinishDocument()' - Finish sending a document.
277 * The document must have been started using @link cupsStartDocument@.
279 * @since CUPS 1.4/OS X 10.6@
282 ipp_status_t
/* O - Status of document submission */
283 cupsFinishDocument(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
284 const char *name
) /* I - Destination name */
286 char resource
[1024]; /* Printer resource */
289 snprintf(resource
, sizeof(resource
), "/printers/%s", name
);
291 ippDelete(cupsGetResponse(http
, resource
));
293 return (cupsLastError());
298 * 'cupsFreeJobs()' - Free memory used by job data.
302 cupsFreeJobs(int num_jobs
, /* I - Number of jobs */
303 cups_job_t
*jobs
) /* I - Jobs */
305 int i
; /* Looping var */
306 cups_job_t
*job
; /* Current job */
309 if (num_jobs
<= 0 || !jobs
)
312 for (i
= num_jobs
, job
= jobs
; i
> 0; i
--, job
++)
314 _cupsStrFree(job
->dest
);
315 _cupsStrFree(job
->user
);
316 _cupsStrFree(job
->format
);
317 _cupsStrFree(job
->title
);
325 * 'cupsGetClasses()' - Get a list of printer classes from the default server.
327 * This function is deprecated - use @link cupsGetDests@ instead.
332 int /* O - Number of classes */
333 cupsGetClasses(char ***classes
) /* O - Classes */
335 int n
; /* Number of classes */
336 ipp_t
*request
, /* IPP Request */
337 *response
; /* IPP Response */
338 ipp_attribute_t
*attr
; /* Current attribute */
339 char **temp
; /* Temporary pointer */
340 http_t
*http
; /* Connection to server */
345 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
352 if ((http
= _cupsConnect()) == NULL
)
356 * Build a CUPS_GET_CLASSES request, which requires the following
360 * attributes-natural-language
361 * requested-attributes
364 request
= ippNewRequest(IPP_OP_CUPS_GET_CLASSES
);
366 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
367 "requested-attributes", NULL
, "printer-name");
370 * Do the request and get back a response...
375 if ((response
= cupsDoRequest(http
, request
, "/")) != NULL
)
377 for (attr
= response
->attrs
; attr
!= NULL
; attr
= attr
->next
)
378 if (attr
->name
!= NULL
&&
379 _cups_strcasecmp(attr
->name
, "printer-name") == 0 &&
380 attr
->value_tag
== IPP_TAG_NAME
)
383 temp
= malloc(sizeof(char *));
385 temp
= realloc(*classes
, sizeof(char *) * (n
+ 1));
405 temp
[n
] = strdup(attr
->values
[0].string
.text
);
417 * 'cupsGetDefault()' - Get the default printer or class for the default server.
419 * This function returns the default printer or class as defined by
420 * the LPDEST or PRINTER environment variables. If these environment
421 * variables are not set, the server default destination is returned.
422 * Applications should use the @link cupsGetDests@ and @link cupsGetDest@
423 * functions to get the user-defined default printer, as this function does
424 * not support the lpoptions-defined default printer.
427 const char * /* O - Default printer or @code NULL@ */
431 * Return the default printer...
434 return (cupsGetDefault2(CUPS_HTTP_DEFAULT
));
439 * 'cupsGetDefault2()' - Get the default printer or class for the specified server.
441 * This function returns the default printer or class as defined by
442 * the LPDEST or PRINTER environment variables. If these environment
443 * variables are not set, the server default destination is returned.
444 * Applications should use the @link cupsGetDests@ and @link cupsGetDest@
445 * functions to get the user-defined default printer, as this function does
446 * not support the lpoptions-defined default printer.
448 * @since CUPS 1.1.21/OS X 10.4@
451 const char * /* O - Default printer or @code NULL@ */
452 cupsGetDefault2(http_t
*http
) /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
454 ipp_t
*request
, /* IPP Request */
455 *response
; /* IPP Response */
456 ipp_attribute_t
*attr
; /* Current attribute */
457 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
461 * See if we have a user default printer set...
464 if (_cupsUserDefault(cg
->def_printer
, sizeof(cg
->def_printer
)))
465 return (cg
->def_printer
);
468 * Connect to the server as needed...
472 if ((http
= _cupsConnect()) == NULL
)
476 * Build a CUPS_GET_DEFAULT request, which requires the following
480 * attributes-natural-language
483 request
= ippNewRequest(IPP_OP_CUPS_GET_DEFAULT
);
486 * Do the request and get back a response...
489 if ((response
= cupsDoRequest(http
, request
, "/")) != NULL
)
491 if ((attr
= ippFindAttribute(response
, "printer-name",
492 IPP_TAG_NAME
)) != NULL
)
494 strlcpy(cg
->def_printer
, attr
->values
[0].string
.text
,
495 sizeof(cg
->def_printer
));
497 return (cg
->def_printer
);
508 * 'cupsGetJobs()' - Get the jobs from the default server.
510 * A "whichjobs" value of @code CUPS_WHICHJOBS_ALL@ returns all jobs regardless
511 * of state, while @code CUPS_WHICHJOBS_ACTIVE@ returns jobs that are
512 * pending, processing, or held and @code CUPS_WHICHJOBS_COMPLETED@ returns
513 * jobs that are stopped, canceled, aborted, or completed.
516 int /* O - Number of jobs */
517 cupsGetJobs(cups_job_t
**jobs
, /* O - Job data */
518 const char *name
, /* I - @code NULL@ = all destinations, otherwise show jobs for named destination */
519 int myjobs
, /* I - 0 = all users, 1 = mine */
520 int whichjobs
) /* I - @code CUPS_WHICHJOBS_ALL@, @code CUPS_WHICHJOBS_ACTIVE@, or @code CUPS_WHICHJOBS_COMPLETED@ */
526 return (cupsGetJobs2(CUPS_HTTP_DEFAULT
, jobs
, name
, myjobs
, whichjobs
));
532 * 'cupsGetJobs2()' - Get the jobs from the specified server.
534 * A "whichjobs" value of @code CUPS_WHICHJOBS_ALL@ returns all jobs regardless
535 * of state, while @code CUPS_WHICHJOBS_ACTIVE@ returns jobs that are
536 * pending, processing, or held and @code CUPS_WHICHJOBS_COMPLETED@ returns
537 * jobs that are stopped, canceled, aborted, or completed.
539 * @since CUPS 1.1.21/OS X 10.4@
542 int /* O - Number of jobs */
543 cupsGetJobs2(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
544 cups_job_t
**jobs
, /* O - Job data */
545 const char *name
, /* I - @code NULL@ = all destinations, otherwise show jobs for named destination */
546 int myjobs
, /* I - 0 = all users, 1 = mine */
547 int whichjobs
) /* I - @code CUPS_WHICHJOBS_ALL@, @code CUPS_WHICHJOBS_ACTIVE@, or @code CUPS_WHICHJOBS_COMPLETED@ */
549 int n
; /* Number of jobs */
550 ipp_t
*request
, /* IPP Request */
551 *response
; /* IPP Response */
552 ipp_attribute_t
*attr
; /* Current attribute */
553 cups_job_t
*temp
; /* Temporary pointer */
555 priority
, /* job-priority */
556 size
; /* job-k-octets */
557 ipp_jstate_t state
; /* job-state */
558 time_t completed_time
, /* time-at-completed */
559 creation_time
, /* time-at-creation */
560 processing_time
; /* time-at-processing */
561 const char *dest
, /* job-printer-uri */
562 *format
, /* document-format */
563 *title
, /* job-name */
564 *user
; /* job-originating-user-name */
565 char uri
[HTTP_MAX_URI
]; /* URI for jobs */
566 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
567 static const char * const attrs
[] = /* Requested attributes */
573 "job-originating-user-name",
584 * Range check input...
589 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
595 * Get the right URI...
600 if (httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
601 "localhost", 0, "/printers/%s",
602 name
) < HTTP_URI_STATUS_OK
)
604 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
,
605 _("Unable to create printer-uri"), 1);
611 strlcpy(uri
, "ipp://localhost/", sizeof(uri
));
614 if ((http
= _cupsConnect()) == NULL
)
618 * Build an IPP_GET_JOBS request, which requires the following
622 * attributes-natural-language
624 * requesting-user-name
627 * requested-attributes
630 request
= ippNewRequest(IPP_OP_GET_JOBS
);
632 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
,
633 "printer-uri", NULL
, uri
);
635 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
636 "requesting-user-name", NULL
, cupsUser());
639 ippAddBoolean(request
, IPP_TAG_OPERATION
, "my-jobs", 1);
641 if (whichjobs
== CUPS_WHICHJOBS_COMPLETED
)
642 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
643 "which-jobs", NULL
, "completed");
644 else if (whichjobs
== CUPS_WHICHJOBS_ALL
)
645 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
646 "which-jobs", NULL
, "all");
648 ippAddStrings(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
649 "requested-attributes", sizeof(attrs
) / sizeof(attrs
[0]),
653 * Do the request and get back a response...
659 if ((response
= cupsDoRequest(http
, request
, "/")) != NULL
)
661 for (attr
= response
->attrs
; attr
; attr
= attr
->next
)
664 * Skip leading attributes until we hit a job...
667 while (attr
&& attr
->group_tag
!= IPP_TAG_JOB
)
674 * Pull the needed attributes from this job...
680 state
= IPP_JSTATE_PENDING
;
683 format
= "application/octet-stream";
689 while (attr
&& attr
->group_tag
== IPP_TAG_JOB
)
691 if (!strcmp(attr
->name
, "job-id") &&
692 attr
->value_tag
== IPP_TAG_INTEGER
)
693 id
= attr
->values
[0].integer
;
694 else if (!strcmp(attr
->name
, "job-state") &&
695 attr
->value_tag
== IPP_TAG_ENUM
)
696 state
= (ipp_jstate_t
)attr
->values
[0].integer
;
697 else if (!strcmp(attr
->name
, "job-priority") &&
698 attr
->value_tag
== IPP_TAG_INTEGER
)
699 priority
= attr
->values
[0].integer
;
700 else if (!strcmp(attr
->name
, "job-k-octets") &&
701 attr
->value_tag
== IPP_TAG_INTEGER
)
702 size
= attr
->values
[0].integer
;
703 else if (!strcmp(attr
->name
, "time-at-completed") &&
704 attr
->value_tag
== IPP_TAG_INTEGER
)
705 completed_time
= attr
->values
[0].integer
;
706 else if (!strcmp(attr
->name
, "time-at-creation") &&
707 attr
->value_tag
== IPP_TAG_INTEGER
)
708 creation_time
= attr
->values
[0].integer
;
709 else if (!strcmp(attr
->name
, "time-at-processing") &&
710 attr
->value_tag
== IPP_TAG_INTEGER
)
711 processing_time
= attr
->values
[0].integer
;
712 else if (!strcmp(attr
->name
, "job-printer-uri") &&
713 attr
->value_tag
== IPP_TAG_URI
)
715 if ((dest
= strrchr(attr
->values
[0].string
.text
, '/')) != NULL
)
718 else if (!strcmp(attr
->name
, "job-originating-user-name") &&
719 attr
->value_tag
== IPP_TAG_NAME
)
720 user
= attr
->values
[0].string
.text
;
721 else if (!strcmp(attr
->name
, "document-format") &&
722 attr
->value_tag
== IPP_TAG_MIMETYPE
)
723 format
= attr
->values
[0].string
.text
;
724 else if (!strcmp(attr
->name
, "job-name") &&
725 (attr
->value_tag
== IPP_TAG_TEXT
||
726 attr
->value_tag
== IPP_TAG_NAME
))
727 title
= attr
->values
[0].string
.text
;
733 * See if we have everything needed...
745 * Allocate memory for the job...
749 temp
= malloc(sizeof(cups_job_t
));
751 temp
= realloc(*jobs
, sizeof(cups_job_t
) * (n
+ 1));
759 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, NULL
, 0);
761 cupsFreeJobs(n
, *jobs
);
774 * Copy the data over...
777 temp
->dest
= _cupsStrAlloc(dest
);
778 temp
->user
= _cupsStrAlloc(user
);
779 temp
->format
= _cupsStrAlloc(format
);
780 temp
->title
= _cupsStrAlloc(title
);
782 temp
->priority
= priority
;
785 temp
->completed_time
= completed_time
;
786 temp
->creation_time
= creation_time
;
787 temp
->processing_time
= processing_time
;
796 if (n
== 0 && cg
->last_error
>= IPP_STATUS_ERROR_BAD_REQUEST
)
804 * 'cupsGetPPD()' - Get the PPD file for a printer on the default server.
806 * For classes, @code cupsGetPPD@ returns the PPD file for the first printer
809 * The returned filename is stored in a static buffer and is overwritten with
810 * each call to @code cupsGetPPD@ or @link cupsGetPPD2@. The caller "owns" the
811 * file that is created and must @code unlink@ the returned filename.
814 const char * /* O - Filename for PPD file */
815 cupsGetPPD(const char *name
) /* I - Destination name */
817 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
818 time_t modtime
= 0; /* Modification time */
822 * Return the PPD file...
825 cg
->ppd_filename
[0] = '\0';
827 if (cupsGetPPD3(CUPS_HTTP_DEFAULT
, name
, &modtime
, cg
->ppd_filename
,
828 sizeof(cg
->ppd_filename
)) == HTTP_STATUS_OK
)
829 return (cg
->ppd_filename
);
836 * 'cupsGetPPD2()' - Get the PPD file for a printer from the specified server.
838 * For classes, @code cupsGetPPD2@ returns the PPD file for the first printer
841 * The returned filename is stored in a static buffer and is overwritten with
842 * each call to @link cupsGetPPD@ or @code cupsGetPPD2@. The caller "owns" the
843 * file that is created and must @code unlink@ the returned filename.
845 * @since CUPS 1.1.21/OS X 10.4@
848 const char * /* O - Filename for PPD file */
849 cupsGetPPD2(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
850 const char *name
) /* I - Destination name */
852 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
853 time_t modtime
= 0; /* Modification time */
856 cg
->ppd_filename
[0] = '\0';
858 if (cupsGetPPD3(http
, name
, &modtime
, cg
->ppd_filename
,
859 sizeof(cg
->ppd_filename
)) == HTTP_STATUS_OK
)
860 return (cg
->ppd_filename
);
867 * 'cupsGetPPD3()' - Get the PPD file for a printer on the specified
868 * server if it has changed.
870 * The "modtime" parameter contains the modification time of any
871 * locally-cached content and is updated with the time from the PPD file on
874 * The "buffer" parameter contains the local PPD filename. If it contains
875 * the empty string, a new temporary file is created, otherwise the existing
876 * file will be overwritten as needed. The caller "owns" the file that is
877 * created and must @code unlink@ the returned filename.
879 * On success, @code HTTP_STATUS_OK@ is returned for a new PPD file and
880 * @code HTTP_STATUS_NOT_MODIFIED@ if the existing PPD file is up-to-date. Any other
881 * status is an error.
883 * For classes, @code cupsGetPPD3@ returns the PPD file for the first printer
886 * @since CUPS 1.4/OS X 10.6@
889 http_status_t
/* O - HTTP status */
890 cupsGetPPD3(http_t
*http
, /* I - HTTP connection or @code CUPS_HTTP_DEFAULT@ */
891 const char *name
, /* I - Destination name */
892 time_t *modtime
, /* IO - Modification time */
893 char *buffer
, /* I - Filename buffer */
894 size_t bufsize
) /* I - Size of filename buffer */
896 int http_port
; /* Port number */
897 char http_hostname
[HTTP_MAX_HOST
];
898 /* Hostname associated with connection */
899 http_t
*http2
; /* Alternate HTTP connection */
900 int fd
; /* PPD file */
901 char localhost
[HTTP_MAX_URI
],/* Local hostname */
902 hostname
[HTTP_MAX_URI
], /* Hostname */
903 resource
[HTTP_MAX_URI
]; /* Resource name */
904 int port
; /* Port number */
905 http_status_t status
; /* HTTP status from server */
906 char tempfile
[1024] = ""; /* Temporary filename */
907 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
911 * Range check input...
914 DEBUG_printf(("cupsGetPPD3(http=%p, name=\"%s\", modtime=%p(%d), buffer=%p, "
915 "bufsize=%d)", http
, name
, modtime
,
916 modtime
? (int)*modtime
: 0, buffer
, (int)bufsize
));
920 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No printer name"), 1);
921 return (HTTP_STATUS_NOT_ACCEPTABLE
);
926 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No modification time"), 1);
927 return (HTTP_STATUS_NOT_ACCEPTABLE
);
930 if (!buffer
|| bufsize
<= 1)
932 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Bad filename buffer"), 1);
933 return (HTTP_STATUS_NOT_ACCEPTABLE
);
938 * See if the PPD file is available locally...
942 httpGetHostname(http
, hostname
, sizeof(hostname
));
945 strlcpy(hostname
, cupsServer(), sizeof(hostname
));
946 if (hostname
[0] == '/')
947 strlcpy(hostname
, "localhost", sizeof(hostname
));
950 if (!_cups_strcasecmp(hostname
, "localhost"))
952 char ppdname
[1024]; /* PPD filename */
953 struct stat ppdinfo
; /* PPD file information */
956 snprintf(ppdname
, sizeof(ppdname
), "%s/ppd/%s.ppd", cg
->cups_serverroot
,
958 if (!stat(ppdname
, &ppdinfo
))
961 * OK, the file exists, use it!
968 if (symlink(ppdname
, buffer
) && errno
!= EEXIST
)
970 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, NULL
, 0);
972 return (HTTP_STATUS_SERVER_ERROR
);
977 int tries
; /* Number of tries */
978 const char *tmpdir
; /* TMPDIR environment variable */
979 struct timeval curtime
; /* Current time */
982 * Previously we put root temporary files in the default CUPS temporary
983 * directory under /var/spool/cups. However, since the scheduler cleans
984 * out temporary files there and runs independently of the user apps, we
985 * don't want to use it unless specifically told to by cupsd.
988 if ((tmpdir
= getenv("TMPDIR")) == NULL
)
990 tmpdir
= "/private/tmp"; /* /tmp is a symlink to /private/tmp */
993 # endif /* __APPLE__ */
996 * Make the temporary name using the specified directory...
1004 * Get the current time of day...
1007 gettimeofday(&curtime
, NULL
);
1010 * Format a string using the hex time values...
1013 snprintf(buffer
, bufsize
, "%s/%08lx%05lx", tmpdir
,
1014 (unsigned long)curtime
.tv_sec
,
1015 (unsigned long)curtime
.tv_usec
);
1018 * Try to make a symlink...
1021 if (!symlink(ppdname
, buffer
))
1026 while (tries
< 1000);
1030 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, NULL
, 0);
1032 return (HTTP_STATUS_SERVER_ERROR
);
1036 if (*modtime
>= ppdinfo
.st_mtime
)
1037 return (HTTP_STATUS_NOT_MODIFIED
);
1040 *modtime
= ppdinfo
.st_mtime
;
1041 return (HTTP_STATUS_OK
);
1048 * Try finding a printer URI for this printer...
1052 if ((http
= _cupsConnect()) == NULL
)
1053 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
1055 if (!cups_get_printer_uri(http
, name
, hostname
, sizeof(hostname
), &port
,
1056 resource
, sizeof(resource
), 0))
1057 return (HTTP_STATUS_NOT_FOUND
);
1059 DEBUG_printf(("2cupsGetPPD3: Printer hostname=\"%s\", port=%d", hostname
,
1063 * Remap local hostname to localhost...
1066 httpGetHostname(NULL
, localhost
, sizeof(localhost
));
1068 DEBUG_printf(("2cupsGetPPD3: Local hostname=\"%s\"", localhost
));
1070 if (!_cups_strcasecmp(localhost
, hostname
))
1071 strlcpy(hostname
, "localhost", sizeof(hostname
));
1074 * Get the hostname and port number we are connected to...
1077 httpGetHostname(http
, http_hostname
, sizeof(http_hostname
));
1078 http_port
= httpAddrPort(http
->hostaddr
);
1080 DEBUG_printf(("2cupsGetPPD3: Connection hostname=\"%s\", port=%d",
1081 http_hostname
, http_port
));
1084 * Reconnect to the correct server as needed...
1087 if (!_cups_strcasecmp(http_hostname
, hostname
) && port
== http_port
)
1089 else if ((http2
= httpConnect2(hostname
, port
, NULL
, AF_UNSPEC
,
1090 cupsEncryption(), 1, 30000, NULL
)) == NULL
)
1092 DEBUG_puts("1cupsGetPPD3: Unable to connect to server");
1094 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
1098 * Get a temp file...
1102 fd
= open(buffer
, O_CREAT
| O_TRUNC
| O_WRONLY
, 0600);
1104 fd
= cupsTempFd(tempfile
, sizeof(tempfile
));
1109 * Can't open file; close the server connection and return NULL...
1112 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, NULL
, 0);
1117 return (HTTP_STATUS_SERVER_ERROR
);
1121 * And send a request to the HTTP server...
1124 strlcat(resource
, ".ppd", sizeof(resource
));
1127 httpSetField(http2
, HTTP_FIELD_IF_MODIFIED_SINCE
,
1128 httpGetDateString(*modtime
));
1130 status
= cupsGetFd(http2
, resource
, fd
);
1135 * See if we actually got the file or an error...
1138 if (status
== HTTP_STATUS_OK
)
1140 *modtime
= httpGetDateTime(httpGetField(http2
, HTTP_FIELD_DATE
));
1143 strlcpy(buffer
, tempfile
, bufsize
);
1145 else if (status
!= HTTP_STATUS_NOT_MODIFIED
)
1147 _cupsSetHTTPError(status
);
1151 else if (tempfile
[0])
1154 else if (tempfile
[0])
1161 * Return the PPD file...
1164 DEBUG_printf(("1cupsGetPPD3: Returning status %d", status
));
1171 * 'cupsGetPrinters()' - Get a list of printers from the default server.
1173 * This function is deprecated - use @link cupsGetDests@ instead.
1178 int /* O - Number of printers */
1179 cupsGetPrinters(char ***printers
) /* O - Printers */
1181 int n
; /* Number of printers */
1182 ipp_t
*request
, /* IPP Request */
1183 *response
; /* IPP Response */
1184 ipp_attribute_t
*attr
; /* Current attribute */
1185 char **temp
; /* Temporary pointer */
1186 http_t
*http
; /* Connection to server */
1190 * Range check input...
1195 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
1203 * Try to connect to the server...
1206 if ((http
= _cupsConnect()) == NULL
)
1210 * Build a CUPS_GET_PRINTERS request, which requires the following
1213 * attributes-charset
1214 * attributes-natural-language
1215 * requested-attributes
1218 request
= ippNewRequest(IPP_OP_CUPS_GET_PRINTERS
);
1220 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_KEYWORD
,
1221 "requested-attributes", NULL
, "printer-name");
1223 ippAddInteger(request
, IPP_TAG_OPERATION
, IPP_TAG_ENUM
,
1226 ippAddInteger(request
, IPP_TAG_OPERATION
, IPP_TAG_ENUM
,
1227 "printer-type-mask", CUPS_PRINTER_CLASS
);
1230 * Do the request and get back a response...
1235 if ((response
= cupsDoRequest(http
, request
, "/")) != NULL
)
1237 for (attr
= response
->attrs
; attr
!= NULL
; attr
= attr
->next
)
1238 if (attr
->name
!= NULL
&&
1239 _cups_strcasecmp(attr
->name
, "printer-name") == 0 &&
1240 attr
->value_tag
== IPP_TAG_NAME
)
1243 temp
= malloc(sizeof(char *));
1245 temp
= realloc(*printers
, sizeof(char *) * (n
+ 1));
1250 * Ran out of memory!
1256 free((*printers
)[n
]);
1260 ippDelete(response
);
1265 temp
[n
] = strdup(attr
->values
[0].string
.text
);
1269 ippDelete(response
);
1277 * 'cupsGetServerPPD()' - Get an available PPD file from the server.
1279 * This function returns the named PPD file from the server. The
1280 * list of available PPDs is provided by the IPP @code CUPS_GET_PPDS@
1283 * You must remove (unlink) the PPD file when you are finished with
1284 * it. The PPD filename is stored in a static location that will be
1285 * overwritten on the next call to @link cupsGetPPD@, @link cupsGetPPD2@,
1286 * or @link cupsGetServerPPD@.
1288 * @since CUPS 1.3/OS X 10.5@
1291 char * /* O - Name of PPD file or @code NULL@ on error */
1292 cupsGetServerPPD(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
1293 const char *name
) /* I - Name of PPD file ("ppd-name") */
1295 int fd
; /* PPD file descriptor */
1296 ipp_t
*request
; /* IPP request */
1297 _cups_globals_t
*cg
= _cupsGlobals();
1298 /* Pointer to library globals */
1302 * Range check input...
1307 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No PPD name"), 1);
1313 if ((http
= _cupsConnect()) == NULL
)
1317 * Get a temp file...
1320 if ((fd
= cupsTempFd(cg
->ppd_filename
, sizeof(cg
->ppd_filename
))) < 0)
1323 * Can't open file; close the server connection and return NULL...
1326 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, NULL
, 0);
1332 * Get the PPD file...
1335 request
= ippNewRequest(IPP_OP_CUPS_GET_PPD
);
1336 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "ppd-name", NULL
,
1339 ippDelete(cupsDoIORequest(http
, request
, "/", -1, fd
));
1343 if (cupsLastError() != IPP_STATUS_OK
)
1345 unlink(cg
->ppd_filename
);
1349 return (cg
->ppd_filename
);
1354 * 'cupsPrintFile()' - Print a file to a printer or class on the default server.
1357 int /* O - Job ID or 0 on error */
1358 cupsPrintFile(const char *name
, /* I - Destination name */
1359 const char *filename
, /* I - File to print */
1360 const char *title
, /* I - Title of job */
1361 int num_options
,/* I - Number of options */
1362 cups_option_t
*options
) /* I - Options */
1364 DEBUG_printf(("cupsPrintFile(name=\"%s\", filename=\"%s\", "
1365 "title=\"%s\", num_options=%d, options=%p)",
1366 name
, filename
, title
, num_options
, options
));
1368 return (cupsPrintFiles2(CUPS_HTTP_DEFAULT
, name
, 1, &filename
, title
,
1369 num_options
, options
));
1374 * 'cupsPrintFile2()' - Print a file to a printer or class on the specified
1377 * @since CUPS 1.1.21/OS X 10.4@
1380 int /* O - Job ID or 0 on error */
1382 http_t
*http
, /* I - Connection to server */
1383 const char *name
, /* I - Destination name */
1384 const char *filename
, /* I - File to print */
1385 const char *title
, /* I - Title of job */
1386 int num_options
, /* I - Number of options */
1387 cups_option_t
*options
) /* I - Options */
1389 DEBUG_printf(("cupsPrintFile2(http=%p, name=\"%s\", filename=\"%s\", "
1390 "title=\"%s\", num_options=%d, options=%p)",
1391 http
, name
, filename
, title
, num_options
, options
));
1393 return (cupsPrintFiles2(http
, name
, 1, &filename
, title
, num_options
,
1399 * 'cupsPrintFiles()' - Print one or more files to a printer or class on the
1403 int /* O - Job ID or 0 on error */
1405 const char *name
, /* I - Destination name */
1406 int num_files
, /* I - Number of files */
1407 const char **files
, /* I - File(s) to print */
1408 const char *title
, /* I - Title of job */
1409 int num_options
, /* I - Number of options */
1410 cups_option_t
*options
) /* I - Options */
1412 DEBUG_printf(("cupsPrintFiles(name=\"%s\", num_files=%d, "
1413 "files=%p, title=\"%s\", num_options=%d, options=%p)",
1414 name
, num_files
, files
, title
, num_options
, options
));
1417 * Print the file(s)...
1420 return (cupsPrintFiles2(CUPS_HTTP_DEFAULT
, name
, num_files
, files
, title
,
1421 num_options
, options
));
1426 * 'cupsPrintFiles2()' - Print one or more files to a printer or class on the
1429 * @since CUPS 1.1.21/OS X 10.4@
1432 int /* O - Job ID or 0 on error */
1434 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
1435 const char *name
, /* I - Destination name */
1436 int num_files
, /* I - Number of files */
1437 const char **files
, /* I - File(s) to print */
1438 const char *title
, /* I - Title of job */
1439 int num_options
, /* I - Number of options */
1440 cups_option_t
*options
) /* I - Options */
1442 int i
; /* Looping var */
1443 int job_id
; /* New job ID */
1444 const char *docname
; /* Basename of current filename */
1445 const char *format
; /* Document format */
1446 cups_file_t
*fp
; /* Current file */
1447 char buffer
[8192]; /* Copy buffer */
1448 ssize_t bytes
; /* Bytes in buffer */
1449 http_status_t status
; /* Status of write */
1450 _cups_globals_t
*cg
= _cupsGlobals(); /* Global data */
1451 ipp_status_t cancel_status
; /* Status code to preserve */
1452 char *cancel_message
; /* Error message to preserve */
1455 DEBUG_printf(("cupsPrintFiles2(http=%p, name=\"%s\", num_files=%d, "
1456 "files=%p, title=\"%s\", num_options=%d, options=%p)",
1457 http
, name
, num_files
, files
, title
, num_options
, options
));
1460 * Range check input...
1463 if (!name
|| num_files
< 1 || !files
)
1465 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
1471 * Create the print job...
1474 if ((job_id
= cupsCreateJob(http
, name
, title
, num_options
, options
)) == 0)
1478 * Send each of the files...
1481 if (cupsGetOption("raw", num_options
, options
))
1482 format
= CUPS_FORMAT_RAW
;
1483 else if ((format
= cupsGetOption("document-format", num_options
,
1485 format
= CUPS_FORMAT_AUTO
;
1487 for (i
= 0; i
< num_files
; i
++)
1490 * Start the next file...
1493 if ((docname
= strrchr(files
[i
], '/')) != NULL
)
1498 if ((fp
= cupsFileOpen(files
[i
], "rb")) == NULL
)
1501 * Unable to open print file, cancel the job and return...
1504 _cupsSetError(IPP_STATUS_ERROR_DOCUMENT_ACCESS
, NULL
, 0);
1508 status
= cupsStartDocument(http
, name
, job_id
, docname
, format
,
1509 i
== (num_files
- 1));
1511 while (status
== HTTP_STATUS_CONTINUE
&&
1512 (bytes
= cupsFileRead(fp
, buffer
, sizeof(buffer
))) > 0)
1513 status
= cupsWriteRequestData(http
, buffer
, bytes
);
1517 if (status
!= HTTP_STATUS_CONTINUE
|| cupsFinishDocument(http
, name
) != IPP_STATUS_OK
)
1520 * Unable to queue, cancel the job and return...
1530 * If we get here, something happened while sending the print job so we need
1531 * to cancel the job without setting the last error (since we need to preserve
1532 * the current error...
1537 cancel_status
= cg
->last_error
;
1538 cancel_message
= cg
->last_status_message
?
1539 _cupsStrRetain(cg
->last_status_message
) : NULL
;
1541 cupsCancelJob2(http
, name
, job_id
, 0);
1543 cg
->last_error
= cancel_status
;
1544 cg
->last_status_message
= cancel_message
;
1551 * 'cupsStartDocument()' - Add a document to a job created with cupsCreateJob().
1553 * Use @link cupsWriteRequestData@ to write data for the document and
1554 * @link cupsFinishDocument@ to finish the document and get the submission status.
1556 * The MIME type constants @code CUPS_FORMAT_AUTO@, @code CUPS_FORMAT_PDF@,
1557 * @code CUPS_FORMAT_POSTSCRIPT@, @code CUPS_FORMAT_RAW@, and
1558 * @code CUPS_FORMAT_TEXT@ are provided for the "format" argument, although
1559 * any supported MIME type string can be supplied.
1561 * @since CUPS 1.4/OS X 10.6@
1564 http_status_t
/* O - HTTP status of request */
1566 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
1567 const char *name
, /* I - Destination name */
1568 int job_id
, /* I - Job ID from @link cupsCreateJob@ */
1569 const char *docname
, /* I - Name of document */
1570 const char *format
, /* I - MIME type or @code CUPS_FORMAT_foo@ */
1571 int last_document
) /* I - 1 for last document in job, 0 otherwise */
1573 char resource
[1024], /* Resource for destinatio */
1574 printer_uri
[1024]; /* Printer URI */
1575 ipp_t
*request
; /* Send-Document request */
1576 http_status_t status
; /* HTTP status */
1580 * Create a Send-Document request...
1583 if ((request
= ippNewRequest(IPP_OP_SEND_DOCUMENT
)) == NULL
)
1585 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(ENOMEM
), 0);
1586 return (HTTP_STATUS_ERROR
);
1589 httpAssembleURIf(HTTP_URI_CODING_ALL
, printer_uri
, sizeof(printer_uri
), "ipp",
1590 NULL
, "localhost", ippPort(), "/printers/%s", name
);
1591 snprintf(resource
, sizeof(resource
), "/printers/%s", name
);
1593 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri",
1595 ippAddInteger(request
, IPP_TAG_OPERATION
, IPP_TAG_INTEGER
, "job-id", job_id
);
1596 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "requesting-user-name",
1599 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
, "document-name",
1602 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_MIMETYPE
,
1603 "document-format", NULL
, format
);
1604 ippAddBoolean(request
, IPP_TAG_OPERATION
, "last-document", last_document
);
1607 * Send and delete the request, then return the status...
1610 status
= cupsSendRequest(http
, request
, resource
, CUPS_LENGTH_VARIABLE
);
1619 * 'cups_get_printer_uri()' - Get the printer-uri-supported attribute for the
1620 * first printer in a class.
1623 static int /* O - 1 on success, 0 on failure */
1624 cups_get_printer_uri(
1625 http_t
*http
, /* I - Connection to server */
1626 const char *name
, /* I - Name of printer or class */
1627 char *host
, /* I - Hostname buffer */
1628 int hostsize
, /* I - Size of hostname buffer */
1629 int *port
, /* O - Port number */
1630 char *resource
, /* I - Resource buffer */
1631 int resourcesize
, /* I - Size of resource buffer */
1632 int depth
) /* I - Depth of query */
1634 int i
; /* Looping var */
1635 int http_port
; /* Port number */
1636 http_t
*http2
; /* Alternate HTTP connection */
1637 ipp_t
*request
, /* IPP request */
1638 *response
; /* IPP response */
1639 ipp_attribute_t
*attr
; /* Current attribute */
1640 char uri
[HTTP_MAX_URI
], /* printer-uri attribute */
1641 scheme
[HTTP_MAX_URI
], /* Scheme name */
1642 username
[HTTP_MAX_URI
], /* Username:password */
1643 classname
[255], /* Temporary class name */
1644 http_hostname
[HTTP_MAX_HOST
];
1645 /* Hostname associated with connection */
1646 static const char * const requested_attrs
[] =
1647 { /* Requested attributes */
1650 "printer-uri-supported",
1655 DEBUG_printf(("7cups_get_printer_uri(http=%p, name=\"%s\", host=%p, "
1656 "hostsize=%d, resource=%p, resourcesize=%d, depth=%d)",
1657 http
, name
, host
, hostsize
, resource
, resourcesize
, depth
));
1660 * Setup the printer URI...
1663 if (httpAssembleURIf(HTTP_URI_CODING_ALL
, uri
, sizeof(uri
), "ipp", NULL
,
1664 "localhost", 0, "/printers/%s",
1665 name
) < HTTP_URI_STATUS_OK
)
1667 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unable to create printer-uri"),
1676 DEBUG_printf(("9cups_get_printer_uri: printer-uri=\"%s\"", uri
));
1679 * Get the hostname and port number we are connected to...
1682 httpGetHostname(http
, http_hostname
, sizeof(http_hostname
));
1683 http_port
= httpAddrPort(http
->hostaddr
);
1686 * Build an IPP_GET_PRINTER_ATTRIBUTES request, which requires the following
1689 * attributes-charset
1690 * attributes-natural-language
1692 * requested-attributes
1695 request
= ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES
);
1697 ippAddString(request
, IPP_TAG_OPERATION
, IPP_TAG_URI
, "printer-uri",
1700 ippAddStrings(request
, IPP_TAG_OPERATION
, IPP_TAG_NAME
,
1701 "requested-attributes",
1702 sizeof(requested_attrs
) / sizeof(requested_attrs
[0]),
1703 NULL
, requested_attrs
);
1706 * Do the request and get back a response...
1709 snprintf(resource
, resourcesize
, "/printers/%s", name
);
1711 if ((response
= cupsDoRequest(http
, request
, resource
)) != NULL
)
1713 const char *device_uri
= NULL
; /* device-uri value */
1715 if ((attr
= ippFindAttribute(response
, "device-uri",
1716 IPP_TAG_URI
)) != NULL
)
1717 device_uri
= attr
->values
[0].string
.text
;
1720 (!strncmp(device_uri
, "ipp://", 6) ||
1721 !strncmp(device_uri
, "ipps://", 7) ||
1722 ((strstr(device_uri
, "._ipp.") != NULL
||
1723 strstr(device_uri
, "._ipps.") != NULL
) &&
1724 !strcmp(device_uri
+ strlen(device_uri
) - 5, "/cups"))))
1727 * Statically-configured shared printer.
1730 httpSeparateURI(HTTP_URI_CODING_ALL
,
1731 _httpResolveURI(device_uri
, uri
, sizeof(uri
),
1732 _HTTP_RESOLVE_DEFAULT
, NULL
, NULL
),
1733 scheme
, sizeof(scheme
), username
, sizeof(username
),
1734 host
, hostsize
, port
, resource
, resourcesize
);
1735 ippDelete(response
);
1739 else if ((attr
= ippFindAttribute(response
, "member-uris",
1740 IPP_TAG_URI
)) != NULL
)
1743 * Get the first actual printer name in the class...
1746 for (i
= 0; i
< attr
->num_values
; i
++)
1748 httpSeparateURI(HTTP_URI_CODING_ALL
, attr
->values
[i
].string
.text
,
1749 scheme
, sizeof(scheme
), username
, sizeof(username
),
1750 host
, hostsize
, port
, resource
, resourcesize
);
1751 if (!strncmp(resource
, "/printers/", 10))
1757 ippDelete(response
);
1764 * No printers in this class - try recursively looking for a printer,
1765 * but not more than 3 levels deep...
1770 for (i
= 0; i
< attr
->num_values
; i
++)
1772 httpSeparateURI(HTTP_URI_CODING_ALL
, attr
->values
[i
].string
.text
,
1773 scheme
, sizeof(scheme
), username
, sizeof(username
),
1774 host
, hostsize
, port
, resource
, resourcesize
);
1775 if (!strncmp(resource
, "/classes/", 9))
1778 * Found a class! Connect to the right server...
1781 if (!_cups_strcasecmp(http_hostname
, host
) && *port
== http_port
)
1783 else if ((http2
= httpConnect2(host
, *port
, NULL
, AF_UNSPEC
,
1784 cupsEncryption(), 1, 30000,
1787 DEBUG_puts("8cups_get_printer_uri: Unable to connect to server");
1793 * Look up printers on that server...
1796 strlcpy(classname
, resource
+ 9, sizeof(classname
));
1798 cups_get_printer_uri(http2
, classname
, host
, hostsize
, port
,
1799 resource
, resourcesize
, depth
+ 1);
1802 * Close the connection as needed...
1814 else if ((attr
= ippFindAttribute(response
, "printer-uri-supported",
1815 IPP_TAG_URI
)) != NULL
)
1817 httpSeparateURI(HTTP_URI_CODING_ALL
,
1818 _httpResolveURI(attr
->values
[0].string
.text
, uri
,
1819 sizeof(uri
), _HTTP_RESOLVE_DEFAULT
,
1821 scheme
, sizeof(scheme
), username
, sizeof(username
),
1822 host
, hostsize
, port
, resource
, resourcesize
);
1823 ippDelete(response
);
1825 if (!strncmp(resource
, "/classes/", 9))
1827 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
,
1828 _("No printer-uri found for class"), 1);
1839 ippDelete(response
);
1842 if (cupsLastError() != IPP_STATUS_ERROR_NOT_FOUND
)
1843 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No printer-uri found"), 1);