4 * HTTP routines for CUPS.
6 * Copyright 2007-2014 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
9 * This file contains Kerberos support code, copyright 2006 by
12 * These coded instructions, statements, and computer programs are the
13 * property of Apple Inc. and are protected by Federal copyright
14 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
15 * which should have been included with this file. If this file is
16 * file is missing or damaged, see the license at "http://www.cups.org/".
18 * This file is subject to the Apple OS-Developed Software exception.
22 * Include necessary headers...
25 #include "cups-private.h"
32 # include <sys/time.h>
33 # include <sys/resource.h>
37 #endif /* HAVE_POLL */
45 static void http_content_coding_finish(http_t
*http
);
46 static void http_content_coding_start(http_t
*http
,
48 #endif /* HAVE_LIBZ */
49 static http_t
*http_create(const char *host
, int port
,
50 http_addrlist_t
*addrlist
, int family
,
51 http_encryption_t encryption
,
52 int blocking
, _http_mode_t mode
);
54 static void http_debug_hex(const char *prefix
, const char *buffer
,
57 static ssize_t
http_read(http_t
*http
, char *buffer
, size_t length
);
58 static ssize_t
http_read_buffered(http_t
*http
, char *buffer
, size_t length
);
59 static ssize_t
http_read_chunk(http_t
*http
, char *buffer
, size_t length
);
60 static int http_send(http_t
*http
, http_state_t request
,
62 static ssize_t
http_write(http_t
*http
, const char *buffer
,
64 static ssize_t
http_write_chunk(http_t
*http
, const char *buffer
,
66 static off_t
http_set_length(http_t
*http
);
67 static void http_set_timeout(int fd
, double timeout
);
68 static void http_set_wait(http_t
*http
);
71 static size_t http_tls_pending(http_t
*http
);
72 static int http_tls_read(http_t
*http
, char *buf
, int len
);
73 static int http_tls_set_credentials(http_t
*http
);
74 static int http_tls_start(http_t
*http
);
75 static void http_tls_stop(http_t
*http
);
76 static int http_tls_upgrade(http_t
*http
);
77 static int http_tls_write(http_t
*http
, const char *buf
, int len
);
79 # include "tls-gnutls.c"
80 # elif defined(HAVE_CDSASSL)
81 # include "tls-darwin.c"
83 # include "tls-sspi.c"
84 # endif /* HAVE_GNUTLS */
92 static const char * const http_fields
[] =
109 "If-Unmodified-since",
128 * 'httpAcceptConnection()' - Accept a new HTTP client connection from the
129 * specified listening socket.
131 * @since CUPS 1.7/OS X 10.9@
134 http_t
* /* O - HTTP connection or @code NULL@ */
135 httpAcceptConnection(int fd
, /* I - Listen socket file descriptor */
136 int blocking
) /* I - 1 if the connection should be
137 blocking, 0 otherwise */
139 http_t
*http
; /* HTTP connection */
140 http_addrlist_t addrlist
; /* Dummy address list */
141 socklen_t addrlen
; /* Length of address */
142 int val
; /* Socket option value */
146 * Range check input...
153 * Create the client connection...
156 memset(&addrlist
, 0, sizeof(addrlist
));
158 if ((http
= http_create(NULL
, 0, &addrlist
, AF_UNSPEC
,
159 HTTP_ENCRYPTION_IF_REQUESTED
, blocking
,
160 _HTTP_MODE_SERVER
)) == NULL
)
164 * Accept the client and get the remote address...
167 addrlen
= sizeof(http_addr_t
);
169 if ((http
->fd
= accept(fd
, (struct sockaddr
*)&(http
->addrlist
->addr
),
172 _cupsSetHTTPError(HTTP_STATUS_ERROR
);
178 http
->hostaddr
= &(http
->addrlist
->addr
);
180 if (httpAddrLocalhost(http
->hostaddr
))
181 strlcpy(http
->hostname
, "localhost", sizeof(http
->hostname
));
183 httpAddrString(http
->hostaddr
, http
->hostname
, sizeof(http
->hostname
));
187 * Disable SIGPIPE for this socket.
191 setsockopt(http
->fd
, SOL_SOCKET
, SO_NOSIGPIPE
, CUPS_SOCAST
&val
, sizeof(val
));
192 #endif /* SO_NOSIGPIPE */
195 * Using TCP_NODELAY improves responsiveness, especially on systems
196 * with a slow loopback interface. Since we write large buffers
197 * when sending print files and requests, there shouldn't be any
198 * performance penalty for this...
202 setsockopt(http
->fd
, IPPROTO_TCP
, TCP_NODELAY
, CUPS_SOCAST
&val
, sizeof(val
));
206 * Close this socket when starting another process...
209 fcntl(http
->fd
, F_SETFD
, FD_CLOEXEC
);
210 #endif /* FD_CLOEXEC */
217 * 'httpAddCredential()' - Allocates and adds a single credential to an array.
219 * Use @code cupsArrayNew(NULL, NULL)@ to create a credentials array.
221 * @since CUPS 1.5/OS X 10.7@
224 int /* O - 0 on success, -1 on error */
226 cups_array_t
*credentials
, /* I - Credentials array */
227 const void *data
, /* I - PEM-encoded X.509 data */
228 size_t datalen
) /* I - Length of data */
230 http_credential_t
*credential
; /* Credential data */
233 if ((credential
= malloc(sizeof(http_credential_t
))) != NULL
)
235 credential
->datalen
= datalen
;
237 if ((credential
->data
= malloc(datalen
)) != NULL
)
239 memcpy(credential
->data
, data
, datalen
);
240 cupsArrayAdd(credentials
, credential
);
252 * 'httpBlocking()' - Set blocking/non-blocking behavior on a connection.
256 httpBlocking(http_t
*http
, /* I - HTTP connection */
257 int b
) /* I - 1 = blocking, 0 = non-blocking */
268 * 'httpCheck()' - Check to see if there is a pending response from the server.
271 int /* O - 0 = no data, 1 = data available */
272 httpCheck(http_t
*http
) /* I - HTTP connection */
274 return (httpWait(http
, 0));
279 * 'httpClearCookie()' - Clear the cookie value(s).
281 * @since CUPS 1.1.19/OS X 10.3@
285 httpClearCookie(http_t
*http
) /* I - HTTP connection */
299 * 'httpClearFields()' - Clear HTTP request fields.
303 httpClearFields(http_t
*http
) /* I - HTTP connection */
305 DEBUG_printf(("httpClearFields(http=%p)", http
));
309 memset(http
->fields
, 0, sizeof(http
->fields
));
311 if (http
->mode
== _HTTP_MODE_CLIENT
)
313 if (http
->hostname
[0] == '/')
314 httpSetField(http
, HTTP_FIELD_HOST
, "localhost");
316 httpSetField(http
, HTTP_FIELD_HOST
, http
->hostname
);
319 if (http
->field_authorization
)
321 free(http
->field_authorization
);
322 http
->field_authorization
= NULL
;
325 if (http
->accept_encoding
)
327 _cupsStrFree(http
->accept_encoding
);
328 http
->accept_encoding
= NULL
;
333 _cupsStrFree(http
->allow
);
339 _cupsStrFree(http
->server
);
343 http
->expect
= (http_status_t
)0;
349 * 'httpClose()' - Close an HTTP connection.
353 httpClose(http_t
*http
) /* I - HTTP connection */
356 OM_uint32 minor_status
; /* Minor status code */
357 #endif /* HAVE_GSSAPI */
360 DEBUG_printf(("httpClose(http=%p)", http
));
363 * Range check input...
370 * Close any open connection...
373 _httpDisconnect(http
);
376 * Free memory used...
379 httpAddrFreeList(http
->addrlist
);
385 if (http
->gssctx
!= GSS_C_NO_CONTEXT
)
386 gss_delete_sec_context(&minor_status
, &http
->gssctx
, GSS_C_NO_BUFFER
);
388 if (http
->gssname
!= GSS_C_NO_NAME
)
389 gss_release_name(&minor_status
, &http
->gssname
);
390 #endif /* HAVE_GSSAPI */
392 #ifdef HAVE_AUTHORIZATION_H
394 AuthorizationFree(http
->auth_ref
, kAuthorizationFlagDefaults
);
395 #endif /* HAVE_AUTHORIZATION_H */
397 httpClearFields(http
);
399 if (http
->authstring
&& http
->authstring
!= http
->_authstring
)
400 free(http
->authstring
);
407 * 'httpCompareCredentials()' - Compare two sets of X.509 credentials.
412 int /* O - 1 if they match, 0 if they do not */
413 httpCompareCredentials(
414 cups_array_t
*cred1
, /* I - First set of X.509 credentials */
415 cups_array_t
*cred2
) /* I - Second set of X.509 credentials */
417 http_credential_t
*temp1
, *temp2
; /* Temporary credentials */
420 for (temp1
= (http_credential_t
*)cupsArrayFirst(cred1
), temp2
= (http_credential_t
*)cupsArrayFirst(cred2
); temp1
&& temp2
; temp1
= (http_credential_t
*)cupsArrayNext(cred1
), temp2
= (http_credential_t
*)cupsArrayNext(cred2
))
421 if (temp1
->datalen
!= temp2
->datalen
)
423 else if (memcmp(temp1
->data
, temp2
->data
, temp1
->datalen
))
426 return (temp1
== temp2
);
431 * 'httpConnect()' - Connect to a HTTP server.
433 * This function is deprecated - use @link httpConnect2@ instead.
438 http_t
* /* O - New HTTP connection */
439 httpConnect(const char *host
, /* I - Host to connect to */
440 int port
) /* I - Port number */
442 return (httpConnect2(host
, port
, NULL
, AF_UNSPEC
,
443 HTTP_ENCRYPTION_IF_REQUESTED
, 1, 30000, NULL
));
448 * 'httpConnect2()' - Connect to a HTTP server.
450 * @since CUPS 1.7/OS X 10.9@
453 http_t
* /* O - New HTTP connection */
455 const char *host
, /* I - Host to connect to */
456 int port
, /* I - Port number */
457 http_addrlist_t
*addrlist
, /* I - List of addresses or NULL to lookup */
458 int family
, /* I - Address family to use or @code AF_UNSPEC@ for any */
459 http_encryption_t encryption
, /* I - Type of encryption to use */
460 int blocking
, /* I - 1 for blocking connection, 0 for non-blocking */
461 int msec
, /* I - Connection timeout in milliseconds, 0 means don't connect */
462 int *cancel
) /* I - Pointer to "cancel" variable */
464 http_t
*http
; /* New HTTP connection */
467 DEBUG_printf(("httpConnect2(host=\"%s\", port=%d, addrlist=%p, family=%d, "
468 "encryption=%d, blocking=%d, msec=%d, cancel=%p)", host
, port
,
469 addrlist
, family
, encryption
, blocking
, msec
, cancel
));
472 * Create the HTTP structure...
475 if ((http
= http_create(host
, port
, addrlist
, family
, encryption
, blocking
,
476 _HTTP_MODE_CLIENT
)) == NULL
)
480 * Optionally connect to the remote system...
483 if (msec
== 0 || !httpReconnect2(http
, msec
, cancel
))
487 * Could not connect to any known address - bail out!
497 * 'httpConnectEncrypt()' - Connect to a HTTP server using encryption.
499 * This function is now deprecated. Please use the @link httpConnect2@ function
505 http_t
* /* O - New HTTP connection */
507 const char *host
, /* I - Host to connect to */
508 int port
, /* I - Port number */
509 http_encryption_t encryption
) /* I - Type of encryption to use */
511 DEBUG_printf(("httpConnectEncrypt(host=\"%s\", port=%d, encryption=%d)",
512 host
, port
, encryption
));
514 return (httpConnect2(host
, port
, NULL
, AF_UNSPEC
, encryption
, 1, 30000,
520 * 'httpDelete()' - Send a DELETE request to the server.
523 int /* O - Status of call (0 = success) */
524 httpDelete(http_t
*http
, /* I - HTTP connection */
525 const char *uri
) /* I - URI to delete */
527 return (http_send(http
, HTTP_STATE_DELETE
, uri
));
532 * '_httpDisconnect()' - Disconnect a HTTP connection.
536 _httpDisconnect(http_t
*http
) /* I - HTTP connection */
541 #endif /* HAVE_SSL */
543 httpAddrClose(NULL
, http
->fd
);
550 * 'httpEncryption()' - Set the required encryption on the link.
553 int /* O - -1 on error, 0 on success */
554 httpEncryption(http_t
*http
, /* I - HTTP connection */
555 http_encryption_t e
) /* I - New encryption preference */
557 DEBUG_printf(("httpEncryption(http=%p, e=%d)", http
, e
));
563 if (http
->mode
== _HTTP_MODE_CLIENT
)
565 http
->encryption
= e
;
567 if ((http
->encryption
== HTTP_ENCRYPTION_ALWAYS
&& !http
->tls
) ||
568 (http
->encryption
== HTTP_ENCRYPTION_NEVER
&& http
->tls
))
569 return (httpReconnect2(http
, 30000, NULL
));
570 else if (http
->encryption
== HTTP_ENCRYPTION_REQUIRED
&& !http
->tls
)
571 return (http_tls_upgrade(http
));
577 if (e
== HTTP_ENCRYPTION_NEVER
&& http
->tls
)
580 http
->encryption
= e
;
581 if (e
!= HTTP_ENCRYPTION_IF_REQUESTED
&& !http
->tls
)
582 return (http_tls_start(http
));
587 if (e
== HTTP_ENCRYPTION_ALWAYS
|| e
== HTTP_ENCRYPTION_REQUIRED
)
591 #endif /* HAVE_SSL */
596 * 'httpError()' - Get the last error on a connection.
599 int /* O - Error code (errno) value */
600 httpError(http_t
*http
) /* I - HTTP connection */
603 return (http
->error
);
610 * 'httpFieldValue()' - Return the HTTP field enumeration value for a field
614 http_field_t
/* O - Field index */
615 httpFieldValue(const char *name
) /* I - String name */
617 int i
; /* Looping var */
620 for (i
= 0; i
< HTTP_FIELD_MAX
; i
++)
621 if (!_cups_strcasecmp(name
, http_fields
[i
]))
622 return ((http_field_t
)i
);
624 return (HTTP_FIELD_UNKNOWN
);
629 * 'httpFlush()' - Flush data from a HTTP connection.
633 httpFlush(http_t
*http
) /* I - HTTP connection */
635 char buffer
[8192]; /* Junk buffer */
636 int blocking
; /* To block or not to block */
637 http_state_t oldstate
; /* Old state */
640 DEBUG_printf(("httpFlush(http=%p), state=%s", http
,
641 httpStateString(http
->state
)));
644 * Nothing to do if we are in the "waiting" state...
647 if (http
->state
== HTTP_STATE_WAITING
)
651 * Temporarily set non-blocking mode so we don't get stuck in httpRead()...
654 blocking
= http
->blocking
;
658 * Read any data we can...
661 oldstate
= http
->state
;
662 while (httpRead2(http
, buffer
, sizeof(buffer
)) > 0);
665 * Restore blocking and reset the connection if we didn't get all of
666 * the remaining data...
669 http
->blocking
= blocking
;
671 if (http
->state
== oldstate
&& http
->state
!= HTTP_STATE_WAITING
&&
675 * Didn't get the data back, so close the current connection.
680 http_content_coding_finish(http
);
681 #endif /* HAVE_LIBZ */
683 DEBUG_puts("1httpFlush: Setting state to HTTP_STATE_WAITING and closing.");
685 http
->state
= HTTP_STATE_WAITING
;
690 #endif /* HAVE_SSL */
692 httpAddrClose(NULL
, http
->fd
);
700 * 'httpFlushWrite()' - Flush data in write buffer.
702 * @since CUPS 1.2/OS X 10.5@
705 int /* O - Bytes written or -1 on error */
706 httpFlushWrite(http_t
*http
) /* I - HTTP connection */
708 ssize_t bytes
; /* Bytes written */
711 DEBUG_printf(("httpFlushWrite(http=%p) data_encoding=%d", http
,
712 http
? http
->data_encoding
: 100));
714 if (!http
|| !http
->wused
)
716 DEBUG_puts(http
? "1httpFlushWrite: Write buffer is empty." :
717 "1httpFlushWrite: No connection.");
721 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
722 bytes
= http_write_chunk(http
, http
->wbuffer
, (size_t)http
->wused
);
724 bytes
= http_write(http
, http
->wbuffer
, (size_t)http
->wused
);
728 DEBUG_printf(("1httpFlushWrite: Returning %d, errno=%d.", (int)bytes
, errno
));
735 * 'httpFreeCredentials()' - Free an array of credentials.
740 cups_array_t
*credentials
) /* I - Array of credentials */
742 http_credential_t
*credential
; /* Credential */
745 for (credential
= (http_credential_t
*)cupsArrayFirst(credentials
);
747 credential
= (http_credential_t
*)cupsArrayNext(credentials
))
749 cupsArrayRemove(credentials
, credential
);
750 free((void *)credential
->data
);
754 cupsArrayDelete(credentials
);
759 * 'httpGet()' - Send a GET request to the server.
762 int /* O - Status of call (0 = success) */
763 httpGet(http_t
*http
, /* I - HTTP connection */
764 const char *uri
) /* I - URI to get */
766 return (http_send(http
, HTTP_STATE_GET
, uri
));
771 * 'httpGetActivity()' - Get the most recent activity for a connection.
773 * The return value is the UNIX time of the last read or write.
778 time_t /* O - Time of last read or write */
779 httpGetActivity(http_t
*http
) /* I - HTTP connection */
781 return (http
? http
->activity
: 0);
786 * 'httpGetAuthString()' - Get the current authorization string.
788 * The authorization string is set by cupsDoAuthentication() and
789 * httpSetAuthString(). Use httpGetAuthString() to retrieve the
790 * string to use with httpSetField() for the HTTP_FIELD_AUTHORIZATION
793 * @since CUPS 1.3/OS X 10.5@
796 char * /* O - Authorization string */
797 httpGetAuthString(http_t
*http
) /* I - HTTP connection */
800 return (http
->authstring
);
807 * 'httpGetBlocking()' - Get the blocking/non-block state of a connection.
809 * @since CUPS 1.2/OS X 10.5@
812 int /* O - 1 if blocking, 0 if non-blocking */
813 httpGetBlocking(http_t
*http
) /* I - HTTP connection */
815 return (http
? http
->blocking
: 0);
820 * 'httpGetContentEncoding()' - Get a common content encoding, if any, between
821 * the client and server.
823 * This function uses the value of the Accepts-Encoding HTTP header and must be
824 * called after receiving a response from the server or a request from the
825 * client. The value returned can be use in subsequent requests (for clients)
826 * or in the response (for servers) in order to compress the content stream.
828 * @since CUPS 1.7/OS X 10.9@
831 const char * /* O - Content-Coding value or
832 @code NULL@ for the identity
834 httpGetContentEncoding(http_t
*http
) /* I - HTTP connection */
837 if (http
&& http
->accept_encoding
)
839 int i
; /* Looping var */
840 char temp
[HTTP_MAX_VALUE
], /* Copy of Accepts-Encoding value */
841 *start
, /* Start of coding value */
842 *end
; /* End of coding value */
843 double qvalue
; /* "qvalue" for coding */
844 struct lconv
*loc
= localeconv(); /* Locale data */
845 static const char * const codings
[] =
846 { /* Supported content codings */
853 strlcpy(temp
, http
->accept_encoding
, sizeof(temp
));
855 for (start
= temp
; *start
; start
= end
)
858 * Find the end of the coding name...
863 while (*end
&& *end
!= ';' && *end
!= ',' && !isspace(*end
& 255))
869 * Grab the qvalue as needed...
872 if (!strncmp(end
, ";q=", 3))
873 qvalue
= _cupsStrScand(end
+ 3, NULL
, loc
);
876 * Skip past all attributes...
880 while (*end
&& *end
!= ',' && !isspace(*end
& 255))
886 while (*end
&& isspace(*end
& 255))
890 * Check value if it matches something we support...
896 for (i
= 0; i
< (int)(sizeof(codings
) / sizeof(codings
[0])); i
++)
897 if (!strcmp(start
, codings
[i
]))
901 #endif /* HAVE_LIBZ */
908 * 'httpGetCookie()' - Get any cookie data from the response.
910 * @since CUPS 1.1.19/OS X 10.3@
913 const char * /* O - Cookie data or NULL */
914 httpGetCookie(http_t
*http
) /* I - HTTP connecion */
916 return (http
? http
->cookie
: NULL
);
921 * 'httpGetEncryption()' - Get the current encryption mode of a connection.
923 * This function returns the encryption mode for the connection. Use the
924 * @link httpIsEncrypted@ function to determine whether a TLS session has
930 http_encryption_t
/* O - Current encryption mode */
931 httpGetEncryption(http_t
*http
) /* I - HTTP connection */
933 return (http
? http
->encryption
: HTTP_ENCRYPTION_IF_REQUESTED
);
938 * 'httpGetExpect()' - Get the value of the Expect header, if any.
940 * Returns @code HTTP_STATUS_NONE@ if there is no Expect header, otherwise
941 * returns the expected HTTP status code, typically @code HTTP_STATUS_CONTINUE@.
943 * @since CUPS 1.7/OS X 10.9@
946 http_status_t
/* O - Expect: status, if any */
947 httpGetExpect(http_t
*http
) /* I - HTTP connection */
950 return (HTTP_STATUS_ERROR
);
952 return (http
->expect
);
957 * 'httpGetFd()' - Get the file descriptor associated with a connection.
959 * @since CUPS 1.2/OS X 10.5@
962 int /* O - File descriptor or -1 if none */
963 httpGetFd(http_t
*http
) /* I - HTTP connection */
965 return (http
? http
->fd
: -1);
970 * 'httpGetField()' - Get a field value from a request/response.
973 const char * /* O - Field value */
974 httpGetField(http_t
*http
, /* I - HTTP connection */
975 http_field_t field
) /* I - Field to get */
977 if (!http
|| field
<= HTTP_FIELD_UNKNOWN
|| field
>= HTTP_FIELD_MAX
)
982 case HTTP_FIELD_ACCEPT_ENCODING
:
983 return (http
->accept_encoding
);
985 case HTTP_FIELD_ALLOW
:
986 return (http
->allow
);
988 case HTTP_FIELD_SERVER
:
989 return (http
->server
);
991 case HTTP_FIELD_AUTHORIZATION
:
992 if (http
->field_authorization
)
995 * Special case for WWW-Authenticate: as its contents can be
996 * longer than HTTP_MAX_VALUE...
999 return (http
->field_authorization
);
1003 return (http
->fields
[field
]);
1009 * 'httpGetKeepAlive()' - Get the current Keep-Alive state of the connection.
1014 http_keepalive_t
/* O - Keep-Alive state */
1015 httpGetKeepAlive(http_t
*http
) /* I - HTTP connection */
1017 return (http
? http
->keep_alive
: HTTP_KEEPALIVE_OFF
);
1022 * 'httpGetLength()' - Get the amount of data remaining from the
1023 * content-length or transfer-encoding fields.
1025 * This function is deprecated and will not return lengths larger than
1026 * 2^31 - 1; use httpGetLength2() instead.
1031 int /* O - Content length */
1032 httpGetLength(http_t
*http
) /* I - HTTP connection */
1035 * Get the read content length and return the 32-bit value.
1040 httpGetLength2(http
);
1042 return (http
->_data_remaining
);
1050 * 'httpGetLength2()' - Get the amount of data remaining from the
1051 * content-length or transfer-encoding fields.
1053 * This function returns the complete content length, even for
1054 * content larger than 2^31 - 1.
1056 * @since CUPS 1.2/OS X 10.5@
1059 off_t
/* O - Content length */
1060 httpGetLength2(http_t
*http
) /* I - HTTP connection */
1062 off_t remaining
; /* Remaining length */
1065 DEBUG_printf(("2httpGetLength2(http=%p), state=%s", http
,
1066 httpStateString(http
->state
)));
1071 if (!_cups_strcasecmp(http
->fields
[HTTP_FIELD_TRANSFER_ENCODING
], "chunked"))
1073 DEBUG_puts("4httpGetLength2: chunked request!");
1079 * The following is a hack for HTTP servers that don't send a
1080 * Content-Length or Transfer-Encoding field...
1082 * If there is no Content-Length then the connection must close
1083 * after the transfer is complete...
1086 if (!http
->fields
[HTTP_FIELD_CONTENT_LENGTH
][0])
1089 * Default content length is 0 for errors and certain types of operations,
1090 * and 2^31-1 for other successful requests...
1093 if (http
->status
>= HTTP_STATUS_MULTIPLE_CHOICES
||
1094 http
->state
== HTTP_STATE_OPTIONS
||
1095 (http
->state
== HTTP_STATE_GET
&& http
->mode
== _HTTP_MODE_SERVER
) ||
1096 http
->state
== HTTP_STATE_HEAD
||
1097 (http
->state
== HTTP_STATE_PUT
&& http
->mode
== _HTTP_MODE_CLIENT
) ||
1098 http
->state
== HTTP_STATE_DELETE
||
1099 http
->state
== HTTP_STATE_TRACE
||
1100 http
->state
== HTTP_STATE_CONNECT
)
1103 remaining
= 2147483647;
1105 else if ((remaining
= strtoll(http
->fields
[HTTP_FIELD_CONTENT_LENGTH
],
1109 DEBUG_printf(("4httpGetLength2: content_length=" CUPS_LLFMT
,
1110 CUPS_LLCAST remaining
));
1118 * 'httpGetPending()' - Get the number of bytes that are buffered for writing.
1123 size_t /* O - Number of bytes buffered */
1124 httpGetPending(http_t
*http
) /* I - HTTP connection */
1126 return (http
? (size_t)http
->wused
: 0);
1131 * 'httpGetReady()' - Get the number of bytes that can be read without blocking.
1136 size_t /* O - Number of bytes available */
1137 httpGetReady(http_t
*http
) /* I - HTTP connection */
1141 else if (http
->used
> 0)
1142 return ((size_t)http
->used
);
1145 return (http_tls_pending(http
));
1146 #endif /* HAVE_SSL */
1153 * 'httpGetRemaining()' - Get the number of remaining bytes in the message
1154 * body or current chunk.
1156 * The @link httpIsChunked@ function can be used to determine whether the
1157 * message body is chunked or fixed-length.
1162 size_t /* O - Remaining bytes */
1163 httpGetRemaining(http_t
*http
) /* I - HTTP connection */
1165 return (http
? (size_t)http
->data_remaining
: 0);
1170 * 'httpGets()' - Get a line of text from a HTTP connection.
1173 char * /* O - Line or NULL */
1174 httpGets(char *line
, /* I - Line to read into */
1175 int length
, /* I - Max length of buffer */
1176 http_t
*http
) /* I - HTTP connection */
1178 char *lineptr
, /* Pointer into line */
1179 *lineend
, /* End of line */
1180 *bufptr
, /* Pointer into input buffer */
1181 *bufend
; /* Pointer to end of buffer */
1182 ssize_t bytes
; /* Number of bytes read */
1183 int eol
; /* End-of-line? */
1186 DEBUG_printf(("2httpGets(line=%p, length=%d, http=%p)", line
, length
, http
));
1188 if (!http
|| !line
|| length
<= 1)
1192 * Read a line from the buffer...
1197 lineend
= line
+ length
- 1;
1200 while (lineptr
< lineend
)
1203 * Pre-load the buffer as needed...
1212 while (http
->used
== 0)
1215 * No newline; see if there is more data to be read...
1218 while (!_httpWait(http
, http
->wait_value
, 1))
1220 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
1223 DEBUG_puts("3httpGets: Timed out!");
1225 http
->error
= WSAETIMEDOUT
;
1227 http
->error
= ETIMEDOUT
;
1232 bytes
= http_read(http
, http
->buffer
+ http
->used
, (size_t)(HTTP_MAX_BUFFER
- http
->used
));
1234 DEBUG_printf(("4httpGets: read " CUPS_LLFMT
" bytes.", CUPS_LLCAST bytes
));
1239 * Nope, can't get a line this time...
1243 DEBUG_printf(("3httpGets: recv() error %d!", WSAGetLastError()));
1245 if (WSAGetLastError() == WSAEINTR
)
1247 else if (WSAGetLastError() == WSAEWOULDBLOCK
)
1249 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
1252 http
->error
= WSAGetLastError();
1254 else if (WSAGetLastError() != http
->error
)
1256 http
->error
= WSAGetLastError();
1261 DEBUG_printf(("3httpGets: recv() error %d!", errno
));
1265 else if (errno
== EWOULDBLOCK
|| errno
== EAGAIN
)
1267 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
1269 else if (!http
->timeout_cb
&& errno
== EAGAIN
)
1272 http
->error
= errno
;
1274 else if (errno
!= http
->error
)
1276 http
->error
= errno
;
1283 else if (bytes
== 0)
1285 http
->error
= EPIPE
;
1291 * Yup, update the amount used...
1294 http
->used
+= (int)bytes
;
1298 * Now copy as much of the current line as possible...
1301 for (bufptr
= http
->buffer
, bufend
= http
->buffer
+ http
->used
;
1302 lineptr
< lineend
&& bufptr
< bufend
;)
1304 if (*bufptr
== 0x0a)
1310 else if (*bufptr
== 0x0d)
1313 *lineptr
++ = *bufptr
++;
1316 http
->used
-= (int)(bufptr
- http
->buffer
);
1318 memmove(http
->buffer
, bufptr
, (size_t)http
->used
);
1326 http
->activity
= time(NULL
);
1330 DEBUG_printf(("3httpGets: Returning \"%s\"", line
));
1336 DEBUG_puts("3httpGets: No new line available!");
1343 * 'httpGetState()' - Get the current state of the HTTP request.
1346 http_state_t
/* O - HTTP state */
1347 httpGetState(http_t
*http
) /* I - HTTP connection */
1349 return (http
? http
->state
: HTTP_STATE_ERROR
);
1354 * 'httpGetStatus()' - Get the status of the last HTTP request.
1356 * @since CUPS 1.2/OS X 10.5@
1359 http_status_t
/* O - HTTP status */
1360 httpGetStatus(http_t
*http
) /* I - HTTP connection */
1362 return (http
? http
->status
: HTTP_STATUS_ERROR
);
1367 * 'httpGetSubField()' - Get a sub-field value.
1372 char * /* O - Value or NULL */
1373 httpGetSubField(http_t
*http
, /* I - HTTP connection */
1374 http_field_t field
, /* I - Field index */
1375 const char *name
, /* I - Name of sub-field */
1376 char *value
) /* O - Value string */
1378 return (httpGetSubField2(http
, field
, name
, value
, HTTP_MAX_VALUE
));
1383 * 'httpGetSubField2()' - Get a sub-field value.
1385 * @since CUPS 1.2/OS X 10.5@
1388 char * /* O - Value or NULL */
1389 httpGetSubField2(http_t
*http
, /* I - HTTP connection */
1390 http_field_t field
, /* I - Field index */
1391 const char *name
, /* I - Name of sub-field */
1392 char *value
, /* O - Value string */
1393 int valuelen
) /* I - Size of value buffer */
1395 const char *fptr
; /* Pointer into field */
1396 char temp
[HTTP_MAX_VALUE
], /* Temporary buffer for name */
1397 *ptr
, /* Pointer into string buffer */
1398 *end
; /* End of value buffer */
1400 DEBUG_printf(("2httpGetSubField2(http=%p, field=%d, name=\"%s\", value=%p, "
1401 "valuelen=%d)", http
, field
, name
, value
, valuelen
));
1403 if (!http
|| !name
|| !value
|| valuelen
< 2 ||
1404 field
<= HTTP_FIELD_UNKNOWN
|| field
>= HTTP_FIELD_MAX
)
1407 end
= value
+ valuelen
- 1;
1409 for (fptr
= http
->fields
[field
]; *fptr
;)
1412 * Skip leading whitespace...
1415 while (_cups_isspace(*fptr
))
1425 * Get the sub-field name...
1429 *fptr
&& *fptr
!= '=' && !_cups_isspace(*fptr
) &&
1430 ptr
< (temp
+ sizeof(temp
) - 1);
1435 DEBUG_printf(("4httpGetSubField2: name=\"%s\"", temp
));
1438 * Skip trailing chars up to the '='...
1441 while (_cups_isspace(*fptr
))
1451 * Skip = and leading whitespace...
1456 while (_cups_isspace(*fptr
))
1462 * Read quoted string...
1465 for (ptr
= value
, fptr
++;
1466 *fptr
&& *fptr
!= '\"' && ptr
< end
;
1471 while (*fptr
&& *fptr
!= '\"')
1480 * Read unquoted string...
1484 *fptr
&& !_cups_isspace(*fptr
) && *fptr
!= ',' && ptr
< end
;
1489 while (*fptr
&& !_cups_isspace(*fptr
) && *fptr
!= ',')
1493 DEBUG_printf(("4httpGetSubField2: value=\"%s\"", value
));
1496 * See if this is the one...
1499 if (!strcmp(name
, temp
))
1501 DEBUG_printf(("3httpGetSubField2: Returning \"%s\"", value
));
1508 DEBUG_puts("3httpGetSubField2: Returning NULL");
1515 * 'httpGetVersion()' - Get the HTTP version at the other end.
1518 http_version_t
/* O - Version number */
1519 httpGetVersion(http_t
*http
) /* I - HTTP connection */
1521 return (http
? http
->version
: HTTP_VERSION_1_0
);
1526 * 'httpHead()' - Send a HEAD request to the server.
1529 int /* O - Status of call (0 = success) */
1530 httpHead(http_t
*http
, /* I - HTTP connection */
1531 const char *uri
) /* I - URI for head */
1533 DEBUG_printf(("httpHead(http=%p, uri=\"%s\")", http
, uri
));
1534 return (http_send(http
, HTTP_STATE_HEAD
, uri
));
1539 * 'httpInitialize()' - Initialize the HTTP interface library and set the
1540 * default HTTP proxy (if any).
1544 httpInitialize(void)
1546 static int initialized
= 0; /* Have we been called before? */
1548 WSADATA winsockdata
; /* WinSock data */
1555 _cupsGlobalUnlock();
1560 WSAStartup(MAKEWORD(2,2), &winsockdata
);
1562 #elif !defined(SO_NOSIGPIPE)
1564 * Ignore SIGPIPE signals...
1568 sigset(SIGPIPE
, SIG_IGN
);
1570 # elif defined(HAVE_SIGACTION)
1571 struct sigaction action
; /* POSIX sigaction data */
1574 memset(&action
, 0, sizeof(action
));
1575 action
.sa_handler
= SIG_IGN
;
1576 sigaction(SIGPIPE
, &action
, NULL
);
1579 signal(SIGPIPE
, SIG_IGN
);
1580 # endif /* !SO_NOSIGPIPE */
1584 http_tls_initialize();
1585 # endif /* HAVE_SSL */
1588 _cupsGlobalUnlock();
1593 * 'httpIsChunked()' - Report whether a message body is chunked.
1595 * This function returns non-zero if the message body is composed of
1596 * variable-length chunks.
1601 int /* O - 1 if chunked, 0 if not */
1602 httpIsChunked(http_t
*http
) /* I - HTTP connection */
1604 return (http
? http
->data_encoding
== HTTP_ENCODING_CHUNKED
: 0);
1609 * 'httpIsEncrypted()' - Report whether a connection is encrypted.
1611 * This function returns non-zero if the connection is currently encrypted.
1616 int /* O - 1 if encrypted, 0 if not */
1617 httpIsEncrypted(http_t
*http
) /* I - HTTP connection */
1619 return (http
? http
->tls
!= NULL
: 0);
1624 * 'httpOptions()' - Send an OPTIONS request to the server.
1627 int /* O - Status of call (0 = success) */
1628 httpOptions(http_t
*http
, /* I - HTTP connection */
1629 const char *uri
) /* I - URI for options */
1631 return (http_send(http
, HTTP_STATE_OPTIONS
, uri
));
1636 * 'httpPeek()' - Peek at data from a HTTP connection.
1638 * This function copies available data from the given HTTP connection, reading
1639 * a buffer as needed. The data is still available for reading using
1640 * @link httpRead@ or @link httpRead2@.
1642 * For non-blocking connections the usual timeouts apply.
1644 * @since CUPS 1.7/OS X 10.9@
1647 ssize_t
/* O - Number of bytes copied */
1648 httpPeek(http_t
*http
, /* I - HTTP connection */
1649 char *buffer
, /* I - Buffer for data */
1650 size_t length
) /* I - Maximum number of bytes */
1652 ssize_t bytes
; /* Bytes read */
1653 char len
[32]; /* Length string */
1656 DEBUG_printf(("httpPeek(http=%p, buffer=%p, length=" CUPS_LLFMT
")",
1657 http
, buffer
, CUPS_LLCAST length
));
1659 if (http
== NULL
|| buffer
== NULL
)
1662 http
->activity
= time(NULL
);
1668 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
&&
1669 http
->data_remaining
<= 0)
1671 DEBUG_puts("2httpPeek: Getting chunk length...");
1673 if (httpGets(len
, sizeof(len
), http
) == NULL
)
1675 DEBUG_puts("1httpPeek: Could not get length!");
1681 DEBUG_puts("1httpPeek: Blank chunk length, trying again...");
1682 if (!httpGets(len
, sizeof(len
), http
))
1684 DEBUG_puts("1httpPeek: Could not get chunk length.");
1689 http
->data_remaining
= strtoll(len
, NULL
, 16);
1691 if (http
->data_remaining
< 0)
1693 DEBUG_puts("1httpPeek: Negative chunk length!");
1698 DEBUG_printf(("2httpPeek: data_remaining=" CUPS_LLFMT
,
1699 CUPS_LLCAST http
->data_remaining
));
1701 if (http
->data_remaining
<= 0 && http
->data_encoding
!= HTTP_ENCODING_FIELDS
)
1704 * A zero-length chunk ends a transfer; unless we are reading POST
1709 if (http
->coding
>= _HTTP_CODING_GUNZIP
)
1710 http_content_coding_finish(http
);
1711 #endif /* HAVE_LIBZ */
1713 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
1714 httpGets(len
, sizeof(len
), http
);
1716 if (http
->state
== HTTP_STATE_POST_RECV
)
1719 http
->state
= HTTP_STATE_STATUS
;
1721 DEBUG_printf(("1httpPeek: 0-length chunk, set state to %s.",
1722 httpStateString(http
->state
)));
1725 * Prevent future reads for this request...
1728 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
1732 else if (length
> (size_t)http
->data_remaining
)
1733 length
= (size_t)http
->data_remaining
;
1736 if (http
->used
== 0 &&
1737 (http
->coding
== _HTTP_CODING_IDENTITY
||
1738 (http
->coding
>= _HTTP_CODING_GUNZIP
&& http
->stream
.avail_in
== 0)))
1740 if (http
->used
== 0)
1741 #endif /* HAVE_LIBZ */
1744 * Buffer small reads for better performance...
1747 ssize_t buflen
; /* Length of read for buffer */
1749 if (!http
->blocking
)
1751 while (!httpWait(http
, http
->wait_value
))
1753 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
1760 if ((size_t)http
->data_remaining
> sizeof(http
->buffer
))
1761 buflen
= sizeof(http
->buffer
);
1763 buflen
= (ssize_t
)http
->data_remaining
;
1765 DEBUG_printf(("2httpPeek: Reading %d bytes into buffer.", (int)buflen
));
1766 bytes
= http_read(http
, http
->buffer
, (size_t)buflen
);
1768 DEBUG_printf(("2httpPeek: Read " CUPS_LLFMT
" bytes into buffer.",
1769 CUPS_LLCAST bytes
));
1773 http_debug_hex("httpPeek", http
->buffer
, (int)bytes
);
1776 http
->used
= (int)bytes
;
1781 if (http
->coding
>= _HTTP_CODING_GUNZIP
)
1783 # ifdef HAVE_INFLATECOPY
1784 int zerr
; /* Decompressor error */
1785 z_stream stream
; /* Copy of decompressor stream */
1787 if (http
->used
> 0 && http
->stream
.avail_in
< HTTP_MAX_BUFFER
)
1789 size_t buflen
= buflen
= HTTP_MAX_BUFFER
- http
->stream
.avail_in
;
1790 /* Number of bytes to copy */
1792 if (http
->stream
.avail_in
> 0 &&
1793 http
->stream
.next_in
> http
->dbuffer
)
1794 memmove(http
->dbuffer
, http
->stream
.next_in
, http
->stream
.avail_in
);
1796 http
->stream
.next_in
= http
->dbuffer
;
1798 if (buflen
> (size_t)http
->data_remaining
)
1799 buflen
= (size_t)http
->data_remaining
;
1801 if (buflen
> (size_t)http
->used
)
1802 buflen
= (size_t)http
->used
;
1804 DEBUG_printf(("1httpPeek: Copying %d more bytes of data into "
1805 "decompression buffer.", (int)buflen
));
1807 memcpy(http
->dbuffer
+ http
->stream
.avail_in
, http
->buffer
, buflen
);
1808 http
->stream
.avail_in
+= buflen
;
1809 http
->used
-= buflen
;
1810 http
->data_remaining
-= buflen
;
1813 memmove(http
->buffer
, http
->buffer
+ buflen
, (size_t)http
->used
);
1816 DEBUG_printf(("2httpPeek: length=%d, avail_in=%d", (int)length
,
1817 (int)http
->stream
.avail_in
));
1819 if (inflateCopy(&stream
, &(http
->stream
)) != Z_OK
)
1821 DEBUG_puts("2httpPeek: Unable to copy decompressor stream.");
1822 http
->error
= ENOMEM
;
1826 stream
.next_out
= (Bytef
*)buffer
;
1827 stream
.avail_out
= (uInt
)length
;
1829 zerr
= inflate(&stream
, Z_SYNC_FLUSH
);
1830 inflateEnd(&stream
);
1834 DEBUG_printf(("2httpPeek: zerr=%d", zerr
));
1836 http_debug_hex("2httpPeek", (char *)http
->dbuffer
, (int)http
->stream
.avail_in
);
1843 bytes
= (ssize_t
)(length
- http
->stream
.avail_out
);
1846 DEBUG_puts("2httpPeek: No inflateCopy on this platform, httpPeek does not "
1847 "work with compressed streams.");
1849 # endif /* HAVE_INFLATECOPY */
1852 #endif /* HAVE_LIBZ */
1855 if (length
> (size_t)http
->used
)
1856 length
= (size_t)http
->used
;
1858 bytes
= (ssize_t
)length
;
1860 DEBUG_printf(("2httpPeek: grabbing %d bytes from input buffer...",
1863 memcpy(buffer
, http
->buffer
, length
);
1871 if (WSAGetLastError() == WSAEINTR
|| WSAGetLastError() == WSAEWOULDBLOCK
)
1874 http
->error
= WSAGetLastError();
1876 if (errno
== EINTR
|| errno
== EAGAIN
)
1879 http
->error
= errno
;
1882 else if (bytes
== 0)
1884 http
->error
= EPIPE
;
1893 * 'httpPost()' - Send a POST request to the server.
1896 int /* O - Status of call (0 = success) */
1897 httpPost(http_t
*http
, /* I - HTTP connection */
1898 const char *uri
) /* I - URI for post */
1900 return (http_send(http
, HTTP_STATE_POST
, uri
));
1905 * 'httpPrintf()' - Print a formatted string to a HTTP connection.
1910 int /* O - Number of bytes written */
1911 httpPrintf(http_t
*http
, /* I - HTTP connection */
1912 const char *format
, /* I - printf-style format string */
1913 ...) /* I - Additional args as needed */
1915 ssize_t bytes
; /* Number of bytes to write */
1916 char buf
[16384]; /* Buffer for formatted string */
1917 va_list ap
; /* Variable argument pointer */
1920 DEBUG_printf(("2httpPrintf(http=%p, format=\"%s\", ...)", http
, format
));
1922 va_start(ap
, format
);
1923 bytes
= vsnprintf(buf
, sizeof(buf
), format
, ap
);
1926 DEBUG_printf(("3httpPrintf: (" CUPS_LLFMT
" bytes) %s", CUPS_LLCAST bytes
, buf
));
1928 if (http
->data_encoding
== HTTP_ENCODING_FIELDS
)
1929 return ((int)httpWrite2(http
, buf
, (size_t)bytes
));
1934 DEBUG_puts("4httpPrintf: flushing existing data...");
1936 if (httpFlushWrite(http
) < 0)
1940 return ((int)http_write(http
, buf
, (size_t)bytes
));
1946 * 'httpPut()' - Send a PUT request to the server.
1949 int /* O - Status of call (0 = success) */
1950 httpPut(http_t
*http
, /* I - HTTP connection */
1951 const char *uri
) /* I - URI to put */
1953 DEBUG_printf(("httpPut(http=%p, uri=\"%s\")", http
, uri
));
1954 return (http_send(http
, HTTP_STATE_PUT
, uri
));
1959 * 'httpRead()' - Read data from a HTTP connection.
1961 * This function is deprecated. Use the httpRead2() function which can
1962 * read more than 2GB of data.
1967 int /* O - Number of bytes read */
1968 httpRead(http_t
*http
, /* I - HTTP connection */
1969 char *buffer
, /* I - Buffer for data */
1970 int length
) /* I - Maximum number of bytes */
1972 return ((int)httpRead2(http
, buffer
, (size_t)length
));
1977 * 'httpRead2()' - Read data from a HTTP connection.
1979 * @since CUPS 1.2/OS X 10.5@
1982 ssize_t
/* O - Number of bytes read */
1983 httpRead2(http_t
*http
, /* I - HTTP connection */
1984 char *buffer
, /* I - Buffer for data */
1985 size_t length
) /* I - Maximum number of bytes */
1987 ssize_t bytes
; /* Bytes read */
1991 DEBUG_printf(("httpRead2(http=%p, buffer=%p, length=" CUPS_LLFMT
1992 ") coding=%d data_encoding=%d data_remaining=" CUPS_LLFMT
,
1993 http
, buffer
, CUPS_LLCAST length
,
1995 http
->data_encoding
, CUPS_LLCAST http
->data_remaining
));
1997 DEBUG_printf(("httpRead2(http=%p, buffer=%p, length=" CUPS_LLFMT
1998 ") data_encoding=%d data_remaining=" CUPS_LLFMT
,
1999 http
, buffer
, CUPS_LLCAST length
,
2000 http
->data_encoding
, CUPS_LLCAST http
->data_remaining
));
2001 #endif /* HAVE_LIBZ */
2003 if (http
== NULL
|| buffer
== NULL
)
2006 http
->activity
= time(NULL
);
2013 if (http
->coding
>= _HTTP_CODING_GUNZIP
)
2017 if (http
->stream
.avail_in
> 0)
2019 int zerr
; /* Decompressor error */
2021 DEBUG_printf(("2httpRead2: avail_in=%d, avail_out=%d",
2022 (int)http
->stream
.avail_in
, (int)length
));
2024 http
->stream
.next_out
= (Bytef
*)buffer
;
2025 http
->stream
.avail_out
= (uInt
)length
;
2027 if ((zerr
= inflate(&(http
->stream
), Z_SYNC_FLUSH
)) < Z_OK
)
2029 DEBUG_printf(("2httpRead2: zerr=%d", zerr
));
2031 http_debug_hex("2httpRead2", (char *)http
->dbuffer
, (int)http
->stream
.avail_in
);
2038 bytes
= (ssize_t
)(length
- http
->stream
.avail_out
);
2040 DEBUG_printf(("2httpRead2: avail_in=%d, avail_out=%d, bytes=%d",
2041 http
->stream
.avail_in
, http
->stream
.avail_out
,
2049 ssize_t buflen
= HTTP_MAX_BUFFER
- (ssize_t
)http
->stream
.avail_in
;
2050 /* Additional bytes for buffer */
2054 if (http
->stream
.avail_in
> 0 &&
2055 http
->stream
.next_in
> http
->dbuffer
)
2056 memmove(http
->dbuffer
, http
->stream
.next_in
, http
->stream
.avail_in
);
2058 http
->stream
.next_in
= http
->dbuffer
;
2060 DEBUG_printf(("1httpRead2: Reading up to %d more bytes of data into "
2061 "decompression buffer.", (int)buflen
));
2063 if (http
->data_remaining
> 0)
2065 if (buflen
> http
->data_remaining
)
2066 buflen
= (ssize_t
)http
->data_remaining
;
2068 bytes
= http_read_buffered(http
, (char *)http
->dbuffer
+ http
->stream
.avail_in
, (size_t)buflen
);
2070 else if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
2071 bytes
= http_read_chunk(http
, (char *)http
->dbuffer
+ http
->stream
.avail_in
, (size_t)buflen
);
2077 else if (bytes
== 0)
2080 DEBUG_printf(("1httpRead2: Adding " CUPS_LLFMT
" bytes to "
2081 "decompression buffer.", CUPS_LLCAST bytes
));
2083 http
->data_remaining
-= bytes
;
2084 http
->stream
.avail_in
+= (uInt
)bytes
;
2086 if (http
->data_remaining
<= 0 &&
2087 http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
2090 * Read the trailing blank line now...
2093 char len
[32]; /* Length string */
2095 httpGets(len
, sizeof(len
), http
);
2107 #endif /* HAVE_LIBZ */
2108 if (http
->data_remaining
== 0 && http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
2110 if ((bytes
= http_read_chunk(http
, buffer
, length
)) > 0)
2112 http
->data_remaining
-= bytes
;
2114 if (http
->data_remaining
<= 0)
2117 * Read the trailing blank line now...
2120 char len
[32]; /* Length string */
2122 httpGets(len
, sizeof(len
), http
);
2126 else if (http
->data_remaining
<= 0)
2129 * No more data to read...
2136 DEBUG_printf(("1httpRead2: Reading up to %d bytes into buffer.",
2139 if (length
> (size_t)http
->data_remaining
)
2140 length
= (size_t)http
->data_remaining
;
2142 if ((bytes
= http_read_buffered(http
, buffer
, length
)) > 0)
2144 http
->data_remaining
-= bytes
;
2146 if (http
->data_remaining
<= 0 &&
2147 http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
2150 * Read the trailing blank line now...
2153 char len
[32]; /* Length string */
2155 httpGets(len
, sizeof(len
), http
);
2162 (http
->coding
== _HTTP_CODING_IDENTITY
||
2163 (http
->coding
>= _HTTP_CODING_GUNZIP
&& http
->stream
.avail_in
== 0)) &&
2164 #endif /* HAVE_LIBZ */
2165 ((http
->data_remaining
<= 0 &&
2166 http
->data_encoding
== HTTP_ENCODING_LENGTH
) ||
2167 (http
->data_encoding
== HTTP_ENCODING_CHUNKED
&& bytes
== 0)))
2170 if (http
->coding
>= _HTTP_CODING_GUNZIP
)
2171 http_content_coding_finish(http
);
2172 #endif /* HAVE_LIBZ */
2174 if (http
->state
== HTTP_STATE_POST_RECV
)
2176 else if (http
->state
== HTTP_STATE_GET_SEND
||
2177 http
->state
== HTTP_STATE_POST_SEND
)
2178 http
->state
= HTTP_STATE_WAITING
;
2180 http
->state
= HTTP_STATE_STATUS
;
2182 DEBUG_printf(("1httpRead2: End of content, set state to %s.",
2183 httpStateString(http
->state
)));
2191 * 'httpReadRequest()' - Read a HTTP request from a connection.
2193 * @since CUPS 1.7/OS X 10.9@
2196 http_state_t
/* O - New state of connection */
2197 httpReadRequest(http_t
*http
, /* I - HTTP connection */
2198 char *uri
, /* I - URI buffer */
2199 size_t urilen
) /* I - Size of URI buffer */
2201 char line
[4096], /* HTTP request line */
2202 *req_method
, /* HTTP request method */
2203 *req_uri
, /* HTTP request URI */
2204 *req_version
; /* HTTP request version number string */
2208 * Range check input...
2211 DEBUG_printf(("httpReadRequest(http=%p, uri=%p, urilen=" CUPS_LLFMT
")",
2212 http
, uri
, CUPS_LLCAST urilen
));
2217 if (!http
|| !uri
|| urilen
< 1)
2219 DEBUG_puts("1httpReadRequest: Bad arguments, returning HTTP_STATE_ERROR.");
2220 return (HTTP_STATE_ERROR
);
2222 else if (http
->state
!= HTTP_STATE_WAITING
)
2224 DEBUG_printf(("1httpReadRequest: Bad state %s, returning HTTP_STATE_ERROR.",
2225 httpStateString(http
->state
)));
2226 return (HTTP_STATE_ERROR
);
2233 httpClearFields(http
);
2235 http
->activity
= time(NULL
);
2236 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
2237 http
->data_remaining
= 0;
2238 http
->keep_alive
= HTTP_KEEPALIVE_OFF
;
2239 http
->status
= HTTP_STATUS_OK
;
2240 http
->version
= HTTP_VERSION_1_1
;
2243 * Read a line from the socket...
2246 if (!httpGets(line
, sizeof(line
), http
))
2248 DEBUG_puts("1httpReadRequest: Unable to read, returning HTTP_STATE_ERROR");
2249 return (HTTP_STATE_ERROR
);
2254 DEBUG_puts("1httpReadRequest: Blank line, returning HTTP_STATE_WAITING");
2255 return (HTTP_STATE_WAITING
);
2258 DEBUG_printf(("1httpReadRequest: %s", line
));
2267 while (*req_uri
&& !isspace(*req_uri
& 255))
2272 DEBUG_puts("1httpReadRequest: No request URI.");
2273 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No request URI."), 1);
2274 return (HTTP_STATE_ERROR
);
2279 while (*req_uri
&& isspace(*req_uri
& 255))
2282 req_version
= req_uri
;
2284 while (*req_version
&& !isspace(*req_version
& 255))
2289 DEBUG_puts("1httpReadRequest: No request protocol version.");
2290 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("No request protocol version."), 1);
2291 return (HTTP_STATE_ERROR
);
2294 *req_version
++ = '\0';
2296 while (*req_version
&& isspace(*req_version
& 255))
2303 if (!strcmp(req_method
, "OPTIONS"))
2304 http
->state
= HTTP_STATE_OPTIONS
;
2305 else if (!strcmp(req_method
, "GET"))
2306 http
->state
= HTTP_STATE_GET
;
2307 else if (!strcmp(req_method
, "HEAD"))
2308 http
->state
= HTTP_STATE_HEAD
;
2309 else if (!strcmp(req_method
, "POST"))
2310 http
->state
= HTTP_STATE_POST
;
2311 else if (!strcmp(req_method
, "PUT"))
2312 http
->state
= HTTP_STATE_PUT
;
2313 else if (!strcmp(req_method
, "DELETE"))
2314 http
->state
= HTTP_STATE_DELETE
;
2315 else if (!strcmp(req_method
, "TRACE"))
2316 http
->state
= HTTP_STATE_TRACE
;
2317 else if (!strcmp(req_method
, "CONNECT"))
2318 http
->state
= HTTP_STATE_CONNECT
;
2321 DEBUG_printf(("1httpReadRequest: Unknown method \"%s\".", req_method
));
2322 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unknown request method."), 1);
2323 return (HTTP_STATE_UNKNOWN_METHOD
);
2326 DEBUG_printf(("1httpReadRequest: Set state to %s.",
2327 httpStateString(http
->state
)));
2329 if (!strcmp(req_version
, "HTTP/1.0"))
2331 http
->version
= HTTP_VERSION_1_0
;
2332 http
->keep_alive
= HTTP_KEEPALIVE_OFF
;
2334 else if (!strcmp(req_version
, "HTTP/1.1"))
2336 http
->version
= HTTP_VERSION_1_1
;
2337 http
->keep_alive
= HTTP_KEEPALIVE_ON
;
2341 DEBUG_printf(("1httpReadRequest: Unknown version \"%s\".", req_version
));
2342 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, _("Unknown request version."), 1);
2343 return (HTTP_STATE_UNKNOWN_VERSION
);
2346 DEBUG_printf(("1httpReadRequest: URI is \"%s\".", req_uri
));
2347 strlcpy(uri
, req_uri
, urilen
);
2349 return (http
->state
);
2354 * 'httpReconnect()' - Reconnect to a HTTP server.
2356 * This function is deprecated. Please use the @link httpReconnect2@ function
2362 int /* O - 0 on success, non-zero on failure */
2363 httpReconnect(http_t
*http
) /* I - HTTP connection */
2365 DEBUG_printf(("httpReconnect(http=%p)", http
));
2367 return (httpReconnect2(http
, 30000, NULL
));
2372 * 'httpReconnect2()' - Reconnect to a HTTP server with timeout and optional
2376 int /* O - 0 on success, non-zero on failure */
2377 httpReconnect2(http_t
*http
, /* I - HTTP connection */
2378 int msec
, /* I - Timeout in milliseconds */
2379 int *cancel
) /* I - Pointer to "cancel" variable */
2381 http_addrlist_t
*addr
; /* Connected address */
2383 http_addrlist_t
*current
; /* Current address */
2384 char temp
[256]; /* Temporary address string */
2388 DEBUG_printf(("httpReconnect2(http=%p, msec=%d, cancel=%p)", http
, msec
,
2393 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(EINVAL
), 0);
2400 DEBUG_puts("2httpReconnect2: Shutting down SSL/TLS...");
2401 http_tls_stop(http
);
2403 #endif /* HAVE_SSL */
2406 * Close any previously open socket...
2411 DEBUG_printf(("2httpReconnect2: Closing socket %d...", http
->fd
));
2413 httpAddrClose(NULL
, http
->fd
);
2419 * Reset all state (except fields, which may be reused)...
2422 http
->state
= HTTP_STATE_WAITING
;
2423 http
->version
= HTTP_VERSION_1_1
;
2424 http
->keep_alive
= HTTP_KEEPALIVE_OFF
;
2425 memset(&http
->_hostaddr
, 0, sizeof(http
->_hostaddr
));
2426 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
2427 http
->_data_remaining
= 0;
2429 http
->data_remaining
= 0;
2430 http
->hostaddr
= NULL
;
2434 * Connect to the server...
2438 for (current
= http
->addrlist
; current
; current
= current
->next
)
2439 DEBUG_printf(("2httpReconnect2: Address %s:%d",
2440 httpAddrString(&(current
->addr
), temp
, sizeof(temp
)),
2441 httpAddrPort(&(current
->addr
))));
2444 if ((addr
= httpAddrConnect2(http
->addrlist
, &(http
->fd
), msec
,
2448 * Unable to connect...
2452 http
->error
= WSAGetLastError();
2454 http
->error
= errno
;
2456 http
->status
= HTTP_STATUS_ERROR
;
2458 DEBUG_printf(("1httpReconnect2: httpAddrConnect failed: %s",
2459 strerror(http
->error
)));
2464 DEBUG_printf(("2httpReconnect2: New socket=%d", http
->fd
));
2466 if (http
->timeout_value
> 0)
2467 http_set_timeout(http
->fd
, http
->timeout_value
);
2469 http
->hostaddr
= &(addr
->addr
);
2473 if (http
->encryption
== HTTP_ENCRYPTION_ALWAYS
)
2476 * Always do encryption via SSL.
2479 if (http_tls_start(http
) != 0)
2481 httpAddrClose(NULL
, http
->fd
);
2486 else if (http
->encryption
== HTTP_ENCRYPTION_REQUIRED
&& !http
->tls_upgrade
)
2487 return (http_tls_upgrade(http
));
2488 #endif /* HAVE_SSL */
2490 DEBUG_printf(("1httpReconnect2: Connected to %s:%d...",
2491 httpAddrString(http
->hostaddr
, temp
, sizeof(temp
)),
2492 httpAddrPort(http
->hostaddr
)));
2499 * 'httpSetAuthString()' - Set the current authorization string.
2501 * This function just stores a copy of the current authorization string in
2502 * the HTTP connection object. You must still call httpSetField() to set
2503 * HTTP_FIELD_AUTHORIZATION prior to issuing a HTTP request using httpGet(),
2504 * httpHead(), httpOptions(), httpPost, or httpPut().
2506 * @since CUPS 1.3/OS X 10.5@
2510 httpSetAuthString(http_t
*http
, /* I - HTTP connection */
2511 const char *scheme
, /* I - Auth scheme (NULL to clear it) */
2512 const char *data
) /* I - Auth data (NULL for none) */
2515 * Range check input...
2521 if (http
->authstring
&& http
->authstring
!= http
->_authstring
)
2522 free(http
->authstring
);
2524 http
->authstring
= http
->_authstring
;
2529 * Set the current authorization string...
2532 size_t len
= strlen(scheme
) + (data
? strlen(data
) + 1 : 0) + 1;
2535 if (len
> sizeof(http
->_authstring
))
2537 if ((temp
= malloc(len
)) == NULL
)
2538 len
= sizeof(http
->_authstring
);
2540 http
->authstring
= temp
;
2544 snprintf(http
->authstring
, len
, "%s %s", scheme
, data
);
2546 strlcpy(http
->authstring
, scheme
, len
);
2551 * Clear the current authorization string...
2554 http
->_authstring
[0] = '\0';
2560 * 'httpSetCredentials()' - Set the credentials associated with an encrypted
2563 * @since CUPS 1.5/OS X 10.7@
2566 int /* O - Status of call (0 = success) */
2567 httpSetCredentials(http_t
*http
, /* I - HTTP connection */
2568 cups_array_t
*credentials
) /* I - Array of credentials */
2570 if (!http
|| cupsArrayCount(credentials
) < 1)
2573 _httpFreeCredentials(http
->tls_credentials
);
2575 http
->tls_credentials
= _httpCreateCredentials(credentials
);
2577 return (http
->tls_credentials
? 0 : -1);
2582 * 'httpSetCookie()' - Set the cookie value(s).
2584 * @since CUPS 1.1.19/OS X 10.3@
2588 httpSetCookie(http_t
*http
, /* I - Connection */
2589 const char *cookie
) /* I - Cookie string */
2598 http
->cookie
= strdup(cookie
);
2600 http
->cookie
= NULL
;
2605 * 'httpSetDefaultField()' - Set the default value of an HTTP header.
2607 * Currently only @code HTTP_FIELD_ACCEPT_ENCODING@, @code HTTP_FIELD_SERVER@,
2608 * and @code HTTP_FIELD_USER_AGENT@ can be set.
2610 * @since CUPS 1.7/OS X 10.9@
2614 httpSetDefaultField(http_t
*http
, /* I - HTTP connection */
2615 http_field_t field
, /* I - Field index */
2616 const char *value
)/* I - Value */
2618 DEBUG_printf(("httpSetDefaultField(http=%p, field=%d(%s), value=\"%s\")",
2619 http
, field
, http_fields
[field
], value
));
2626 case HTTP_FIELD_ACCEPT_ENCODING
:
2627 if (http
->default_accept_encoding
)
2628 _cupsStrFree(http
->default_accept_encoding
);
2630 http
->default_accept_encoding
= value
? _cupsStrAlloc(value
) : NULL
;
2633 case HTTP_FIELD_SERVER
:
2634 if (http
->default_server
)
2635 _cupsStrFree(http
->default_server
);
2637 http
->default_server
= value
? _cupsStrAlloc(value
) : NULL
;
2640 case HTTP_FIELD_USER_AGENT
:
2641 if (http
->default_user_agent
)
2642 _cupsStrFree(http
->default_user_agent
);
2644 http
->default_user_agent
= value
? _cupsStrAlloc(value
) : NULL
;
2648 DEBUG_puts("1httpSetDefaultField: Ignored.");
2655 * 'httpSetExpect()' - Set the Expect: header in a request.
2657 * Currently only @code HTTP_STATUS_CONTINUE@ is supported for the "expect"
2660 * @since CUPS 1.2/OS X 10.5@
2664 httpSetExpect(http_t
*http
, /* I - HTTP connection */
2665 http_status_t expect
) /* I - HTTP status to expect
2666 (@code HTTP_STATUS_CONTINUE@) */
2668 DEBUG_printf(("httpSetExpect(http=%p, expect=%d)", http
, expect
));
2671 http
->expect
= expect
;
2676 * 'httpSetField()' - Set the value of an HTTP header.
2680 httpSetField(http_t
*http
, /* I - HTTP connection */
2681 http_field_t field
, /* I - Field index */
2682 const char *value
) /* I - Value */
2684 DEBUG_printf(("httpSetField(http=%p, field=%d(%s), value=\"%s\")", http
,
2685 field
, http_fields
[field
], value
));
2688 field
< HTTP_FIELD_ACCEPT_LANGUAGE
||
2689 field
>= HTTP_FIELD_MAX
||
2695 case HTTP_FIELD_ACCEPT_ENCODING
:
2696 if (http
->accept_encoding
)
2697 _cupsStrFree(http
->accept_encoding
);
2699 http
->accept_encoding
= _cupsStrAlloc(value
);
2702 case HTTP_FIELD_ALLOW
:
2704 _cupsStrFree(http
->allow
);
2706 http
->allow
= _cupsStrAlloc(value
);
2709 case HTTP_FIELD_SERVER
:
2711 _cupsStrFree(http
->server
);
2713 http
->server
= _cupsStrAlloc(value
);
2717 strlcpy(http
->fields
[field
], value
, HTTP_MAX_VALUE
);
2721 if (field
== HTTP_FIELD_AUTHORIZATION
)
2724 * Special case for Authorization: as its contents can be
2725 * longer than HTTP_MAX_VALUE
2728 if (http
->field_authorization
)
2729 free(http
->field_authorization
);
2731 http
->field_authorization
= strdup(value
);
2733 else if (field
== HTTP_FIELD_HOST
)
2736 * Special-case for Host: as we don't want a trailing "." on the hostname and
2737 * need to bracket IPv6 numeric addresses.
2740 char *ptr
= strchr(value
, ':');
2742 if (value
[0] != '[' && ptr
&& strchr(ptr
+ 1, ':'))
2745 * Bracket IPv6 numeric addresses...
2747 * This is slightly inefficient (basically copying twice), but is an edge
2748 * case and not worth optimizing...
2751 snprintf(http
->fields
[HTTP_FIELD_HOST
],
2752 sizeof(http
->fields
[HTTP_FIELD_HOST
]), "[%s]", value
);
2757 * Check for a trailing dot on the hostname...
2760 ptr
= http
->fields
[HTTP_FIELD_HOST
];
2764 ptr
+= strlen(ptr
) - 1;
2772 else if (field
== HTTP_FIELD_CONTENT_ENCODING
&&
2773 http
->data_encoding
!= HTTP_ENCODING_FIELDS
)
2775 DEBUG_puts("1httpSetField: Calling http_content_coding_start.");
2776 http_content_coding_start(http
, value
);
2778 #endif /* HAVE_LIBZ */
2783 * 'httpSetKeepAlive()' - Set the current Keep-Alive state of a connection.
2790 http_t
*http
, /* I - HTTP connection */
2791 http_keepalive_t keep_alive
) /* I - New Keep-Alive value */
2794 http
->keep_alive
= keep_alive
;
2799 * 'httpSetLength()' - Set the content-length and content-encoding.
2801 * @since CUPS 1.2/OS X 10.5@
2805 httpSetLength(http_t
*http
, /* I - HTTP connection */
2806 size_t length
) /* I - Length (0 for chunked) */
2808 DEBUG_printf(("httpSetLength(http=%p, length=" CUPS_LLFMT
")", http
,
2809 CUPS_LLCAST length
));
2816 strlcpy(http
->fields
[HTTP_FIELD_TRANSFER_ENCODING
], "chunked",
2818 http
->fields
[HTTP_FIELD_CONTENT_LENGTH
][0] = '\0';
2822 http
->fields
[HTTP_FIELD_TRANSFER_ENCODING
][0] = '\0';
2823 snprintf(http
->fields
[HTTP_FIELD_CONTENT_LENGTH
], HTTP_MAX_VALUE
,
2824 CUPS_LLFMT
, CUPS_LLCAST length
);
2830 * 'httpSetTimeout()' - Set read/write timeouts and an optional callback.
2832 * The optional timeout callback receives both the HTTP connection and a user
2833 * data pointer and must return 1 to continue or 0 to error (time) out.
2835 * @since CUPS 1.5/OS X 10.7@
2840 http_t
*http
, /* I - HTTP connection */
2841 double timeout
, /* I - Number of seconds for timeout,
2842 must be greater than 0 */
2843 http_timeout_cb_t cb
, /* I - Callback function or NULL */
2844 void *user_data
) /* I - User data pointer */
2846 if (!http
|| timeout
<= 0.0)
2849 http
->timeout_cb
= cb
;
2850 http
->timeout_data
= user_data
;
2851 http
->timeout_value
= timeout
;
2854 http_set_timeout(http
->fd
, timeout
);
2856 http_set_wait(http
);
2861 * 'httpShutdown()' - Shutdown one side of an HTTP connection.
2867 httpShutdown(http_t
*http
) /* I - HTTP connection */
2869 if (!http
|| http
->fd
< 0)
2873 http_tls_stop(http
);
2875 shutdown(http
->fd
, SHUT_RD
);
2880 * 'httpTrace()' - Send an TRACE request to the server.
2883 int /* O - Status of call (0 = success) */
2884 httpTrace(http_t
*http
, /* I - HTTP connection */
2885 const char *uri
) /* I - URI for trace */
2887 return (http_send(http
, HTTP_STATE_TRACE
, uri
));
2892 * '_httpUpdate()' - Update the current HTTP status for incoming data.
2894 * Note: Unlike httpUpdate(), this function does not flush pending write data
2895 * and only retrieves a single status line from the HTTP connection.
2898 int /* O - 1 to continue, 0 to stop */
2899 _httpUpdate(http_t
*http
, /* I - HTTP connection */
2900 http_status_t
*status
) /* O - Current HTTP status */
2902 char line
[32768], /* Line from connection... */
2903 *value
; /* Pointer to value on line */
2904 http_field_t field
; /* Field index */
2905 int major
, minor
; /* HTTP version numbers */
2908 DEBUG_printf(("_httpUpdate(http=%p, status=%p), state=%s", http
, status
,
2909 httpStateString(http
->state
)));
2912 * Grab a single line from the connection...
2915 if (!httpGets(line
, sizeof(line
), http
))
2917 *status
= HTTP_STATUS_ERROR
;
2921 DEBUG_printf(("2_httpUpdate: Got \"%s\"", line
));
2923 if (line
[0] == '\0')
2926 * Blank line means the start of the data section (if any). Return
2927 * the result code, too...
2929 * If we get status 100 (HTTP_STATUS_CONTINUE), then we *don't* change
2930 * states. Instead, we just return HTTP_STATUS_CONTINUE to the caller and
2934 if (http
->status
== HTTP_STATUS_CONTINUE
)
2936 *status
= http
->status
;
2940 if (http
->status
< HTTP_STATUS_BAD_REQUEST
)
2941 http
->digest_tries
= 0;
2944 if (http
->status
== HTTP_STATUS_SWITCHING_PROTOCOLS
&& !http
->tls
)
2946 if (http_tls_start(http
) != 0)
2948 httpAddrClose(NULL
, http
->fd
);
2950 *status
= http
->status
= HTTP_STATUS_ERROR
;
2954 *status
= HTTP_STATUS_CONTINUE
;
2957 #endif /* HAVE_SSL */
2959 if (http_set_length(http
) < 0)
2961 DEBUG_puts("1_httpUpdate: Bad Content-Length.");
2962 http
->error
= EINVAL
;
2963 http
->status
= *status
= HTTP_STATUS_ERROR
;
2967 switch (http
->state
)
2969 case HTTP_STATE_GET
:
2970 case HTTP_STATE_POST
:
2971 case HTTP_STATE_POST_RECV
:
2972 case HTTP_STATE_PUT
:
2975 DEBUG_printf(("1_httpUpdate: Set state to %s.",
2976 httpStateString(http
->state
)));
2978 case HTTP_STATE_POST_SEND
:
2979 case HTTP_STATE_HEAD
:
2983 http
->state
= HTTP_STATE_WAITING
;
2985 DEBUG_puts("1_httpUpdate: Reset state to HTTP_STATE_WAITING.");
2990 DEBUG_puts("1_httpUpdate: Calling http_content_coding_start.");
2991 http_content_coding_start(http
,
2992 httpGetField(http
, HTTP_FIELD_CONTENT_ENCODING
));
2993 #endif /* HAVE_LIBZ */
2995 *status
= http
->status
;
2998 else if (!strncmp(line
, "HTTP/", 5))
3001 * Got the beginning of a response...
3004 int intstatus
; /* Status value as an integer */
3006 if (sscanf(line
, "HTTP/%d.%d%d", &major
, &minor
, &intstatus
) != 3)
3008 *status
= http
->status
= HTTP_STATUS_ERROR
;
3012 httpClearFields(http
);
3014 http
->version
= (http_version_t
)(major
* 100 + minor
);
3015 *status
= http
->status
= (http_status_t
)intstatus
;
3017 else if ((value
= strchr(line
, ':')) != NULL
)
3024 while (_cups_isspace(*value
))
3027 DEBUG_printf(("1_httpUpdate: Header %s: %s", line
, value
));
3030 * Be tolerants of servers that send unknown attribute fields...
3033 if (!_cups_strcasecmp(line
, "expect"))
3036 * "Expect: 100-continue" or similar...
3039 http
->expect
= (http_status_t
)atoi(value
);
3041 else if (!_cups_strcasecmp(line
, "cookie"))
3044 * "Cookie: name=value[; name=value ...]" - replaces previous cookies...
3047 httpSetCookie(http
, value
);
3049 else if ((field
= httpFieldValue(line
)) != HTTP_FIELD_UNKNOWN
)
3050 httpSetField(http
, field
, value
);
3053 DEBUG_printf(("1_httpUpdate: unknown field %s seen!", line
));
3058 DEBUG_printf(("1_httpUpdate: Bad response line \"%s\"!", line
));
3059 http
->error
= EINVAL
;
3060 http
->status
= *status
= HTTP_STATUS_ERROR
;
3069 * 'httpUpdate()' - Update the current HTTP state for incoming data.
3072 http_status_t
/* O - HTTP status */
3073 httpUpdate(http_t
*http
) /* I - HTTP connection */
3075 http_status_t status
; /* Request status */
3078 DEBUG_printf(("httpUpdate(http=%p), state=%s", http
,
3079 httpStateString(http
->state
)));
3082 * Flush pending data, if any...
3087 DEBUG_puts("2httpUpdate: flushing buffer...");
3089 if (httpFlushWrite(http
) < 0)
3090 return (HTTP_STATUS_ERROR
);
3094 * If we haven't issued any commands, then there is nothing to "update"...
3097 if (http
->state
== HTTP_STATE_WAITING
)
3098 return (HTTP_STATUS_CONTINUE
);
3101 * Grab all of the lines we can from the connection...
3104 while (_httpUpdate(http
, &status
));
3107 * See if there was an error...
3110 if (http
->error
== EPIPE
&& http
->status
> HTTP_STATUS_CONTINUE
)
3112 DEBUG_printf(("1httpUpdate: Returning status %d...", http
->status
));
3113 return (http
->status
);
3118 DEBUG_printf(("1httpUpdate: socket error %d - %s", http
->error
,
3119 strerror(http
->error
)));
3120 http
->status
= HTTP_STATUS_ERROR
;
3121 return (HTTP_STATUS_ERROR
);
3125 * Return the current status...
3133 * '_httpWait()' - Wait for data available on a connection (no flush).
3136 int /* O - 1 if data is available, 0 otherwise */
3137 _httpWait(http_t
*http
, /* I - HTTP connection */
3138 int msec
, /* I - Milliseconds to wait */
3139 int usessl
) /* I - Use SSL context? */
3142 struct pollfd pfd
; /* Polled file descriptor */
3144 fd_set input_set
; /* select() input set */
3145 struct timeval timeout
; /* Timeout */
3146 #endif /* HAVE_POLL */
3147 int nfds
; /* Result from select()/poll() */
3150 DEBUG_printf(("4_httpWait(http=%p, msec=%d, usessl=%d)", http
, msec
, usessl
));
3154 DEBUG_printf(("5_httpWait: Returning 0 since fd=%d", http
->fd
));
3159 * Check the SSL/TLS buffers for data first...
3163 if (http
->tls
&& http_tls_pending(http
))
3165 DEBUG_puts("5_httpWait: Return 1 since there is pending TLS data.");
3168 #endif /* HAVE_SSL */
3171 * Then try doing a select() or poll() to poll the socket...
3176 pfd
.events
= POLLIN
;
3180 nfds
= poll(&pfd
, 1, msec
);
3182 while (nfds
< 0 && (errno
== EINTR
|| errno
== EAGAIN
));
3187 FD_ZERO(&input_set
);
3188 FD_SET(http
->fd
, &input_set
);
3190 DEBUG_printf(("6_httpWait: msec=%d, http->fd=%d", msec
, http
->fd
));
3194 timeout
.tv_sec
= msec
/ 1000;
3195 timeout
.tv_usec
= (msec
% 1000) * 1000;
3197 nfds
= select(http
->fd
+ 1, &input_set
, NULL
, NULL
, &timeout
);
3200 nfds
= select(http
->fd
+ 1, &input_set
, NULL
, NULL
, NULL
);
3202 DEBUG_printf(("6_httpWait: select() returned %d...", nfds
));
3205 while (nfds
< 0 && (WSAGetLastError() == WSAEINTR
||
3206 WSAGetLastError() == WSAEWOULDBLOCK
));
3208 while (nfds
< 0 && (errno
== EINTR
|| errno
== EAGAIN
));
3210 #endif /* HAVE_POLL */
3212 DEBUG_printf(("5_httpWait: returning with nfds=%d, errno=%d...", nfds
,
3220 * 'httpWait()' - Wait for data available on a connection.
3222 * @since CUPS 1.1.19/OS X 10.3@
3225 int /* O - 1 if data is available, 0 otherwise */
3226 httpWait(http_t
*http
, /* I - HTTP connection */
3227 int msec
) /* I - Milliseconds to wait */
3230 * First see if there is data in the buffer...
3233 DEBUG_printf(("2httpWait(http=%p, msec=%d)", http
, msec
));
3240 DEBUG_puts("3httpWait: Returning 1 since there is buffered data ready.");
3245 if (http
->coding
>= _HTTP_CODING_GUNZIP
&& http
->stream
.avail_in
> 0)
3247 DEBUG_puts("3httpWait: Returning 1 since there is buffered data ready.");
3250 #endif /* HAVE_LIBZ */
3253 * Flush pending data, if any...
3258 DEBUG_puts("3httpWait: Flushing write buffer.");
3260 if (httpFlushWrite(http
) < 0)
3265 * If not, check the SSL/TLS buffers and do a select() on the connection...
3268 return (_httpWait(http
, msec
, 1));
3273 * 'httpWrite()' - Write data to a HTTP connection.
3275 * This function is deprecated. Use the httpWrite2() function which can
3276 * write more than 2GB of data.
3281 int /* O - Number of bytes written */
3282 httpWrite(http_t
*http
, /* I - HTTP connection */
3283 const char *buffer
, /* I - Buffer for data */
3284 int length
) /* I - Number of bytes to write */
3286 return ((int)httpWrite2(http
, buffer
, (size_t)length
));
3291 * 'httpWrite2()' - Write data to a HTTP connection.
3293 * @since CUPS 1.2/OS X 10.5@
3296 ssize_t
/* O - Number of bytes written */
3297 httpWrite2(http_t
*http
, /* I - HTTP connection */
3298 const char *buffer
, /* I - Buffer for data */
3299 size_t length
) /* I - Number of bytes to write */
3301 ssize_t bytes
; /* Bytes written */
3304 DEBUG_printf(("httpWrite2(http=%p, buffer=%p, length=" CUPS_LLFMT
")", http
,
3305 buffer
, CUPS_LLCAST length
));
3308 * Range check input...
3311 if (!http
|| !buffer
)
3313 DEBUG_puts("1httpWrite2: Returning -1 due to bad input.");
3318 * Mark activity on the connection...
3321 http
->activity
= time(NULL
);
3324 * Buffer small writes for better performance...
3328 if (http
->coding
== _HTTP_CODING_GZIP
|| http
->coding
== _HTTP_CODING_DEFLATE
)
3330 DEBUG_printf(("1httpWrite2: http->coding=%d", http
->coding
));
3334 http_content_coding_finish(http
);
3339 http
->stream
.next_in
= (Bytef
*)buffer
;
3340 http
->stream
.avail_in
= (uInt
)length
;
3341 http
->stream
.next_out
= (Bytef
*)http
->wbuffer
+ http
->wused
;
3342 http
->stream
.avail_out
= (uInt
)(sizeof(http
->wbuffer
) - (size_t)http
->wused
);
3344 while (deflate(&(http
->stream
), Z_NO_FLUSH
) == Z_OK
)
3346 http
->wused
= (int)(sizeof(http
->wbuffer
) - (size_t)http
->stream
.avail_out
);
3348 if (http
->stream
.avail_out
== 0)
3350 if (httpFlushWrite(http
) < 0)
3352 DEBUG_puts("1httpWrite2: Unable to flush, returning -1.");
3356 http
->stream
.next_out
= (Bytef
*)http
->wbuffer
;
3357 http
->stream
.avail_out
= sizeof(http
->wbuffer
);
3361 http
->wused
= (int)(sizeof(http
->wbuffer
) - (size_t)http
->stream
.avail_out
);
3362 bytes
= (ssize_t
)length
;
3366 #endif /* HAVE_LIBZ */
3369 if (http
->wused
&& (length
+ (size_t)http
->wused
) > sizeof(http
->wbuffer
))
3371 DEBUG_printf(("2httpWrite2: Flushing buffer (wused=%d, length="
3372 CUPS_LLFMT
")", http
->wused
, CUPS_LLCAST length
));
3374 httpFlushWrite(http
);
3377 if ((length
+ (size_t)http
->wused
) <= sizeof(http
->wbuffer
) && length
< sizeof(http
->wbuffer
))
3380 * Write to buffer...
3383 DEBUG_printf(("2httpWrite2: Copying " CUPS_LLFMT
" bytes to wbuffer...",
3384 CUPS_LLCAST length
));
3386 memcpy(http
->wbuffer
+ http
->wused
, buffer
, length
);
3387 http
->wused
+= (int)length
;
3388 bytes
= (ssize_t
)length
;
3393 * Otherwise write the data directly...
3396 DEBUG_printf(("2httpWrite2: Writing " CUPS_LLFMT
" bytes to socket...",
3397 CUPS_LLCAST length
));
3399 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
3400 bytes
= (ssize_t
)http_write_chunk(http
, buffer
, length
);
3402 bytes
= (ssize_t
)http_write(http
, buffer
, length
);
3404 DEBUG_printf(("2httpWrite2: Wrote " CUPS_LLFMT
" bytes...",
3405 CUPS_LLCAST bytes
));
3408 if (http
->data_encoding
== HTTP_ENCODING_LENGTH
)
3409 http
->data_remaining
-= bytes
;
3415 * Handle end-of-request processing...
3418 if ((http
->data_encoding
== HTTP_ENCODING_CHUNKED
&& length
== 0) ||
3419 (http
->data_encoding
== HTTP_ENCODING_LENGTH
&& http
->data_remaining
== 0))
3422 * Finished with the transfer; unless we are sending POST or PUT
3427 if (http
->coding
== _HTTP_CODING_GZIP
|| http
->coding
== _HTTP_CODING_DEFLATE
)
3428 http_content_coding_finish(http
);
3429 #endif /* HAVE_LIBZ */
3433 if (httpFlushWrite(http
) < 0)
3437 if (http
->data_encoding
== HTTP_ENCODING_CHUNKED
)
3440 * Send a 0-length chunk at the end of the request...
3443 http_write(http
, "0\r\n\r\n", 5);
3446 * Reset the data state...
3449 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
3450 http
->data_remaining
= 0;
3453 if (http
->state
== HTTP_STATE_POST_RECV
)
3455 else if (http
->state
== HTTP_STATE_POST_SEND
||
3456 http
->state
== HTTP_STATE_GET_SEND
)
3457 http
->state
= HTTP_STATE_WAITING
;
3459 http
->state
= HTTP_STATE_STATUS
;
3461 DEBUG_printf(("2httpWrite2: Changed state to %s.",
3462 httpStateString(http
->state
)));
3465 DEBUG_printf(("1httpWrite2: Returning " CUPS_LLFMT
".", CUPS_LLCAST bytes
));
3472 * 'httpWriteResponse()' - Write a HTTP response to a client connection.
3474 * @since CUPS 1.7/OS X 10.9@
3477 int /* O - 0 on success, -1 on error */
3478 httpWriteResponse(http_t
*http
, /* I - HTTP connection */
3479 http_status_t status
) /* I - Status code */
3481 http_encoding_t old_encoding
; /* Old data_encoding value */
3482 off_t old_remaining
; /* Old data_remaining value */
3486 * Range check input...
3489 DEBUG_printf(("httpWriteResponse(http=%p, status=%d)", http
, status
));
3491 if (!http
|| status
< HTTP_STATUS_CONTINUE
)
3493 DEBUG_puts("1httpWriteResponse: Bad input.");
3498 * Set the various standard fields if they aren't already...
3501 if (!http
->fields
[HTTP_FIELD_DATE
][0])
3502 httpSetField(http
, HTTP_FIELD_DATE
, httpGetDateString(time(NULL
)));
3504 if (status
>= HTTP_STATUS_BAD_REQUEST
&& http
->keep_alive
)
3506 http
->keep_alive
= HTTP_KEEPALIVE_OFF
;
3507 httpSetField(http
, HTTP_FIELD_KEEP_ALIVE
, "");
3510 if (http
->version
== HTTP_VERSION_1_1
)
3512 if (!http
->fields
[HTTP_FIELD_CONNECTION
][0])
3514 if (http
->keep_alive
)
3515 httpSetField(http
, HTTP_FIELD_CONNECTION
, "Keep-Alive");
3517 httpSetField(http
, HTTP_FIELD_CONNECTION
, "close");
3520 if (http
->keep_alive
&& !http
->fields
[HTTP_FIELD_KEEP_ALIVE
][0])
3521 httpSetField(http
, HTTP_FIELD_KEEP_ALIVE
, "timeout=10");
3525 if (status
== HTTP_STATUS_UPGRADE_REQUIRED
||
3526 status
== HTTP_STATUS_SWITCHING_PROTOCOLS
)
3528 if (!http
->fields
[HTTP_FIELD_CONNECTION
][0])
3529 httpSetField(http
, HTTP_FIELD_CONNECTION
, "Upgrade");
3531 if (!http
->fields
[HTTP_FIELD_UPGRADE
][0])
3532 httpSetField(http
, HTTP_FIELD_UPGRADE
, "TLS/1.2,TLS/1.1,TLS/1.0");
3534 if (!http
->fields
[HTTP_FIELD_CONTENT_LENGTH
][0])
3535 httpSetField(http
, HTTP_FIELD_CONTENT_LENGTH
, "0");
3537 #endif /* HAVE_SSL */
3540 httpSetField(http
, HTTP_FIELD_SERVER
,
3541 http
->default_server
? http
->default_server
: CUPS_MINIMAL
);
3544 * Set the Accept-Encoding field if it isn't already...
3547 if (!http
->accept_encoding
)
3548 httpSetField(http
, HTTP_FIELD_ACCEPT_ENCODING
,
3549 http
->default_accept_encoding
? http
->default_accept_encoding
:
3551 "gzip, deflate, identity");
3554 #endif /* HAVE_LIBZ */
3557 * Send the response header...
3560 old_encoding
= http
->data_encoding
;
3561 old_remaining
= http
->data_remaining
;
3562 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
3564 if (httpPrintf(http
, "HTTP/%d.%d %d %s\r\n", http
->version
/ 100,
3565 http
->version
% 100, (int)status
, httpStatus(status
)) < 0)
3567 http
->status
= HTTP_STATUS_ERROR
;
3571 if (status
!= HTTP_STATUS_CONTINUE
)
3574 * 100 Continue doesn't have the rest of the response headers...
3577 int i
; /* Looping var */
3578 const char *value
; /* Field value */
3580 for (i
= 0; i
< HTTP_FIELD_MAX
; i
++)
3582 if ((value
= httpGetField(http
, i
)) != NULL
&& *value
)
3584 if (httpPrintf(http
, "%s: %s\r\n", http_fields
[i
], value
) < 1)
3586 http
->status
= HTTP_STATUS_ERROR
;
3594 if (httpPrintf(http
, "Set-Cookie: %s path=/ httponly%s\r\n",
3595 http
->cookie
, http
->tls
? " secure" : "") < 1)
3597 http
->status
= HTTP_STATUS_ERROR
;
3603 if (httpWrite2(http
, "\r\n", 2) < 2)
3605 http
->status
= HTTP_STATUS_ERROR
;
3609 if (httpFlushWrite(http
) < 0)
3611 http
->status
= HTTP_STATUS_ERROR
;
3615 if (status
== HTTP_STATUS_CONTINUE
||
3616 status
== HTTP_STATUS_SWITCHING_PROTOCOLS
)
3619 * Restore the old data_encoding and data_length values...
3622 http
->data_encoding
= old_encoding
;
3623 http
->data_remaining
= old_remaining
;
3625 if (old_remaining
<= INT_MAX
)
3626 http
->_data_remaining
= (int)old_remaining
;
3628 http
->_data_remaining
= INT_MAX
;
3630 else if (http
->state
== HTTP_STATE_OPTIONS
||
3631 http
->state
== HTTP_STATE_HEAD
||
3632 http
->state
== HTTP_STATE_PUT
||
3633 http
->state
== HTTP_STATE_TRACE
||
3634 http
->state
== HTTP_STATE_CONNECT
||
3635 http
->state
== HTTP_STATE_STATUS
)
3637 DEBUG_printf(("1httpWriteResponse: Resetting state to HTTP_STATE_WAITING, "
3638 "was %s.", httpStateString(http
->state
)));
3639 http
->state
= HTTP_STATE_WAITING
;
3644 * Force data_encoding and data_length to be set according to the response
3648 http_set_length(http
);
3650 if (http
->data_encoding
== HTTP_ENCODING_LENGTH
&& http
->data_remaining
== 0)
3652 DEBUG_printf(("1httpWriteResponse: Resetting state to HTTP_STATE_WAITING, "
3653 "was %s.", httpStateString(http
->state
)));
3654 http
->state
= HTTP_STATE_WAITING
;
3660 * Then start any content encoding...
3663 DEBUG_puts("1httpWriteResponse: Calling http_content_coding_start.");
3664 http_content_coding_start(http
,
3665 httpGetField(http
, HTTP_FIELD_CONTENT_ENCODING
));
3666 #endif /* HAVE_LIBZ */
3676 * 'http_content_coding_finish()' - Finish doing any content encoding.
3680 http_content_coding_finish(
3681 http_t
*http
) /* I - HTTP connection */
3683 int zerr
; /* Compression status */
3684 Byte dummy
[1]; /* Dummy read buffer */
3687 switch (http
->coding
)
3689 case _HTTP_CODING_DEFLATE
:
3690 case _HTTP_CODING_GZIP
:
3691 http
->stream
.next_in
= dummy
;
3692 http
->stream
.avail_in
= 0;
3696 http
->stream
.next_out
= (Bytef
*)http
->wbuffer
+ http
->wused
;
3697 http
->stream
.avail_out
= (uInt
)(sizeof(http
->wbuffer
) - (size_t)http
->wused
);
3699 zerr
= deflate(&(http
->stream
), Z_FINISH
);
3701 http
->wused
= (int)(sizeof(http
->wbuffer
) - (size_t)http
->stream
.avail_out
);
3702 if (http
->wused
== sizeof(http
->wbuffer
))
3703 httpFlushWrite(http
);
3705 while (zerr
== Z_OK
);
3707 deflateEnd(&(http
->stream
));
3710 httpFlushWrite(http
);
3713 case _HTTP_CODING_INFLATE
:
3714 case _HTTP_CODING_GUNZIP
:
3715 inflateEnd(&(http
->stream
));
3716 free(http
->dbuffer
);
3717 http
->dbuffer
= NULL
;
3724 http
->coding
= _HTTP_CODING_IDENTITY
;
3729 * 'http_content_coding_start()' - Start doing content encoding.
3733 http_content_coding_start(
3734 http_t
*http
, /* I - HTTP connection */
3735 const char *value
) /* I - Value of Content-Encoding */
3737 int zerr
; /* Error/status */
3738 _http_coding_t coding
; /* Content coding value */
3741 DEBUG_printf(("http_content_coding_start(http=%p, value=\"%s\")", http
,
3744 if (http
->coding
!= _HTTP_CODING_IDENTITY
)
3746 DEBUG_printf(("1http_content_coding_start: http->coding already %d.",
3750 else if (!strcmp(value
, "x-gzip") || !strcmp(value
, "gzip"))
3752 if (http
->state
== HTTP_STATE_GET_SEND
||
3753 http
->state
== HTTP_STATE_POST_SEND
)
3754 coding
= http
->mode
== _HTTP_MODE_SERVER
? _HTTP_CODING_GZIP
:
3755 _HTTP_CODING_GUNZIP
;
3756 else if (http
->state
== HTTP_STATE_POST_RECV
||
3757 http
->state
== HTTP_STATE_PUT_RECV
)
3758 coding
= http
->mode
== _HTTP_MODE_CLIENT
? _HTTP_CODING_GZIP
:
3759 _HTTP_CODING_GUNZIP
;
3762 DEBUG_puts("1http_content_coding_start: Not doing content coding.");
3766 else if (!strcmp(value
, "x-deflate") || !strcmp(value
, "deflate"))
3768 if (http
->state
== HTTP_STATE_GET_SEND
||
3769 http
->state
== HTTP_STATE_POST_SEND
)
3770 coding
= http
->mode
== _HTTP_MODE_SERVER
? _HTTP_CODING_DEFLATE
:
3771 _HTTP_CODING_INFLATE
;
3772 else if (http
->state
== HTTP_STATE_POST_RECV
||
3773 http
->state
== HTTP_STATE_PUT_RECV
)
3774 coding
= http
->mode
== _HTTP_MODE_CLIENT
? _HTTP_CODING_DEFLATE
:
3775 _HTTP_CODING_INFLATE
;
3778 DEBUG_puts("1http_content_coding_start: Not doing content coding.");
3784 DEBUG_puts("1http_content_coding_start: Not doing content coding.");
3788 memset(&(http
->stream
), 0, sizeof(http
->stream
));
3792 case _HTTP_CODING_DEFLATE
:
3793 case _HTTP_CODING_GZIP
:
3795 httpFlushWrite(http
);
3798 * Window size for compression is 11 bits - optimal based on PWG Raster
3799 * sample files on pwg.org. -11 is raw deflate, 27 is gzip, per ZLIB
3803 if ((zerr
= deflateInit2(&(http
->stream
), Z_DEFAULT_COMPRESSION
,
3805 coding
== _HTTP_CODING_DEFLATE
? -11 : 27, 7,
3806 Z_DEFAULT_STRATEGY
)) < Z_OK
)
3808 http
->status
= HTTP_STATUS_ERROR
;
3809 http
->error
= zerr
== Z_MEM_ERROR
? ENOMEM
: EINVAL
;
3814 case _HTTP_CODING_INFLATE
:
3815 case _HTTP_CODING_GUNZIP
:
3816 if ((http
->dbuffer
= malloc(HTTP_MAX_BUFFER
)) == NULL
)
3818 http
->status
= HTTP_STATUS_ERROR
;
3819 http
->error
= errno
;
3824 * Window size for decompression is up to 15 bits (maximum supported).
3825 * -15 is raw inflate, 31 is gunzip, per ZLIB documentation.
3828 if ((zerr
= inflateInit2(&(http
->stream
),
3829 coding
== _HTTP_CODING_INFLATE
? -15 : 31))
3832 free(http
->dbuffer
);
3833 http
->dbuffer
= NULL
;
3834 http
->status
= HTTP_STATUS_ERROR
;
3835 http
->error
= zerr
== Z_MEM_ERROR
? ENOMEM
: EINVAL
;
3839 http
->stream
.avail_in
= 0;
3840 http
->stream
.next_in
= http
->dbuffer
;
3847 http
->coding
= coding
;
3849 DEBUG_printf(("1http_content_coding_start: http->coding now %d.",
3852 #endif /* HAVE_LIBZ */
3856 * 'http_create()' - Create an unconnected HTTP connection.
3859 static http_t
* /* O - HTTP connection */
3861 const char *host
, /* I - Hostname */
3862 int port
, /* I - Port number */
3863 http_addrlist_t
*addrlist
, /* I - Address list or NULL */
3864 int family
, /* I - Address family or AF_UNSPEC */
3865 http_encryption_t encryption
, /* I - Encryption to use */
3866 int blocking
, /* I - 1 for blocking mode */
3867 _http_mode_t mode
) /* I - _HTTP_MODE_CLIENT or _SERVER */
3869 http_t
*http
; /* New HTTP connection */
3870 char service
[255]; /* Service name */
3871 http_addrlist_t
*myaddrlist
= NULL
; /* My address list */
3874 DEBUG_printf(("4http_create(host=\"%s\", port=%d, addrlist=%p, family=%d, "
3875 "encryption=%d, blocking=%d, mode=%d)", host
, port
, addrlist
,
3876 family
, encryption
, blocking
, mode
));
3878 if (!host
&& mode
== _HTTP_MODE_CLIENT
)
3884 * Lookup the host...
3889 myaddrlist
= httpAddrCopyList(addrlist
);
3893 snprintf(service
, sizeof(service
), "%d", port
);
3895 myaddrlist
= httpAddrGetList(host
, family
, service
);
3902 * Allocate memory for the structure...
3905 if ((http
= calloc(sizeof(http_t
), 1)) == NULL
)
3907 _cupsSetError(IPP_STATUS_ERROR_INTERNAL
, strerror(errno
), 0);
3908 httpAddrFreeList(addrlist
);
3913 * Initialize the HTTP data...
3917 http
->activity
= time(NULL
);
3918 http
->addrlist
= myaddrlist
;
3919 http
->blocking
= blocking
;
3922 http
->gssctx
= GSS_C_NO_CONTEXT
;
3923 http
->gssname
= GSS_C_NO_NAME
;
3924 #endif /* HAVE_GSSAPI */
3925 http
->status
= HTTP_STATUS_CONTINUE
;
3926 http
->version
= HTTP_VERSION_1_1
;
3929 strlcpy(http
->hostname
, host
, sizeof(http
->hostname
));
3931 if (port
== 443) /* Always use encryption for https */
3932 http
->encryption
= HTTP_ENCRYPTION_ALWAYS
;
3934 http
->encryption
= encryption
;
3936 http_set_wait(http
);
3939 * Return the new structure...
3948 * 'http_debug_hex()' - Do a hex dump of a buffer.
3952 http_debug_hex(const char *prefix
, /* I - Prefix for line */
3953 const char *buffer
, /* I - Buffer to dump */
3954 int bytes
) /* I - Bytes to dump */
3956 int i
, j
, /* Looping vars */
3957 ch
; /* Current character */
3958 char line
[255], /* Line buffer */
3959 *start
, /* Start of line after prefix */
3960 *ptr
; /* Pointer into line */
3963 if (_cups_debug_fd
< 0 || _cups_debug_level
< 6)
3966 DEBUG_printf(("6%s: %d bytes:", prefix
, bytes
));
3968 snprintf(line
, sizeof(line
), "6%s: ", prefix
);
3969 start
= line
+ strlen(line
);
3971 for (i
= 0; i
< bytes
; i
+= 16)
3973 for (j
= 0, ptr
= start
; j
< 16 && (i
+ j
) < bytes
; j
++, ptr
+= 2)
3974 sprintf(ptr
, "%02X", buffer
[i
+ j
] & 255);
3978 memcpy(ptr
, " ", 3);
3983 memcpy(ptr
, " ", 3);
3986 for (j
= 0; j
< 16 && (i
+ j
) < bytes
; j
++)
3988 ch
= buffer
[i
+ j
] & 255;
3990 if (ch
< ' ' || ch
>= 127)
4004 * 'http_read()' - Read a buffer from a HTTP connection.
4006 * This function does the low-level read from the socket, retrying and timing
4010 static ssize_t
/* O - Number of bytes read or -1 on error */
4011 http_read(http_t
*http
, /* I - HTTP connection */
4012 char *buffer
, /* I - Buffer */
4013 size_t length
) /* I - Maximum bytes to read */
4015 ssize_t bytes
; /* Bytes read */
4018 DEBUG_printf(("http_read(http=%p, buffer=%p, length=" CUPS_LLFMT
")", http
,
4019 buffer
, CUPS_LLCAST length
));
4021 if (!http
->blocking
)
4023 while (!httpWait(http
, http
->wait_value
))
4025 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
4028 DEBUG_puts("2http_read: Timeout.");
4033 DEBUG_printf(("2http_read: Reading %d bytes into buffer.", (int)length
));
4039 bytes
= http_tls_read(http
, buffer
, (int)length
);
4041 #endif /* HAVE_SSL */
4042 bytes
= recv(http
->fd
, buffer
, length
, 0);
4047 if (WSAGetLastError() != WSAEINTR
)
4049 http
->error
= WSAGetLastError();
4052 else if (WSAGetLastError() == WSAEWOULDBLOCK
)
4054 if (!http
->timeout_cb
||
4055 !(*http
->timeout_cb
)(http
, http
->timeout_data
))
4057 http
->error
= WSAEWOULDBLOCK
;
4062 DEBUG_printf(("2http_read: %s", strerror(errno
)));
4064 if (errno
== EWOULDBLOCK
|| errno
== EAGAIN
)
4066 if (http
->timeout_cb
&& !(*http
->timeout_cb
)(http
, http
->timeout_data
))
4068 http
->error
= errno
;
4071 else if (!http
->timeout_cb
&& errno
!= EAGAIN
)
4073 http
->error
= errno
;
4077 else if (errno
!= EINTR
)
4079 http
->error
= errno
;
4087 DEBUG_printf(("2http_read: Read " CUPS_LLFMT
" bytes into buffer.",
4088 CUPS_LLCAST bytes
));
4091 http_debug_hex("http_read", buffer
, (int)bytes
);
4097 if (WSAGetLastError() == WSAEINTR
)
4100 http
->error
= WSAGetLastError();
4102 if (errno
== EINTR
|| (errno
== EAGAIN
&& !http
->timeout_cb
))
4105 http
->error
= errno
;
4108 else if (bytes
== 0)
4110 http
->error
= EPIPE
;
4119 * 'http_read_buffered()' - Do a buffered read from a HTTP connection.
4121 * This function reads data from the HTTP buffer or from the socket, as needed.
4124 static ssize_t
/* O - Number of bytes read or -1 on error */
4125 http_read_buffered(http_t
*http
, /* I - HTTP connection */
4126 char *buffer
, /* I - Buffer */
4127 size_t length
) /* I - Maximum bytes to read */
4129 ssize_t bytes
; /* Bytes read */
4132 DEBUG_printf(("http_read_buffered(http=%p, buffer=%p, length=" CUPS_LLFMT
4134 http
, buffer
, CUPS_LLCAST length
, http
->used
));
4138 if (length
> (size_t)http
->used
)
4139 bytes
= (ssize_t
)http
->used
;
4141 bytes
= (ssize_t
)length
;
4143 DEBUG_printf(("2http_read: Grabbing %d bytes from input buffer.",
4146 memcpy(buffer
, http
->buffer
, (size_t)bytes
);
4147 http
->used
-= (int)bytes
;
4150 memmove(http
->buffer
, http
->buffer
+ bytes
, (size_t)http
->used
);
4153 bytes
= http_read(http
, buffer
, length
);
4160 * 'http_read_chunk()' - Read a chunk from a HTTP connection.
4162 * This function reads and validates the chunk length, then does a buffered read
4163 * returning the number of bytes placed in the buffer.
4166 static ssize_t
/* O - Number of bytes read or -1 on error */
4167 http_read_chunk(http_t
*http
, /* I - HTTP connection */
4168 char *buffer
, /* I - Buffer */
4169 size_t length
) /* I - Maximum bytes to read */
4171 DEBUG_printf(("http_read_chunk(http=%p, buffer=%p, length=" CUPS_LLFMT
")",
4172 http
, buffer
, CUPS_LLCAST length
));
4174 if (http
->data_remaining
<= 0)
4176 char len
[32]; /* Length string */
4178 if (!httpGets(len
, sizeof(len
), http
))
4180 DEBUG_puts("1http_read_chunk: Could not get chunk length.");
4186 DEBUG_puts("1http_read_chunk: Blank chunk length, trying again...");
4187 if (!httpGets(len
, sizeof(len
), http
))
4189 DEBUG_puts("1http_read_chunk: Could not get chunk length.");
4194 http
->data_remaining
= strtoll(len
, NULL
, 16);
4196 if (http
->data_remaining
< 0)
4198 DEBUG_printf(("1http_read_chunk: Negative chunk length \"%s\" ("
4199 CUPS_LLFMT
")", len
, CUPS_LLCAST http
->data_remaining
));
4203 DEBUG_printf(("2http_read_chunk: Got chunk length \"%s\" (" CUPS_LLFMT
")",
4204 len
, CUPS_LLCAST http
->data_remaining
));
4206 if (http
->data_remaining
== 0)
4209 * 0-length chunk, grab trailing blank line...
4212 httpGets(len
, sizeof(len
), http
);
4216 DEBUG_printf(("2http_read_chunk: data_remaining=" CUPS_LLFMT
,
4217 CUPS_LLCAST http
->data_remaining
));
4219 if (http
->data_remaining
<= 0)
4221 else if (length
> (size_t)http
->data_remaining
)
4222 length
= (size_t)http
->data_remaining
;
4224 return (http_read_buffered(http
, buffer
, length
));
4229 * 'http_send()' - Send a request with all fields and the trailing blank line.
4232 static int /* O - 0 on success, non-zero on error */
4233 http_send(http_t
*http
, /* I - HTTP connection */
4234 http_state_t request
, /* I - Request code */
4235 const char *uri
) /* I - URI */
4237 int i
; /* Looping var */
4238 char buf
[1024]; /* Encoded URI buffer */
4239 const char *value
; /* Field value */
4240 static const char * const codes
[] = /* Request code strings */
4260 DEBUG_printf(("4http_send(http=%p, request=HTTP_%s, uri=\"%s\")",
4261 http
, codes
[request
], uri
));
4263 if (http
== NULL
|| uri
== NULL
)
4267 * Set the User-Agent field if it isn't already...
4270 if (!http
->fields
[HTTP_FIELD_USER_AGENT
][0])
4272 if (http
->default_user_agent
)
4273 httpSetField(http
, HTTP_FIELD_USER_AGENT
, http
->default_user_agent
);
4275 httpSetField(http
, HTTP_FIELD_USER_AGENT
, cupsUserAgent());
4279 * Set the Accept-Encoding field if it isn't already...
4282 if (!http
->accept_encoding
&& http
->default_accept_encoding
)
4283 httpSetField(http
, HTTP_FIELD_ACCEPT_ENCODING
,
4284 http
->default_accept_encoding
);
4287 * Encode the URI as needed...
4290 _httpEncodeURI(buf
, uri
, sizeof(buf
));
4293 * See if we had an error the last time around; if so, reconnect...
4296 if (http
->fd
< 0 || http
->status
== HTTP_STATUS_ERROR
||
4297 http
->status
>= HTTP_STATUS_BAD_REQUEST
)
4299 DEBUG_printf(("5http_send: Reconnecting, fd=%d, status=%d, tls_upgrade=%d",
4300 http
->fd
, http
->status
, http
->tls_upgrade
));
4302 if (httpReconnect2(http
, 30000, NULL
))
4307 * Flush any written data that is pending...
4312 if (httpFlushWrite(http
) < 0)
4313 if (httpReconnect2(http
, 30000, NULL
))
4318 * Send the request header...
4321 http
->state
= request
;
4322 http
->data_encoding
= HTTP_ENCODING_FIELDS
;
4324 if (request
== HTTP_STATE_POST
|| request
== HTTP_STATE_PUT
)
4327 http
->status
= HTTP_STATUS_CONTINUE
;
4330 if (http
->encryption
== HTTP_ENCRYPTION_REQUIRED
&& !http
->tls
)
4332 httpSetField(http
, HTTP_FIELD_CONNECTION
, "Upgrade");
4333 httpSetField(http
, HTTP_FIELD_UPGRADE
, "TLS/1.2,TLS/1.1,TLS/1.0");
4335 #endif /* HAVE_SSL */
4337 if (httpPrintf(http
, "%s %s HTTP/1.1\r\n", codes
[request
], buf
) < 1)
4339 http
->status
= HTTP_STATUS_ERROR
;
4343 for (i
= 0; i
< HTTP_FIELD_MAX
; i
++)
4344 if ((value
= httpGetField(http
, i
)) != NULL
&& *value
)
4346 DEBUG_printf(("5http_send: %s: %s", http_fields
[i
], value
));
4348 if (i
== HTTP_FIELD_HOST
)
4350 if (httpPrintf(http
, "Host: %s:%d\r\n", value
,
4351 httpAddrPort(http
->hostaddr
)) < 1)
4353 http
->status
= HTTP_STATUS_ERROR
;
4357 else if (httpPrintf(http
, "%s: %s\r\n", http_fields
[i
], value
) < 1)
4359 http
->status
= HTTP_STATUS_ERROR
;
4365 if (httpPrintf(http
, "Cookie: $Version=0; %s\r\n", http
->cookie
) < 1)
4367 http
->status
= HTTP_STATUS_ERROR
;
4371 DEBUG_printf(("5http_send: expect=%d, mode=%d, state=%d", http
->expect
,
4372 http
->mode
, http
->state
));
4374 if (http
->expect
== HTTP_STATUS_CONTINUE
&& http
->mode
== _HTTP_MODE_CLIENT
&&
4375 (http
->state
== HTTP_STATE_POST_RECV
||
4376 http
->state
== HTTP_STATE_PUT_RECV
))
4377 if (httpPrintf(http
, "Expect: 100-continue\r\n") < 1)
4379 http
->status
= HTTP_STATUS_ERROR
;
4383 if (httpPrintf(http
, "\r\n") < 1)
4385 http
->status
= HTTP_STATUS_ERROR
;
4389 if (httpFlushWrite(http
) < 0)
4392 http_set_length(http
);
4393 httpClearFields(http
);
4396 * The Kerberos and AuthRef authentication strings can only be used once...
4399 if (http
->field_authorization
&& http
->authstring
&&
4400 (!strncmp(http
->authstring
, "Negotiate", 9) ||
4401 !strncmp(http
->authstring
, "AuthRef", 7)))
4403 http
->_authstring
[0] = '\0';
4405 if (http
->authstring
!= http
->_authstring
)
4406 free(http
->authstring
);
4408 http
->authstring
= http
->_authstring
;
4416 * 'http_set_length()' - Set the data_encoding and data_remaining values.
4419 static off_t
/* O - Remainder or -1 on error */
4420 http_set_length(http_t
*http
) /* I - Connection */
4422 off_t remaining
; /* Remainder */
4425 DEBUG_printf(("http_set_length(http=%p) mode=%d state=%s", http
, http
->mode
,
4426 httpStateString(http
->state
)));
4428 if ((remaining
= httpGetLength2(http
)) >= 0)
4430 if (http
->mode
== _HTTP_MODE_SERVER
&&
4431 http
->state
!= HTTP_STATE_GET_SEND
&&
4432 http
->state
!= HTTP_STATE_PUT
&&
4433 http
->state
!= HTTP_STATE_POST
&&
4434 http
->state
!= HTTP_STATE_POST_SEND
)
4436 DEBUG_puts("1http_set_length: Not setting data_encoding/remaining.");
4440 if (!_cups_strcasecmp(http
->fields
[HTTP_FIELD_TRANSFER_ENCODING
],
4443 DEBUG_puts("1http_set_length: Setting data_encoding to "
4444 "HTTP_ENCODING_CHUNKED.");
4445 http
->data_encoding
= HTTP_ENCODING_CHUNKED
;
4449 DEBUG_puts("1http_set_length: Setting data_encoding to "
4450 "HTTP_ENCODING_LENGTH.");
4451 http
->data_encoding
= HTTP_ENCODING_LENGTH
;
4454 DEBUG_printf(("1http_set_length: Setting data_remaining to " CUPS_LLFMT
".",
4455 CUPS_LLCAST remaining
));
4456 http
->data_remaining
= remaining
;
4458 if (remaining
<= INT_MAX
)
4459 http
->_data_remaining
= (int)remaining
;
4461 http
->_data_remaining
= INT_MAX
;
4468 * 'http_set_timeout()' - Set the socket timeout values.
4472 http_set_timeout(int fd
, /* I - File descriptor */
4473 double timeout
) /* I - Timeout in seconds */
4476 DWORD tv
= (DWORD
)(timeout
* 1000);
4477 /* Timeout in milliseconds */
4479 setsockopt(fd
, SOL_SOCKET
, SO_RCVTIMEO
, CUPS_SOCAST
&tv
, sizeof(tv
));
4480 setsockopt(fd
, SOL_SOCKET
, SO_SNDTIMEO
, CUPS_SOCAST
&tv
, sizeof(tv
));
4483 struct timeval tv
; /* Timeout in secs and usecs */
4485 tv
.tv_sec
= (int)timeout
;
4486 tv
.tv_usec
= (int)(1000000 * fmod(timeout
, 1.0));
4488 setsockopt(fd
, SOL_SOCKET
, SO_RCVTIMEO
, CUPS_SOCAST
&tv
, sizeof(tv
));
4489 setsockopt(fd
, SOL_SOCKET
, SO_SNDTIMEO
, CUPS_SOCAST
&tv
, sizeof(tv
));
4495 * 'http_set_wait()' - Set the default wait value for reads.
4499 http_set_wait(http_t
*http
) /* I - HTTP connection */
4503 http
->wait_value
= (int)(http
->timeout_value
* 1000);
4505 if (http
->wait_value
<= 0)
4506 http
->wait_value
= 60000;
4509 http
->wait_value
= 10000;
4515 * 'http_tls_upgrade()' - Force upgrade to TLS encryption.
4518 static int /* O - Status of connection */
4519 http_tls_upgrade(http_t
*http
) /* I - HTTP connection */
4521 int ret
; /* Return value */
4522 http_t myhttp
; /* Local copy of HTTP data */
4525 DEBUG_printf(("7http_tls_upgrade(%p)", http
));
4528 * Flush the connection to make sure any previous "Upgrade" message
4535 * Copy the HTTP data to a local variable so we can do the OPTIONS
4536 * request without interfering with the existing request data...
4539 memcpy(&myhttp
, http
, sizeof(myhttp
));
4542 * Send an OPTIONS request to the server, requiring SSL or TLS
4543 * encryption on the link...
4546 http
->tls_upgrade
= 1;
4547 http
->field_authorization
= NULL
; /* Don't free the auth string */
4549 httpClearFields(http
);
4550 httpSetField(http
, HTTP_FIELD_CONNECTION
, "upgrade");
4551 httpSetField(http
, HTTP_FIELD_UPGRADE
, "TLS/1.2,TLS/1.1,TLS/1.0");
4553 if ((ret
= httpOptions(http
, "*")) == 0)
4556 * Wait for the secure connection...
4559 while (httpUpdate(http
) == HTTP_STATUS_CONTINUE
);
4563 * Restore the HTTP request data...
4566 memcpy(http
->fields
, myhttp
.fields
, sizeof(http
->fields
));
4567 http
->data_encoding
= myhttp
.data_encoding
;
4568 http
->data_remaining
= myhttp
.data_remaining
;
4569 http
->_data_remaining
= myhttp
._data_remaining
;
4570 http
->expect
= myhttp
.expect
;
4571 http
->field_authorization
= myhttp
.field_authorization
;
4572 http
->digest_tries
= myhttp
.digest_tries
;
4573 http
->tls_upgrade
= 0;
4576 * See if we actually went secure...
4582 * Server does not support HTTP upgrade...
4585 DEBUG_puts("8http_tls_upgrade: Server does not support HTTP upgrade!");
4587 httpAddrClose(NULL
, http
->fd
);
4596 #endif /* HAVE_SSL */
4600 * 'http_write()' - Write a buffer to a HTTP connection.
4603 static ssize_t
/* O - Number of bytes written */
4604 http_write(http_t
*http
, /* I - HTTP connection */
4605 const char *buffer
, /* I - Buffer for data */
4606 size_t length
) /* I - Number of bytes to write */
4608 ssize_t tbytes
, /* Total bytes sent */
4609 bytes
; /* Bytes sent */
4612 DEBUG_printf(("2http_write(http=%p, buffer=%p, length=" CUPS_LLFMT
")", http
,
4613 buffer
, CUPS_LLCAST length
));
4619 DEBUG_printf(("3http_write: About to write %d bytes.", (int)length
));
4621 if (http
->timeout_cb
)
4624 struct pollfd pfd
; /* Polled file descriptor */
4626 fd_set output_set
; /* Output ready for write? */
4627 struct timeval timeout
; /* Timeout value */
4628 #endif /* HAVE_POLL */
4629 int nfds
; /* Result from select()/poll() */
4635 pfd
.events
= POLLOUT
;
4637 while ((nfds
= poll(&pfd
, 1, http
->wait_value
)) < 0 &&
4638 (errno
== EINTR
|| errno
== EAGAIN
))
4644 FD_ZERO(&output_set
);
4645 FD_SET(http
->fd
, &output_set
);
4647 timeout
.tv_sec
= http
->wait_value
/ 1000;
4648 timeout
.tv_usec
= 1000 * (http
->wait_value
% 1000);
4650 nfds
= select(http
->fd
+ 1, NULL
, &output_set
, NULL
, &timeout
);
4653 while (nfds
< 0 && (WSAGetLastError() == WSAEINTR
||
4654 WSAGetLastError() == WSAEWOULDBLOCK
));
4656 while (nfds
< 0 && (errno
== EINTR
|| errno
== EAGAIN
));
4658 #endif /* HAVE_POLL */
4662 http
->error
= errno
;
4665 else if (nfds
== 0 && !(*http
->timeout_cb
)(http
, http
->timeout_data
))
4668 http
->error
= WSAEWOULDBLOCK
;
4670 http
->error
= EWOULDBLOCK
;
4680 bytes
= http_tls_write(http
, buffer
, (int)length
);
4682 #endif /* HAVE_SSL */
4683 bytes
= send(http
->fd
, buffer
, length
, 0);
4685 DEBUG_printf(("3http_write: Write of " CUPS_LLFMT
" bytes returned "
4686 CUPS_LLFMT
".", CUPS_LLCAST length
, CUPS_LLCAST bytes
));
4691 if (WSAGetLastError() == WSAEINTR
)
4693 else if (WSAGetLastError() == WSAEWOULDBLOCK
)
4695 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
4698 http
->error
= WSAGetLastError();
4700 else if (WSAGetLastError() != http
->error
&&
4701 WSAGetLastError() != WSAECONNRESET
)
4703 http
->error
= WSAGetLastError();
4710 else if (errno
== EWOULDBLOCK
|| errno
== EAGAIN
)
4712 if (http
->timeout_cb
&& (*http
->timeout_cb
)(http
, http
->timeout_data
))
4714 else if (!http
->timeout_cb
&& errno
== EAGAIN
)
4717 http
->error
= errno
;
4719 else if (errno
!= http
->error
&& errno
!= ECONNRESET
)
4721 http
->error
= errno
;
4726 DEBUG_printf(("3http_write: error writing data (%s).",
4727 strerror(http
->error
)));
4734 length
-= (size_t)bytes
;
4738 http_debug_hex("http_write", buffer
- tbytes
, (int)tbytes
);
4741 DEBUG_printf(("3http_write: Returning " CUPS_LLFMT
".", CUPS_LLCAST tbytes
));
4748 * 'http_write_chunk()' - Write a chunked buffer.
4751 static ssize_t
/* O - Number bytes written */
4752 http_write_chunk(http_t
*http
, /* I - HTTP connection */
4753 const char *buffer
, /* I - Buffer to write */
4754 size_t length
) /* I - Length of buffer */
4756 char header
[16]; /* Chunk header */
4757 ssize_t bytes
; /* Bytes written */
4760 DEBUG_printf(("7http_write_chunk(http=%p, buffer=%p, length=" CUPS_LLFMT
")",
4761 http
, buffer
, CUPS_LLCAST length
));
4764 * Write the chunk header, data, and trailer.
4767 snprintf(header
, sizeof(header
), "%x\r\n", (unsigned)length
);
4768 if (http_write(http
, header
, strlen(header
)) < 0)
4770 DEBUG_puts("8http_write_chunk: http_write of length failed.");
4774 if ((bytes
= http_write(http
, buffer
, length
)) < 0)
4776 DEBUG_puts("8http_write_chunk: http_write of buffer failed.");
4780 if (http_write(http
, "\r\n", 2) < 0)
4782 DEBUG_puts("8http_write_chunk: http_write of CR LF failed.");