4 * IPP utilities for CUPS.
6 * Copyright 2007-2014 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 * Include necessary headers...
22 #include "cups-private.h"
25 #if defined(WIN32) || defined(__EMX__)
29 #endif /* WIN32 || __EMX__ */
34 # define MSG_DONTWAIT 0
35 #endif /* !MSG_DONTWAIT */
39 * 'cupsDoFileRequest()' - Do an IPP request with a file.
41 * This function sends the IPP request and attached file to the specified
42 * server, retrying and authenticating as necessary. The request is freed with
46 ipp_t
* /* O - Response data */
47 cupsDoFileRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
48 ipp_t
*request
, /* I - IPP request */
49 const char *resource
, /* I - HTTP resource for POST */
50 const char *filename
) /* I - File to send or @code NULL@ for none */
52 ipp_t
*response
; /* IPP response data */
53 int infile
; /* Input file */
56 DEBUG_printf(("cupsDoFileRequest(http=%p, request=%p(%s), resource=\"%s\", "
57 "filename=\"%s\")", http
, request
,
58 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
63 if ((infile
= open(filename
, O_RDONLY
| O_BINARY
)) < 0)
66 * Can't get file information!
69 _cupsSetError(errno
== ENOENT
? IPP_STATUS_ERROR_NOT_FOUND
: IPP_STATUS_ERROR_NOT_AUTHORIZED
,
80 response
= cupsDoIORequest(http
, request
, resource
, infile
, -1);
90 * 'cupsDoIORequest()' - Do an IPP request with file descriptors.
92 * This function sends the IPP request with the optional input file "infile" to
93 * the specified server, retrying and authenticating as necessary. The request
94 * is freed with @link ippDelete@.
96 * If "infile" is a valid file descriptor, @code cupsDoIORequest@ copies
97 * all of the data from the file after the IPP request message.
99 * If "outfile" is a valid file descriptor, @code cupsDoIORequest@ copies
100 * all of the data after the IPP response message to the file.
102 * @since CUPS 1.3/OS X 10.5@
105 ipp_t
* /* O - Response data */
106 cupsDoIORequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
107 ipp_t
*request
, /* I - IPP request */
108 const char *resource
, /* I - HTTP resource for POST */
109 int infile
, /* I - File to read from or -1 for none */
110 int outfile
) /* I - File to write to or -1 for none */
112 ipp_t
*response
= NULL
; /* IPP response data */
113 size_t length
= 0; /* Content-Length value */
114 http_status_t status
; /* Status of HTTP request */
115 struct stat fileinfo
; /* File information */
116 ssize_t bytes
; /* Number of bytes read/written */
117 char buffer
[32768]; /* Output buffer */
120 DEBUG_printf(("cupsDoIORequest(http=%p, request=%p(%s), resource=\"%s\", "
121 "infile=%d, outfile=%d)", http
, request
,
122 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
123 resource
, infile
, outfile
));
126 * Range check input...
129 if (!request
|| !resource
)
133 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
139 * Get the default connection as needed...
143 if ((http
= _cupsConnect()) == NULL
)
151 * See if we have a file to send...
156 if (fstat(infile
, &fileinfo
))
159 * Can't get file information!
162 _cupsSetError(errno
== EBADF
? IPP_STATUS_ERROR_NOT_FOUND
: IPP_STATUS_ERROR_NOT_AUTHORIZED
,
171 if (fileinfo
.st_mode
& _S_IFDIR
)
173 if (S_ISDIR(fileinfo
.st_mode
))
177 * Can't send a directory...
182 _cupsSetError(IPP_STATUS_ERROR_NOT_POSSIBLE
, strerror(EISDIR
), 0);
188 if (!S_ISREG(fileinfo
.st_mode
))
189 length
= 0; /* Chunk when piping */
192 length
= ippLength(request
) + (size_t)fileinfo
.st_size
;
195 length
= ippLength(request
);
197 DEBUG_printf(("2cupsDoIORequest: Request length=%ld, total length=%ld",
198 (long)ippLength(request
), (long)length
));
201 * Clear any "Local" authentication data since it is probably stale...
204 if (http
->authstring
&& !strncmp(http
->authstring
, "Local ", 6))
205 httpSetAuthString(http
, NULL
, NULL
);
208 * Loop until we can send the request without authorization problems.
211 while (response
== NULL
)
213 DEBUG_puts("2cupsDoIORequest: setup...");
216 * Send the request...
219 status
= cupsSendRequest(http
, request
, resource
, length
);
221 DEBUG_printf(("2cupsDoIORequest: status=%d", status
));
223 if (status
== HTTP_STATUS_CONTINUE
&& request
->state
== IPP_STATE_DATA
&& infile
>= 0)
225 DEBUG_puts("2cupsDoIORequest: file write...");
228 * Send the file with the request...
232 if (S_ISREG(fileinfo
.st_mode
))
234 lseek(infile
, 0, SEEK_SET
);
236 while ((bytes
= read(infile
, buffer
, sizeof(buffer
))) > 0)
238 if ((status
= cupsWriteRequestData(http
, buffer
, (size_t)bytes
))
239 != HTTP_STATUS_CONTINUE
)
245 * Get the server's response...
248 if (status
<= HTTP_STATUS_CONTINUE
|| status
== HTTP_STATUS_OK
)
250 response
= cupsGetResponse(http
, resource
);
251 status
= httpGetStatus(http
);
254 DEBUG_printf(("2cupsDoIORequest: status=%d", status
));
256 if (status
== HTTP_STATUS_ERROR
||
257 (status
>= HTTP_STATUS_BAD_REQUEST
&& status
!= HTTP_STATUS_UNAUTHORIZED
&&
258 status
!= HTTP_STATUS_UPGRADE_REQUIRED
))
260 _cupsSetHTTPError(status
);
264 if (response
&& outfile
>= 0)
267 * Write trailing data to file...
270 while ((bytes
= httpRead2(http
, buffer
, sizeof(buffer
))) > 0)
271 if (write(outfile
, buffer
, (size_t)bytes
) < bytes
)
275 if (http
->state
!= HTTP_STATE_WAITING
)
278 * Flush any remaining data...
286 * Delete the original request and return the response...
296 * 'cupsDoRequest()' - Do an IPP request.
298 * This function sends the IPP request to the specified server, retrying
299 * and authenticating as necessary. The request is freed with @link ippDelete@.
302 ipp_t
* /* O - Response data */
303 cupsDoRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
304 ipp_t
*request
, /* I - IPP request */
305 const char *resource
) /* I - HTTP resource for POST */
307 DEBUG_printf(("cupsDoRequest(http=%p, request=%p(%s), resource=\"%s\")",
309 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
312 return (cupsDoIORequest(http
, request
, resource
, -1, -1));
317 * 'cupsGetResponse()' - Get a response to an IPP request.
319 * Use this function to get the response for an IPP request sent using
320 * @link cupsSendRequest@. For requests that return additional data, use
321 * @link cupsReadResponseData@ after getting a successful response,
322 * otherwise call @link httpFlush@ to complete the response processing.
324 * @since CUPS 1.4/OS X 10.6@
327 ipp_t
* /* O - Response or @code NULL@ on HTTP error */
328 cupsGetResponse(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
329 const char *resource
) /* I - HTTP resource for POST */
331 http_status_t status
; /* HTTP status */
332 ipp_state_t state
; /* IPP read state */
333 ipp_t
*response
= NULL
; /* IPP response */
336 DEBUG_printf(("cupsGetResponse(http=%p, resource=\"%s\")", http
, resource
));
339 * Connect to the default server as needed...
343 http
= _cupsConnect();
345 if (!http
|| (http
->state
!= HTTP_STATE_POST_RECV
&&
346 http
->state
!= HTTP_STATE_POST_SEND
))
350 * Check for an unfinished chunked request...
353 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
356 * Send a 0-length chunk to finish off the request...
359 DEBUG_puts("2cupsGetResponse: Finishing chunked POST...");
361 if (httpWrite2(http
, "", 0) < 0)
366 * Wait for a response from the server...
369 DEBUG_printf(("2cupsGetResponse: Update loop, http->status=%d...",
374 status
= httpUpdate(http
);
376 while (status
== HTTP_STATUS_CONTINUE
);
378 DEBUG_printf(("2cupsGetResponse: status=%d", status
));
380 if (status
== HTTP_STATUS_OK
)
383 * Get the IPP response...
388 while ((state
= ippRead(http
, response
)) != IPP_STATE_DATA
)
389 if (state
== IPP_STATE_ERROR
)
392 if (state
== IPP_STATE_ERROR
)
395 * Flush remaining data and delete the response...
398 DEBUG_puts("1cupsGetResponse: IPP read error!");
405 http
->status
= status
= HTTP_STATUS_ERROR
;
406 http
->error
= EINVAL
;
409 else if (status
!= HTTP_STATUS_ERROR
)
412 * Flush any error message...
418 * Then handle encryption and authentication...
421 if (status
== HTTP_STATUS_UNAUTHORIZED
)
424 * See if we can do authentication...
427 DEBUG_puts("2cupsGetResponse: Need authorization...");
429 if (!cupsDoAuthentication(http
, "POST", resource
))
430 httpReconnect2(http
, 30000, NULL
);
432 http
->status
= status
= HTTP_STATUS_CUPS_AUTHORIZATION_CANCELED
;
436 else if (status
== HTTP_STATUS_UPGRADE_REQUIRED
)
439 * Force a reconnect with encryption...
442 DEBUG_puts("2cupsGetResponse: Need encryption...");
444 if (!httpReconnect2(http
, 30000, NULL
))
445 httpEncryption(http
, HTTP_ENCRYPTION_REQUIRED
);
447 #endif /* HAVE_SSL */
452 ipp_attribute_t
*attr
; /* status-message attribute */
455 attr
= ippFindAttribute(response
, "status-message", IPP_TAG_TEXT
);
457 DEBUG_printf(("1cupsGetResponse: status-code=%s, status-message=\"%s\"",
458 ippErrorString(response
->request
.status
.status_code
),
459 attr
? attr
->values
[0].string
.text
: ""));
461 _cupsSetError(response
->request
.status
.status_code
,
462 attr
? attr
->values
[0].string
.text
:
463 ippErrorString(response
->request
.status
.status_code
), 0);
471 * 'cupsLastError()' - Return the last IPP status code received on the current
475 ipp_status_t
/* O - IPP status code from last request */
478 return (_cupsGlobals()->last_error
);
483 * 'cupsLastErrorString()' - Return the last IPP status-message received on the
486 * @since CUPS 1.2/OS X 10.5@
489 const char * /* O - status-message text from last request */
490 cupsLastErrorString(void)
492 return (_cupsGlobals()->last_status_message
);
497 * '_cupsNextDelay()' - Return the next retry delay value.
499 * This function currently returns the Fibonacci sequence 1 1 2 3 5 8.
501 * Pass 0 for the current delay value to initialize the sequence.
504 int /* O - Next delay value */
505 _cupsNextDelay(int current
, /* I - Current delay value or 0 */
506 int *previous
) /* IO - Previous delay value */
508 int next
; /* Next delay value */
513 next
= (current
+ *previous
) % 12;
514 *previous
= next
< current
? 0 : current
;
527 * 'cupsReadResponseData()' - Read additional data after the IPP response.
529 * This function is used after @link cupsGetResponse@ to read the PPD or document
530 * files from @code CUPS_GET_PPD@ and @code CUPS_GET_DOCUMENT@ requests,
533 * @since CUPS 1.4/OS X 10.6@
536 ssize_t
/* O - Bytes read, 0 on EOF, -1 on error */
537 cupsReadResponseData(
538 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
539 char *buffer
, /* I - Buffer to use */
540 size_t length
) /* I - Number of bytes to read */
543 * Get the default connection as needed...
546 DEBUG_printf(("cupsReadResponseData(http=%p, buffer=%p, "
547 "length=" CUPS_LLFMT
")", http
, buffer
, CUPS_LLCAST length
));
551 _cups_globals_t
*cg
= _cupsGlobals();
552 /* Pointer to library globals */
554 if ((http
= cg
->http
) == NULL
)
556 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No active connection"), 1);
562 * Then read from the HTTP connection...
565 return (httpRead2(http
, buffer
, length
));
570 * 'cupsSendRequest()' - Send an IPP request.
572 * Use @link cupsWriteRequestData@ to write any additional data (document, PPD
573 * file, etc.) for the request, @link cupsGetResponse@ to get the IPP response,
574 * and @link cupsReadResponseData@ to read any additional data following the
575 * response. Only one request can be sent/queued at a time per @code http_t@
578 * Returns the initial HTTP status code, which will be @code HTTP_STATUS_CONTINUE@
579 * on a successful send of the request.
581 * Note: Unlike @link cupsDoFileRequest@, @link cupsDoIORequest@, and
582 * @link cupsDoRequest@, the request is NOT freed with @link ippDelete@.
584 * @since CUPS 1.4/OS X 10.6@
587 http_status_t
/* O - Initial HTTP status */
588 cupsSendRequest(http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
589 ipp_t
*request
, /* I - IPP request */
590 const char *resource
, /* I - Resource path */
591 size_t length
) /* I - Length of data to follow or @code CUPS_LENGTH_VARIABLE@ */
593 http_status_t status
; /* Status of HTTP request */
594 int got_status
; /* Did we get the status? */
595 ipp_state_t state
; /* State of IPP processing */
596 http_status_t expect
; /* Expect: header to use */
599 DEBUG_printf(("cupsSendRequest(http=%p, request=%p(%s), resource=\"%s\", "
600 "length=" CUPS_LLFMT
")", http
, request
,
601 request
? ippOpString(request
->request
.op
.operation_id
) : "?",
602 resource
, CUPS_LLCAST length
));
605 * Range check input...
608 if (!request
|| !resource
)
610 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
612 return (HTTP_STATUS_ERROR
);
616 * Get the default connection as needed...
620 if ((http
= _cupsConnect()) == NULL
)
621 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
624 * If the prior request was not flushed out, do so now...
627 if (http
->state
== HTTP_STATE_GET_SEND
||
628 http
->state
== HTTP_STATE_POST_SEND
)
630 DEBUG_puts("2cupsSendRequest: Flush prior response.");
633 else if (http
->state
!= HTTP_STATE_WAITING
)
635 DEBUG_printf(("1cupsSendRequest: Unknown HTTP state (%d), "
636 "reconnecting.", http
->state
));
637 if (httpReconnect2(http
, 30000, NULL
))
638 return (HTTP_STATUS_ERROR
);
643 * See if we have an auth-info attribute and are communicating over
644 * a non-local link. If so, encrypt the link so that we can pass
645 * the authentication information securely...
648 if (ippFindAttribute(request
, "auth-info", IPP_TAG_TEXT
) &&
649 !httpAddrLocalhost(http
->hostaddr
) && !http
->tls
&&
650 httpEncryption(http
, HTTP_ENCRYPTION_REQUIRED
))
652 DEBUG_puts("1cupsSendRequest: Unable to encrypt connection.");
653 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
655 #endif /* HAVE_SSL */
658 * Reconnect if the last response had a "Connection: close"...
661 if (!_cups_strcasecmp(http
->fields
[HTTP_FIELD_CONNECTION
], "close"))
663 DEBUG_puts("2cupsSendRequest: Connection: close");
664 httpClearFields(http
);
665 if (httpReconnect2(http
, 30000, NULL
))
667 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
668 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
673 * Loop until we can send the request without authorization problems.
676 expect
= HTTP_STATUS_CONTINUE
;
680 DEBUG_puts("2cupsSendRequest: Setup...");
683 * Setup the HTTP variables needed...
686 httpClearFields(http
);
687 httpSetExpect(http
, expect
);
688 httpSetField(http
, HTTP_FIELD_CONTENT_TYPE
, "application/ipp");
689 httpSetLength(http
, length
);
692 if (http
->authstring
&& !strncmp(http
->authstring
, "Negotiate", 9))
695 * Do not use cached Kerberos credentials since they will look like a
699 _cupsSetNegotiateAuthString(http
, "POST", resource
);
701 #endif /* HAVE_GSSAPI */
703 httpSetField(http
, HTTP_FIELD_AUTHORIZATION
, http
->authstring
);
705 DEBUG_printf(("2cupsSendRequest: authstring=\"%s\"", http
->authstring
));
711 DEBUG_puts("2cupsSendRequest: Sending HTTP POST...");
713 if (httpPost(http
, resource
))
715 DEBUG_puts("2cupsSendRequest: POST failed, reconnecting.");
716 if (httpReconnect2(http
, 30000, NULL
))
718 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
719 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
726 * Send the IPP data...
729 DEBUG_puts("2cupsSendRequest: Writing IPP request...");
731 request
->state
= IPP_STATE_IDLE
;
732 status
= HTTP_STATUS_CONTINUE
;
735 while ((state
= ippWrite(http
, request
)) != IPP_STATE_DATA
)
736 if (state
== IPP_STATE_ERROR
)
738 else if (httpCheck(http
))
742 _httpUpdate(http
, &status
);
743 if (status
>= HTTP_STATUS_MULTIPLE_CHOICES
)
747 if (state
== IPP_STATE_ERROR
)
749 DEBUG_puts("1cupsSendRequest: Unable to send IPP request.");
751 http
->status
= HTTP_STATUS_ERROR
;
752 http
->state
= HTTP_STATE_WAITING
;
754 return (HTTP_STATUS_ERROR
);
758 * Wait up to 1 second to get the 100-continue response as needed...
763 if (expect
== HTTP_STATUS_CONTINUE
)
765 DEBUG_puts("2cupsSendRequest: Waiting for 100-continue...");
767 if (httpWait(http
, 1000))
768 _httpUpdate(http
, &status
);
770 else if (httpCheck(http
))
771 _httpUpdate(http
, &status
);
774 DEBUG_printf(("2cupsSendRequest: status=%d", status
));
777 * Process the current HTTP status...
780 if (status
>= HTTP_STATUS_MULTIPLE_CHOICES
)
782 int temp_status
; /* Temporary status */
784 _cupsSetHTTPError(status
);
788 temp_status
= httpUpdate(http
);
790 while (temp_status
!= HTTP_STATUS_ERROR
&&
791 http
->state
== HTTP_STATE_POST_RECV
);
798 case HTTP_STATUS_CONTINUE
:
799 case HTTP_STATUS_OK
:
800 case HTTP_STATUS_ERROR
:
801 DEBUG_printf(("1cupsSendRequest: Returning %d.", status
));
804 case HTTP_STATUS_UNAUTHORIZED
:
805 if (cupsDoAuthentication(http
, "POST", resource
))
807 DEBUG_puts("1cupsSendRequest: Returning HTTP_STATUS_CUPS_AUTHORIZATION_CANCELED.");
808 return (HTTP_STATUS_CUPS_AUTHORIZATION_CANCELED
);
811 DEBUG_puts("2cupsSendRequest: Reconnecting after HTTP_STATUS_UNAUTHORIZED.");
813 if (httpReconnect2(http
, 30000, NULL
))
815 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
816 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
821 case HTTP_STATUS_UPGRADE_REQUIRED
:
823 * Flush any error message, reconnect, and then upgrade with
827 DEBUG_puts("2cupsSendRequest: Reconnecting after "
828 "HTTP_STATUS_UPGRADE_REQUIRED.");
830 if (httpReconnect2(http
, 30000, NULL
))
832 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
833 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
836 DEBUG_puts("2cupsSendRequest: Upgrading to TLS.");
837 if (httpEncryption(http
, HTTP_ENCRYPTION_REQUIRED
))
839 DEBUG_puts("1cupsSendRequest: Unable to encrypt connection.");
840 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
843 #endif /* HAVE_SSL */
845 case HTTP_STATUS_EXPECTATION_FAILED
:
847 * Don't try using the Expect: header the next time around...
850 expect
= (http_status_t
)0;
852 DEBUG_puts("2cupsSendRequest: Reconnecting after "
853 "HTTP_EXPECTATION_FAILED.");
855 if (httpReconnect2(http
, 30000, NULL
))
857 DEBUG_puts("1cupsSendRequest: Unable to reconnect.");
858 return (HTTP_STATUS_SERVICE_UNAVAILABLE
);
864 * Some other error...
874 * 'cupsWriteRequestData()' - Write additional data after an IPP request.
876 * This function is used after @link cupsSendRequest@ to provide a PPD and
877 * after @link cupsStartDocument@ to provide a document file.
879 * @since CUPS 1.4/OS X 10.6@
882 http_status_t
/* O - @code HTTP_STATUS_CONTINUE@ if OK or HTTP status on error */
883 cupsWriteRequestData(
884 http_t
*http
, /* I - Connection to server or @code CUPS_HTTP_DEFAULT@ */
885 const char *buffer
, /* I - Bytes to write */
886 size_t length
) /* I - Number of bytes to write */
888 int wused
; /* Previous bytes in buffer */
892 * Get the default connection as needed...
895 DEBUG_printf(("cupsWriteRequestData(http=%p, buffer=%p, "
896 "length=" CUPS_LLFMT
")", http
, buffer
, CUPS_LLCAST length
));
900 _cups_globals_t
*cg
= _cupsGlobals();
901 /* Pointer to library globals */
903 if ((http
= cg
->http
) == NULL
)
905 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No active connection"), 1);
906 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_STATUS_ERROR.");
907 return (HTTP_STATUS_ERROR
);
912 * Then write to the HTTP connection...
917 if (httpWrite2(http
, buffer
, length
) < 0)
919 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_STATUS_ERROR.");
920 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(http
->error
), 0);
921 return (HTTP_STATUS_ERROR
);
925 * Finally, check if we have any pending data from the server...
928 if (length
>= HTTP_MAX_BUFFER
||
929 http
->wused
< wused
||
930 (wused
> 0 && (size_t)http
->wused
== length
))
933 * We've written something to the server, so check for response data...
936 if (_httpWait(http
, 0, 1))
938 http_status_t status
; /* Status from _httpUpdate */
940 _httpUpdate(http
, &status
);
941 if (status
>= HTTP_STATUS_MULTIPLE_CHOICES
)
943 _cupsSetHTTPError(status
);
947 status
= httpUpdate(http
);
949 while (status
!= HTTP_STATUS_ERROR
&& http
->state
== HTTP_STATE_POST_RECV
);
954 DEBUG_printf(("1cupsWriteRequestData: Returning %d.\n", status
));
959 DEBUG_puts("1cupsWriteRequestData: Returning HTTP_STATUS_CONTINUE.");
960 return (HTTP_STATUS_CONTINUE
);
965 * '_cupsConnect()' - Get the default server connection...
968 http_t
* /* O - HTTP connection */
971 _cups_globals_t
*cg
= _cupsGlobals(); /* Pointer to library globals */
975 * See if we are connected to the same server...
981 * Compare the connection hostname, port, and encryption settings to
982 * the cached defaults; these were initialized the first time we
986 if (strcmp(cg
->http
->hostname
, cg
->server
) ||
987 cg
->ipp_port
!= httpAddrPort(cg
->http
->hostaddr
) ||
988 (cg
->http
->encryption
!= cg
->encryption
&&
989 cg
->http
->encryption
== HTTP_ENCRYPTION_NEVER
))
992 * Need to close the current connection because something has changed...
1001 * Same server, see if the connection is still established...
1004 char ch
; /* Connection check byte */
1005 ssize_t n
; /* Number of bytes */
1008 if ((n
= recv(cg
->http
->fd
, &ch
, 1, MSG_PEEK
)) == 0 ||
1009 (n
< 0 && WSAGetLastError() != WSAEWOULDBLOCK
))
1011 if ((n
= recv(cg
->http
->fd
, &ch
, 1, MSG_PEEK
| MSG_DONTWAIT
)) == 0 ||
1012 (n
< 0 && errno
!= EWOULDBLOCK
))
1016 * Nope, close the connection...
1019 httpClose(cg
->http
);
1026 * (Re)connect as needed...
1031 if ((cg
->http
= httpConnect2(cupsServer(), ippPort(), NULL
, AF_UNSPEC
,
1032 cupsEncryption(), 1, 30000, NULL
)) == NULL
)
1035 _cupsSetError(IPP_STATUS_ERROR_SERVICE_UNAVAILABLE
, NULL
, 0);
1037 _cupsSetError(IPP_STATUS_ERROR_SERVICE_UNAVAILABLE
,
1038 _("Unable to connect to host."), 1);
1043 * Return the cached connection...
1051 * '_cupsSetError()' - Set the last IPP status code and status-message.
1055 _cupsSetError(ipp_status_t status
, /* I - IPP status code */
1056 const char *message
, /* I - status-message value */
1057 int localize
) /* I - Localize the message? */
1059 _cups_globals_t
*cg
; /* Global data */
1062 if (!message
&& errno
)
1064 message
= strerror(errno
);
1068 cg
= _cupsGlobals();
1069 cg
->last_error
= status
;
1071 if (cg
->last_status_message
)
1073 _cupsStrFree(cg
->last_status_message
);
1075 cg
->last_status_message
= NULL
;
1083 * Get the message catalog...
1086 if (!cg
->lang_default
)
1087 cg
->lang_default
= cupsLangDefault();
1089 cg
->last_status_message
= _cupsStrAlloc(_cupsLangString(cg
->lang_default
,
1093 cg
->last_status_message
= _cupsStrAlloc(message
);
1096 DEBUG_printf(("4_cupsSetError: last_error=%s, last_status_message=\"%s\"",
1097 ippErrorString(cg
->last_error
), cg
->last_status_message
));
1102 * '_cupsSetHTTPError()' - Set the last error using the HTTP status.
1106 _cupsSetHTTPError(http_status_t status
) /* I - HTTP status code */
1110 case HTTP_STATUS_NOT_FOUND
:
1111 _cupsSetError(IPP_STATUS_ERROR_NOT_FOUND
, httpStatus(status
), 0);
1114 case HTTP_STATUS_UNAUTHORIZED
:
1115 _cupsSetError(IPP_STATUS_ERROR_NOT_AUTHENTICATED
, httpStatus(status
), 0);
1118 case HTTP_STATUS_CUPS_AUTHORIZATION_CANCELED
:
1119 _cupsSetError(IPP_STATUS_ERROR_CUPS_AUTHENTICATION_CANCELED
, httpStatus(status
), 0);
1122 case HTTP_STATUS_FORBIDDEN
:
1123 _cupsSetError(IPP_STATUS_ERROR_FORBIDDEN
, httpStatus(status
), 0);
1126 case HTTP_STATUS_BAD_REQUEST
:
1127 _cupsSetError(IPP_STATUS_ERROR_BAD_REQUEST
, httpStatus(status
), 0);
1130 case HTTP_STATUS_REQUEST_TOO_LARGE
:
1131 _cupsSetError(IPP_STATUS_ERROR_REQUEST_VALUE
, httpStatus(status
), 0);
1134 case HTTP_STATUS_NOT_IMPLEMENTED
:
1135 _cupsSetError(IPP_STATUS_ERROR_OPERATION_NOT_SUPPORTED
, httpStatus(status
), 0);
1138 case HTTP_STATUS_NOT_SUPPORTED
:
1139 _cupsSetError(IPP_STATUS_ERROR_VERSION_NOT_SUPPORTED
, httpStatus(status
), 0);
1142 case HTTP_STATUS_UPGRADE_REQUIRED
:
1143 _cupsSetError(IPP_STATUS_ERROR_CUPS_UPGRADE_REQUIRED
, httpStatus(status
), 0);
1146 case HTTP_STATUS_CUPS_PKI_ERROR
:
1147 _cupsSetError(IPP_STATUS_ERROR_CUPS_PKI
, httpStatus(status
), 0);
1150 case HTTP_STATUS_ERROR
:
1151 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(errno
), 0);
1155 DEBUG_printf(("4_cupsSetHTTPError: HTTP error %d mapped to "
1156 "IPP_STATUS_ERROR_SERVICE_UNAVAILABLE!", status
));
1157 _cupsSetError(IPP_STATUS_ERROR_SERVICE_UNAVAILABLE
, httpStatus(status
), 0);