2 * "$Id: request.c 7946 2008-09-16 23:27:54Z mike $"
4 * IPP utilities for CUPS.
6 * Copyright 2007-2011 by Apple Inc.
7 * Copyright 1997-2007 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 * cupsDoFileRequest() - Do an IPP request with a file.
20 * cupsDoIORequest() - Do an IPP request with file descriptors.
21 * cupsDoRequest() - Do an IPP request.
22 * cupsGetResponse() - Get a response to an IPP request.
23 * cupsLastError() - Return the last IPP status code.
24 * cupsLastErrorString() - Return the last IPP status-message.
25 * _cupsNextDelay() - Return the next retry delay value.
26 * cupsReadResponseData() - Read additional data after the IPP response.
27 * cupsSendRequest() - Send an IPP request.
28 * cupsWriteRequestData() - Write additional data after an IPP request.
29 * _cupsConnect() - Get the default server connection...
30 * _cupsSetError() - Set the last IPP status code and status-message.
31 * _cupsSetHTTPError() - Set the last error using the HTTP status.
35 * Include necessary headers...
38 #include "cups-private.h"
41 #if defined(WIN32) || defined(__EMX__)
45 #endif /* WIN32 || __EMX__ */
52 * 'cupsDoFileRequest()' - Do an IPP request with a file.
54 * This function sends the IPP request to the specified server, retrying
55 * and authenticating as necessary. The request is freed with @link ippDelete@
56 * after receiving a valid IPP response.
59 ipp_t
* /* O - Response data */
60 cupsDoFileRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
61 ipp_t
*request
, /* I - IPP request */
62 const char *resource
, /* I - HTTP resource for POST */
63 const char *filename
) /* I - File to send or @code NULL@ for none */
65 ipp_t
*response
; /* IPP response data */
66 int infile
; /* Input file */
69 DEBUG_printf(("cupsDoFileRequest(http=%p, request=%p(%s), resource=\"%s\", "
70 "filename=\"%s\")", http
, request
,
71 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
76 if ((infile
= open(filename
, O_RDONLY
| O_BINARY
)) < 0)
79 * Can't get file information!
82 _cupsSetError(errno
== ENOENT
? IPP_NOT_FOUND
: IPP_NOT_AUTHORIZED
,
93 response
= cupsDoIORequest(http
, request
, resource
, infile
, -1);
103 * 'cupsDoIORequest()' - Do an IPP request with file descriptors.
105 * This function sends the IPP request to the specified server, retrying
106 * and authenticating as necessary. The request is freed with ippDelete()
107 * after receiving a valid IPP response.
109 * If "infile" is a valid file descriptor, cupsDoIORequest() copies
110 * all of the data from the file after the IPP request message.
112 * If "outfile" is a valid file descriptor, cupsDoIORequest() copies
113 * all of the data after the IPP response message to the file.
115 * @since CUPS 1.3/Mac OS X 10.5@
118 ipp_t
* /* O - Response data */
119 cupsDoIORequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
120 ipp_t
*request
, /* I - IPP request */
121 const char *resource
, /* I - HTTP resource for POST */
122 int infile
, /* I - File to read from or -1 for none */
123 int outfile
) /* I - File to write to or -1 for none */
125 ipp_t
*response
= NULL
; /* IPP response data */
126 size_t length
= 0; /* Content-Length value */
127 http_status_t status
; /* Status of HTTP request */
128 struct stat fileinfo
; /* File information */
129 int bytes
; /* Number of bytes read/written */
130 char buffer
[32768]; /* Output buffer */
133 DEBUG_printf(("cupsDoIORequest(http=%p, request=%p(%s), resource=\"%s\", "
134 "infile=%d, outfile=%d)", http
, request
,
135 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
136 resource
, infile
, outfile
));
139 * Range check input...
142 if (!request
|| !resource
)
146 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(EINVAL
), 0);
152 * Get the default connection as needed...
156 if ((http
= _cupsConnect()) == NULL
)
164 * See if we have a file to send...
169 if (fstat(infile
, &fileinfo
))
172 * Can't get file information!
175 _cupsSetError(errno
== EBADF
? IPP_NOT_FOUND
: IPP_NOT_AUTHORIZED
,
184 if (fileinfo
.st_mode
& _S_IFDIR
)
186 if (S_ISDIR(fileinfo
.st_mode
))
190 * Can't send a directory...
195 _cupsSetError(IPP_NOT_POSSIBLE
, strerror(EISDIR
), 0);
201 if (!S_ISREG(fileinfo
.st_mode
))
202 length
= 0; /* Chunk when piping */
205 length
= ippLength(request
) + fileinfo
.st_size
;
208 length
= ippLength(request
);
210 DEBUG_printf(("2cupsDoIORequest: Request length=%ld, total length=%ld",
211 (long)ippLength(request
), (long)length
));
214 * Clear any "Local" authentication data since it is probably stale...
217 if (http
->authstring
&& !strncmp(http
->authstring
, "Local ", 6))
218 httpSetAuthString(http
, NULL
, NULL
);
221 * Loop until we can send the request without authorization problems.
224 while (response
== NULL
)
226 DEBUG_puts("2cupsDoIORequest: setup...");
229 * Send the request...
232 status
= cupsSendRequest(http
, request
, resource
, length
);
234 DEBUG_printf(("2cupsDoIORequest: status=%d", status
));
236 if (status
== HTTP_CONTINUE
&& request
->state
== IPP_DATA
&& infile
>= 0)
238 DEBUG_puts("2cupsDoIORequest: file write...");
241 * Send the file with the request...
245 if (S_ISREG(fileinfo
.st_mode
))
247 lseek(infile
, 0, SEEK_SET
);
249 while ((bytes
= (int)read(infile
, buffer
, sizeof(buffer
))) > 0)
251 if ((status
= cupsWriteRequestData(http
, buffer
, bytes
))
258 * Get the server's response...
261 if (status
!= HTTP_ERROR
)
263 response
= cupsGetResponse(http
, resource
);
264 status
= httpGetStatus(http
);
267 DEBUG_printf(("2cupsDoIORequest: status=%d", status
));
269 if (status
== HTTP_ERROR
||
270 (status
>= HTTP_BAD_REQUEST
&& status
!= HTTP_UNAUTHORIZED
&&
271 status
!= HTTP_UPGRADE_REQUIRED
))
273 _cupsSetHTTPError(status
);
277 if (response
&& outfile
>= 0)
280 * Write trailing data to file...
283 while ((bytes
= (int)httpRead2(http
, buffer
, sizeof(buffer
))) > 0)
284 if (write(outfile
, buffer
, bytes
) < bytes
)
288 if (http
->state
!= HTTP_WAITING
)
291 * Flush any remaining data...
299 * Delete the original request and return the response...
309 * 'cupsDoRequest()' - Do an IPP request.
311 * This function sends the IPP request to the specified server, retrying
312 * and authenticating as necessary. The request is freed with ippDelete()
313 * after receiving a valid IPP response.
316 ipp_t
* /* O - Response data */
317 cupsDoRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
318 ipp_t
*request
, /* I - IPP request */
319 const char *resource
) /* I - HTTP resource for POST */
321 DEBUG_printf(("cupsDoRequest(http=%p, request=%p(%s), resource=\"%s\")",
323 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
326 return (cupsDoIORequest(http
, request
, resource
, -1, -1));
331 * 'cupsGetResponse()' - Get a response to an IPP request.
333 * Use this function to get the response for an IPP request sent using
334 * cupsSendDocument() or cupsSendRequest(). For requests that return
335 * additional data, use httpRead() after getting a successful response,
336 * otherwise call httpFlush() to complete the response processing.
338 * @since CUPS 1.4/Mac OS X 10.6@
341 ipp_t
* /* O - Response or @code NULL@ on HTTP error */
342 cupsGetResponse(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
343 const char *resource
) /* I - HTTP resource for POST */
345 http_status_t status
; /* HTTP status */
346 ipp_state_t state
; /* IPP read state */
347 ipp_t
*response
= NULL
; /* IPP response */
350 DEBUG_printf(("cupsGetResponse(http=%p, resource=\"%s\")", http
, resource
));
353 * Connect to the default server as needed...
357 http
= _cupsConnect();
359 if (!http
|| (http
->state
!= HTTP_POST_RECV
&& http
->state
!= HTTP_POST_SEND
))
363 * Check for an unfinished chunked request...
366 if (http
->data_encoding
== HTTP_ENCODE_CHUNKED
)
369 * Send a 0-length chunk to finish off the request...
372 DEBUG_puts("2cupsGetResponse: Finishing chunked POST...");
374 if (httpWrite2(http
, "", 0) < 0)
379 * Wait for a response from the server...
382 DEBUG_printf(("2cupsGetResponse: Update loop, http->status=%d...",
387 status
= httpUpdate(http
);
389 while (status
!= HTTP_ERROR
&& http
->state
== HTTP_POST_RECV
);
391 DEBUG_printf(("2cupsGetResponse: status=%d", status
));
393 if (status
== HTTP_OK
)
396 * Get the IPP response...
401 while ((state
= ippRead(http
, response
)) != IPP_DATA
)
402 if (state
== IPP_ERROR
)
405 if (state
== IPP_ERROR
)
408 * Flush remaining data and delete the response...
411 DEBUG_puts("1cupsGetResponse: IPP read error!");
418 _cupsSetError(IPP_SERVICE_UNAVAILABLE
, NULL
, 0);
419 http
->status
= status
= HTTP_ERROR
;
423 else if (status
!= HTTP_ERROR
)
426 * Flush any error message...
432 * Then handle encryption and authentication...
435 if (status
== HTTP_UNAUTHORIZED
)
438 * See if we can do authentication...
441 DEBUG_puts("2cupsGetResponse: Need authorization...");
443 if (!cupsDoAuthentication(http
, "POST", resource
))
446 http
->status
= status
= HTTP_AUTHORIZATION_CANCELED
;
450 else if (status
== HTTP_UPGRADE_REQUIRED
)
453 * Force a reconnect with encryption...
456 DEBUG_puts("2cupsGetResponse: Need encryption...");
458 if (!httpReconnect(http
))
459 httpEncryption(http
, HTTP_ENCRYPT_REQUIRED
);
461 #endif /* HAVE_SSL */
466 ipp_attribute_t
*attr
; /* status-message attribute */
469 attr
= ippFindAttribute(response
, "status-message", IPP_TAG_TEXT
);
471 DEBUG_printf(("1cupsGetResponse: status-code=%s, status-message=\"%s\"",
472 ippErrorString(response
->request
.status
.status_code
),
473 attr
? attr
->values
[0].string
.text
: ""));
475 _cupsSetError(response
->request
.status
.status_code
,
476 attr
? attr
->values
[0].string
.text
:
477 ippErrorString(response
->request
.status
.status_code
), 0);
479 else if (status
== HTTP_ERROR
)
480 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(http
->error
), 0);
481 else if (status
!= HTTP_OK
)
482 _cupsSetHTTPError(status
);
489 * 'cupsLastError()' - Return the last IPP status code.
492 ipp_status_t
/* O - IPP status code from last request */
495 return (_cupsGlobals()->last_error
);
500 * 'cupsLastErrorString()' - Return the last IPP status-message.
502 * @since CUPS 1.2/Mac OS X 10.5@
505 const char * /* O - status-message text from last request */
506 cupsLastErrorString(void)
508 return (_cupsGlobals()->last_status_message
);
513 * '_cupsNextDelay()' - Return the next retry delay value.
515 * This function currently returns the Fibonacci sequence 1 1 2 3 5 8.
517 * Pass 0 for the current delay value to initialize the sequence.
520 int /* O - Next delay value */
521 _cupsNextDelay(int current
, /* I - Current delay value or 0 */
522 int *previous
) /* IO - Previous delay value */
524 int next
; /* Next delay value */
529 next
= (current
+ *previous
) % 12;
530 *previous
= next
< current
? 0 : current
;
543 * 'cupsReadResponseData()' - Read additional data after the IPP response.
545 * This function is used after cupsGetResponse() to read the PPD or document
546 * files for CUPS_GET_PPD and CUPS_GET_DOCUMENT requests, respectively.
548 * @since CUPS 1.4/Mac OS X 10.6@
551 ssize_t
/* O - Bytes read, 0 on EOF, -1 on error */
552 cupsReadResponseData(
553 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
554 char *buffer
, /* I - Buffer to use */
555 size_t length
) /* I - Number of bytes to read */
558 * Get the default connection as needed...
561 DEBUG_printf(("cupsReadResponseData(http=%p, buffer=%p, "
562 "length=" CUPS_LLFMT
")", http
, buffer
, CUPS_LLCAST length
));
566 _cups_globals_t
*cg
= _cupsGlobals();
567 /* Pointer to library globals */
569 if ((http
= cg
->http
) == NULL
)
571 _cupsSetError(IPP_INTERNAL_ERROR
, _("No active connection"), 1);
577 * Then read from the HTTP connection...
580 return (httpRead2(http
, buffer
, length
));
585 * 'cupsSendRequest()' - Send an IPP request.
587 * Use httpWrite() to write any additional data (document, PPD file, etc.)
588 * for the request, cupsGetResponse() to get the IPP response, and httpRead()
589 * to read any additional data following the response. Only one request can be
590 * sent/queued at a time.
592 * Unlike cupsDoFileRequest(), cupsDoIORequest(), and cupsDoRequest(), the
593 * request is not freed.
595 * @since CUPS 1.4/Mac OS X 10.6@
598 http_status_t
/* O - Initial HTTP status */
599 cupsSendRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
600 ipp_t
*request
, /* I - IPP request */
601 const char *resource
, /* I - Resource path */
602 size_t length
) /* I - Length of data to follow or @code CUPS_LENGTH_VARIABLE@ */
604 http_status_t status
; /* Status of HTTP request */
605 int got_status
; /* Did we get the status? */
606 ipp_state_t state
; /* State of IPP processing */
607 http_status_t expect
; /* Expect: header to use */
610 DEBUG_printf(("cupsSendRequest(http=%p, request=%p(%s), resource=\"%s\", "
611 "length=" CUPS_LLFMT
")", http
, request
,
612 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
613 resource
, CUPS_LLCAST length
));
616 * Range check input...
619 if (!request
|| !resource
)
621 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(EINVAL
), 0);
627 * Get the default connection as needed...
631 if ((http
= _cupsConnect()) == NULL
)
632 return (HTTP_SERVICE_UNAVAILABLE
);
635 * If the prior request was not flushed out, do so now...
638 if (http
->state
== HTTP_GET_SEND
||
639 http
->state
== HTTP_POST_SEND
)
641 DEBUG_puts("2cupsSendRequest: Flush prior response.");
644 else if (http
->state
!= HTTP_WAITING
)
646 DEBUG_printf(("1cupsSendRequest: Unknown HTTP state (%d), bailing.",
648 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(EINVAL
), 0);
655 * See if we have an auth-info attribute and are communicating over
656 * a non-local link. If so, encrypt the link so that we can pass
657 * the authentication information securely...
660 if (ippFindAttribute(request
, "auth-info", IPP_TAG_TEXT
) &&
661 !httpAddrLocalhost(http
->hostaddr
) && !http
->tls
&&
662 httpEncryption(http
, HTTP_ENCRYPT_REQUIRED
))
664 DEBUG_puts("1cupsSendRequest: Unable to encrypt connection.");
665 return (HTTP_SERVICE_UNAVAILABLE
);
667 #endif /* HAVE_SSL */
670 * Reconnect if the last response had a "Connection: close"...
673 if (!_cups_strcasecmp(http
->fields
[HTTP_FIELD_CONNECTION
], "close"))
675 DEBUG_puts("2cupsSendRequest: Connection: close");
676 httpClearFields(http
);
677 if (httpReconnect(http
))
679 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
680 return (HTTP_SERVICE_UNAVAILABLE
);
685 * Loop until we can send the request without authorization problems.
688 expect
= HTTP_CONTINUE
;
692 DEBUG_puts("2cupsSendRequest: Setup...");
695 * Setup the HTTP variables needed...
698 httpClearFields(http
);
699 httpSetExpect(http
, expect
);
700 httpSetField(http
, HTTP_FIELD_CONTENT_TYPE
, "application/ipp");
701 httpSetLength(http
, length
);
704 if (http
->authstring
&& !strncmp(http
->authstring
, "Negotiate", 9))
707 * Do not use cached Kerberos credentials since they will look like a
711 _cupsSetNegotiateAuthString(http
, "POST", resource
);
713 #endif /* HAVE_GSSAPI */
715 httpSetField(http
, HTTP_FIELD_AUTHORIZATION
, http
->authstring
);
717 DEBUG_printf(("2cupsSendRequest: authstring=\"%s\"", http
->authstring
));
723 DEBUG_puts("2cupsSendRequest: Sending HTTP POST...");
725 if (httpPost(http
, resource
))
727 DEBUG_puts("2cupsSendRequest: POST failed, reconnecting.");
728 if (httpReconnect(http
))
730 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
731 return (HTTP_SERVICE_UNAVAILABLE
);
738 * Send the IPP data...
741 DEBUG_puts("2cupsSendRequest: Writing IPP request...");
743 request
->state
= IPP_IDLE
;
744 status
= HTTP_CONTINUE
;
747 while ((state
= ippWrite(http
, request
)) != IPP_DATA
)
748 if (state
== IPP_ERROR
)
750 else if (httpCheck(http
))
754 _httpUpdate(http
, &status
);
755 if (status
>= HTTP_MULTIPLE_CHOICES
)
759 if (state
== IPP_ERROR
)
761 DEBUG_puts("1cupsSendRequest: Unable to send IPP request.");
763 http
->status
= HTTP_ERROR
;
764 http
->state
= HTTP_WAITING
;
770 * Wait up to 1 second to get the 100-continue response as needed...
775 if (expect
== HTTP_CONTINUE
)
777 DEBUG_puts("2cupsSendRequest: Waiting for 100-continue...");
779 if (httpWait(http
, 1000))
780 _httpUpdate(http
, &status
);
782 else if (httpCheck(http
))
783 _httpUpdate(http
, &status
);
786 DEBUG_printf(("2cupsSendRequest: status=%d", status
));
789 * Process the current HTTP status...
792 if (status
>= HTTP_MULTIPLE_CHOICES
)
794 _cupsSetHTTPError(status
);
798 status
= httpUpdate(http
);
800 while (status
!= HTTP_ERROR
&& http
->state
== HTTP_POST_RECV
);
810 DEBUG_printf(("1cupsSendRequest: Returning %d.", status
));
813 case HTTP_UNAUTHORIZED
:
814 if (cupsDoAuthentication(http
, "POST", resource
))
816 DEBUG_puts("1cupsSendRequest: Returning HTTP_AUTHORIZATION_CANCELED.");
817 return (HTTP_AUTHORIZATION_CANCELED
);
820 DEBUG_puts("2cupsSendRequest: Reconnecting after HTTP_UNAUTHORIZED.");
822 if (httpReconnect(http
))
824 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
825 return (HTTP_SERVICE_UNAVAILABLE
);
830 case HTTP_UPGRADE_REQUIRED
:
832 * Flush any error message, reconnect, and then upgrade with
836 DEBUG_puts("2cupsSendRequest: Reconnecting after "
837 "HTTP_UPGRADE_REQUIRED.");
839 if (httpReconnect(http
))
841 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
842 return (HTTP_SERVICE_UNAVAILABLE
);
845 DEBUG_puts("2cupsSendRequest: Upgrading to TLS.");
846 if (httpEncryption(http
, HTTP_ENCRYPT_REQUIRED
))
848 DEBUG_puts("1cupsSendRequest: Unable to encrypt connection.");
849 return (HTTP_SERVICE_UNAVAILABLE
);
852 #endif /* HAVE_SSL */
854 case HTTP_EXPECTATION_FAILED
:
856 * Don't try using the Expect: header the next time around...
859 expect
= (http_status_t
)0;
861 DEBUG_puts("2cupsSendRequest: Reconnecting after "
862 "HTTP_EXPECTATION_FAILED.");
864 if (httpReconnect(http
))
866 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
867 return (HTTP_SERVICE_UNAVAILABLE
);
873 * Some other error...
883 * 'cupsWriteRequestData()' - Write additional data after an IPP request.
885 * This function is used after @link cupsSendRequest@ to provide a PPD and
886 * after @link cupsStartDocument@ to provide a document file.
888 * @since CUPS 1.4/Mac OS X 10.6@
891 http_status_t
/* O - @code HTTP_CONTINUE@ if OK or HTTP status on error */
892 cupsWriteRequestData(
893 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
894 const char *buffer
, /* I - Bytes to write */
895 size_t length
) /* I - Number of bytes to write */
897 int wused
; /* Previous bytes in buffer */
901 * Get the default connection as needed...
904 DEBUG_printf(("cupsWriteRequestData(http=%p, buffer=%p, "
905 "length=" CUPS_LLFMT
")", http
, buffer
, CUPS_LLCAST length
));
909 _cups_globals_t
*cg
= _cupsGlobals();
910 /* Pointer to library globals */
912 if ((http
= cg
->http
) == NULL
)
914 _cupsSetError(IPP_INTERNAL_ERROR
, _("No active connection"), 1);
915 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_ERROR.");
921 * Then write to the HTTP connection...
926 if (httpWrite2(http
, buffer
, length
) < 0)
928 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_ERROR.");
929 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(http
->error
), 0);
934 * Finally, check if we have any pending data from the server...
937 if (length
>= HTTP_MAX_BUFFER
||
938 http
->wused
< wused
||
939 (wused
> 0 && http
->wused
== length
))
942 * We've written something to the server, so check for response data...
945 if (_httpWait(http
, 0, 1))
947 http_status_t status
; /* Status from _httpUpdate */
949 _httpUpdate(http
, &status
);
950 if (status
>= HTTP_MULTIPLE_CHOICES
)
952 _cupsSetHTTPError(status
);
956 status
= httpUpdate(http
);
958 while (status
!= HTTP_ERROR
&& http
->state
== HTTP_POST_RECV
);
963 DEBUG_printf(("1cupsWriteRequestData: Returning %d.\n", status
));
968 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_CONTINUE.");
969 return (HTTP_CONTINUE
);
974 * '_cupsConnect()' - Get the default server connection...
977 http_t
* /* O - HTTP connection */
980 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
984 * See if we are connected to the same server...
990 * Compare the connection hostname, port, and encryption settings to
991 * the cached defaults; these were initialized the first time we
995 if (strcmp(cg
->http
->hostname
, cg
->server
) ||
996 cg
->ipp_port
!= _httpAddrPort(cg
->http
->hostaddr
) ||
997 (cg
->http
->encryption
!= cg
->encryption
&&
998 cg
->http
->encryption
== HTTP_ENCRYPT_NEVER
))
1001 * Need to close the current connection because something has changed...
1004 httpClose(cg
->http
);
1010 * (Re)connect as needed...
1015 if ((cg
->http
= httpConnectEncrypt(cupsServer(), ippPort(),
1016 cupsEncryption())) == NULL
)
1019 _cupsSetError(IPP_SERVICE_UNAVAILABLE
, NULL
, 0);
1021 _cupsSetError(IPP_SERVICE_UNAVAILABLE
,
1022 _("Unable to connect to host."), 1);
1027 * Return the cached connection...
1035 * '_cupsSetError()' - Set the last IPP status code and status-message.
1039 _cupsSetError(ipp_status_t status
, /* I - IPP status code */
1040 const char *message
, /* I - status-message value */
1041 int localize
) /* I - Localize the message? */
1043 _cups_globals_t
*cg
; /* Global data */
1046 if (!message
&& errno
)
1048 message
= strerror(errno
);
1052 cg
= _cupsGlobals();
1053 cg
->last_error
= status
;
1055 if (cg
->last_status_message
)
1057 _cupsStrFree(cg
->last_status_message
);
1059 cg
->last_status_message
= NULL
;
1067 * Get the message catalog...
1070 if (!cg
->lang_default
)
1071 cg
->lang_default
= cupsLangDefault();
1073 cg
->last_status_message
= _cupsStrAlloc(_cupsLangString(cg
->lang_default
,
1077 cg
->last_status_message
= _cupsStrAlloc(message
);
1080 DEBUG_printf(("4_cupsSetError: last_error=%s, last_status_message=\"%s\"",
1081 ippErrorString(cg
->last_error
), cg
->last_status_message
));
1086 * '_cupsSetHTTPError()' - Set the last error using the HTTP status.
1090 _cupsSetHTTPError(http_status_t status
) /* I - HTTP status code */
1094 case HTTP_NOT_FOUND
:
1095 _cupsSetError(IPP_NOT_FOUND
, httpStatus(status
), 0);
1098 case HTTP_UNAUTHORIZED
:
1099 _cupsSetError(IPP_NOT_AUTHENTICATED
, httpStatus(status
), 0);
1102 case HTTP_AUTHORIZATION_CANCELED
:
1103 _cupsSetError(IPP_AUTHENTICATION_CANCELED
, httpStatus(status
), 0);
1106 case HTTP_FORBIDDEN
:
1107 _cupsSetError(IPP_FORBIDDEN
, httpStatus(status
), 0);
1110 case HTTP_BAD_REQUEST
:
1111 _cupsSetError(IPP_BAD_REQUEST
, httpStatus(status
), 0);
1114 case HTTP_REQUEST_TOO_LARGE
:
1115 _cupsSetError(IPP_REQUEST_VALUE
, httpStatus(status
), 0);
1118 case HTTP_NOT_IMPLEMENTED
:
1119 _cupsSetError(IPP_OPERATION_NOT_SUPPORTED
, httpStatus(status
), 0);
1122 case HTTP_NOT_SUPPORTED
:
1123 _cupsSetError(IPP_VERSION_NOT_SUPPORTED
, httpStatus(status
), 0);
1126 case HTTP_UPGRADE_REQUIRED
:
1127 _cupsSetError(IPP_UPGRADE_REQUIRED
, httpStatus(status
), 0);
1130 case HTTP_PKI_ERROR
:
1131 _cupsSetError(IPP_PKI_ERROR
, httpStatus(status
), 0);
1135 _cupsSetError(IPP_INTERNAL_ERROR
, strerror(errno
), 0);
1139 DEBUG_printf(("4_cupsSetHTTPError: HTTP error %d mapped to "
1140 "IPP_SERVICE_UNAVAILABLE!", status
));
1141 _cupsSetError(IPP_SERVICE_UNAVAILABLE
, httpStatus(status
), 0);
1148 * End of "$Id: request.c 7946 2008-09-16 23:27:54Z mike $".