]> git.ipfire.org Git - thirdparty/cups.git/blob - cups/http.c
projects / thirdparty / cups.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
Merge changes from CUPS 1.5b1-r9774.
[thirdparty/cups.git] / cups / http.c
1 /*
2 * "$Id: http.c 7850 2008-08-20 00:07:25Z mike $"
3 *
4 * HTTP routines for CUPS.
5 *
6 * Copyright 2007-2011 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
8 *
9 * This file contains Kerberos support code, copyright 2006 by
10 * Jelmer Vernooij.
11 *
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/".
17 *
18 * This file is subject to the Apple OS-Developed Software exception.
19 *
20 * Contents:
21 *
22 * httpAddCredential() - Allocates and adds a single credential to an
23 * array.
24 * _httpBIOMethods() - Get the OpenSSL BIO methods for HTTP
25 * connections.
26 * httpBlocking() - Set blocking/non-blocking behavior on a
27 * connection.
28 * httpCheck() - Check to see if there is a pending response
29 * from the server.
30 * httpClearCookie() - Clear the cookie value(s).
31 * httpClearFields() - Clear HTTP request fields.
32 * httpClose() - Close an HTTP connection.
33 * httpConnect() - Connect to a HTTP server.
34 * httpConnectEncrypt() - Connect to a HTTP server using encryption.
35 * httpCopyCredentials() - Copy the credentials associated with an
36 * encrypted connection.
37 * _httpConvertCredentials() - Convert credentials to the internal format.
38 * _httpCreate() - Create an unconnected HTTP connection.
39 * httpDelete() - Send a DELETE request to the server.
40 * _httpDisconnect() - Disconnect a HTTP connection.
41 * httpEncryption() - Set the required encryption on the link.
42 * httpError() - Get the last error on a connection.
43 * httpFlush() - Flush data from a HTTP connection.
44 * httpFlushWrite() - Flush data in write buffer.
45 * _httpFreeCredentials() - Free internal credentials.
46 * httpFreeCredentials() - Free an array of credentials.
47 * httpGet() - Send a GET request to the server.
48 * httpGetAuthString() - Get the current authorization string.
49 * httpGetBlocking() - Get the blocking/non-block state of a
50 * connection.
51 * httpGetCookie() - Get any cookie data from the response.
52 * httpGetFd() - Get the file descriptor associated with a
53 * connection.
54 * httpGetField() - Get a field value from a request/response.
55 * httpGetLength() - Get the amount of data remaining from the
56 * content-length or transfer-encoding fields.
57 * httpGetLength2() - Get the amount of data remaining from the
58 * content-length or transfer-encoding fields.
59 * httpGetStatus() - Get the status of the last HTTP request.
60 * httpGetSubField() - Get a sub-field value.
61 * httpGetSubField2() - Get a sub-field value.
62 * httpGets() - Get a line of text from a HTTP connection.
63 * httpHead() - Send a HEAD request to the server.
64 * httpInitialize() - Initialize the HTTP interface library and set
65 * the default HTTP proxy (if any).
66 * httpOptions() - Send an OPTIONS request to the server.
67 * _httpPeek() - Peek at data from a HTTP connection.
68 * httpPost() - Send a POST request to the server.
69 * httpPrintf() - Print a formatted string to a HTTP connection.
70 * httpPut() - Send a PUT request to the server.
71 * httpRead() - Read data from a HTTP connection.
72 * httpRead2() - Read data from a HTTP connection.
73 * _httpReadCDSA() - Read function for the CDSA library.
74 * _httpReadGNUTLS() - Read function for the GNU TLS library.
75 * httpReconnect() - Reconnect to a HTTP server.
76 * httpSetAuthString() - Set the current authorization string.
77 * httpSetCredentials() - Set the credentials associated with an
78 * encrypted connection.
79 * httpSetCookie() - Set the cookie value(s).
80 * httpSetExpect() - Set the Expect: header in a request.
81 * httpSetField() - Set the value of an HTTP header.
82 * httpSetLength() - Set the content-length and content-encoding.
83 * _httpSetTimeout() - Set read/write timeouts and an optional
84 * callback.
85 * httpTrace() - Send an TRACE request to the server.
86 * _httpUpdate() - Update the current HTTP status for incoming
87 * data.
88 * httpUpdate() - Update the current HTTP state for incoming
89 * data.
90 * _httpWait() - Wait for data available on a connection (no
91 * flush).
92 * httpWait() - Wait for data available on a connection.
93 * httpWrite() - Write data to a HTTP connection.
94 * httpWrite2() - Write data to a HTTP connection.
95 * _httpWriteCDSA() - Write function for the CDSA library.
96 * _httpWriteGNUTLS() - Write function for the GNU TLS library.
97 * http_bio_ctrl() - Control the HTTP connection.
98 * http_bio_free() - Free OpenSSL data.
99 * http_bio_new() - Initialize an OpenSSL BIO structure.
100 * http_bio_puts() - Send a string for OpenSSL.
101 * http_bio_read() - Read data for OpenSSL.
102 * http_bio_write() - Write data for OpenSSL.
103 * http_debug_hex() - Do a hex dump of a buffer.
104 * http_field() - Return the field index for a field name.
105 * http_read_ssl() - Read from a SSL/TLS connection.
106 * http_locking_cb() - Lock/unlock a thread's mutex.
107 * http_send() - Send a request with all fields and the trailing
108 * blank line.
109 * http_set_credentials() - Set the SSL/TLS credentials.
110 * http_setup_ssl() - Set up SSL/TLS support on a connection.
111 * http_shutdown_ssl() - Shut down SSL/TLS on a connection.
112 * http_threadid_cb() - Return the current thread ID.
113 * http_upgrade() - Force upgrade to TLS encryption.
114 * http_write() - Write a buffer to a HTTP connection.
115 * http_write_chunk() - Write a chunked buffer.
116 * http_write_ssl() - Write to a SSL/TLS connection.
117 */
118
119 /*
120 * Include necessary headers...
121 */
122
123 #include "cups-private.h"
124 #include <fcntl.h>
125 #ifdef WIN32
126 # include <tchar.h>
127 #else
128 # include <signal.h>
129 # include <sys/time.h>
130 # include <sys/resource.h>
131 #endif /* WIN32 */
132 #ifdef HAVE_POLL
133 # include <sys/poll.h>
134 #endif /* HAVE_POLL */
135
136
137 /*
138 * Some operating systems have done away with the Fxxxx constants for
139 * the fcntl() call; this works around that "feature"...
140 */
141
142 #ifndef FNONBLK
143 # define FNONBLK O_NONBLOCK
144 #endif /* !FNONBLK */
145
146
147 /*
148 * Local functions...
149 */
150
151 #ifdef DEBUG
152 static void http_debug_hex(const char *prefix, const char *buffer,
153 int bytes);
154 #endif /* DEBUG */
155 static http_field_t http_field(const char *name);
156 static int http_send(http_t *http, http_state_t request,
157 const char *uri);
158 static int http_write(http_t *http, const char *buffer,
159 int length);
160 static int http_write_chunk(http_t *http, const char *buffer,
161 int length);
162 #ifdef HAVE_SSL
163 static int http_read_ssl(http_t *http, char *buf, int len);
164 # if defined(HAVE_CDSASSL) && defined(HAVE_SECCERTIFICATECOPYDATA)
165 static int http_set_credentials(http_t *http);
166 # endif /* HAVE_CDSASSL ** HAVE_SECCERTIFICATECOPYDATA */
167 static int http_setup_ssl(http_t *http);
168 static void http_shutdown_ssl(http_t *http);
169 static int http_upgrade(http_t *http);
170 static int http_write_ssl(http_t *http, const char *buf, int len);
171 #endif /* HAVE_SSL */
172
173
174 /*
175 * Local globals...
176 */
177
178 static const char * const http_fields[] =
179 {
180 "Accept-Language",
181 "Accept-Ranges",
182 "Authorization",
183 "Connection",
184 "Content-Encoding",
185 "Content-Language",
186 "Content-Length",
187 "Content-Location",
188 "Content-MD5",
189 "Content-Range",
190 "Content-Type",
191 "Content-Version",
192 "Date",
193 "Host",
194 "If-Modified-Since",
195 "If-Unmodified-since",
196 "Keep-Alive",
197 "Last-Modified",
198 "Link",
199 "Location",
200 "Range",
201 "Referer",
202 "Retry-After",
203 "Transfer-Encoding",
204 "Upgrade",
205 "User-Agent",
206 "WWW-Authenticate"
207 };
208 #ifdef DEBUG
209 static const char * const http_states[] =
210 {
211 "HTTP_WAITING",
212 "HTTP_OPTIONS",
213 "HTTP_GET",
214 "HTTP_GET_SEND",
215 "HTTP_HEAD",
216 "HTTP_POST",
217 "HTTP_POST_RECV",
218 "HTTP_POST_SEND",
219 "HTTP_PUT",
220 "HTTP_PUT_RECV",
221 "HTTP_DELETE",
222 "HTTP_TRACE",
223 "HTTP_CLOSE",
224 "HTTP_STATUS"
225 };
226 #endif /* DEBUG */
227
228
229 #if defined(HAVE_SSL) && defined(HAVE_LIBSSL)
230 /*
231 * BIO methods for OpenSSL...
232 */
233
234 static int http_bio_write(BIO *h, const char *buf, int num);
235 static int http_bio_read(BIO *h, char *buf, int size);
236 static int http_bio_puts(BIO *h, const char *str);
237 static long http_bio_ctrl(BIO *h, int cmd, long arg1, void *arg2);
238 static int http_bio_new(BIO *h);
239 static int http_bio_free(BIO *data);
240
241 static BIO_METHOD http_bio_methods =
242 {
243 BIO_TYPE_SOCKET,
244 "http",
245 http_bio_write,
246 http_bio_read,
247 http_bio_puts,
248 NULL, /* http_bio_gets, */
249 http_bio_ctrl,
250 http_bio_new,
251 http_bio_free,
252 NULL,
253 };
254 #endif /* HAVE_SSL && HAVE_LIBSSL */
255
256
257 /*
258 * 'httpAddCredential()' - Allocates and adds a single credential to an array.
259 *
260 * Use @code cupsArrayNew(NULL, NULL)@ to create a credentials array.
261 *
262 * @since CUPS 1.5/Mac OS X 10.7@
263 */
264
265 int /* O - 0 on success, -1 on error */
266 httpAddCredential(
267 cups_array_t *credentials, /* I - Credentials array */
268 const void *data, /* I - PEM-encoded X.509 data */
269 size_t datalen) /* I - Length of data */
270 {
271 http_credential_t *credential; /* Credential data */
272
273
274 if ((credential = malloc(sizeof(http_credential_t))) != NULL)
275 {
276 credential->datalen = datalen;
277
278 if ((credential->data = malloc(datalen)) != NULL)
279 {
280 memcpy(credential->data, data, datalen);
281 cupsArrayAdd(credentials, credential);
282 return (0);
283 }
284
285 free(credential);
286 }
287
288 return (-1);
289 }
290
291
292 #if defined(HAVE_SSL) && defined(HAVE_LIBSSL)
293 /*
294 * '_httpBIOMethods()' - Get the OpenSSL BIO methods for HTTP connections.
295 */
296
297 BIO_METHOD * /* O - BIO methods for OpenSSL */
298 _httpBIOMethods(void)
299 {
300 return (&http_bio_methods);
301 }
302 #endif /* HAVE_SSL && HAVE_LIBSSL */
303
304
305 /*
306 * 'httpBlocking()' - Set blocking/non-blocking behavior on a connection.
307 */
308
309 void
310 httpBlocking(http_t *http, /* I - Connection to server */
311 int b) /* I - 1 = blocking, 0 = non-blocking */
312 {
313 if (http)
314 http->blocking = b;
315 }
316
317
318 /*
319 * 'httpCheck()' - Check to see if there is a pending response from the server.
320 */
321
322 int /* O - 0 = no data, 1 = data available */
323 httpCheck(http_t *http) /* I - Connection to server */
324 {
325 return (httpWait(http, 0));
326 }
327
328
329 /*
330 * 'httpClearCookie()' - Clear the cookie value(s).
331 *
332 * @since CUPS 1.1.19/Mac OS X 10.3@
333 */
334
335 void
336 httpClearCookie(http_t *http) /* I - Connection to server */
337 {
338 if (!http)
339 return;
340
341 if (http->cookie)
342 {
343 free(http->cookie);
344 http->cookie = NULL;
345 }
346 }
347
348
349 /*
350 * 'httpClearFields()' - Clear HTTP request fields.
351 */
352
353 void
354 httpClearFields(http_t *http) /* I - Connection to server */
355 {
356 if (http)
357 {
358 memset(http->fields, 0, sizeof(http->fields));
359 if (http->hostname[0] == '/')
360 httpSetField(http, HTTP_FIELD_HOST, "localhost");
361 else
362 httpSetField(http, HTTP_FIELD_HOST, http->hostname);
363
364 if (http->field_authorization)
365 {
366 free(http->field_authorization);
367 http->field_authorization = NULL;
368 }
369
370 http->expect = (http_status_t)0;
371 }
372 }
373
374
375 /*
376 * 'httpClose()' - Close an HTTP connection.
377 */
378
379 void
380 httpClose(http_t *http) /* I - Connection to server */
381 {
382 #ifdef HAVE_GSSAPI
383 OM_uint32 minor_status; /* Minor status code */
384 #endif /* HAVE_GSSAPI */
385
386
387 DEBUG_printf(("httpClose(http=%p)", http));
388
389 /*
390 * Range check input...
391 */
392
393 if (!http)
394 return;
395
396 /*
397 * Close any open connection...
398 */
399
400 _httpDisconnect(http);
401
402 /*
403 * Free memory used...
404 */
405
406 httpAddrFreeList(http->addrlist);
407
408 if (http->cookie)
409 free(http->cookie);
410
411 #ifdef HAVE_GSSAPI
412 if (http->gssctx != GSS_C_NO_CONTEXT)
413 gss_delete_sec_context(&minor_status, &http->gssctx, GSS_C_NO_BUFFER);
414
415 if (http->gssname != GSS_C_NO_NAME)
416 gss_release_name(&minor_status, &http->gssname);
417 #endif /* HAVE_GSSAPI */
418
419 #ifdef HAVE_AUTHORIZATION_H
420 if (http->auth_ref)
421 AuthorizationFree(http->auth_ref, kAuthorizationFlagDefaults);
422 #endif /* HAVE_AUTHORIZATION_H */
423
424 httpClearFields(http);
425
426 if (http->authstring && http->authstring != http->_authstring)
427 free(http->authstring);
428
429 free(http);
430 }
431
432
433 /*
434 * 'httpConnect()' - Connect to a HTTP server.
435 *
436 * This function is deprecated - use @link httpConnectEncrypt@ instead.
437 *
438 * @deprecated@
439 */
440
441 http_t * /* O - New HTTP connection */
442 httpConnect(const char *host, /* I - Host to connect to */
443 int port) /* I - Port number */
444 {
445 return (httpConnectEncrypt(host, port, HTTP_ENCRYPT_IF_REQUESTED));
446 }
447
448
449 /*
450 * 'httpConnectEncrypt()' - Connect to a HTTP server using encryption.
451 */
452
453 http_t * /* O - New HTTP connection */
454 httpConnectEncrypt(
455 const char *host, /* I - Host to connect to */
456 int port, /* I - Port number */
457 http_encryption_t encryption) /* I - Type of encryption to use */
458 {
459 http_t *http; /* New HTTP connection */
460
461
462 DEBUG_printf(("httpConnectEncrypt(host=\"%s\", port=%d, encryption=%d)",
463 host, port, encryption));
464
465 /*
466 * Create the HTTP structure...
467 */
468
469 if ((http = _httpCreate(host, port, NULL, encryption, AF_UNSPEC)) == NULL)
470 return (NULL);
471
472 /*
473 * Connect to the remote system...
474 */
475
476 if (!httpReconnect(http))
477 return (http);
478
479 /*
480 * Could not connect to any known address - bail out!
481 */
482
483 httpAddrFreeList(http->addrlist);
484
485 free(http);
486
487 return (NULL);
488 }
489
490
491 /*
492 * 'httpCopyCredentials()' - Copy the credentials associated with an encrypted
493 * connection.
494 *
495 * @since CUPS 1.5/Mac OS X 10.7@
496 */
497
498 int /* O - Status of call (0 = success) */
499 httpCopyCredentials(
500 http_t *http, /* I - Connection to server */
501 cups_array_t **credentials) /* O - Array of credentials */
502 {
503 # ifdef HAVE_LIBSSL
504 # elif defined(HAVE_GNUTLS)
505 # elif defined(HAVE_CDSASSL) && defined(HAVE_SECCERTIFICATECOPYDATA)
506 OSStatus error; /* Error code */
507 CFIndex count; /* Number of credentials */
508 CFArrayRef peerCerts; /* Peer certificates */
509 SecCertificateRef secCert; /* Certificate reference */
510 CFDataRef data; /* Certificate data */
511 int i; /* Looping var */
512 # elif defined(HAVE_SSPISSL)
513 # endif /* HAVE_LIBSSL */
514
515
516 if (credentials)
517 *credentials = NULL;
518
519 if (!http || !http->tls || !credentials)
520 return (-1);
521
522 # ifdef HAVE_LIBSSL
523 return (-1);
524
525 # elif defined(HAVE_GNUTLS)
526 return (-1);
527
528 # elif defined(HAVE_CDSASSL) && defined(HAVE_SECCERTIFICATECOPYDATA)
529 if (!(error = SSLCopyPeerCertificates(http->tls, &peerCerts)) && peerCerts)
530 {
531 if ((*credentials = cupsArrayNew(NULL, NULL)) != NULL)
532 {
533 for (i = 0, count = CFArrayGetCount(peerCerts); i < count; i++)
534 {
535 secCert = (SecCertificateRef)CFArrayGetValueAtIndex(peerCerts, i);
536 if ((data = SecCertificateCopyData(secCert)))
537 {
538 httpAddCredential(*credentials, CFDataGetBytePtr(data),
539 CFDataGetLength(data));
540 CFRelease(data);
541 }
542 }
543 }
544
545 CFRelease(peerCerts);
546 }
547
548 return (error);
549
550 # elif defined(HAVE_SSPISSL)
551 return (-1);
552
553 # else
554 return (-1);
555 # endif /* HAVE_LIBSSL */
556 }
557
558
559 /*
560 * '_httpConvertCredentials()' - Convert credentials to the internal format.
561 */
562
563 http_tls_credentials_t /* O - Internal credentials */
564 _httpConvertCredentials(
565 cups_array_t *credentials) /* I - Array of credentials */
566 {
567 if (!credentials)
568 return (NULL);
569
570 # ifdef HAVE_LIBSSL
571 return (NULL);
572
573 # elif defined(HAVE_GNUTLS)
574 return (NULL);
575
576 # elif defined(HAVE_CDSASSL) && defined(HAVE_SECCERTIFICATECOPYDATA)
577 CFMutableArrayRef peerCerts; /* Peer credentials reference */
578 SecCertificateRef secCert; /* Certificate reference */
579 CFDataRef data; /* Credential data reference */
580 http_credential_t *credential; /* Credential data */
581
582
583 if ((peerCerts = CFArrayCreateMutable(kCFAllocatorDefault,
584 cupsArrayCount(credentials),
585 &kCFTypeArrayCallBacks)) == NULL)
586 return (NULL);
587
588 for (credential = (http_credential_t *)cupsArrayFirst(credentials);
589 credential;
590 credential = (http_credential_t *)cupsArrayNext(credentials))
591 {
592 if ((data = CFDataCreate(kCFAllocatorDefault, credential->data,
593 credential->datalen)))
594 {
595 if ((secCert = SecCertificateCreateWithData(kCFAllocatorDefault, data))
596 != NULL)
597 {
598 CFArrayAppendValue(peerCerts, secCert);
599 CFRelease(secCert);
600 }
601
602 CFRelease(data);
603 }
604 }
605
606 return (peerCerts);
607
608 # elif defined(HAVE_SSPISSL)
609 return (NULL);
610
611 # else
612 return (NULL);
613 # endif /* HAVE_LIBSSL */
614 }
615
616
617 /*
618 * '_httpCreate()' - Create an unconnected HTTP connection.
619 */
620
621 http_t * /* O - HTTP connection */
622 _httpCreate(
623 const char *host, /* I - Hostname */
624 int port, /* I - Port number */
625 http_addrlist_t *addrlist, /* I - Address list or NULL */
626 http_encryption_t encryption, /* I - Encryption to use */
627 int family) /* I - Address family or AF_UNSPEC */
628 {
629 http_t *http; /* New HTTP connection */
630 char service[255]; /* Service name */
631
632
633 DEBUG_printf(("4_httpCreate(host=\"%s\", port=%d, encryption=%d)",
634 host, port, encryption));
635
636 if (!host)
637 return (NULL);
638
639 httpInitialize();
640
641 /*
642 * Lookup the host...
643 */
644
645 sprintf(service, "%d", port);
646
647 if (!addrlist)
648 if ((addrlist = httpAddrGetList(host, family, service)) == NULL)
649 return (NULL);
650
651 /*
652 * Allocate memory for the structure...
653 */
654
655 if ((http = calloc(sizeof(http_t), 1)) == NULL)
656 {
657 httpAddrFreeList(addrlist);
658 return (NULL);
659 }
660
661 /*
662 * Initialize the HTTP data...
663 */
664
665 http->activity = time(NULL);
666 http->addrlist = addrlist;
667 http->blocking = 1;
668 http->fd = -1;
669 #ifdef HAVE_GSSAPI
670 http->gssctx = GSS_C_NO_CONTEXT;
671 http->gssname = GSS_C_NO_NAME;
672 #endif /* HAVE_GSSAPI */
673 http->version = HTTP_1_1;
674
675 strlcpy(http->hostname, host, sizeof(http->hostname));
676
677 if (port == 443) /* Always use encryption for https */
678 http->encryption = HTTP_ENCRYPT_ALWAYS;
679 else
680 http->encryption = encryption;
681
682 /*
683 * Return the new structure...
684 */
685
686 return (http);
687 }
688
689
690 /*
691 * 'httpDelete()' - Send a DELETE request to the server.
692 */
693
694 int /* O - Status of call (0 = success) */
695 httpDelete(http_t *http, /* I - Connection to server */
696 const char *uri) /* I - URI to delete */
697 {
698 return (http_send(http, HTTP_DELETE, uri));
699 }
700
701
702 /*
703 * '_httpDisconnect()' - Disconnect a HTTP connection.
704 */
705
706 void
707 _httpDisconnect(http_t *http) /* I - Connection to server */
708 {
709 #ifdef HAVE_SSL
710 if (http->tls)
711 http_shutdown_ssl(http);
712 #endif /* HAVE_SSL */
713
714 #ifdef WIN32
715 closesocket(http->fd);
716 #else
717 close(http->fd);
718 #endif /* WIN32 */
719
720 http->fd = -1;
721 }
722
723
724 /*
725 * 'httpEncryption()' - Set the required encryption on the link.
726 */
727
728 int /* O - -1 on error, 0 on success */
729 httpEncryption(http_t *http, /* I - Connection to server */
730 http_encryption_t e) /* I - New encryption preference */
731 {
732 DEBUG_printf(("httpEncryption(http=%p, e=%d)", http, e));
733
734 #ifdef HAVE_SSL
735 if (!http)
736 return (0);
737
738 http->encryption = e;
739
740 if ((http->encryption == HTTP_ENCRYPT_ALWAYS && !http->tls) ||
741 (http->encryption == HTTP_ENCRYPT_NEVER && http->tls))
742 return (httpReconnect(http));
743 else if (http->encryption == HTTP_ENCRYPT_REQUIRED && !http->tls)
744 return (http_upgrade(http));
745 else
746 return (0);
747 #else
748 if (e == HTTP_ENCRYPT_ALWAYS || e == HTTP_ENCRYPT_REQUIRED)
749 return (-1);
750 else
751 return (0);
752 #endif /* HAVE_SSL */
753 }
754
755
756 /*
757 * 'httpError()' - Get the last error on a connection.
758 */
759
760 int /* O - Error code (errno) value */
761 httpError(http_t *http) /* I - Connection to server */
762 {
763 if (http)
764 return (http->error);
765 else
766 return (EINVAL);
767 }
768
769
770 /*
771 * 'httpFlush()' - Flush data from a HTTP connection.
772 */
773
774 void
775 httpFlush(http_t *http) /* I - Connection to server */
776 {
777 char buffer[8192]; /* Junk buffer */
778 int blocking; /* To block or not to block */
779 http_state_t oldstate; /* Old state */
780
781
782 DEBUG_printf(("httpFlush(http=%p), state=%s", http,
783 http_states[http->state]));
784
785 /*
786 * Temporarily set non-blocking mode so we don't get stuck in httpRead()...
787 */
788
789 blocking = http->blocking;
790 http->blocking = 0;
791
792 /*
793 * Read any data we can...
794 */
795
796 oldstate = http->state;
797 while (httpRead2(http, buffer, sizeof(buffer)) > 0);
798
799 /*
800 * Restore blocking and reset the connection if we didn't get all of
801 * the remaining data...
802 */
803
804 http->blocking = blocking;
805
806 if (http->state == oldstate && http->state != HTTP_WAITING && http->fd >= 0)
807 {
808 /*
809 * Didn't get the data back, so close the current connection.
810 */
811
812 http->state = HTTP_WAITING;
813
814 #ifdef HAVE_SSL
815 if (http->tls)
816 http_shutdown_ssl(http);
817 #endif /* HAVE_SSL */
818
819 #ifdef WIN32
820 closesocket(http->fd);
821 #else
822 close(http->fd);
823 #endif /* WIN32 */
824
825 http->fd = -1;
826 }
827 }
828
829
830 /*
831 * 'httpFlushWrite()' - Flush data in write buffer.
832 *
833 * @since CUPS 1.2/Mac OS X 10.5@
834 */
835
836 int /* O - Bytes written or -1 on error */
837 httpFlushWrite(http_t *http) /* I - Connection to server */
838 {
839 int bytes; /* Bytes written */
840
841
842 DEBUG_printf(("httpFlushWrite(http=%p)", http));
843
844 if (!http || !http->wused)
845 {
846 DEBUG_puts(http ? "1httpFlushWrite: Write buffer is empty." :
847 "1httpFlushWrite: No connection.");
848 return (0);
849 }
850
851 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
852 bytes = http_write_chunk(http, http->wbuffer, http->wused);
853 else
854 bytes = http_write(http, http->wbuffer, http->wused);
855
856 http->wused = 0;
857
858 DEBUG_printf(("1httpFlushWrite: Returning %d, errno=%d.", bytes, errno));
859
860 return (bytes);
861 }
862
863
864 /*
865 * '_httpFreeCredentials()' - Free internal credentials.
866 */
867
868 void
869 _httpFreeCredentials(
870 http_tls_credentials_t credentials) /* I - Internal credentials */
871 {
872 if (!credentials)
873 return;
874
875 #ifdef HAVE_LIBSSL
876 (void)credentials;
877
878 #elif defined(HAVE_GNUTLS)
879 (void)credentials;
880
881 #elif defined(HAVE_CDSASSL)
882 CFRelease(credentials);
883
884 #elif defined(HAVE_SSPISSL)
885 (void)credentials;
886
887 #endif /* HAVE_LIBSSL */
888 }
889
890
891 /*
892 * 'httpFreeCredentials()' - Free an array of credentials.
893 */
894
895 void
896 httpFreeCredentials(
897 cups_array_t *credentials) /* I - Array of credentials */
898 {
899 http_credential_t *credential; /* Credential */
900
901
902 for (credential = (http_credential_t *)cupsArrayFirst(credentials);
903 credential;
904 credential = (http_credential_t *)cupsArrayNext(credentials))
905 {
906 cupsArrayRemove(credentials, credential);
907 free((void *)credential->data);
908 free(credential);
909 }
910
911 cupsArrayDelete(credentials);
912 }
913
914
915 /*
916 * 'httpGet()' - Send a GET request to the server.
917 */
918
919 int /* O - Status of call (0 = success) */
920 httpGet(http_t *http, /* I - Connection to server */
921 const char *uri) /* I - URI to get */
922 {
923 return (http_send(http, HTTP_GET, uri));
924 }
925
926
927 /*
928 * 'httpGetAuthString()' - Get the current authorization string.
929 *
930 * The authorization string is set by cupsDoAuthentication() and
931 * httpSetAuthString(). Use httpGetAuthString() to retrieve the
932 * string to use with httpSetField() for the HTTP_FIELD_AUTHORIZATION
933 * value.
934 *
935 * @since CUPS 1.3/Mac OS X 10.5@
936 */
937
938 char * /* O - Authorization string */
939 httpGetAuthString(http_t *http) /* I - Connection to server */
940 {
941 if (http)
942 return (http->authstring);
943 else
944 return (NULL);
945 }
946
947
948 /*
949 * 'httpGetBlocking()' - Get the blocking/non-block state of a connection.
950 *
951 * @since CUPS 1.2/Mac OS X 10.5@
952 */
953
954 int /* O - 1 if blocking, 0 if non-blocking */
955 httpGetBlocking(http_t *http) /* I - Connection to server */
956 {
957 return (http ? http->blocking : 0);
958 }
959
960
961 /*
962 * 'httpGetCookie()' - Get any cookie data from the response.
963 *
964 * @since CUPS 1.1.19/Mac OS X 10.3@
965 */
966
967 const char * /* O - Cookie data or NULL */
968 httpGetCookie(http_t *http) /* I - HTTP connecion */
969 {
970 return (http ? http->cookie : NULL);
971 }
972
973
974 /*
975 * 'httpGetFd()' - Get the file descriptor associated with a connection.
976 *
977 * @since CUPS 1.2/Mac OS X 10.5@
978 */
979
980 int /* O - File descriptor or -1 if none */
981 httpGetFd(http_t *http) /* I - Connection to server */
982 {
983 return (http ? http->fd : -1);
984 }
985
986
987 /*
988 * 'httpGetField()' - Get a field value from a request/response.
989 */
990
991 const char * /* O - Field value */
992 httpGetField(http_t *http, /* I - Connection to server */
993 http_field_t field) /* I - Field to get */
994 {
995 if (!http || field <= HTTP_FIELD_UNKNOWN || field >= HTTP_FIELD_MAX)
996 return (NULL);
997 else if (field == HTTP_FIELD_AUTHORIZATION &&
998 http->field_authorization)
999 {
1000 /*
1001 * Special case for WWW-Authenticate: as its contents can be
1002 * longer than HTTP_MAX_VALUE...
1003 */
1004
1005 return (http->field_authorization);
1006 }
1007 else
1008 return (http->fields[field]);
1009 }
1010
1011
1012 /*
1013 * 'httpGetLength()' - Get the amount of data remaining from the
1014 * content-length or transfer-encoding fields.
1015 *
1016 * This function is deprecated and will not return lengths larger than
1017 * 2^31 - 1; use httpGetLength2() instead.
1018 *
1019 * @deprecated@
1020 */
1021
1022 int /* O - Content length */
1023 httpGetLength(http_t *http) /* I - Connection to server */
1024 {
1025 /*
1026 * Get the read content length and return the 32-bit value.
1027 */
1028
1029 if (http)
1030 {
1031 httpGetLength2(http);
1032
1033 return (http->_data_remaining);
1034 }
1035 else
1036 return (-1);
1037 }
1038
1039
1040 /*
1041 * 'httpGetLength2()' - Get the amount of data remaining from the
1042 * content-length or transfer-encoding fields.
1043 *
1044 * This function returns the complete content length, even for
1045 * content larger than 2^31 - 1.
1046 *
1047 * @since CUPS 1.2/Mac OS X 10.5@
1048 */
1049
1050 off_t /* O - Content length */
1051 httpGetLength2(http_t *http) /* I - Connection to server */
1052 {
1053 DEBUG_printf(("2httpGetLength2(http=%p), state=%s", http,
1054 http_states[http->state]));
1055
1056 if (!http)
1057 return (-1);
1058
1059 if (!strcasecmp(http->fields[HTTP_FIELD_TRANSFER_ENCODING], "chunked"))
1060 {
1061 DEBUG_puts("4httpGetLength2: chunked request!");
1062
1063 http->data_encoding = HTTP_ENCODE_CHUNKED;
1064 http->data_remaining = 0;
1065 }
1066 else
1067 {
1068 http->data_encoding = HTTP_ENCODE_LENGTH;
1069
1070 /*
1071 * The following is a hack for HTTP servers that don't send a
1072 * content-length or transfer-encoding field...
1073 *
1074 * If there is no content-length then the connection must close
1075 * after the transfer is complete...
1076 */
1077
1078 if (!http->fields[HTTP_FIELD_CONTENT_LENGTH][0])
1079 {
1080 /*
1081 * Default content length is 0 for errors and 2^31-1 for other
1082 * successful requests...
1083 */
1084
1085 if (http->status >= HTTP_MULTIPLE_CHOICES)
1086 http->data_remaining = 0;
1087 else
1088 http->data_remaining = 2147483647;
1089 }
1090 else
1091 http->data_remaining = strtoll(http->fields[HTTP_FIELD_CONTENT_LENGTH],
1092 NULL, 10);
1093
1094 DEBUG_printf(("4httpGetLength2: content_length=" CUPS_LLFMT,
1095 CUPS_LLCAST http->data_remaining));
1096 }
1097
1098 if (http->data_remaining <= INT_MAX)
1099 http->_data_remaining = (int)http->data_remaining;
1100 else
1101 http->_data_remaining = INT_MAX;
1102
1103 return (http->data_remaining);
1104 }
1105
1106
1107 /*
1108 * 'httpGetStatus()' - Get the status of the last HTTP request.
1109 *
1110 * @since CUPS 1.2/Mac OS X 10.5@
1111 */
1112
1113 http_status_t /* O - HTTP status */
1114 httpGetStatus(http_t *http) /* I - Connection to server */
1115 {
1116 return (http ? http->status : HTTP_ERROR);
1117 }
1118
1119
1120 /*
1121 * 'httpGetSubField()' - Get a sub-field value.
1122 *
1123 * @deprecated@
1124 */
1125
1126 char * /* O - Value or NULL */
1127 httpGetSubField(http_t *http, /* I - Connection to server */
1128 http_field_t field, /* I - Field index */
1129 const char *name, /* I - Name of sub-field */
1130 char *value) /* O - Value string */
1131 {
1132 return (httpGetSubField2(http, field, name, value, HTTP_MAX_VALUE));
1133 }
1134
1135
1136 /*
1137 * 'httpGetSubField2()' - Get a sub-field value.
1138 *
1139 * @since CUPS 1.2/Mac OS X 10.5@
1140 */
1141
1142 char * /* O - Value or NULL */
1143 httpGetSubField2(http_t *http, /* I - Connection to server */
1144 http_field_t field, /* I - Field index */
1145 const char *name, /* I - Name of sub-field */
1146 char *value, /* O - Value string */
1147 int valuelen) /* I - Size of value buffer */
1148 {
1149 const char *fptr; /* Pointer into field */
1150 char temp[HTTP_MAX_VALUE], /* Temporary buffer for name */
1151 *ptr, /* Pointer into string buffer */
1152 *end; /* End of value buffer */
1153
1154 DEBUG_printf(("2httpGetSubField2(http=%p, field=%d, name=\"%s\", value=%p, "
1155 "valuelen=%d)", http, field, name, value, valuelen));
1156
1157 if (!http || !name || !value || valuelen < 2 ||
1158 field <= HTTP_FIELD_UNKNOWN || field >= HTTP_FIELD_MAX)
1159 return (NULL);
1160
1161 end = value + valuelen - 1;
1162
1163 for (fptr = http->fields[field]; *fptr;)
1164 {
1165 /*
1166 * Skip leading whitespace...
1167 */
1168
1169 while (_cups_isspace(*fptr))
1170 fptr ++;
1171
1172 if (*fptr == ',')
1173 {
1174 fptr ++;
1175 continue;
1176 }
1177
1178 /*
1179 * Get the sub-field name...
1180 */
1181
1182 for (ptr = temp;
1183 *fptr && *fptr != '=' && !_cups_isspace(*fptr) &&
1184 ptr < (temp + sizeof(temp) - 1);
1185 *ptr++ = *fptr++);
1186
1187 *ptr = '\0';
1188
1189 DEBUG_printf(("4httpGetSubField2: name=\"%s\"", temp));
1190
1191 /*
1192 * Skip trailing chars up to the '='...
1193 */
1194
1195 while (_cups_isspace(*fptr))
1196 fptr ++;
1197
1198 if (!*fptr)
1199 break;
1200
1201 if (*fptr != '=')
1202 continue;
1203
1204 /*
1205 * Skip = and leading whitespace...
1206 */
1207
1208 fptr ++;
1209
1210 while (_cups_isspace(*fptr))
1211 fptr ++;
1212
1213 if (*fptr == '\"')
1214 {
1215 /*
1216 * Read quoted string...
1217 */
1218
1219 for (ptr = value, fptr ++;
1220 *fptr && *fptr != '\"' && ptr < end;
1221 *ptr++ = *fptr++);
1222
1223 *ptr = '\0';
1224
1225 while (*fptr && *fptr != '\"')
1226 fptr ++;
1227
1228 if (*fptr)
1229 fptr ++;
1230 }
1231 else
1232 {
1233 /*
1234 * Read unquoted string...
1235 */
1236
1237 for (ptr = value;
1238 *fptr && !_cups_isspace(*fptr) && *fptr != ',' && ptr < end;
1239 *ptr++ = *fptr++);
1240
1241 *ptr = '\0';
1242
1243 while (*fptr && !_cups_isspace(*fptr) && *fptr != ',')
1244 fptr ++;
1245 }
1246
1247 DEBUG_printf(("4httpGetSubField2: value=\"%s\"", value));
1248
1249 /*
1250 * See if this is the one...
1251 */
1252
1253 if (!strcmp(name, temp))
1254 {
1255 DEBUG_printf(("3httpGetSubField2: Returning \"%s\"", value));
1256 return (value);
1257 }
1258 }
1259
1260 value[0] = '\0';
1261
1262 DEBUG_puts("3httpGetSubField2: Returning NULL");
1263
1264 return (NULL);
1265 }
1266
1267
1268 /*
1269 * 'httpGets()' - Get a line of text from a HTTP connection.
1270 */
1271
1272 char * /* O - Line or NULL */
1273 httpGets(char *line, /* I - Line to read into */
1274 int length, /* I - Max length of buffer */
1275 http_t *http) /* I - Connection to server */
1276 {
1277 char *lineptr, /* Pointer into line */
1278 *lineend, /* End of line */
1279 *bufptr, /* Pointer into input buffer */
1280 *bufend; /* Pointer to end of buffer */
1281 int bytes, /* Number of bytes read */
1282 eol; /* End-of-line? */
1283
1284
1285 DEBUG_printf(("2httpGets(line=%p, length=%d, http=%p)", line, length, http));
1286
1287 if (http == NULL || line == NULL)
1288 return (NULL);
1289
1290 /*
1291 * Read a line from the buffer...
1292 */
1293
1294 http->error = 0;
1295 lineptr = line;
1296 lineend = line + length - 1;
1297 eol = 0;
1298
1299 while (lineptr < lineend)
1300 {
1301 /*
1302 * Pre-load the buffer as needed...
1303 */
1304
1305 #ifdef WIN32
1306 WSASetLastError(0);
1307 #else
1308 errno = 0;
1309 #endif /* WIN32 */
1310
1311 while (http->used == 0)
1312 {
1313 /*
1314 * No newline; see if there is more data to be read...
1315 */
1316
1317 if (!_httpWait(http, http->blocking ? 30000 : 10000, 1))
1318 {
1319 DEBUG_puts("3httpGets: Timed out!");
1320 #ifdef WIN32
1321 http->error = WSAETIMEDOUT;
1322 #else
1323 http->error = ETIMEDOUT;
1324 #endif /* WIN32 */
1325 return (NULL);
1326 }
1327
1328 #ifdef HAVE_SSL
1329 if (http->tls)
1330 bytes = http_read_ssl(http, http->buffer + http->used,
1331 HTTP_MAX_BUFFER - http->used);
1332 else
1333 #endif /* HAVE_SSL */
1334 bytes = recv(http->fd, http->buffer + http->used,
1335 HTTP_MAX_BUFFER - http->used, 0);
1336
1337 DEBUG_printf(("4httpGets: read %d bytes...", bytes));
1338
1339 if (bytes < 0)
1340 {
1341 /*
1342 * Nope, can't get a line this time...
1343 */
1344
1345 #ifdef WIN32
1346 DEBUG_printf(("3httpGets: recv() error %d!", WSAGetLastError()));
1347
1348 if (WSAGetLastError() == WSAEINTR)
1349 continue;
1350 else if (WSAGetLastError() == WSAEWOULDBLOCK)
1351 {
1352 if (http->timeout_cb && (*http->timeout_cb)(http, http->timeout_data))
1353 continue;
1354
1355 http->error = WSAGetLastError();
1356 }
1357 else if (WSAGetLastError() != http->error)
1358 {
1359 http->error = WSAGetLastError();
1360 continue;
1361 }
1362
1363 #else
1364 DEBUG_printf(("3httpGets: recv() error %d!", errno));
1365
1366 if (errno == EINTR)
1367 continue;
1368 else if (errno == EWOULDBLOCK || errno == EAGAIN)
1369 {
1370 if (http->timeout_cb && (*http->timeout_cb)(http, http->timeout_data))
1371 continue;
1372 else if (!http->timeout_cb && errno == EAGAIN)
1373 continue;
1374
1375 http->error = errno;
1376 }
1377 else if (errno != http->error)
1378 {
1379 http->error = errno;
1380 continue;
1381 }
1382 #endif /* WIN32 */
1383
1384 return (NULL);
1385 }
1386 else if (bytes == 0)
1387 {
1388 http->error = EPIPE;
1389
1390 return (NULL);
1391 }
1392
1393 /*
1394 * Yup, update the amount used...
1395 */
1396
1397 http->used += bytes;
1398 }
1399
1400 /*
1401 * Now copy as much of the current line as possible...
1402 */
1403
1404 for (bufptr = http->buffer, bufend = http->buffer + http->used;
1405 lineptr < lineend && bufptr < bufend;)
1406 {
1407 if (*bufptr == 0x0a)
1408 {
1409 eol = 1;
1410 bufptr ++;
1411 break;
1412 }
1413 else if (*bufptr == 0x0d)
1414 bufptr ++;
1415 else
1416 *lineptr++ = *bufptr++;
1417 }
1418
1419 http->used -= (int)(bufptr - http->buffer);
1420 if (http->used > 0)
1421 memmove(http->buffer, bufptr, http->used);
1422
1423 if (eol)
1424 {
1425 /*
1426 * End of line...
1427 */
1428
1429 http->activity = time(NULL);
1430
1431 *lineptr = '\0';
1432
1433 DEBUG_printf(("3httpGets: Returning \"%s\"", line));
1434
1435 return (line);
1436 }
1437 }
1438
1439 DEBUG_puts("3httpGets: No new line available!");
1440
1441 return (NULL);
1442 }
1443
1444
1445 /*
1446 * 'httpHead()' - Send a HEAD request to the server.
1447 */
1448
1449 int /* O - Status of call (0 = success) */
1450 httpHead(http_t *http, /* I - Connection to server */
1451 const char *uri) /* I - URI for head */
1452 {
1453 DEBUG_printf(("httpHead(http=%p, uri=\"%s\")", http, uri));
1454 return (http_send(http, HTTP_HEAD, uri));
1455 }
1456
1457
1458 /*
1459 * 'httpInitialize()' - Initialize the HTTP interface library and set the
1460 * default HTTP proxy (if any).
1461 */
1462
1463 void
1464 httpInitialize(void)
1465 {
1466 static int initialized = 0; /* Have we been called before? */
1467 #ifdef WIN32
1468 WSADATA winsockdata; /* WinSock data */
1469 #endif /* WIN32 */
1470 #ifdef HAVE_LIBSSL
1471 int i; /* Looping var */
1472 unsigned char data[1024]; /* Seed data */
1473 #endif /* HAVE_LIBSSL */
1474
1475
1476 _cupsGlobalLock();
1477 if (initialized)
1478 {
1479 _cupsGlobalUnlock();
1480 return;
1481 }
1482
1483 #ifdef WIN32
1484 WSAStartup(MAKEWORD(2,2), &winsockdata);
1485
1486 #elif !defined(SO_NOSIGPIPE)
1487 /*
1488 * Ignore SIGPIPE signals...
1489 */
1490
1491 # ifdef HAVE_SIGSET
1492 sigset(SIGPIPE, SIG_IGN);
1493
1494 # elif defined(HAVE_SIGACTION)
1495 struct sigaction action; /* POSIX sigaction data */
1496
1497
1498 memset(&action, 0, sizeof(action));
1499 action.sa_handler = SIG_IGN;
1500 sigaction(SIGPIPE, &action, NULL);
1501
1502 # else
1503 signal(SIGPIPE, SIG_IGN);
1504 # endif /* !SO_NOSIGPIPE */
1505 #endif /* WIN32 */
1506
1507 #ifdef HAVE_GNUTLS
1508 /*
1509 * Initialize GNU TLS...
1510 */
1511
1512 gnutls_global_init();
1513
1514 #elif defined(HAVE_LIBSSL)
1515 /*
1516 * Initialize OpenSSL...
1517 */
1518
1519 SSL_load_error_strings();
1520 SSL_library_init();
1521
1522 /*
1523 * Using the current time is a dubious random seed, but on some systems
1524 * it is the best we can do (on others, this seed isn't even used...)
1525 */
1526
1527 CUPS_SRAND(time(NULL));
1528
1529 for (i = 0; i < sizeof(data); i ++)
1530 data[i] = CUPS_RAND();
1531
1532 RAND_seed(data, sizeof(data));
1533 #endif /* HAVE_GNUTLS */
1534
1535 initialized = 1;
1536 _cupsGlobalUnlock();
1537 }
1538
1539
1540 /*
1541 * 'httpOptions()' - Send an OPTIONS request to the server.
1542 */
1543
1544 int /* O - Status of call (0 = success) */
1545 httpOptions(http_t *http, /* I - Connection to server */
1546 const char *uri) /* I - URI for options */
1547 {
1548 return (http_send(http, HTTP_OPTIONS, uri));
1549 }
1550
1551
1552 /*
1553 * '_httpPeek()' - Peek at data from a HTTP connection.
1554 *
1555 * This function copies available data from the given HTTP connection, reading
1556 * a buffer as needed. The data is still available for reading using
1557 * @link httpRead@ or @link httpRead2@.
1558 *
1559 * For non-blocking connections the usual timeouts apply.
1560 */
1561
1562 ssize_t /* O - Number of bytes copied */
1563 _httpPeek(http_t *http, /* I - Connection to server */
1564 char *buffer, /* I - Buffer for data */
1565 size_t length) /* I - Maximum number of bytes */
1566 {
1567 ssize_t bytes; /* Bytes read */
1568 char len[32]; /* Length string */
1569
1570
1571 DEBUG_printf(("_httpPeek(http=%p, buffer=%p, length=" CUPS_LLFMT ")",
1572 http, buffer, CUPS_LLCAST length));
1573
1574 if (http == NULL || buffer == NULL)
1575 return (-1);
1576
1577 http->activity = time(NULL);
1578 http->error = 0;
1579
1580 if (length <= 0)
1581 return (0);
1582
1583 if (http->data_encoding == HTTP_ENCODE_CHUNKED &&
1584 http->data_remaining <= 0)
1585 {
1586 DEBUG_puts("2_httpPeek: Getting chunk length...");
1587
1588 if (httpGets(len, sizeof(len), http) == NULL)
1589 {
1590 DEBUG_puts("1_httpPeek: Could not get length!");
1591 return (0);
1592 }
1593
1594 http->data_remaining = strtoll(len, NULL, 16);
1595 if (http->data_remaining < 0)
1596 {
1597 DEBUG_puts("1_httpPeek: Negative chunk length!");
1598 return (0);
1599 }
1600 }
1601
1602 DEBUG_printf(("2_httpPeek: data_remaining=" CUPS_LLFMT,
1603 CUPS_LLCAST http->data_remaining));
1604
1605 if (http->data_remaining <= 0)
1606 {
1607 /*
1608 * A zero-length chunk ends a transfer; unless we are reading POST
1609 * data, go idle...
1610 */
1611
1612 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
1613 httpGets(len, sizeof(len), http);
1614
1615 if (http->state == HTTP_POST_RECV)
1616 http->state ++;
1617 else
1618 http->state = HTTP_WAITING;
1619
1620 /*
1621 * Prevent future reads for this request...
1622 */
1623
1624 http->data_encoding = HTTP_ENCODE_LENGTH;
1625
1626 return (0);
1627 }
1628 else if (length > (size_t)http->data_remaining)
1629 length = (size_t)http->data_remaining;
1630
1631 if (http->used == 0)
1632 {
1633 /*
1634 * Buffer small reads for better performance...
1635 */
1636
1637 if (!http->blocking && !httpWait(http, 10000))
1638 return (0);
1639
1640 if (http->data_remaining > sizeof(http->buffer))
1641 bytes = sizeof(http->buffer);
1642 else
1643 bytes = http->data_remaining;
1644
1645 #ifdef HAVE_SSL
1646 if (http->tls)
1647 bytes = http_read_ssl(http, http->buffer, bytes);
1648 else
1649 #endif /* HAVE_SSL */
1650 {
1651 DEBUG_printf(("2_httpPeek: reading %d bytes from socket into buffer...",
1652 (int)bytes));
1653
1654 bytes = recv(http->fd, http->buffer, bytes, 0);
1655
1656 DEBUG_printf(("2_httpPeek: read %d bytes from socket into buffer...",
1657 (int)bytes));
1658 }
1659
1660 if (bytes > 0)
1661 http->used = bytes;
1662 else if (bytes < 0)
1663 {
1664 #ifdef WIN32
1665 if (WSAGetLastError() != WSAEINTR && WSAGetLastError() != WSAEWOULDBLOCK)
1666 {
1667 http->error = WSAGetLastError();
1668 return (-1);
1669 }
1670 #else
1671 if (errno != EINTR && errno != EAGAIN)
1672 {
1673 http->error = errno;
1674 return (-1);
1675 }
1676 #endif /* WIN32 */
1677 }
1678 else
1679 {
1680 http->error = EPIPE;
1681 return (0);
1682 }
1683 }
1684
1685 if (http->used > 0)
1686 {
1687 if (length > (size_t)http->used)
1688 length = (size_t)http->used;
1689
1690 bytes = (ssize_t)length;
1691
1692 DEBUG_printf(("2_httpPeek: grabbing %d bytes from input buffer...",
1693 (int)bytes));
1694
1695 memcpy(buffer, http->buffer, length);
1696 }
1697 else
1698 bytes = 0;
1699
1700 if (bytes < 0)
1701 {
1702 #ifdef WIN32
1703 if (WSAGetLastError() == WSAEINTR || WSAGetLastError() == WSAEWOULDBLOCK)
1704 bytes = 0;
1705 else
1706 http->error = WSAGetLastError();
1707 #else
1708 if (errno == EINTR || errno == EAGAIN)
1709 bytes = 0;
1710 else
1711 http->error = errno;
1712 #endif /* WIN32 */
1713 }
1714 else if (bytes == 0)
1715 {
1716 http->error = EPIPE;
1717 return (0);
1718 }
1719
1720 #ifdef DEBUG
1721 http_debug_hex("_httpPeek", buffer, (int)bytes);
1722 #endif /* DEBUG */
1723
1724 return (bytes);
1725 }
1726
1727
1728 /*
1729 * 'httpPost()' - Send a POST request to the server.
1730 */
1731
1732 int /* O - Status of call (0 = success) */
1733 httpPost(http_t *http, /* I - Connection to server */
1734 const char *uri) /* I - URI for post */
1735 {
1736 return (http_send(http, HTTP_POST, uri));
1737 }
1738
1739
1740 /*
1741 * 'httpPrintf()' - Print a formatted string to a HTTP connection.
1742 *
1743 * @private@
1744 */
1745
1746 int /* O - Number of bytes written */
1747 httpPrintf(http_t *http, /* I - Connection to server */
1748 const char *format, /* I - printf-style format string */
1749 ...) /* I - Additional args as needed */
1750 {
1751 int bytes; /* Number of bytes to write */
1752 char buf[16384]; /* Buffer for formatted string */
1753 va_list ap; /* Variable argument pointer */
1754
1755
1756 DEBUG_printf(("2httpPrintf(http=%p, format=\"%s\", ...)", http, format));
1757
1758 va_start(ap, format);
1759 bytes = vsnprintf(buf, sizeof(buf), format, ap);
1760 va_end(ap);
1761
1762 DEBUG_printf(("3httpPrintf: %s", buf));
1763
1764 if (http->data_encoding == HTTP_ENCODE_FIELDS)
1765 return (httpWrite2(http, buf, bytes));
1766 else
1767 {
1768 if (http->wused)
1769 {
1770 DEBUG_puts("4httpPrintf: flushing existing data...");
1771
1772 if (httpFlushWrite(http) < 0)
1773 return (-1);
1774 }
1775
1776 return (http_write(http, buf, bytes));
1777 }
1778 }
1779
1780
1781 /*
1782 * 'httpPut()' - Send a PUT request to the server.
1783 */
1784
1785 int /* O - Status of call (0 = success) */
1786 httpPut(http_t *http, /* I - Connection to server */
1787 const char *uri) /* I - URI to put */
1788 {
1789 DEBUG_printf(("httpPut(http=%p, uri=\"%s\")", http, uri));
1790 return (http_send(http, HTTP_PUT, uri));
1791 }
1792
1793
1794 /*
1795 * 'httpRead()' - Read data from a HTTP connection.
1796 *
1797 * This function is deprecated. Use the httpRead2() function which can
1798 * read more than 2GB of data.
1799 *
1800 * @deprecated@
1801 */
1802
1803 int /* O - Number of bytes read */
1804 httpRead(http_t *http, /* I - Connection to server */
1805 char *buffer, /* I - Buffer for data */
1806 int length) /* I - Maximum number of bytes */
1807 {
1808 return ((int)httpRead2(http, buffer, length));
1809 }
1810
1811
1812 /*
1813 * 'httpRead2()' - Read data from a HTTP connection.
1814 *
1815 * @since CUPS 1.2/Mac OS X 10.5@
1816 */
1817
1818 ssize_t /* O - Number of bytes read */
1819 httpRead2(http_t *http, /* I - Connection to server */
1820 char *buffer, /* I - Buffer for data */
1821 size_t length) /* I - Maximum number of bytes */
1822 {
1823 ssize_t bytes; /* Bytes read */
1824 char len[32]; /* Length string */
1825
1826
1827 DEBUG_printf(("httpRead2(http=%p, buffer=%p, length=" CUPS_LLFMT ")",
1828 http, buffer, CUPS_LLCAST length));
1829
1830 if (http == NULL || buffer == NULL)
1831 return (-1);
1832
1833 http->activity = time(NULL);
1834 http->error = 0;
1835
1836 if (length <= 0)
1837 return (0);
1838
1839 if (http->data_encoding == HTTP_ENCODE_CHUNKED &&
1840 http->data_remaining <= 0)
1841 {
1842 DEBUG_puts("2httpRead2: Getting chunk length...");
1843
1844 if (httpGets(len, sizeof(len), http) == NULL)
1845 {
1846 DEBUG_puts("1httpRead2: Could not get length!");
1847 return (0);
1848 }
1849
1850 http->data_remaining = strtoll(len, NULL, 16);
1851 if (http->data_remaining < 0)
1852 {
1853 DEBUG_puts("1httpRead2: Negative chunk length!");
1854 return (0);
1855 }
1856 }
1857
1858 DEBUG_printf(("2httpRead2: data_remaining=" CUPS_LLFMT,
1859 CUPS_LLCAST http->data_remaining));
1860
1861 if (http->data_remaining <= 0)
1862 {
1863 /*
1864 * A zero-length chunk ends a transfer; unless we are reading POST
1865 * data, go idle...
1866 */
1867
1868 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
1869 httpGets(len, sizeof(len), http);
1870
1871 if (http->state == HTTP_POST_RECV)
1872 http->state ++;
1873 else
1874 http->state = HTTP_WAITING;
1875
1876 /*
1877 * Prevent future reads for this request...
1878 */
1879
1880 http->data_encoding = HTTP_ENCODE_LENGTH;
1881
1882 return (0);
1883 }
1884 else if (length > (size_t)http->data_remaining)
1885 length = (size_t)http->data_remaining;
1886
1887 if (http->used == 0 && length <= 256)
1888 {
1889 /*
1890 * Buffer small reads for better performance...
1891 */
1892
1893 if (!http->blocking && !httpWait(http, 10000))
1894 return (0);
1895
1896 if (http->data_remaining > sizeof(http->buffer))
1897 bytes = sizeof(http->buffer);
1898 else
1899 bytes = http->data_remaining;
1900
1901 #ifdef HAVE_SSL
1902 if (http->tls)
1903 bytes = http_read_ssl(http, http->buffer, bytes);
1904 else
1905 #endif /* HAVE_SSL */
1906 {
1907 DEBUG_printf(("2httpRead2: reading %d bytes from socket into buffer...",
1908 (int)bytes));
1909
1910 bytes = recv(http->fd, http->buffer, bytes, 0);
1911
1912 DEBUG_printf(("2httpRead2: read %d bytes from socket into buffer...",
1913 (int)bytes));
1914 }
1915
1916 if (bytes > 0)
1917 http->used = bytes;
1918 else if (bytes < 0)
1919 {
1920 #ifdef WIN32
1921 if (WSAGetLastError() != WSAEINTR)
1922 {
1923 http->error = WSAGetLastError();
1924 return (-1);
1925 }
1926 else if (WSAGetLastError() == WSAEWOULDBLOCK)
1927 {
1928 if (!http->timeout_cb || !(*http->timeout_cb)(http, http->timeout_data))
1929 {
1930 http->error = WSAEWOULDBLOCK;
1931 return (-1);
1932 }
1933 }
1934 #else
1935 if (errno == EWOULDBLOCK || errno == EAGAIN)
1936 {
1937 if (http->timeout_cb && !(*http->timeout_cb)(http, http->timeout_data))
1938 {
1939 http->error = errno;
1940 return (-1);
1941 }
1942 else if (!http->timeout_cb && errno != EAGAIN)
1943 {
1944 http->error = errno;
1945 return (-1);
1946 }
1947 }
1948 else if (errno != EINTR)
1949 {
1950 http->error = errno;
1951 return (-1);
1952 }
1953 #endif /* WIN32 */
1954 }
1955 else
1956 {
1957 http->error = EPIPE;
1958 return (0);
1959 }
1960 }
1961
1962 if (http->used > 0)
1963 {
1964 if (length > (size_t)http->used)
1965 length = (size_t)http->used;
1966
1967 bytes = (ssize_t)length;
1968
1969 DEBUG_printf(("2httpRead2: grabbing %d bytes from input buffer...",
1970 (int)bytes));
1971
1972 memcpy(buffer, http->buffer, length);
1973 http->used -= (int)length;
1974
1975 if (http->used > 0)
1976 memmove(http->buffer, http->buffer + length, http->used);
1977 }
1978 #ifdef HAVE_SSL
1979 else if (http->tls)
1980 {
1981 if (!http->blocking && !httpWait(http, 10000))
1982 return (0);
1983
1984 bytes = (ssize_t)http_read_ssl(http, buffer, (int)length);
1985 }
1986 #endif /* HAVE_SSL */
1987 else
1988 {
1989 if (!http->blocking && !httpWait(http, 10000))
1990 return (0);
1991
1992 DEBUG_printf(("2httpRead2: reading " CUPS_LLFMT " bytes from socket...",
1993 CUPS_LLCAST length));
1994
1995 #ifdef WIN32
1996 while ((bytes = (ssize_t)recv(http->fd, buffer, (int)length, 0)) < 0)
1997 {
1998 if (WSAGetLastError() == WSAEWOULDBLOCK)
1999 {
2000 if (!http->timeout_cb || !(*http->timeout_cb)(http, http->timeout_data))
2001 break;
2002 }
2003 else if (WSAGetLastError() != WSAEINTR)
2004 break;
2005 }
2006 #else
2007 while ((bytes = recv(http->fd, buffer, length, 0)) < 0)
2008 {
2009 if (errno == EWOULDBLOCK || errno == EAGAIN)
2010 {
2011 if (http->timeout_cb && !(*http->timeout_cb)(http, http->timeout_data))
2012 break;
2013 else if (!http->timeout_cb && errno != EAGAIN)
2014 break;
2015 }
2016 else if (errno != EINTR)
2017 break;
2018 }
2019 #endif /* WIN32 */
2020
2021 DEBUG_printf(("2httpRead2: read " CUPS_LLFMT " bytes from socket...",
2022 CUPS_LLCAST bytes));
2023 }
2024
2025 if (bytes > 0)
2026 {
2027 http->data_remaining -= bytes;
2028
2029 if (http->data_remaining <= INT_MAX)
2030 http->_data_remaining = (int)http->data_remaining;
2031 else
2032 http->_data_remaining = INT_MAX;
2033 }
2034 else if (bytes < 0)
2035 {
2036 #ifdef WIN32
2037 if (WSAGetLastError() == WSAEINTR)
2038 bytes = 0;
2039 else
2040 http->error = WSAGetLastError();
2041 #else
2042 if (errno == EINTR || (errno == EAGAIN && !http->timeout_cb))
2043 bytes = 0;
2044 else
2045 http->error = errno;
2046 #endif /* WIN32 */
2047 }
2048 else
2049 {
2050 http->error = EPIPE;
2051 return (0);
2052 }
2053
2054 if (http->data_remaining == 0)
2055 {
2056 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
2057 httpGets(len, sizeof(len), http);
2058
2059 if (http->data_encoding != HTTP_ENCODE_CHUNKED)
2060 {
2061 if (http->state == HTTP_POST_RECV)
2062 http->state ++;
2063 else
2064 http->state = HTTP_WAITING;
2065 }
2066 }
2067
2068 #ifdef DEBUG
2069 http_debug_hex("httpRead2", buffer, (int)bytes);
2070 #endif /* DEBUG */
2071
2072 return (bytes);
2073 }
2074
2075
2076 #if defined(HAVE_SSL) && defined(HAVE_CDSASSL)
2077 /*
2078 * '_httpReadCDSA()' - Read function for the CDSA library.
2079 */
2080
2081 OSStatus /* O - -1 on error, 0 on success */
2082 _httpReadCDSA(
2083 SSLConnectionRef connection, /* I - SSL/TLS connection */
2084 void *data, /* I - Data buffer */
2085 size_t *dataLength) /* IO - Number of bytes */
2086 {
2087 OSStatus result; /* Return value */
2088 ssize_t bytes; /* Number of bytes read */
2089 http_t *http; /* HTTP connection */
2090
2091
2092 http = (http_t *)connection;
2093
2094 if (!http->blocking)
2095 {
2096 /*
2097 * Make sure we have data before we read...
2098 */
2099
2100 if (!_httpWait(http, 10000, 0))
2101 {
2102 http->error = ETIMEDOUT;
2103 return (-1);
2104 }
2105 }
2106
2107 do
2108 {
2109 bytes = recv(http->fd, data, *dataLength, 0);
2110 }
2111 while (bytes == -1 && (errno == EINTR || errno == EAGAIN));
2112
2113 if (bytes == *dataLength)
2114 {
2115 result = 0;
2116 }
2117 else if (bytes > 0)
2118 {
2119 *dataLength = bytes;
2120 result = errSSLWouldBlock;
2121 }
2122 else
2123 {
2124 *dataLength = 0;
2125
2126 if (bytes == 0)
2127 result = errSSLClosedGraceful;
2128 else if (errno == EAGAIN)
2129 result = errSSLWouldBlock;
2130 else
2131 result = errSSLClosedAbort;
2132 }
2133
2134 return (result);
2135 }
2136 #endif /* HAVE_SSL && HAVE_CDSASSL */
2137
2138
2139 #if defined(HAVE_SSL) && defined(HAVE_GNUTLS)
2140 /*
2141 * '_httpReadGNUTLS()' - Read function for the GNU TLS library.
2142 */
2143
2144 ssize_t /* O - Number of bytes read or -1 on error */
2145 _httpReadGNUTLS(
2146 gnutls_transport_ptr ptr, /* I - Connection to server */
2147 void *data, /* I - Buffer */
2148 size_t length) /* I - Number of bytes to read */
2149 {
2150 http_t *http; /* HTTP connection */
2151
2152
2153 http = (http_t *)ptr;
2154
2155 if (!http->blocking)
2156 {
2157 /*
2158 * Make sure we have data before we read...
2159 */
2160
2161 if (!_httpWait(http, 10000, 0))
2162 {
2163 http->error = ETIMEDOUT;
2164 return (-1);
2165 }
2166 }
2167
2168 return (recv(http->fd, data, length, 0));
2169 }
2170 #endif /* HAVE_SSL && HAVE_GNUTLS */
2171
2172
2173 /*
2174 * 'httpReconnect()' - Reconnect to a HTTP server.
2175 */
2176
2177 int /* O - 0 on success, non-zero on failure */
2178 httpReconnect(http_t *http) /* I - Connection to server */
2179 {
2180 http_addrlist_t *addr; /* Connected address */
2181 #ifdef DEBUG
2182 http_addrlist_t *current; /* Current address */
2183 char temp[256]; /* Temporary address string */
2184 #endif /* DEBUG */
2185
2186
2187 DEBUG_printf(("httpReconnect(http=%p)", http));
2188
2189 if (!http)
2190 return (-1);
2191
2192 #ifdef HAVE_SSL
2193 if (http->tls)
2194 {
2195 DEBUG_puts("2httpReconnect: Shutting down SSL/TLS...");
2196 http_shutdown_ssl(http);
2197 }
2198 #endif /* HAVE_SSL */
2199
2200 /*
2201 * Close any previously open socket...
2202 */
2203
2204 if (http->fd >= 0)
2205 {
2206 DEBUG_printf(("2httpReconnect: Closing socket %d...", http->fd));
2207
2208 #ifdef WIN32
2209 closesocket(http->fd);
2210 #else
2211 close(http->fd);
2212 #endif /* WIN32 */
2213
2214 http->fd = -1;
2215 }
2216
2217 /*
2218 * Connect to the server...
2219 */
2220
2221 #ifdef DEBUG
2222 for (current = http->addrlist; current; current = current->next)
2223 DEBUG_printf(("2httpReconnect: Address %s:%d",
2224 httpAddrString(&(current->addr), temp, sizeof(temp)),
2225 _httpAddrPort(&(current->addr))));
2226 #endif /* DEBUG */
2227
2228 if ((addr = httpAddrConnect(http->addrlist, &(http->fd))) == NULL)
2229 {
2230 /*
2231 * Unable to connect...
2232 */
2233
2234 #ifdef WIN32
2235 http->error = WSAGetLastError();
2236 #else
2237 http->error = errno;
2238 #endif /* WIN32 */
2239 http->status = HTTP_ERROR;
2240
2241 DEBUG_printf(("1httpReconnect: httpAddrConnect failed: %s",
2242 strerror(http->error)));
2243
2244 return (-1);
2245 }
2246
2247 DEBUG_printf(("2httpReconnect: New socket=%d", http->fd));
2248
2249 if (http->timeout_value.tv_sec > 0)
2250 {
2251 #ifdef WIN32
2252 DWORD timeout_value = http->timeout_value.tv_sec * 1000 +
2253 http->timeout_value.tv_usec / 1000;
2254 /* Timeout in milliseconds */
2255
2256 setsockopt(http->fd, SOL_SOCKET, SO_RCVTIMEO, (char *)&timeout_value,
2257 sizeof(timeout_value));
2258 setsockopt(http->fd, SOL_SOCKET, SO_SNDTIMEO, (char *)&timeout_value,
2259 sizeof(timeout_value));
2260 #else
2261 setsockopt(http->fd, SOL_SOCKET, SO_RCVTIMEO, &(http->timeout_value),
2262 sizeof(http->timeout_value));
2263 setsockopt(http->fd, SOL_SOCKET, SO_SNDTIMEO, &(http->timeout_value),
2264 sizeof(http->timeout_value));
2265 #endif /* WIN32 */
2266 }
2267
2268 http->hostaddr = &(addr->addr);
2269 http->error = 0;
2270 http->status = HTTP_CONTINUE;
2271
2272 #ifdef HAVE_SSL
2273 if (http->encryption == HTTP_ENCRYPT_ALWAYS)
2274 {
2275 /*
2276 * Always do encryption via SSL.
2277 */
2278
2279 if (http_setup_ssl(http) != 0)
2280 {
2281 # ifdef WIN32
2282 closesocket(http->fd);
2283 # else
2284 close(http->fd);
2285 # endif /* WIN32 */
2286
2287 return (-1);
2288 }
2289 }
2290 else if (http->encryption == HTTP_ENCRYPT_REQUIRED)
2291 return (http_upgrade(http));
2292 #endif /* HAVE_SSL */
2293
2294 DEBUG_printf(("1httpReconnect: Connected to %s:%d...",
2295 httpAddrString(http->hostaddr, temp, sizeof(temp)),
2296 _httpAddrPort(http->hostaddr)));
2297
2298 return (0);
2299 }
2300
2301
2302 /*
2303 * 'httpSetAuthString()' - Set the current authorization string.
2304 *
2305 * This function just stores a copy of the current authorization string in
2306 * the HTTP connection object. You must still call httpSetField() to set
2307 * HTTP_FIELD_AUTHORIZATION prior to issuing a HTTP request using httpGet(),
2308 * httpHead(), httpOptions(), httpPost, or httpPut().
2309 *
2310 * @since CUPS 1.3/Mac OS X 10.5@
2311 */
2312
2313 void
2314 httpSetAuthString(http_t *http, /* I - Connection to server */
2315 const char *scheme, /* I - Auth scheme (NULL to clear it) */
2316 const char *data) /* I - Auth data (NULL for none) */
2317 {
2318 /*
2319 * Range check input...
2320 */
2321
2322 if (!http)
2323 return;
2324
2325 if (http->authstring && http->authstring != http->_authstring)
2326 free(http->authstring);
2327
2328 http->authstring = http->_authstring;
2329
2330 if (scheme)
2331 {
2332 /*
2333 * Set the current authorization string...
2334 */
2335
2336 int len = (int)strlen(scheme) + (data ? (int)strlen(data) + 1 : 0) + 1;
2337 char *temp;
2338
2339 if (len > (int)sizeof(http->_authstring))
2340 {
2341 if ((temp = malloc(len)) == NULL)
2342 len = sizeof(http->_authstring);
2343 else
2344 http->authstring = temp;
2345 }
2346
2347 if (data)
2348 snprintf(http->authstring, len, "%s %s", scheme, data);
2349 else
2350 strlcpy(http->authstring, scheme, len);
2351 }
2352 else
2353 {
2354 /*
2355 * Clear the current authorization string...
2356 */
2357
2358 http->_authstring[0] = '\0';
2359 }
2360 }
2361
2362
2363 /*
2364 * 'httpSetCredentials()' - Set the credentials associated with an encrypted
2365 * connection.
2366 *
2367 * @since CUPS 1.5/Mac OS X 10.7@
2368 */
2369
2370 int /* O - Status of call (0 = success) */
2371 httpSetCredentials(http_t *http, /* I - Connection to server */
2372 cups_array_t *credentials) /* I - Array of credentials */
2373 {
2374 if (!http || cupsArrayCount(credentials) < 1)
2375 return (-1);
2376
2377 _httpFreeCredentials(http->tls_credentials);
2378
2379 http->tls_credentials = _httpConvertCredentials(credentials);
2380
2381 return (http->tls_credentials ? 0 : -1);
2382 }
2383
2384
2385 /*
2386 * 'httpSetCookie()' - Set the cookie value(s).
2387 *
2388 * @since CUPS 1.1.19/Mac OS X 10.3@
2389 */
2390
2391 void
2392 httpSetCookie(http_t *http, /* I - Connection */
2393 const char *cookie) /* I - Cookie string */
2394 {
2395 if (!http)
2396 return;
2397
2398 if (http->cookie)
2399 free(http->cookie);
2400
2401 if (cookie)
2402 http->cookie = strdup(cookie);
2403 else
2404 http->cookie = NULL;
2405 }
2406
2407
2408 /*
2409 * 'httpSetExpect()' - Set the Expect: header in a request.
2410 *
2411 * Currently only HTTP_CONTINUE is supported for the "expect" argument.
2412 *
2413 * @since CUPS 1.2/Mac OS X 10.5@
2414 */
2415
2416 void
2417 httpSetExpect(http_t *http, /* I - Connection to server */
2418 http_status_t expect) /* I - HTTP status to expect (HTTP_CONTINUE) */
2419 {
2420 if (http)
2421 http->expect = expect;
2422 }
2423
2424
2425 /*
2426 * 'httpSetField()' - Set the value of an HTTP header.
2427 */
2428
2429 void
2430 httpSetField(http_t *http, /* I - Connection to server */
2431 http_field_t field, /* I - Field index */
2432 const char *value) /* I - Value */
2433 {
2434 if (http == NULL ||
2435 field < HTTP_FIELD_ACCEPT_LANGUAGE ||
2436 field > HTTP_FIELD_WWW_AUTHENTICATE ||
2437 value == NULL)
2438 return;
2439
2440 strlcpy(http->fields[field], value, HTTP_MAX_VALUE);
2441
2442 if (field == HTTP_FIELD_AUTHORIZATION)
2443 {
2444 /*
2445 * Special case for Authorization: as its contents can be
2446 * longer than HTTP_MAX_VALUE
2447 */
2448
2449 if (http->field_authorization)
2450 free(http->field_authorization);
2451
2452 http->field_authorization = strdup(value);
2453 }
2454 else if (field == HTTP_FIELD_HOST)
2455 {
2456 /*
2457 * Special-case for Host: as we don't want a trailing "." on the hostname and
2458 * need to bracket IPv6 numeric addresses.
2459 */
2460
2461 char *ptr = strchr(value, ':');
2462
2463 if (value[0] != '[' && ptr && strchr(ptr + 1, ':'))
2464 {
2465 /*
2466 * Bracket IPv6 numeric addresses...
2467 *
2468 * This is slightly inefficient (basically copying twice), but is an edge
2469 * case and not worth optimizing...
2470 */
2471
2472 snprintf(http->fields[HTTP_FIELD_HOST],
2473 sizeof(http->fields[HTTP_FIELD_HOST]), "[%s]", value);
2474 }
2475 else
2476 {
2477 /*
2478 * Check for a trailing dot on the hostname...
2479 */
2480
2481 ptr = http->fields[HTTP_FIELD_HOST];
2482
2483 if (*ptr)
2484 {
2485 ptr += strlen(ptr) - 1;
2486
2487 if (*ptr == '.')
2488 *ptr = '\0';
2489 }
2490 }
2491 }
2492 }
2493
2494
2495 /*
2496 * 'httpSetLength()' - Set the content-length and content-encoding.
2497 *
2498 * @since CUPS 1.2/Mac OS X 10.5@
2499 */
2500
2501 void
2502 httpSetLength(http_t *http, /* I - Connection to server */
2503 size_t length) /* I - Length (0 for chunked) */
2504 {
2505 if (!http)
2506 return;
2507
2508 if (!length)
2509 {
2510 strcpy(http->fields[HTTP_FIELD_TRANSFER_ENCODING], "chunked");
2511 http->fields[HTTP_FIELD_CONTENT_LENGTH][0] = '\0';
2512 }
2513 else
2514 {
2515 http->fields[HTTP_FIELD_TRANSFER_ENCODING][0] = '\0';
2516 snprintf(http->fields[HTTP_FIELD_CONTENT_LENGTH], HTTP_MAX_VALUE,
2517 CUPS_LLFMT, CUPS_LLCAST length);
2518 }
2519 }
2520
2521
2522 /*
2523 * '_httpSetTimeout()' - Set read/write timeouts and an optional callback.
2524 *
2525 * The optional timeout callback receives both the HTTP connection and a user
2526 * data pointer and must return 1 to continue or 0 to error out.
2527 */
2528
2529 void
2530 _httpSetTimeout(
2531 http_t *http, /* I - Connection to server */
2532 double timeout, /* I - Number of seconds for timeout,
2533 must be greater than 0 */
2534 _http_timeout_cb_t cb, /* I - Callback function or NULL */
2535 void *user_data) /* I - User data pointer */
2536 {
2537 if (!http || timeout <= 0.0)
2538 return;
2539
2540 http->timeout_cb = cb;
2541 http->timeout_data = user_data;
2542 http->timeout_value.tv_sec = (int)timeout;
2543 http->timeout_value.tv_usec = (int)(timeout * 1000000) % 1000000;
2544
2545 if (http->fd >= 0)
2546 {
2547 #ifdef WIN32
2548 DWORD timeout_value = http->timeout_value.tv_sec * 1000 +
2549 http->timeout_value.tv_usec / 1000;
2550 /* Timeout in milliseconds */
2551
2552 setsockopt(http->fd, SOL_SOCKET, SO_RCVTIMEO, (char *)&timeout_value,
2553 sizeof(timeout_value));
2554 setsockopt(http->fd, SOL_SOCKET, SO_SNDTIMEO, (char *)&timeout_value,
2555 sizeof(timeout_value));
2556 #else
2557 setsockopt(http->fd, SOL_SOCKET, SO_RCVTIMEO, &(http->timeout_value),
2558 sizeof(http->timeout_value));
2559 setsockopt(http->fd, SOL_SOCKET, SO_SNDTIMEO, &(http->timeout_value),
2560 sizeof(http->timeout_value));
2561 #endif /* WIN32 */
2562 }
2563 }
2564
2565
2566 /*
2567 * 'httpTrace()' - Send an TRACE request to the server.
2568 */
2569
2570 int /* O - Status of call (0 = success) */
2571 httpTrace(http_t *http, /* I - Connection to server */
2572 const char *uri) /* I - URI for trace */
2573 {
2574 return (http_send(http, HTTP_TRACE, uri));
2575 }
2576
2577
2578 /*
2579 * '_httpUpdate()' - Update the current HTTP status for incoming data.
2580 *
2581 * Note: Unlike httpUpdate(), this function does not flush pending write data
2582 * and only retrieves a single status line from the HTTP connection.
2583 */
2584
2585 int /* O - 1 to continue, 0 to stop */
2586 _httpUpdate(http_t *http, /* I - Connection to server */
2587 http_status_t *status) /* O - Current HTTP status */
2588 {
2589 char line[32768], /* Line from connection... */
2590 *value; /* Pointer to value on line */
2591 http_field_t field; /* Field index */
2592 int major, minor; /* HTTP version numbers */
2593
2594
2595 DEBUG_printf(("_httpUpdate(http=%p, status=%p), state=%s", http, status,
2596 http_states[http->state]));
2597
2598 /*
2599 * Grab a single line from the connection...
2600 */
2601
2602 if (!httpGets(line, sizeof(line), http))
2603 {
2604 *status = HTTP_ERROR;
2605 return (0);
2606 }
2607
2608 DEBUG_printf(("2_httpUpdate: Got \"%s\"", line));
2609
2610 if (line[0] == '\0')
2611 {
2612 /*
2613 * Blank line means the start of the data section (if any). Return
2614 * the result code, too...
2615 *
2616 * If we get status 100 (HTTP_CONTINUE), then we *don't* change states.
2617 * Instead, we just return HTTP_CONTINUE to the caller and keep on
2618 * tryin'...
2619 */
2620
2621 if (http->status == HTTP_CONTINUE)
2622 {
2623 *status = http->status;
2624 return (0);
2625 }
2626
2627 if (http->status < HTTP_BAD_REQUEST)
2628 http->digest_tries = 0;
2629
2630 #ifdef HAVE_SSL
2631 if (http->status == HTTP_SWITCHING_PROTOCOLS && !http->tls)
2632 {
2633 if (http_setup_ssl(http) != 0)
2634 {
2635 # ifdef WIN32
2636 closesocket(http->fd);
2637 # else
2638 close(http->fd);
2639 # endif /* WIN32 */
2640
2641 *status = http->status = HTTP_ERROR;
2642 return (0);
2643 }
2644
2645 *status = HTTP_CONTINUE;
2646 return (0);
2647 }
2648 #endif /* HAVE_SSL */
2649
2650 httpGetLength2(http);
2651
2652 switch (http->state)
2653 {
2654 case HTTP_GET :
2655 case HTTP_POST :
2656 case HTTP_POST_RECV :
2657 case HTTP_PUT :
2658 http->state ++;
2659 case HTTP_POST_SEND :
2660 case HTTP_HEAD :
2661 break;
2662
2663 default :
2664 http->state = HTTP_WAITING;
2665 break;
2666 }
2667
2668 *status = http->status;
2669 return (0);
2670 }
2671 else if (!strncmp(line, "HTTP/", 5))
2672 {
2673 /*
2674 * Got the beginning of a response...
2675 */
2676
2677 int intstatus; /* Status value as an integer */
2678
2679 if (sscanf(line, "HTTP/%d.%d%d", &major, &minor, &intstatus) != 3)
2680 {
2681 *status = http->status = HTTP_ERROR;
2682 return (0);
2683 }
2684
2685 http->version = (http_version_t)(major * 100 + minor);
2686 *status = http->status = (http_status_t)intstatus;
2687 }
2688 else if ((value = strchr(line, ':')) != NULL)
2689 {
2690 /*
2691 * Got a value...
2692 */
2693
2694 *value++ = '\0';
2695 while (_cups_isspace(*value))
2696 value ++;
2697
2698 /*
2699 * Be tolerants of servers that send unknown attribute fields...
2700 */
2701
2702 if (!strcasecmp(line, "expect"))
2703 {
2704 /*
2705 * "Expect: 100-continue" or similar...
2706 */
2707
2708 http->expect = (http_status_t)atoi(value);
2709 }
2710 else if (!strcasecmp(line, "cookie"))
2711 {
2712 /*
2713 * "Cookie: name=value[; name=value ...]" - replaces previous cookies...
2714 */
2715
2716 httpSetCookie(http, value);
2717 }
2718 else if ((field = http_field(line)) != HTTP_FIELD_UNKNOWN)
2719 httpSetField(http, field, value);
2720 #ifdef DEBUG
2721 else
2722 DEBUG_printf(("1_httpUpdate: unknown field %s seen!", line));
2723 #endif /* DEBUG */
2724 }
2725 else
2726 {
2727 DEBUG_printf(("1_httpUpdate: Bad response line \"%s\"!", line));
2728 *status = http->status = HTTP_ERROR;
2729 return (0);
2730 }
2731
2732 return (1);
2733 }
2734
2735
2736 /*
2737 * 'httpUpdate()' - Update the current HTTP state for incoming data.
2738 */
2739
2740 http_status_t /* O - HTTP status */
2741 httpUpdate(http_t *http) /* I - Connection to server */
2742 {
2743 http_status_t status; /* Request status */
2744
2745
2746 DEBUG_printf(("httpUpdate(http=%p), state=%s", http,
2747 http_states[http->state]));
2748
2749 /*
2750 * Flush pending data, if any...
2751 */
2752
2753 if (http->wused)
2754 {
2755 DEBUG_puts("2httpUpdate: flushing buffer...");
2756
2757 if (httpFlushWrite(http) < 0)
2758 return (HTTP_ERROR);
2759 }
2760
2761 /*
2762 * If we haven't issued any commands, then there is nothing to "update"...
2763 */
2764
2765 if (http->state == HTTP_WAITING)
2766 return (HTTP_CONTINUE);
2767
2768 /*
2769 * Grab all of the lines we can from the connection...
2770 */
2771
2772 while (_httpUpdate(http, &status));
2773
2774 /*
2775 * See if there was an error...
2776 */
2777
2778 if (http->error == EPIPE && http->status > HTTP_CONTINUE)
2779 {
2780 DEBUG_printf(("1httpUpdate: Returning status %d...", http->status));
2781 return (http->status);
2782 }
2783
2784 if (http->error)
2785 {
2786 DEBUG_printf(("1httpUpdate: socket error %d - %s", http->error,
2787 strerror(http->error)));
2788 http->status = HTTP_ERROR;
2789 return (HTTP_ERROR);
2790 }
2791
2792 /*
2793 * Return the current status...
2794 */
2795
2796 return (status);
2797 }
2798
2799
2800 /*
2801 * '_httpWait()' - Wait for data available on a connection (no flush).
2802 */
2803
2804 int /* O - 1 if data is available, 0 otherwise */
2805 _httpWait(http_t *http, /* I - Connection to server */
2806 int msec, /* I - Milliseconds to wait */
2807 int usessl) /* I - Use SSL context? */
2808 {
2809 #ifdef HAVE_POLL
2810 struct pollfd pfd; /* Polled file descriptor */
2811 #else
2812 fd_set input_set; /* select() input set */
2813 struct timeval timeout; /* Timeout */
2814 #endif /* HAVE_POLL */
2815 int nfds; /* Result from select()/poll() */
2816
2817
2818 DEBUG_printf(("4_httpWait(http=%p, msec=%d, usessl=%d)", http, msec, usessl));
2819
2820 if (http->fd < 0)
2821 {
2822 DEBUG_printf(("5_httpWait: Returning 0 since fd=%d", http->fd));
2823 return (0);
2824 }
2825
2826 /*
2827 * Check the SSL/TLS buffers for data first...
2828 */
2829
2830 #ifdef HAVE_SSL
2831 if (http->tls && usessl)
2832 {
2833 # ifdef HAVE_LIBSSL
2834 if (SSL_pending(http->tls))
2835 {
2836 DEBUG_puts("5_httpWait: Return 1 since there is pending SSL data.");
2837 return (1);
2838 }
2839
2840 # elif defined(HAVE_GNUTLS)
2841 if (gnutls_record_check_pending(http->tls))
2842 {
2843 DEBUG_puts("5_httpWait: Return 1 since there is pending SSL data.");
2844 return (1);
2845 }
2846
2847 # elif defined(HAVE_CDSASSL)
2848 size_t bytes; /* Bytes that are available */
2849
2850 if (!SSLGetBufferedReadSize(http->tls, &bytes) &&
2851 bytes > 0)
2852 {
2853 DEBUG_puts("5_httpWait: Return 1 since there is pending SSL data.");
2854 return (1);
2855 }
2856 # endif /* HAVE_LIBSSL */
2857 }
2858 #endif /* HAVE_SSL */
2859
2860 /*
2861 * Then try doing a select() or poll() to poll the socket...
2862 */
2863
2864 #ifdef HAVE_POLL
2865 pfd.fd = http->fd;
2866 pfd.events = POLLIN;
2867
2868 while ((nfds = poll(&pfd, 1, msec)) < 0 &&
2869 (errno == EINTR || errno == EAGAIN));
2870
2871 #else
2872 do
2873 {
2874 FD_ZERO(&input_set);
2875 FD_SET(http->fd, &input_set);
2876
2877 DEBUG_printf(("6_httpWait: msec=%d, http->fd=%d", msec, http->fd));
2878
2879 if (msec >= 0)
2880 {
2881 timeout.tv_sec = msec / 1000;
2882 timeout.tv_usec = (msec % 1000) * 1000;
2883
2884 nfds = select(http->fd + 1, &input_set, NULL, NULL, &timeout);
2885 }
2886 else
2887 nfds = select(http->fd + 1, &input_set, NULL, NULL, NULL);
2888
2889 DEBUG_printf(("6_httpWait: select() returned %d...", nfds));
2890 }
2891 # ifdef WIN32
2892 while (nfds < 0 && (WSAGetLastError() == WSAEINTR ||
2893 WSAGetLastError() == WSAEWOULDBLOCK));
2894 # else
2895 while (nfds < 0 && (errno == EINTR || errno == EAGAIN));
2896 # endif /* WIN32 */
2897 #endif /* HAVE_POLL */
2898
2899 DEBUG_printf(("5_httpWait: returning with nfds=%d, errno=%d...", nfds,
2900 errno));
2901
2902 return (nfds > 0);
2903 }
2904
2905
2906 /*
2907 * 'httpWait()' - Wait for data available on a connection.
2908 *
2909 * @since CUPS 1.1.19/Mac OS X 10.3@
2910 */
2911
2912 int /* O - 1 if data is available, 0 otherwise */
2913 httpWait(http_t *http, /* I - Connection to server */
2914 int msec) /* I - Milliseconds to wait */
2915 {
2916 /*
2917 * First see if there is data in the buffer...
2918 */
2919
2920 DEBUG_printf(("2httpWait(http=%p, msec=%d)", http, msec));
2921
2922 if (http == NULL)
2923 return (0);
2924
2925 if (http->used)
2926 {
2927 DEBUG_puts("3httpWait: Returning 1 since there is buffered data ready.");
2928 return (1);
2929 }
2930
2931 /*
2932 * Flush pending data, if any...
2933 */
2934
2935 if (http->wused)
2936 {
2937 DEBUG_puts("3httpWait: Flushing write buffer.");
2938
2939 if (httpFlushWrite(http) < 0)
2940 return (0);
2941 }
2942
2943 /*
2944 * If not, check the SSL/TLS buffers and do a select() on the connection...
2945 */
2946
2947 return (_httpWait(http, msec, 1));
2948 }
2949
2950
2951 /*
2952 * 'httpWrite()' - Write data to a HTTP connection.
2953 *
2954 * This function is deprecated. Use the httpWrite2() function which can
2955 * write more than 2GB of data.
2956 *
2957 * @deprecated@
2958 */
2959
2960 int /* O - Number of bytes written */
2961 httpWrite(http_t *http, /* I - Connection to server */
2962 const char *buffer, /* I - Buffer for data */
2963 int length) /* I - Number of bytes to write */
2964 {
2965 return ((int)httpWrite2(http, buffer, length));
2966 }
2967
2968
2969 /*
2970 * 'httpWrite2()' - Write data to a HTTP connection.
2971 *
2972 * @since CUPS 1.2/Mac OS X 10.5@
2973 */
2974
2975 ssize_t /* O - Number of bytes written */
2976 httpWrite2(http_t *http, /* I - Connection to server */
2977 const char *buffer, /* I - Buffer for data */
2978 size_t length) /* I - Number of bytes to write */
2979 {
2980 ssize_t bytes; /* Bytes written */
2981
2982
2983 DEBUG_printf(("httpWrite2(http=%p, buffer=%p, length=" CUPS_LLFMT ")", http,
2984 buffer, CUPS_LLCAST length));
2985
2986 /*
2987 * Range check input...
2988 */
2989
2990 if (http == NULL || buffer == NULL)
2991 return (-1);
2992
2993 /*
2994 * Mark activity on the connection...
2995 */
2996
2997 http->activity = time(NULL);
2998
2999 /*
3000 * Buffer small writes for better performance...
3001 */
3002
3003 if (length > 0)
3004 {
3005 if (http->wused && (length + http->wused) > sizeof(http->wbuffer))
3006 {
3007 DEBUG_printf(("2httpWrite2: Flushing buffer (wused=%d, length="
3008 CUPS_LLFMT ")", http->wused, CUPS_LLCAST length));
3009
3010 httpFlushWrite(http);
3011 }
3012
3013 if ((length + http->wused) <= sizeof(http->wbuffer) &&
3014 length < sizeof(http->wbuffer))
3015 {
3016 /*
3017 * Write to buffer...
3018 */
3019
3020 DEBUG_printf(("2httpWrite2: Copying " CUPS_LLFMT " bytes to wbuffer...",
3021 CUPS_LLCAST length));
3022
3023 memcpy(http->wbuffer + http->wused, buffer, length);
3024 http->wused += (int)length;
3025 bytes = (ssize_t)length;
3026 }
3027 else
3028 {
3029 /*
3030 * Otherwise write the data directly...
3031 */
3032
3033 DEBUG_printf(("2httpWrite2: Writing " CUPS_LLFMT " bytes to socket...",
3034 CUPS_LLCAST length));
3035
3036 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
3037 bytes = (ssize_t)http_write_chunk(http, buffer, (int)length);
3038 else
3039 bytes = (ssize_t)http_write(http, buffer, (int)length);
3040
3041 DEBUG_printf(("2httpWrite2: Wrote " CUPS_LLFMT " bytes...",
3042 CUPS_LLCAST bytes));
3043 }
3044
3045 if (http->data_encoding == HTTP_ENCODE_LENGTH)
3046 http->data_remaining -= bytes;
3047 }
3048 else
3049 bytes = 0;
3050
3051 /*
3052 * Handle end-of-request processing...
3053 */
3054
3055 if ((http->data_encoding == HTTP_ENCODE_CHUNKED && length == 0) ||
3056 (http->data_encoding == HTTP_ENCODE_LENGTH && http->data_remaining == 0))
3057 {
3058 /*
3059 * Finished with the transfer; unless we are sending POST or PUT
3060 * data, go idle...
3061 */
3062
3063 DEBUG_puts("2httpWrite: changing states...");
3064
3065 if (http->wused)
3066 httpFlushWrite(http);
3067
3068 if (http->data_encoding == HTTP_ENCODE_CHUNKED)
3069 {
3070 /*
3071 * Send a 0-length chunk at the end of the request...
3072 */
3073
3074 http_write(http, "0\r\n\r\n", 5);
3075
3076 /*
3077 * Reset the data state...
3078 */
3079
3080 http->data_encoding = HTTP_ENCODE_LENGTH;
3081 http->data_remaining = 0;
3082 }
3083 }
3084
3085 return (bytes);
3086 }
3087
3088
3089 #if defined(HAVE_SSL) && defined(HAVE_CDSASSL)
3090 /*
3091 * '_httpWriteCDSA()' - Write function for the CDSA library.
3092 */
3093
3094 OSStatus /* O - -1 on error, 0 on success */
3095 _httpWriteCDSA(
3096 SSLConnectionRef connection, /* I - SSL/TLS connection */
3097 const void *data, /* I - Data buffer */
3098 size_t *dataLength) /* IO - Number of bytes */
3099 {
3100 OSStatus result; /* Return value */
3101 ssize_t bytes; /* Number of bytes read */
3102 http_t *http; /* HTTP connection */
3103
3104
3105 http = (http_t *)connection;
3106
3107 do
3108 {
3109 bytes = write(http->fd, data, *dataLength);
3110 }
3111 while (bytes == -1 && (errno == EINTR || errno == EAGAIN));
3112
3113 if (bytes == *dataLength)
3114 {
3115 result = 0;
3116 }
3117 else if (bytes >= 0)
3118 {
3119 *dataLength = bytes;
3120 result = errSSLWouldBlock;
3121 }
3122 else
3123 {
3124 *dataLength = 0;
3125
3126 if (errno == EAGAIN)
3127 result = errSSLWouldBlock;
3128 else
3129 result = errSSLClosedAbort;
3130 }
3131
3132 return (result);
3133 }
3134 #endif /* HAVE_SSL && HAVE_CDSASSL */
3135
3136
3137 #if defined(HAVE_SSL) && defined(HAVE_GNUTLS)
3138 /*
3139 * '_httpWriteGNUTLS()' - Write function for the GNU TLS library.
3140 */
3141
3142 ssize_t /* O - Number of bytes written or -1 on error */
3143 _httpWriteGNUTLS(
3144 gnutls_transport_ptr ptr, /* I - Connection to server */
3145 const void *data, /* I - Data buffer */
3146 size_t length) /* I - Number of bytes to write */
3147 {
3148 return (send(((http_t *)ptr)->fd, data, length, 0));
3149 }
3150 #endif /* HAVE_SSL && HAVE_GNUTLS */
3151
3152
3153 #if defined(HAVE_SSL) && defined(HAVE_LIBSSL)
3154 /*
3155 * 'http_bio_ctrl()' - Control the HTTP connection.
3156 */
3157
3158 static long /* O - Result/data */
3159 http_bio_ctrl(BIO *h, /* I - BIO data */
3160 int cmd, /* I - Control command */
3161 long arg1, /* I - First argument */
3162 void *arg2) /* I - Second argument */
3163 {
3164 switch (cmd)
3165 {
3166 default :
3167 return (0);
3168
3169 case BIO_CTRL_RESET :
3170 h->ptr = NULL;
3171 return (0);
3172
3173 case BIO_C_SET_FILE_PTR :
3174 h->ptr = arg2;
3175 h->init = 1;
3176 return (1);
3177
3178 case BIO_C_GET_FILE_PTR :
3179 if (arg2)
3180 {
3181 *((void **)arg2) = h->ptr;
3182 return (1);
3183 }
3184 else
3185 return (0);
3186
3187 case BIO_CTRL_DUP :
3188 case BIO_CTRL_FLUSH :
3189 return (1);
3190 }
3191 }
3192
3193
3194 /*
3195 * 'http_bio_free()' - Free OpenSSL data.
3196 */
3197
3198 static int /* O - 1 on success, 0 on failure */
3199 http_bio_free(BIO *h) /* I - BIO data */
3200 {
3201 if (!h)
3202 return (0);
3203
3204 if (h->shutdown)
3205 {
3206 h->init = 0;
3207 h->flags = 0;
3208 }
3209
3210 return (1);
3211 }
3212
3213
3214 /*
3215 * 'http_bio_new()' - Initialize an OpenSSL BIO structure.
3216 */
3217
3218 static int /* O - 1 on success, 0 on failure */
3219 http_bio_new(BIO *h) /* I - BIO data */
3220 {
3221 if (!h)
3222 return (0);
3223
3224 h->init = 0;
3225 h->num = 0;
3226 h->ptr = NULL;
3227 h->flags = 0;
3228
3229 return (1);
3230 }
3231
3232
3233 /*
3234 * 'http_bio_puts()' - Send a string for OpenSSL.
3235 */
3236
3237 static int /* O - Bytes written */
3238 http_bio_puts(BIO *h, /* I - BIO data */
3239 const char *str) /* I - String to write */
3240 {
3241 #ifdef WIN32
3242 return (send(((http_t *)h->ptr)->fd, str, (int)strlen(str), 0));
3243 #else
3244 return (send(((http_t *)h->ptr)->fd, str, strlen(str), 0));
3245 #endif /* WIN32 */
3246 }
3247
3248
3249 /*
3250 * 'http_bio_read()' - Read data for OpenSSL.
3251 */
3252
3253 static int /* O - Bytes read */
3254 http_bio_read(BIO *h, /* I - BIO data */
3255 char *buf, /* I - Buffer */
3256 int size) /* I - Number of bytes to read */
3257 {
3258 http_t *http; /* HTTP connection */
3259
3260
3261 http = (http_t *)h->ptr;
3262
3263 if (!http->blocking)
3264 {
3265 /*
3266 * Make sure we have data before we read...
3267 */
3268
3269 if (!_httpWait(http, 10000, 0))
3270 {
3271 #ifdef WIN32
3272 http->error = WSAETIMEDOUT;
3273 #else
3274 http->error = ETIMEDOUT;
3275 #endif /* WIN32 */
3276
3277 return (-1);
3278 }
3279 }
3280
3281 return (recv(http->fd, buf, size, 0));
3282 }
3283
3284
3285 /*
3286 * 'http_bio_write()' - Write data for OpenSSL.
3287 */
3288
3289 static int /* O - Bytes written */
3290 http_bio_write(BIO *h, /* I - BIO data */
3291 const char *buf, /* I - Buffer to write */
3292 int num) /* I - Number of bytes to write */
3293 {
3294 return (send(((http_t *)h->ptr)->fd, buf, num, 0));
3295 }
3296 #endif /* HAVE_SSL && HAVE_LIBSSL */
3297
3298
3299 #ifdef DEBUG
3300 /*
3301 * 'http_debug_hex()' - Do a hex dump of a buffer.
3302 */
3303
3304 static void
3305 http_debug_hex(const char *prefix, /* I - Prefix for line */
3306 const char *buffer, /* I - Buffer to dump */
3307 int bytes) /* I - Bytes to dump */
3308 {
3309 int i, j, /* Looping vars */
3310 ch; /* Current character */
3311 char line[255], /* Line buffer */
3312 *start, /* Start of line after prefix */
3313 *ptr; /* Pointer into line */
3314
3315
3316 if (_cups_debug_fd < 0 || _cups_debug_level < 6)
3317 return;
3318
3319 DEBUG_printf(("6%s: %d bytes:\n", prefix, bytes));
3320
3321 snprintf(line, sizeof(line), "6%s: ", prefix);
3322 start = line + strlen(line);
3323
3324 for (i = 0; i < bytes; i += 16)
3325 {
3326 for (j = 0, ptr = start; j < 16 && (i + j) < bytes; j ++, ptr += 2)
3327 sprintf(ptr, "%02X", buffer[i + j] & 255);
3328
3329 while (j < 16)
3330 {
3331 strcpy(ptr, " ");
3332 ptr += 2;
3333 j ++;
3334 }
3335
3336 strcpy(ptr, " ");
3337 ptr += 2;
3338
3339 for (j = 0; j < 16 && (i + j) < bytes; j ++)
3340 {
3341 ch = buffer[i + j] & 255;
3342
3343 if (ch < ' ' || ch >= 127)
3344 ch = '.';
3345
3346 *ptr++ = ch;
3347 }
3348
3349 *ptr = '\0';
3350 DEBUG_puts(line);
3351 }
3352 }
3353 #endif /* DEBUG */
3354
3355
3356 /*
3357 * 'http_field()' - Return the field index for a field name.
3358 */
3359
3360 static http_field_t /* O - Field index */
3361 http_field(const char *name) /* I - String name */
3362 {
3363 int i; /* Looping var */
3364
3365
3366 for (i = 0; i < HTTP_FIELD_MAX; i ++)
3367 if (strcasecmp(name, http_fields[i]) == 0)
3368 return ((http_field_t)i);
3369
3370 return (HTTP_FIELD_UNKNOWN);
3371 }
3372
3373
3374 #ifdef HAVE_SSL
3375 /*
3376 * 'http_read_ssl()' - Read from a SSL/TLS connection.
3377 */
3378
3379 static int /* O - Bytes read */
3380 http_read_ssl(http_t *http, /* I - Connection to server */
3381 char *buf, /* I - Buffer to store data */
3382 int len) /* I - Length of buffer */
3383 {
3384 # if defined(HAVE_LIBSSL)
3385 return (SSL_read((SSL *)(http->tls), buf, len));
3386
3387 # elif defined(HAVE_GNUTLS)
3388 ssize_t result; /* Return value */
3389
3390
3391 result = gnutls_record_recv(http->tls, buf, len);
3392
3393 if (result < 0 && !errno)
3394 {
3395 /*
3396 * Convert GNU TLS error to errno value...
3397 */
3398
3399 switch (result)
3400 {
3401 case GNUTLS_E_INTERRUPTED :
3402 errno = EINTR;
3403 break;
3404
3405 case GNUTLS_E_AGAIN :
3406 errno = EAGAIN;
3407 break;
3408
3409 default :
3410 errno = EPIPE;
3411 break;
3412 }
3413
3414 result = -1;
3415 }
3416
3417 return ((int)result);
3418
3419 # elif defined(HAVE_CDSASSL)
3420 int result; /* Return value */
3421 OSStatus error; /* Error info */
3422 size_t processed; /* Number of bytes processed */
3423
3424
3425 error = SSLRead(http->tls, buf, len, &processed);
3426
3427 switch (error)
3428 {
3429 case 0 :
3430 result = (int)processed;
3431 break;
3432
3433 case errSSLWouldBlock :
3434 if (processed)
3435 result = (int)processed;
3436 else
3437 {
3438 result = -1;
3439 errno = EINTR;
3440 }
3441 break;
3442
3443 case errSSLClosedGraceful :
3444 default :
3445 if (processed)
3446 result = (int)processed;
3447 else
3448 {
3449 result = -1;
3450 errno = EPIPE;
3451 }
3452 break;
3453 }
3454
3455 return (result);
3456 # elif defined(HAVE_SSPISSL)
3457 return _sspiRead((_sspi_struct_t*) http->tls, buf, len);
3458 # endif /* HAVE_LIBSSL */
3459 }
3460 #endif /* HAVE_SSL */
3461
3462
3463 /*
3464 * 'http_send()' - Send a request with all fields and the trailing blank line.
3465 */
3466
3467 static int /* O - 0 on success, non-zero on error */
3468 http_send(http_t *http, /* I - Connection to server */
3469 http_state_t request, /* I - Request code */
3470 const char *uri) /* I - URI */
3471 {
3472 int i; /* Looping var */
3473 char buf[1024]; /* Encoded URI buffer */
3474 static const char * const codes[] =
3475 { /* Request code strings */
3476 NULL,
3477 "OPTIONS",
3478 "GET",
3479 NULL,
3480 "HEAD",
3481 "POST",
3482 NULL,
3483 NULL,
3484 "PUT",
3485 NULL,
3486 "DELETE",
3487 "TRACE",
3488 "CLOSE"
3489 };
3490
3491
3492 DEBUG_printf(("7http_send(http=%p, request=HTTP_%s, uri=\"%s\")",
3493 http, codes[request], uri));
3494
3495 if (http == NULL || uri == NULL)
3496 return (-1);
3497
3498 /*
3499 * Set the User-Agent field if it isn't already...
3500 */
3501
3502 if (!http->fields[HTTP_FIELD_USER_AGENT][0])
3503 httpSetField(http, HTTP_FIELD_USER_AGENT, CUPS_MINIMAL);
3504
3505 /*
3506 * Encode the URI as needed...
3507 */
3508
3509 _httpEncodeURI(buf, uri, sizeof(buf));
3510
3511 /*
3512 * See if we had an error the last time around; if so, reconnect...
3513 */
3514
3515 if (http->status == HTTP_ERROR || http->status >= HTTP_BAD_REQUEST)
3516 if (httpReconnect(http))
3517 return (-1);
3518
3519 /*
3520 * Flush any written data that is pending...
3521 */
3522
3523 if (http->wused)
3524 {
3525 if (httpFlushWrite(http) < 0)
3526 if (httpReconnect(http))
3527 return (-1);
3528 }
3529
3530 /*
3531 * Send the request header...
3532 */
3533
3534 http->state = request;
3535 http->data_encoding = HTTP_ENCODE_FIELDS;
3536
3537 if (request == HTTP_POST || request == HTTP_PUT)
3538 http->state ++;
3539
3540 http->status = HTTP_CONTINUE;
3541
3542 #ifdef HAVE_SSL
3543 if (http->encryption == HTTP_ENCRYPT_REQUIRED && !http->tls)
3544 {
3545 httpSetField(http, HTTP_FIELD_CONNECTION, "Upgrade");
3546 httpSetField(http, HTTP_FIELD_UPGRADE, "TLS/1.0,SSL/2.0,SSL/3.0");
3547 }
3548 #endif /* HAVE_SSL */
3549
3550 if (httpPrintf(http, "%s %s HTTP/1.1\r\n", codes[request], buf) < 1)
3551 {
3552 http->status = HTTP_ERROR;
3553 return (-1);
3554 }
3555
3556 for (i = 0; i < HTTP_FIELD_MAX; i ++)
3557 if (http->fields[i][0] != '\0')
3558 {
3559 DEBUG_printf(("9http_send: %s: %s", http_fields[i],
3560 httpGetField(http, i)));
3561
3562 if (httpPrintf(http, "%s: %s\r\n", http_fields[i],
3563 httpGetField(http, i)) < 1)
3564 {
3565 http->status = HTTP_ERROR;
3566 return (-1);
3567 }
3568 }
3569
3570 if (http->cookie)
3571 if (httpPrintf(http, "Cookie: $Version=0; %s\r\n", http->cookie) < 1)
3572 {
3573 http->status = HTTP_ERROR;
3574 return (-1);
3575 }
3576
3577 if (http->expect == HTTP_CONTINUE &&
3578 (http->state == HTTP_POST_RECV || http->state == HTTP_PUT_RECV))
3579 if (httpPrintf(http, "Expect: 100-continue\r\n") < 1)
3580 {
3581 http->status = HTTP_ERROR;
3582 return (-1);
3583 }
3584
3585 if (httpPrintf(http, "\r\n") < 1)
3586 {
3587 http->status = HTTP_ERROR;
3588 return (-1);
3589 }
3590
3591 if (httpFlushWrite(http) < 0)
3592 return (-1);
3593
3594 httpGetLength2(http);
3595 httpClearFields(http);
3596
3597 /*
3598 * The Kerberos and AuthRef authentication strings can only be used once...
3599 */
3600
3601 if (http->field_authorization && http->authstring &&
3602 (!strncmp(http->authstring, "Negotiate", 9) ||
3603 !strncmp(http->authstring, "AuthRef", 7)))
3604 {
3605 http->_authstring[0] = '\0';
3606
3607 if (http->authstring != http->_authstring)
3608 free(http->authstring);
3609
3610 http->authstring = http->_authstring;
3611 }
3612
3613 return (0);
3614 }
3615
3616
3617 #ifdef HAVE_SSL
3618 # if defined(HAVE_CDSASSL) && defined(HAVE_SECCERTIFICATECOPYDATA)
3619 /*
3620 * 'http_set_credentials()' - Set the SSL/TLS credentials.
3621 */
3622
3623 static int /* O - Status of connection */
3624 http_set_credentials(http_t *http) /* I - Connection to server */
3625 {
3626 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
3627 OSStatus error = 0; /* Error code */
3628 http_tls_credentials_t credentials = NULL;
3629 /* TLS credentials */
3630
3631
3632 DEBUG_printf(("7http_set_credentials(%p)", http));
3633
3634 /*
3635 * Prefer connection specific credentials...
3636 */
3637
3638 if ((credentials = http->tls_credentials) == NULL)
3639 credentials = cg->tls_credentials;
3640
3641 # if HAVE_SECPOLICYCREATESSL
3642 /*
3643 * Otherwise root around in the user's keychain to see if one can be found...
3644 */
3645
3646 if (!credentials)
3647 {
3648 CFDictionaryRef query; /* Query dictionary */
3649 CFTypeRef matches = NULL; /* Matching credentials */
3650 CFArrayRef dn_array = NULL;/* Distinguished names array */
3651 CFTypeRef keys[] = { kSecClass,
3652 kSecMatchLimit,
3653 kSecReturnRef };
3654 /* Keys for dictionary */
3655 CFTypeRef values[] = { kSecClassCertificate,
3656 kSecMatchLimitOne,
3657 kCFBooleanTrue };
3658 /* Values for dictionary */
3659
3660 /*
3661 * Get the names associated with the server.
3662 */
3663
3664 if ((error = SSLCopyDistinguishedNames(http->tls, &dn_array)) != noErr)
3665 {
3666 DEBUG_printf(("4http_set_credentials: SSLCopyDistinguishedNames, error=%d",
3667 (int)error));
3668 return (error);
3669 }
3670
3671 /*
3672 * Create a query which will return all identities that can sign and match
3673 * the passed in policy.
3674 */
3675
3676 query = CFDictionaryCreate(NULL,
3677 (const void**)(&keys[0]),
3678 (const void**)(&values[0]),
3679 sizeof(keys) / sizeof(keys[0]),
3680 &kCFTypeDictionaryKeyCallBacks,
3681 &kCFTypeDictionaryValueCallBacks);
3682 if (query)
3683 {
3684 error = SecItemCopyMatching(query, &matches);
3685 DEBUG_printf(("4http_set_credentials: SecItemCopyMatching, error=%d",
3686 (int)error));
3687 CFRelease(query);
3688 }
3689
3690 if (matches)
3691 CFRelease(matches);
3692
3693 if (dn_array)
3694 CFRelease(dn_array);
3695 }
3696 # endif /* HAVE_SECPOLICYCREATESSL */
3697
3698 if (credentials)
3699 {
3700 error = SSLSetCertificate(http->tls, credentials);
3701 DEBUG_printf(("4http_set_credentials: SSLSetCertificate, error=%d",
3702 (int)error));
3703 }
3704 else
3705 DEBUG_puts("4http_set_credentials: No credentials to set.");
3706
3707 return (error);
3708 }
3709 # endif /* HAVE_CDSASSL && HAVE_SECCERTIFICATECOPYDATA */
3710
3711
3712 /*
3713 * 'http_setup_ssl()' - Set up SSL/TLS support on a connection.
3714 */
3715
3716 static int /* O - Status of connection */
3717 http_setup_ssl(http_t *http) /* I - Connection to server */
3718 {
3719 _cups_globals_t *cg = _cupsGlobals();
3720 /* Pointer to library globals */
3721 int any_root; /* Allow any root */
3722
3723 # ifdef HAVE_LIBSSL
3724 SSL_CTX *context; /* Context for encryption */
3725 BIO *bio; /* BIO data */
3726 # elif defined(HAVE_GNUTLS)
3727 gnutls_certificate_client_credentials *credentials;
3728 /* TLS credentials */
3729 # elif defined(HAVE_CDSASSL)
3730 OSStatus error; /* Error code */
3731 const char *message = NULL; /* Error message */
3732 char *hostname; /* Hostname */
3733 # ifdef HAVE_SECCERTIFICATECOPYDATA
3734 cups_array_t *credentials; /* Credentials array */
3735 cups_array_t *names; /* CUPS distinguished names */
3736 CFArrayRef dn_array; /* CF distinguished names array */
3737 CFIndex count; /* Number of credentials */
3738 CFDataRef data; /* Certificate data */
3739 int i; /* Looping var */
3740 http_credential_t
3741 *credential; /* Credential data */
3742 # endif /* HAVE_SECCERTIFICATECOPYDATA */
3743 # elif defined(HAVE_SSPISSL)
3744 TCHAR username[256]; /* Username returned from GetUserName() */
3745 TCHAR commonName[256]; /* Common name for certificate */
3746 DWORD dwSize; /* 32 bit size */
3747 # endif /* HAVE_LIBSSL */
3748
3749
3750 DEBUG_printf(("7http_setup_ssl(http=%p)", http));
3751
3752 /*
3753 * Always allow self-signed certificates for the local loopback address...
3754 */
3755
3756 if (httpAddrLocalhost(http->hostaddr))
3757 any_root = 1;
3758 else
3759 any_root = cg->any_root;
3760
3761 # ifdef HAVE_LIBSSL
3762 context = SSL_CTX_new(SSLv23_client_method());
3763
3764 SSL_CTX_set_options(context, SSL_OP_NO_SSLv2); /* Only use SSLv3 or TLS */
3765
3766 bio = BIO_new(_httpBIOMethods());
3767 BIO_ctrl(bio, BIO_C_SET_FILE_PTR, 0, (char *)http);
3768
3769 http->tls = SSL_new(context);
3770 SSL_set_bio(http->tls_credentials, bio, bio);
3771
3772 if (SSL_connect(http->tls) != 1)
3773 {
3774 # ifdef DEBUG
3775 unsigned long error; /* Error code */
3776
3777 while ((error = ERR_get_error()) != 0)
3778 DEBUG_printf(("8http_setup_ssl: %s", ERR_error_string(error, NULL)));
3779 # endif /* DEBUG */
3780
3781 SSL_CTX_free(context);
3782 SSL_free(http->tls);
3783 http->tls = NULL;
3784
3785 # ifdef WIN32
3786 http->error = WSAGetLastError();
3787 # else
3788 http->error = errno;
3789 # endif /* WIN32 */
3790 http->status = HTTP_ERROR;
3791
3792 return (HTTP_ERROR);
3793 }
3794
3795 # elif defined(HAVE_GNUTLS)
3796 credentials = (gnutls_certificate_client_credentials *)
3797 malloc(sizeof(gnutls_certificate_client_credentials));
3798 if (credentials == NULL)
3799 {
3800 http->error = errno;
3801 http->status = HTTP_ERROR;
3802
3803 return (-1);
3804 }
3805
3806 gnutls_certificate_allocate_credentials(credentials);
3807
3808 gnutls_init(&http->tls, GNUTLS_CLIENT);
3809 gnutls_set_default_priority(http->tls);
3810 gnutls_credentials_set(http->tls, GNUTLS_CRD_CERTIFICATE, *credentials);
3811 gnutls_transport_set_ptr(http->tls, (gnutls_transport_ptr)http);
3812 gnutls_transport_set_pull_function(http->tls, _httpReadGNUTLS);
3813 gnutls_transport_set_push_function(http->tls, _httpWriteGNUTLS);
3814
3815 if ((gnutls_handshake(http->tls)) != GNUTLS_E_SUCCESS)
3816 {
3817 http->error = errno;
3818 http->status = HTTP_ERROR;
3819
3820 gnutls_deinit(http->tls);
3821 gnutls_certificate_free_credentials(*credentials);
3822 free(credentials);
3823 http->tls = NULL;
3824
3825 return (-1);
3826 }
3827
3828 http->tls_credentials = credentials;
3829
3830 # elif defined(HAVE_CDSASSL)
3831 if ((error = SSLNewContext(false, &http->tls)))
3832 {
3833 http->error = error;
3834 http->status = HTTP_ERROR;
3835
3836 return (-1);
3837 }
3838
3839 error = SSLSetConnection(http->tls, http);
3840 DEBUG_printf(("4http_setup_ssl: SSLSetConnection, error=%d", (int)error));
3841
3842 if (!error)
3843 {
3844 error = SSLSetIOFuncs(http->tls, _httpReadCDSA, _httpWriteCDSA);
3845 DEBUG_printf(("4http_setup_ssl: SSLSetIOFuncs, error=%d", (int)error));
3846 }
3847
3848 if (!error)
3849 {
3850 error = SSLSetProtocolVersionEnabled(http->tls, kSSLProtocol2, false);
3851 DEBUG_printf(("4http_setup_ssl: SSLSetProtocolVersionEnabled, error=%d",
3852 (int)error));
3853 }
3854
3855 if (!error)
3856 {
3857 error = SSLSetAllowsAnyRoot(http->tls, any_root);
3858 DEBUG_printf(("4http_setup_ssl: SSLSetAllowsAnyRoot(%d), error=%d",
3859 any_root, (int)error));
3860 }
3861
3862 if (!error)
3863 {
3864 error = SSLSetAllowsExpiredCerts(http->tls, cg->expired_certs);
3865 DEBUG_printf(("4http_setup_ssl: SSLSetAllowsExpiredCerts(%d), error=%d",
3866 cg->expired_certs, (int)error));
3867 }
3868
3869 if (!error)
3870 {
3871 error = SSLSetAllowsExpiredRoots(http->tls, cg->expired_root);
3872 DEBUG_printf(("4http_setup_ssl: SSLSetAllowsExpiredRoots(%d), error=%d",
3873 cg->expired_root, (int)error));
3874 }
3875
3876 # ifdef HAVE_SECCERTIFICATECOPYDATA
3877 if (!error)
3878 {
3879 if (cg->client_cert_cb)
3880 {
3881 error = SSLSetSessionOption(http->tls,
3882 kSSLSessionOptionBreakOnCertRequested, true);
3883 DEBUG_printf(("4http_setup_ssl: kSSLSessionOptionBreakOnCertRequested, "
3884 "error=%d", (int)error));
3885 }
3886 else
3887 {
3888 error = http_set_credentials(http);
3889 DEBUG_printf(("4http_setup_ssl: http_set_credentials, error=%d",
3890 (int)error));
3891 }
3892 }
3893
3894 /*
3895 * If there's a server certificate callback installed let it evaluate the
3896 * certificate(s) during the handshake...
3897 */
3898
3899 if (!error && cg->server_cert_cb != NULL)
3900 {
3901 error = SSLSetEnableCertVerify(http->tls, false);
3902 DEBUG_printf(("4http_setup_ssl: SSLSetEnableCertVerify, error=%d",
3903 (int)error));
3904
3905 if (!error)
3906 {
3907 error = SSLSetSessionOption(http->tls,
3908 kSSLSessionOptionBreakOnServerAuth, true);
3909 DEBUG_printf(("4http_setup_ssl: kSSLSessionOptionBreakOnServerAuth, "
3910 "error=%d", (int)error));
3911 }
3912 }
3913 # endif /* HAVE_SECCERTIFICATECOPYDATA */
3914
3915 if (!error)
3916 {
3917 hostname = httpAddrLocalhost(http->hostaddr) ? "localhost" : http->hostname;
3918 error = SSLSetPeerDomainName(http->tls, hostname, strlen(hostname));
3919
3920 DEBUG_printf(("4http_setup_ssl: SSLSetPeerDomainName, error=%d",
3921 (int)error));
3922 }
3923
3924 if (!error)
3925 {
3926 int done = 0; /* Are we done yet? */
3927
3928 while (!error && !done)
3929 {
3930 error = SSLHandshake(http->tls);
3931
3932 DEBUG_printf(("4_httpWait: SSLHandshake returned %d.", (int)error));
3933
3934 switch (error)
3935 {
3936 case noErr :
3937 done = 1;
3938 break;
3939
3940 case errSSLWouldBlock :
3941 usleep(1000);
3942 break;
3943
3944 # ifdef HAVE_SECCERTIFICATECOPYDATA
3945 case errSSLServerAuthCompleted :
3946 error = 0;
3947 if (cg->server_cert_cb)
3948 {
3949 error = httpCopyCredentials(http, &credentials);
3950 if (!error)
3951 {
3952 error = (cg->server_cert_cb)(http, http->tls, credentials,
3953 cg->server_cert_data);
3954 httpFreeCredentials(credentials);
3955 }
3956
3957 DEBUG_printf(("4_httpWait: Server certificate callback returned "
3958 "%d.", (int)error));
3959 }
3960 break;
3961
3962 case errSSLClientCertRequested :
3963 error = 0;
3964
3965 if (cg->client_cert_cb)
3966 {
3967 names = NULL;
3968 if (!(error = SSLCopyDistinguishedNames(http->tls, &dn_array)) &&
3969 dn_array)
3970 {
3971 if ((names = cupsArrayNew(NULL, NULL)) != NULL)
3972 {
3973 for (i = 0, count = CFArrayGetCount(dn_array); i < count; i++)
3974 {
3975 data = (CFDataRef)CFArrayGetValueAtIndex(dn_array, i);
3976
3977 if ((credential = malloc(sizeof(*credential))))
3978 {
3979 credential->datalen = CFDataGetLength(data);
3980 if ((credential->data = malloc(credential->datalen)))
3981 {
3982 memcpy((void *)credential->data, CFDataGetBytePtr(data),
3983 credential->datalen);
3984 cupsArrayAdd(names, credential);
3985 }
3986 }
3987 }
3988 }
3989
3990 CFRelease(dn_array);
3991 }
3992
3993 if (!error)
3994 {
3995 error = (cg->client_cert_cb)(http, http->tls, names,
3996 cg->client_cert_data);
3997
3998 DEBUG_printf(("4_httpWait: Client certificate callback "
3999 "returned %d.", (int)error));
4000 }
4001
4002 httpFreeCredentials(names);
4003 }
4004 break;
4005 # endif /* HAVE_SECCERTIFICATECOPYDATA */
4006
4007 case errSSLUnknownRootCert :
4008 message = _("Unable to establish a secure connection to host "
4009 "(untrusted certificate).");
4010 break;
4011
4012 case errSSLNoRootCert :
4013 message = _("Unable to establish a secure connection to host "
4014 "(self-signed certificate).");
4015 break;
4016
4017 case errSSLCertExpired :
4018 message = _("Unable to establish a secure connection to host "
4019 "(expired certificate).");
4020 break;
4021
4022 case errSSLCertNotYetValid :
4023 message = _("Unable to establish a secure connection to host "
4024 "(certificate not yet valid).");
4025 break;
4026
4027 case errSSLHostNameMismatch :
4028 message = _("Unable to establish a secure connection to host "
4029 "(host name mismatch).");
4030 break;
4031
4032 case errSSLXCertChainInvalid :
4033 message = _("Unable to establish a secure connection to host "
4034 "(certificate chain invalid).");
4035 break;
4036
4037 case errSSLConnectionRefused :
4038 message = _("Unable to establish a secure connection to host "
4039 "(peer dropped connection before responding).");
4040 break;
4041
4042 default :
4043 break;
4044 }
4045 }
4046 }
4047
4048 if (error)
4049 {
4050 http->error = error;
4051 http->status = HTTP_ERROR;
4052 errno = ECONNREFUSED;
4053
4054 SSLDisposeContext(http->tls);
4055 http->tls = NULL;
4056
4057 /*
4058 * If an error string wasn't set by the callbacks use a generic one...
4059 */
4060
4061 if (!message)
4062 #ifdef HAVE_CSSMERRORSTRING
4063 message = cssmErrorString(error);
4064 #else
4065 message = _("Unable to establish a secure connection to host.");
4066 #endif /* HAVE_CSSMERRORSTRING */
4067
4068 _cupsSetError(IPP_PKI_ERROR, message, 1);
4069
4070 return (-1);
4071 }
4072
4073 # elif defined(HAVE_SSPISSL)
4074 http->tls = _sspiAlloc();
4075
4076 if (!http->tls)
4077 return (-1);
4078
4079 http->tls->sock = http->fd;
4080 dwSize = sizeof(username) / sizeof(TCHAR);
4081 GetUserName(username, &dwSize);
4082 _sntprintf_s(commonName, sizeof(commonName) / sizeof(TCHAR),
4083 sizeof(commonName) / sizeof(TCHAR), TEXT("CN=%s"), username);
4084
4085 if (!_sspiGetCredentials(http->tls_credentials, L"ClientContainer",
4086 commonName, FALSE))
4087 {
4088 _sspiFree(http->tls_credentials);
4089 http->tls_credentials = NULL;
4090 return (-1);
4091 }
4092
4093 _sspiSetAllowsAnyRoot(http->tls_credentials, TRUE);
4094 _sspiSetAllowsExpiredCerts(http->tls_credentials, TRUE);
4095
4096 if (!_sspiConnect(http->tls_credentials, http->hostname))
4097 {
4098 _sspiFree(http->tls_credentials);
4099 http->tls_credentials = NULL;
4100 return (-1);
4101 }
4102 # endif /* HAVE_CDSASSL */
4103
4104 return (0);
4105 }
4106 #endif /* HAVE_SSL */
4107
4108
4109 #ifdef HAVE_SSL
4110 /*
4111 * 'http_shutdown_ssl()' - Shut down SSL/TLS on a connection.
4112 */
4113
4114 static void
4115 http_shutdown_ssl(http_t *http) /* I - Connection to server */
4116 {
4117 # ifdef HAVE_LIBSSL
4118 SSL_CTX *context; /* Context for encryption */
4119
4120 context = SSL_get_SSL_CTX(http->tls_credentials);
4121
4122 SSL_shutdown(http->tls_credentials);
4123 SSL_CTX_free(context);
4124 SSL_free(http->tls_credentials);
4125
4126 # elif defined(HAVE_GNUTLS)
4127 gnutls_certificate_client_credentials *credentials;
4128 /* TLS credentials */
4129
4130 credentials = (gnutls_certificate_client_credentials *)(http->tls_credentials);
4131
4132 gnutls_bye(http->tls, GNUTLS_SHUT_RDWR);
4133 gnutls_deinit(http->tls);
4134 gnutls_certificate_free_credentials(*credentials);
4135 free(credentials);
4136
4137 # elif defined(HAVE_CDSASSL)
4138 while (SSLClose(http->tls) == errSSLWouldBlock)
4139 usleep(1000);
4140
4141 SSLDisposeContext(http->tls);
4142
4143 if (http->tls_credentials)
4144 CFRelease(http->tls_credentials);
4145
4146 # elif defined(HAVE_SSPISSL)
4147 _sspiFree(http->tls_credentials);
4148 # endif /* HAVE_LIBSSL */
4149
4150 http->tls = NULL;
4151 http->tls_credentials = NULL;
4152 }
4153 #endif /* HAVE_SSL */
4154
4155
4156 #ifdef HAVE_SSL
4157 /*
4158 * 'http_upgrade()' - Force upgrade to TLS encryption.
4159 */
4160
4161 static int /* O - Status of connection */
4162 http_upgrade(http_t *http) /* I - Connection to server */
4163 {
4164 int ret; /* Return value */
4165 http_t myhttp; /* Local copy of HTTP data */
4166
4167
4168 DEBUG_printf(("7http_upgrade(%p)", http));
4169
4170 /*
4171 * Flush the connection to make sure any previous "Upgrade" message
4172 * has been read.
4173 */
4174
4175 httpFlush(http);
4176
4177 /*
4178 * Copy the HTTP data to a local variable so we can do the OPTIONS
4179 * request without interfering with the existing request data...
4180 */
4181
4182 memcpy(&myhttp, http, sizeof(myhttp));
4183
4184 /*
4185 * Send an OPTIONS request to the server, requiring SSL or TLS
4186 * encryption on the link...
4187 */
4188
4189 http->field_authorization = NULL; /* Don't free the auth string */
4190
4191 httpClearFields(http);
4192 httpSetField(http, HTTP_FIELD_CONNECTION, "upgrade");
4193 httpSetField(http, HTTP_FIELD_UPGRADE, "TLS/1.2, TLS/1.1, TLS/1.0, SSL/3.0");
4194
4195 if ((ret = httpOptions(http, "*")) == 0)
4196 {
4197 /*
4198 * Wait for the secure connection...
4199 */
4200
4201 while (httpUpdate(http) == HTTP_CONTINUE);
4202 }
4203
4204 /*
4205 * Restore the HTTP request data...
4206 */
4207
4208 memcpy(http->fields, myhttp.fields, sizeof(http->fields));
4209 http->data_encoding = myhttp.data_encoding;
4210 http->data_remaining = myhttp.data_remaining;
4211 http->_data_remaining = myhttp._data_remaining;
4212 http->expect = myhttp.expect;
4213 http->field_authorization = myhttp.field_authorization;
4214 http->digest_tries = myhttp.digest_tries;
4215
4216 /*
4217 * See if we actually went secure...
4218 */
4219
4220 if (!http->tls)
4221 {
4222 /*
4223 * Server does not support HTTP upgrade...
4224 */
4225
4226 DEBUG_puts("8http_upgrade: Server does not support HTTP upgrade!");
4227
4228 # ifdef WIN32
4229 closesocket(http->fd);
4230 # else
4231 close(http->fd);
4232 # endif
4233
4234 http->fd = -1;
4235
4236 return (-1);
4237 }
4238 else
4239 return (ret);
4240 }
4241 #endif /* HAVE_SSL */
4242
4243
4244 /*
4245 * 'http_write()' - Write a buffer to a HTTP connection.
4246 */
4247
4248 static int /* O - Number of bytes written */
4249 http_write(http_t *http, /* I - Connection to server */
4250 const char *buffer, /* I - Buffer for data */
4251 int length) /* I - Number of bytes to write */
4252 {
4253 int tbytes, /* Total bytes sent */
4254 bytes; /* Bytes sent */
4255
4256
4257 DEBUG_printf(("2http_write(http=%p, buffer=%p, length=%d)", http, buffer,
4258 length));
4259 http->error = 0;
4260 tbytes = 0;
4261
4262 while (length > 0)
4263 {
4264 #ifdef HAVE_SSL
4265 if (http->tls)
4266 bytes = http_write_ssl(http, buffer, length);
4267 else
4268 #endif /* HAVE_SSL */
4269 bytes = send(http->fd, buffer, length, 0);
4270
4271 if (bytes < 0)
4272 {
4273 #ifdef WIN32
4274 if (WSAGetLastError() == WSAEINTR)
4275 continue;
4276 else if (WSAGetLastError() == WSAEWOULDBLOCK)
4277 {
4278 if (http->timeout_cb && (*http->timeout_cb)(http, http->timeout_data))
4279 continue;
4280
4281 http->error = WSAGetLastError();
4282 }
4283 else if (WSAGetLastError() != http->error &&
4284 WSAGetLastError() != WSAECONNRESET)
4285 {
4286 http->error = WSAGetLastError();
4287 continue;
4288 }
4289
4290 #else
4291 if (errno == EINTR)
4292 continue;
4293 else if (errno == EWOULDBLOCK || errno == EAGAIN)
4294 {
4295 if (http->timeout_cb && (*http->timeout_cb)(http, http->timeout_data))
4296 continue;
4297 else if (!http->timeout_cb && errno == EAGAIN)
4298 continue;
4299
4300 http->error = errno;
4301 }
4302 else if (errno != http->error && errno != ECONNRESET)
4303 {
4304 http->error = errno;
4305 continue;
4306 }
4307 #endif /* WIN32 */
4308
4309 DEBUG_printf(("3http_write: error writing data (%s).",
4310 strerror(http->error)));
4311
4312 return (-1);
4313 }
4314
4315 buffer += bytes;
4316 tbytes += bytes;
4317 length -= bytes;
4318 }
4319
4320 #ifdef DEBUG
4321 http_debug_hex("http_write", buffer - tbytes, tbytes);
4322 #endif /* DEBUG */
4323
4324 DEBUG_printf(("3http_write: Returning %d.", tbytes));
4325
4326 return (tbytes);
4327 }
4328
4329
4330 /*
4331 * 'http_write_chunk()' - Write a chunked buffer.
4332 */
4333
4334 static int /* O - Number bytes written */
4335 http_write_chunk(http_t *http, /* I - Connection to server */
4336 const char *buffer, /* I - Buffer to write */
4337 int length) /* I - Length of buffer */
4338 {
4339 char header[255]; /* Chunk header */
4340 int bytes; /* Bytes written */
4341
4342
4343 DEBUG_printf(("7http_write_chunk(http=%p, buffer=%p, length=%d)",
4344 http, buffer, length));
4345
4346 /*
4347 * Write the chunk header, data, and trailer.
4348 */
4349
4350 sprintf(header, "%x\r\n", length);
4351 if (http_write(http, header, (int)strlen(header)) < 0)
4352 {
4353 DEBUG_puts("8http_write_chunk: http_write of length failed!");
4354 return (-1);
4355 }
4356
4357 if ((bytes = http_write(http, buffer, length)) < 0)
4358 {
4359 DEBUG_puts("8http_write_chunk: http_write of buffer failed!");
4360 return (-1);
4361 }
4362
4363 if (http_write(http, "\r\n", 2) < 0)
4364 {
4365 DEBUG_puts("8http_write_chunk: http_write of CR LF failed!");
4366 return (-1);
4367 }
4368
4369 return (bytes);
4370 }
4371
4372
4373 #ifdef HAVE_SSL
4374 /*
4375 * 'http_write_ssl()' - Write to a SSL/TLS connection.
4376 */
4377
4378 static int /* O - Bytes written */
4379 http_write_ssl(http_t *http, /* I - Connection to server */
4380 const char *buf, /* I - Buffer holding data */
4381 int len) /* I - Length of buffer */
4382 {
4383 ssize_t result; /* Return value */
4384
4385
4386 DEBUG_printf(("2http_write_ssl(http=%p, buf=%p, len=%d)", http, buf, len));
4387
4388 # if defined(HAVE_LIBSSL)
4389 result = SSL_write((SSL *)(http->tls), buf, len);
4390
4391 # elif defined(HAVE_GNUTLS)
4392 result = gnutls_record_send(http->tls, buf, len);
4393
4394 if (result < 0 && !errno)
4395 {
4396 /*
4397 * Convert GNU TLS error to errno value...
4398 */
4399
4400 switch (result)
4401 {
4402 case GNUTLS_E_INTERRUPTED :
4403 errno = EINTR;
4404 break;
4405
4406 case GNUTLS_E_AGAIN :
4407 errno = EAGAIN;
4408 break;
4409
4410 default :
4411 errno = EPIPE;
4412 break;
4413 }
4414
4415 result = -1;
4416 }
4417
4418 # elif defined(HAVE_CDSASSL)
4419 OSStatus error; /* Error info */
4420 size_t processed; /* Number of bytes processed */
4421
4422
4423 error = SSLWrite(http->tls, buf, len, &processed);
4424
4425 switch (error)
4426 {
4427 case 0 :
4428 result = (int)processed;
4429 break;
4430
4431 case errSSLWouldBlock :
4432 if (processed)
4433 result = (int)processed;
4434 else
4435 {
4436 result = -1;
4437 errno = EINTR;
4438 }
4439 break;
4440
4441 case errSSLClosedGraceful :
4442 default :
4443 if (processed)
4444 result = (int)processed;
4445 else
4446 {
4447 result = -1;
4448 errno = EPIPE;
4449 }
4450 break;
4451 }
4452 # elif defined(HAVE_SSPISSL)
4453 return _sspiWrite((_sspi_struct_t *)http->tls, (void *)buf, len);
4454 # endif /* HAVE_LIBSSL */
4455
4456 DEBUG_printf(("3http_write_ssl: Returning %d.", (int)result));
4457
4458 return ((int)result);
4459 }
4460 #endif /* HAVE_SSL */
4461
4462
4463 /*
4464 * End of "$Id: http.c 7850 2008-08-20 00:07:25Z mike $".
4465 */
Unnamed repository; edit this file 'description' to name the repository.