2 * "$Id: http-private.h 7850 2008-08-20 00:07:25Z mike $"
4 * Private HTTP definitions for CUPS.
6 * Copyright 2007-2011 by Apple Inc.
7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
18 #ifndef _CUPS_HTTP_PRIVATE_H_
19 # define _CUPS_HTTP_PRIVATE_H_
22 * Include necessary headers...
30 # include <sys/select.h>
36 # include <winsock2.h>
40 # include <sys/socket.h>
41 # define closesocket(f) close(f)
45 # ifdef HAVE_GSS_GSSAPI_H
46 # include <GSS/gssapi.h>
47 # ifdef HAVE_GSSAPI_GENERIC_H
48 # include <GSS/gssapi_generic.h>
49 # endif /* HAVE_GSSAPI_GENERIC_H */
50 # ifdef HAVE_GSSAPI_KRB5_H
51 # include <GSS/gssapi_krb5.h>
52 # endif /* HAVE_GSSAPI_KRB5_H */
53 # elif defined(HAVE_GSSAPI_GSSAPI_H)
54 # include <gssapi/gssapi.h>
55 # ifdef HAVE_GSSAPI_GENERIC_H
56 # include <gssapi/gssapi_generic.h>
57 # endif /* HAVE_GSSAPI_GENERIC_H */
58 # ifdef HAVE_GSSAPI_KRB5_H
59 # include <gssapi/gssapi_krb5.h>
60 # endif /* HAVE_GSSAPI_KRB5_H */
61 # elif defined(HAVE_GSSAPI_H)
63 # endif /* HAVE_GSS_GSSAPI_H */
64 # ifndef HAVE_GSS_C_NT_HOSTBASED_SERVICE
65 # define GSS_C_NT_HOSTBASED_SERVICE gss_nt_service_name
66 # endif /* !HAVE_GSS_C_NT_HOSTBASED_SERVICE */
69 # endif /* HAVE_KRB5_H */
70 # endif /* HAVE_GSSAPI */
72 # ifdef HAVE_AUTHORIZATION_H
73 # include <Security/Authorization.h>
74 # endif /* HAVE_AUTHORIZATION_H */
76 # if defined(__sgi) || (defined(__APPLE__) && !defined(_SOCKLEN_T))
78 * IRIX and MacOS X 10.2.x do not define socklen_t, and in fact use an int instead of
79 * unsigned type for length values...
82 typedef int socklen_t
;
83 # endif /* __sgi || (__APPLE__ && !_SOCKLEN_T) */
85 # include <cups/http.h>
86 # include "md5-private.h"
87 # include "ipp-private.h"
89 # if defined HAVE_LIBSSL
90 # include <openssl/err.h>
91 # include <openssl/rand.h>
92 # include <openssl/ssl.h>
93 # elif defined HAVE_GNUTLS
94 # include <gnutls/gnutls.h>
95 # include <gnutls/x509.h>
97 # elif defined(HAVE_CDSASSL)
98 # include <CoreFoundation/CoreFoundation.h>
99 # include <Security/Security.h>
100 # include <Security/SecureTransport.h>
101 # ifdef HAVE_SECURETRANSPORTPRIV_H
102 # include <Security/SecureTransportPriv.h>
103 # endif /* HAVE_SECURETRANSPORTPRIV_H */
104 # ifdef HAVE_SECITEM_H
105 # include <Security/SecItem.h>
106 # endif /* HAVE_SECITEM_H */
107 # ifdef HAVE_SECBASEPRIV_H
108 # include <Security/SecBasePriv.h>
109 # endif /* HAVE_SECBASEPRIV_H */
110 # ifdef HAVE_SECCERTIFICATE_H
111 # include <Security/SecCertificate.h>
112 # include <Security/SecIdentity.h>
113 # endif /* HAVE_SECCERTIFICATE_H */
114 # ifdef HAVE_SECITEMPRIV_H
115 # include <Security/SecItemPriv.h>
116 # endif /* HAVE_SECITEMPRIV_H */
117 # ifdef HAVE_SECIDENTITYSEARCHPRIV_H
118 # include <Security/SecIdentitySearchPriv.h>
119 # endif /* HAVE_SECIDENTITYSEARCHPRIV_H */
120 # ifdef HAVE_SECPOLICYPRIV_H
121 # include <Security/SecPolicyPriv.h>
122 # endif /* HAVE_SECPOLICYPRIV_H */
123 # elif defined(HAVE_SSPISSL)
124 # include "sspi-private.h"
125 # endif /* HAVE_LIBSSL */
129 # ifdef HAVE_GETIFADDRS
130 # include <ifaddrs.h>
132 # include <sys/ioctl.h>
133 # ifdef HAVE_SYS_SOCKIO_H
134 # include <sys/sockio.h>
135 # endif /* HAVE_SYS_SOCKIO_H */
136 # endif /* HAVE_GETIFADDRS */
146 # endif /* __cplusplus */
154 #define _HTTP_RESOLVE_DEFAULT 0 /* Just resolve with default options */
155 #define _HTTP_RESOLVE_STDERR 1 /* Log resolve progress to stderr */
156 #define _HTTP_RESOLVE_FQDN 2 /* Resolve to a FQDN */
160 * Types and functions for SSL support...
163 # if defined HAVE_LIBSSL
165 * The OpenSSL library provides its own SSL/TLS context structure for its
166 * IO and protocol management. However, we need to provide our own BIO
167 * (basic IO) implementation to do timeouts...
170 typedef SSL
*http_tls_t
;
171 typedef void *http_tls_credentials_t
;
173 extern BIO_METHOD
*_httpBIOMethods(void);
175 # elif defined HAVE_GNUTLS
177 * The GNU TLS library is more of a "bare metal" SSL/TLS library...
180 typedef gnutls_session http_tls_t
;
181 typedef void *http_tls_credentials_t
;
183 extern ssize_t
_httpReadGNUTLS(gnutls_transport_ptr ptr
, void *data
,
185 extern ssize_t
_httpWriteGNUTLS(gnutls_transport_ptr ptr
, const void *data
,
188 # elif defined(HAVE_CDSASSL)
190 * Darwin's Security framework provides its own SSL/TLS context structure
191 * for its IO and protocol management...
194 # if !defined(HAVE_SECBASEPRIV_H) && defined(HAVE_CSSMERRORSTRING) /* Declare prototype for function in that header... */
195 extern const char *cssmErrorString(int error
);
196 # endif /* !HAVE_SECBASEPRIV_H && HAVE_CSSMERRORSTRING */
197 # ifndef HAVE_SECITEMPRIV_H /* Declare constants from that header... */
198 extern const CFTypeRef kSecClassCertificate
;
199 extern const CFTypeRef kSecClassIdentity
;
200 # endif /* !HAVE_SECITEMPRIV_H */
201 # if !defined(HAVE_SECIDENTITYSEARCHPRIV_H) && defined(HAVE_SECIDENTITYSEARCHCREATEWITHPOLICY) /* Declare prototype for function in that header... */
202 extern OSStatus
SecIdentitySearchCreateWithPolicy(SecPolicyRef policy
,
203 CFStringRef idString
, CSSM_KEYUSE keyUsage
,
204 CFTypeRef keychainOrArray
,
205 Boolean returnOnlyValidIdentities
,
206 SecIdentitySearchRef
* searchRef
);
207 # endif /* !HAVE_SECIDENTITYSEARCHPRIV_H && HAVE_SECIDENTITYSEARCHCREATEWITHPOLICY */
208 # if !defined(HAVE_SECPOLICYPRIV_H) && defined(HAVE_SECPOLICYSETVALUE) /* Declare prototype for function in that header... */
209 extern OSStatus
SecPolicySetValue(SecPolicyRef policyRef
,
210 const CSSM_DATA
*value
);
211 # endif /* !HAVE_SECPOLICYPRIV_H && HAVE_SECPOLICYSETVALUE */
213 typedef SSLContextRef http_tls_t
;
214 typedef CFArrayRef http_tls_credentials_t
;
216 extern OSStatus
_httpReadCDSA(SSLConnectionRef connection
, void *data
,
218 extern OSStatus
_httpWriteCDSA(SSLConnectionRef connection
, const void *data
,
221 # elif defined(HAVE_SSPISSL)
223 * Windows' SSPI library gets a CUPS wrapper...
226 typedef _sspi_struct_t
* http_tls_t
;
227 typedef void *http_tls_credentials_t
;
231 * Otherwise define stub types since we have no SSL support...
234 typedef void *http_tls_t
;
235 typedef void *http_tls_credentials_t
;
236 # endif /* HAVE_LIBSSL */
238 struct _http_s
/**** HTTP connection structure. ****/
240 int fd
; /* File descriptor for this socket */
241 int blocking
; /* To block or not to block */
242 int error
; /* Last error on read */
243 time_t activity
; /* Time since last read/write */
244 http_state_t state
; /* State of client */
245 http_status_t status
; /* Status of last request */
246 http_version_t version
; /* Protocol version */
247 http_keepalive_t keep_alive
; /* Keep-alive supported? */
248 struct sockaddr_in _hostaddr
; /* Address of connected host (deprecated) */
249 char hostname
[HTTP_MAX_HOST
],
250 /* Name of connected host */
251 fields
[HTTP_FIELD_MAX
][HTTP_MAX_VALUE
];
253 char *data
; /* Pointer to data buffer */
254 http_encoding_t data_encoding
; /* Chunked or not */
255 int _data_remaining
;/* Number of bytes left (deprecated) */
256 int used
; /* Number of bytes used in buffer */
257 char buffer
[HTTP_MAX_BUFFER
];
258 /* Buffer for incoming data */
259 int auth_type
; /* Authentication in use */
260 _cups_md5_state_t md5_state
; /* MD5 state */
261 char nonce
[HTTP_MAX_VALUE
];
263 int nonce_count
; /* Nonce count */
264 http_tls_t tls
; /* TLS state information */
265 http_encryption_t encryption
; /* Encryption requirements */
266 /**** New in CUPS 1.1.19 ****/
267 fd_set
*input_set
; /* select() set for httpWait() (deprecated) */
268 http_status_t expect
; /* Expect: header */
269 char *cookie
; /* Cookie value(s) */
270 /**** New in CUPS 1.1.20 ****/
271 char _authstring
[HTTP_MAX_VALUE
],
272 /* Current Authentication value (deprecated) */
273 userpass
[HTTP_MAX_VALUE
];
274 /* Username:password string */
275 int digest_tries
; /* Number of tries for digest auth */
276 /**** New in CUPS 1.2 ****/
277 off_t data_remaining
; /* Number of bytes left */
278 http_addr_t
*hostaddr
; /* Current host address and port */
279 http_addrlist_t
*addrlist
; /* List of valid addresses */
280 char wbuffer
[HTTP_MAX_BUFFER
];
281 /* Buffer for outgoing data */
282 int wused
; /* Write buffer bytes used */
283 /**** New in CUPS 1.3 ****/
284 char *field_authorization
;
285 /* Authorization field */
286 char *authstring
; /* Current authorization field */
288 gss_OID gssmech
; /* Authentication mechanism */
289 gss_ctx_id_t gssctx
; /* Authentication context */
290 gss_name_t gssname
; /* Authentication server name */
291 # endif /* HAVE_GSSAPI */
292 # ifdef HAVE_AUTHORIZATION_H
293 AuthorizationRef auth_ref
; /* Authorization ref */
294 # endif /* HAVE_AUTHORIZATION_H */
295 /**** New in CUPS 1.5 ****/
296 http_tls_credentials_t tls_credentials
;
297 /* TLS credentials */
298 http_timeout_cb_t timeout_cb
; /* Timeout callback */
299 void *timeout_data
; /* User data pointer */
300 double timeout_value
; /* Timeout in seconds */
301 int wait_value
; /* httpWait value for timeout */
303 char gsshost
[256]; /* Hostname for Kerberos */
304 # endif /* HAVE_GSSAPI */
309 * Some OS's don't have hstrerror(), most notably Solaris...
312 # ifndef HAVE_HSTRERROR
313 extern const char *_cups_hstrerror(int error
);
314 # define hstrerror _cups_hstrerror
315 # elif defined(_AIX) || defined(__osf__)
317 * AIX and Tru64 UNIX don't provide a prototype but do provide the function...
319 extern const char *hstrerror(int error
);
320 # endif /* !HAVE_HSTRERROR */
324 * Some OS's don't have getifaddrs() and freeifaddrs()...
327 # if !defined(WIN32) && !defined(HAVE_GETIFADDRS)
330 # endif /* ifa_dstaddr */
332 # define ifr_netmask ifr_addr
333 # endif /* !ifr_netmask */
335 struct ifaddrs
/**** Interface Structure ****/
337 struct ifaddrs
*ifa_next
; /* Next interface in list */
338 char *ifa_name
; /* Name of interface */
339 unsigned int ifa_flags
; /* Flags (up, point-to-point, etc.) */
340 struct sockaddr
*ifa_addr
, /* Network address */
341 *ifa_netmask
; /* Address mask */
344 struct sockaddr
*ifu_broadaddr
; /* Broadcast address of this interface. */
345 struct sockaddr
*ifu_dstaddr
; /* Point-to-point destination address. */
348 void *ifa_data
; /* Interface statistics */
351 # ifndef ifa_broadaddr
352 # define ifa_broadaddr ifa_ifu.ifu_broadaddr
353 # endif /* !ifa_broadaddr */
355 # define ifa_dstaddr ifa_ifu.ifu_dstaddr
356 # endif /* !ifa_dstaddr */
358 extern int _cups_getifaddrs(struct ifaddrs
**addrs
);
359 # define getifaddrs _cups_getifaddrs
360 extern void _cups_freeifaddrs(struct ifaddrs
*addrs
);
361 # define freeifaddrs _cups_freeifaddrs
362 # endif /* !WIN32 && !HAVE_GETIFADDRS */
369 #define _httpAddrFamily(addrp) (addrp)->addr.sa_family
370 extern int _httpAddrPort(http_addr_t
*addr
);
371 extern void _httpAddrSetPort(http_addr_t
*addr
, int port
);
372 extern char *_httpAssembleUUID(const char *server
, int port
,
373 const char *name
, int number
,
374 char *buffer
, size_t bufsize
);
375 extern http_t
*_httpCreate(const char *host
, int port
,
376 http_addrlist_t
*addrlist
,
377 http_encryption_t encryption
,
379 extern http_tls_credentials_t
380 _httpCreateCredentials(cups_array_t
*credentials
);
381 extern char *_httpDecodeURI(char *dst
, const char *src
,
383 extern void _httpDisconnect(http_t
*http
);
384 extern char *_httpEncodeURI(char *dst
, const char *src
,
386 extern void _httpFreeCredentials(http_tls_credentials_t credentials
);
387 extern ssize_t
_httpPeek(http_t
*http
, char *buffer
, size_t length
);
388 extern const char *_httpResolveURI(const char *uri
, char *resolved_uri
,
389 size_t resolved_size
, int options
,
390 int (*cb
)(void *context
),
392 extern int _httpUpdate(http_t
*http
, http_status_t
*status
);
393 extern int _httpWait(http_t
*http
, int msec
, int usessl
);
402 # endif /* __cplusplus */
404 #endif /* !_CUPS_HTTP_PRIVATE_H_ */
407 * End of "$Id: http-private.h 7850 2008-08-20 00:07:25Z mike $".