]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - cups/http.h
Fix typos in snprintf/vsnprintf emulation code.
[thirdparty/cups.git] / cups / http.h
index a7a25753d2bd8d1c6b255779c354c179f41bb2df..01a0321dfa068a3396f479f1039e8bc83b949f74 100644 (file)
@@ -1,18 +1,11 @@
 /*
- * "$Id$"
+ * Hyper-Text Transport Protocol definitions for CUPS.
  *
- *   Hyper-Text Transport Protocol definitions for CUPS.
+ * Copyright © 2007-2018 by Apple Inc.
+ * Copyright © 1997-2007 by Easy Software Products, all rights reserved.
  *
- *   Copyright 2007-2013 by Apple Inc.
- *   Copyright 1997-2007 by Easy Software Products, all rights reserved.
- *
- *   These coded instructions, statements, and computer programs are the
- *   property of Apple Inc. and are protected by Federal copyright
- *   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
- *   which should have been included with this file.  If this file is
- *   file is missing or damaged, see the license at "http://www.cups.org/".
- *
- *   This file is subject to the Apple OS-Developed Software exception.
+ * Licensed under Apache License v2.0.  See the file "LICENSE" for more
+ * information.
  */
 
 #ifndef _CUPS_HTTP_H_
@@ -27,7 +20,7 @@
 #  include <string.h>
 #  include <time.h>
 #  include <sys/types.h>
-#  ifdef WIN32
+#  ifdef _WIN32
 #    ifndef __CUPS_SSIZE_T_DEFINED
 #      define __CUPS_SSIZE_T_DEFINED
 /* Windows does not support the ssize_t type, so map it to off_t... */
@@ -56,7 +49,7 @@ typedef off_t ssize_t;                        /* @private@ */
 #    if defined(LOCAL_PEERCRED) && !defined(SO_PEERCRED)
 #      define SO_PEERCRED LOCAL_PEERCRED
 #    endif /* LOCAL_PEERCRED && !SO_PEERCRED */
-#  endif /* WIN32 */
+#  endif /* _WIN32 */
 
 
 /*
@@ -87,9 +80,7 @@ extern "C" {
 #    define s6_addr32  _S6_un._S6_u32
 #  elif defined(__FreeBSD__) || defined(__NetBSD__) || defined(__OpenBSD__) || defined(__APPLE__)|| defined(__DragonFly__)
 #    define s6_addr32  __u6_addr.__u6_addr32
-#  elif defined(__osf__)
-#    define s6_addr32  s6_un.sa6_laddr
-#  elif defined(WIN32)
+#  elif defined(_WIN32)
 /*
  * Windows only defines byte and 16-bit word members of the union and
  * requires special casing of all raw address code...
@@ -113,7 +104,7 @@ extern "C" {
  * Types and structures...
  */
 
-typedef enum http_auth_e               /**** HTTP authentication types ****/
+typedef enum http_auth_e               /**** HTTP authentication types @exclude all@ ****/
 {
   HTTP_AUTH_NONE,                      /* No authentication in use */
   HTTP_AUTH_BASIC,                     /* Basic authentication in use */
@@ -121,7 +112,7 @@ typedef enum http_auth_e            /**** HTTP authentication types ****/
   HTTP_AUTH_MD5_SESS,                  /* MD5-session authentication in use */
   HTTP_AUTH_MD5_INT,                   /* Digest authentication in use for body */
   HTTP_AUTH_MD5_SESS_INT,              /* MD5-session authentication in use for body */
-  HTTP_AUTH_NEGOTIATE                  /* GSSAPI authentication in use @since CUPS 1.3/OS X 10.5@ */
+  HTTP_AUTH_NEGOTIATE                  /* GSSAPI authentication in use @since CUPS 1.3/macOS 10.5@ */
 } http_auth_t;
 
 typedef enum http_encoding_e           /**** HTTP transfer encoding values ****/
@@ -182,9 +173,10 @@ typedef enum http_field_e          /**** HTTP field names ****/
   HTTP_FIELD_UPGRADE,                  /* Upgrade field */
   HTTP_FIELD_USER_AGENT,               /* User-Agent field */
   HTTP_FIELD_WWW_AUTHENTICATE,         /* WWW-Authenticate field */
-  HTTP_FIELD_ACCEPT_ENCODING,          /* Accepting-Encoding field @since CUPS 1.7/OS X 10.9@ */
-  HTTP_FIELD_ALLOW,                    /* Allow field @since CUPS 1.7/OS X 10.9@ */
-  HTTP_FIELD_SERVER,                   /* Server field @since CUPS 1.7/OS X 10.9@ */
+  HTTP_FIELD_ACCEPT_ENCODING,          /* Accepting-Encoding field @since CUPS 1.7/macOS 10.9@ */
+  HTTP_FIELD_ALLOW,                    /* Allow field @since CUPS 1.7/macOS 10.9@ */
+  HTTP_FIELD_SERVER,                   /* Server field @since CUPS 1.7/macOS 10.9@ */
+  HTTP_FIELD_AUTHENTICATION_INFO,      /* Authentication-Info field (@since CUPS 2.2.9) */
   HTTP_FIELD_MAX                       /* Maximum field index */
 } http_field_t;
 
@@ -213,8 +205,8 @@ typedef enum http_state_e           /**** HTTP state values; states
   HTTP_STATE_TRACE,                    /* TRACE command, waiting for blank line */
   HTTP_STATE_CONNECT,                  /* CONNECT command, waiting for blank line */
   HTTP_STATE_STATUS,                   /* Command complete, sending status */
-  HTTP_STATE_UNKNOWN_METHOD,           /* Unknown request method, waiting for blank line @since CUPS 1.7/OS X 10.9@ */
-  HTTP_STATE_UNKNOWN_VERSION           /* Unknown request method, waiting for blank line @since CUPS 1.7/OS X 10.9@ */
+  HTTP_STATE_UNKNOWN_METHOD,           /* Unknown request method, waiting for blank line @since CUPS 1.7/macOS 10.9@ */
+  HTTP_STATE_UNKNOWN_VERSION           /* Unknown request method, waiting for blank line @since CUPS 1.7/macOS 10.9@ */
 
 #  ifndef _CUPS_NO_DEPRECATED
 #    define HTTP_WAITING       HTTP_STATE_WAITING
@@ -237,7 +229,7 @@ typedef enum http_state_e           /**** HTTP state values; states
 typedef enum http_status_e             /**** HTTP status codes ****/
 {
   HTTP_STATUS_ERROR = -1,              /* An error response from httpXxxx() */
-  HTTP_STATUS_NONE = 0,                        /* No Expect value @since CUPS 1.7/OS X 10.9@ */
+  HTTP_STATUS_NONE = 0,                        /* No Expect value @since CUPS 1.7/macOS 10.9@ */
 
   HTTP_STATUS_CONTINUE = 100,          /* Everything OK, keep going... */
   HTTP_STATUS_SWITCHING_PROTOCOLS,     /* HTTP upgrade to TLS/SSL */
@@ -248,14 +240,15 @@ typedef enum http_status_e                /**** HTTP status codes ****/
   HTTP_STATUS_NOT_AUTHORITATIVE,       /* Information isn't authoritative */
   HTTP_STATUS_NO_CONTENT,              /* Successful command, no new data */
   HTTP_STATUS_RESET_CONTENT,           /* Content was reset/recreated */
-  HTTP_STATUS_PARTIAL_CONTENT,         /* Only a partial file was recieved/sent */
+  HTTP_STATUS_PARTIAL_CONTENT,         /* Only a partial file was received/sent */
 
   HTTP_STATUS_MULTIPLE_CHOICES = 300,  /* Multiple files match request */
   HTTP_STATUS_MOVED_PERMANENTLY,       /* Document has moved permanently */
-  HTTP_STATUS_MOVED_TEMPORARILY,       /* Document has moved temporarily */
-  HTTP_STATUS_SEE_OTHER,               /* See this other link... */
+  HTTP_STATUS_FOUND,                   /* Document was found at a different URI */
+  HTTP_STATUS_SEE_OTHER,               /* See this other link */
   HTTP_STATUS_NOT_MODIFIED,            /* File not modified */
   HTTP_STATUS_USE_PROXY,               /* Must use a proxy to access this URI */
+  HTTP_STATUS_TEMPORARY_REDIRECT = 307,        /* Temporary redirection */
 
   HTTP_STATUS_BAD_REQUEST = 400,       /* Bad request */
   HTTP_STATUS_UNAUTHORIZED,            /* Unauthorized to access host */
@@ -286,9 +279,11 @@ typedef enum http_status_e         /**** HTTP status codes ****/
 
   HTTP_STATUS_CUPS_AUTHORIZATION_CANCELED = 1000,
                                        /* User canceled authorization @since CUPS 1.4@ */
-  HTTP_STATUS_CUPS_PKI_ERROR,          /* Error negotiating a secure connection @since CUPS 1.5/OS X 10.7@ */
+  HTTP_STATUS_CUPS_PKI_ERROR,          /* Error negotiating a secure connection @since CUPS 1.5/macOS 10.7@ */
   HTTP_STATUS_CUPS_WEBIF_DISABLED      /* Web interface is disabled @private@ */
 
+#  define HTTP_STATUS_MOVED_TEMPORARILY HTTP_STATUS_FOUND /* Renamed in RFC 7231 */
+
 #  ifndef _CUPS_NO_DEPRECATED
 /* Old names for this enumeration */
 #    define HTTP_ERROR                 HTTP_STATUS_ERROR
@@ -344,6 +339,16 @@ typedef enum http_status_e         /**** HTTP status codes ****/
 #  endif /* !_CUPS_NO_DEPRECATED */
 } http_status_t;
 
+typedef enum http_trust_e              /**** Level of trust for credentials @since CUPS 2.0/OS 10.10@ */
+{
+  HTTP_TRUST_OK = 0,                   /* Credentials are OK/trusted */
+  HTTP_TRUST_INVALID,                  /* Credentials are invalid */
+  HTTP_TRUST_CHANGED,                  /* Credentials have changed */
+  HTTP_TRUST_EXPIRED,                  /* Credentials are expired */
+  HTTP_TRUST_RENEWED,                  /* Credentials have been renewed */
+  HTTP_TRUST_UNKNOWN,                  /* Credentials are unknown/new */
+} http_trust_t;
+
 typedef enum http_uri_status_e         /**** URI separation status @since CUPS 1.2@ ****/
 {
   HTTP_URI_STATUS_OVERFLOW = -8,       /* URI buffer for httpAssembleURI is too small */
@@ -387,7 +392,7 @@ typedef enum http_uri_coding_e              /**** URI en/decode flags ****/
   HTTP_URI_CODING_RFC6874 = 16         /* Use RFC 6874 address format */
 } http_uri_coding_t;
 
-typedef enum http_version_e            /**** HTTP version numbers ****/
+typedef enum http_version_e            /**** HTTP version numbers @exclude all@ ****/
 {
   HTTP_VERSION_0_9 = 9,                        /* HTTP/0.9 */
   HTTP_VERSION_1_0 = 100,              /* HTTP/1.0 */
@@ -403,7 +408,7 @@ typedef enum http_version_e         /**** HTTP version numbers ****/
 typedef union _http_addr_u             /**** Socket address union, which
                                         **** makes using IPv6 and other
                                         **** address types easier and
-                                        **** more portable. @since CUPS 1.2/OS X 10.5@
+                                        **** more portable. @since CUPS 1.2/macOS 10.5@
                                         ****/
 {
   struct sockaddr      addr;           /* Base structure for family value */
@@ -420,7 +425,8 @@ typedef union _http_addr_u          /**** Socket address union, which
 typedef struct http_addrlist_s         /**** Socket address list, which is
                                         **** used to enumerate all of the
                                         **** addresses that are associated
-                                        **** with a hostname. @since CUPS 1.2/OS X 10.5@
+                                        **** with a hostname. @since CUPS 1.2/macOS 10.5@
+                                         **** @exclude all@
                                         ****/
 {
   struct http_addrlist_s *next;                /* Pointer to next address in list */
@@ -429,14 +435,14 @@ typedef struct http_addrlist_s            /**** Socket address list, which is
 
 typedef struct _http_s http_t;         /**** HTTP connection type ****/
 
-typedef struct http_credential_s       /**** HTTP credential data @since CUPS 1.5/OS X 10.7@ ****/
+typedef struct http_credential_s       /**** HTTP credential data @since CUPS 1.5/macOS 10.7@ @exclude all@ ****/
 {
   void         *data;                  /* Pointer to credential data */
   size_t       datalen;                /* Credential length */
 } http_credential_t;
 
 typedef int (*http_timeout_cb_t)(http_t *http, void *user_data);
-                                       /**** HTTP timeout callback @since CUPS 1.5/OS X 10.7@ ****/
+                                       /**** HTTP timeout callback @since CUPS 1.5/macOS 10.7@ ****/
 
 
 
@@ -444,53 +450,43 @@ typedef int (*http_timeout_cb_t)(http_t *http, void *user_data);
  * Prototypes...
  */
 
-extern void            httpBlocking(http_t *http, int b);
-extern int             httpCheck(http_t *http);
-extern void            httpClearFields(http_t *http);
-extern void            httpClose(http_t *http);
-extern http_t          *httpConnect(const char *host, int port)
-                                    _CUPS_DEPRECATED_1_7_MSG("Use httpConnect2 instead.");
-extern http_t          *httpConnectEncrypt(const char *host, int port,
-                                           http_encryption_t encryption)
-                                           _CUPS_DEPRECATED_1_7_MSG("Use httpConnect2 instead.");
-extern int             httpDelete(http_t *http, const char *uri);
-extern int             httpEncryption(http_t *http, http_encryption_t e);
-extern int             httpError(http_t *http);
-extern void            httpFlush(http_t *http);
-extern int             httpGet(http_t *http, const char *uri);
-extern char            *httpGets(char *line, int length, http_t *http);
-extern const char      *httpGetDateString(time_t t);
-extern time_t          httpGetDateTime(const char *s);
-extern const char      *httpGetField(http_t *http, http_field_t field);
-extern struct hostent  *httpGetHostByName(const char *name);
-extern char            *httpGetSubField(http_t *http, http_field_t field,
-                                        const char *name, char *value);
-extern int             httpHead(http_t *http, const char *uri);
-extern void            httpInitialize(void);
-extern int             httpOptions(http_t *http, const char *uri);
-extern int             httpPost(http_t *http, const char *uri);
-extern int             httpPrintf(http_t *http, const char *format, ...)
-                       __attribute__ ((__format__ (__printf__, 2, 3)));
-extern int             httpPut(http_t *http, const char *uri);
+extern void            httpBlocking(http_t *http, int b) _CUPS_PUBLIC;
+extern int             httpCheck(http_t *http) _CUPS_PUBLIC;
+extern void            httpClearFields(http_t *http) _CUPS_PUBLIC;
+extern void            httpClose(http_t *http) _CUPS_PUBLIC;
+extern http_t          *httpConnect(const char *host, int port) _CUPS_DEPRECATED_1_7_MSG("Use httpConnect2 instead.");
+extern http_t          *httpConnectEncrypt(const char *host, int port, http_encryption_t encryption) _CUPS_DEPRECATED_1_7_MSG("Use httpConnect2 instead.");
+extern int             httpDelete(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern int             httpEncryption(http_t *http, http_encryption_t e) _CUPS_PUBLIC;
+extern int             httpError(http_t *http) _CUPS_PUBLIC;
+extern void            httpFlush(http_t *http) _CUPS_PUBLIC;
+extern int             httpGet(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern char            *httpGets(char *line, int length, http_t *http) _CUPS_PUBLIC;
+extern const char      *httpGetDateString(time_t t) _CUPS_PUBLIC;
+extern time_t          httpGetDateTime(const char *s) _CUPS_PUBLIC;
+extern const char      *httpGetField(http_t *http, http_field_t field) _CUPS_PUBLIC;
+extern struct hostent  *httpGetHostByName(const char *name) _CUPS_PUBLIC;
+extern char            *httpGetSubField(http_t *http, http_field_t field, const char *name, char *value) _CUPS_PUBLIC;
+extern int             httpHead(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern void            httpInitialize(void) _CUPS_PUBLIC;
+extern int             httpOptions(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern int             httpPost(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern int             httpPrintf(http_t *http, const char *format, ...) _CUPS_FORMAT(2, 3) _CUPS_PUBLIC;
+extern int             httpPut(http_t *http, const char *uri) _CUPS_PUBLIC;
 extern int             httpRead(http_t *http, char *buffer, int length) _CUPS_DEPRECATED_MSG("Use httpRead2 instead.");
 extern int             httpReconnect(http_t *http) _CUPS_DEPRECATED_1_6_MSG("Use httpReconnect2 instead.");
-extern void            httpSeparate(const char *uri, char *method,
-                                    char *username, char *host, int *port,
-                                    char *resource) _CUPS_DEPRECATED_MSG("Use httpSeparateURI instead.");
-extern void            httpSetField(http_t *http, http_field_t field,
-                                    const char *value);
-extern const char      *httpStatus(http_status_t status);
-extern int             httpTrace(http_t *http, const char *uri);
-extern http_status_t   httpUpdate(http_t *http);
+extern void            httpSeparate(const char *uri, char *method, char *username, char *host, int *port, char *resource) _CUPS_DEPRECATED_1_2_MSG("Use httpSeparateURI instead.");
+extern void            httpSetField(http_t *http, http_field_t field, const char *value) _CUPS_PUBLIC;
+extern const char      *httpStatus(http_status_t status) _CUPS_PUBLIC;
+extern int             httpTrace(http_t *http, const char *uri) _CUPS_PUBLIC;
+extern http_status_t   httpUpdate(http_t *http) _CUPS_PUBLIC;
 extern int             httpWrite(http_t *http, const char *buffer, int length) _CUPS_DEPRECATED_MSG("Use httpWrite2 instead.");
 extern char            *httpEncode64(char *out, const char *in) _CUPS_DEPRECATED_MSG("Use httpEncode64_2 instead.");
 extern char            *httpDecode64(char *out, const char *in) _CUPS_DEPRECATED_MSG("Use httpDecode64_2 instead.");
-extern int             httpGetLength(http_t *http) _CUPS_DEPRECATED_MSG("Use httpGetLength2 instead.");
-extern char            *httpMD5(const char *, const char *, const char *,
-                                char [33]);
-extern char            *httpMD5Final(const char *, const char *, const char *,
-                                     char [33]);
-extern char            *httpMD5String(const unsigned char *, char [33]);
+extern int             httpGetLength(http_t *http) _CUPS_DEPRECATED_1_2_MSG("Use httpGetLength2 instead.");
+extern char            *httpMD5(const char *, const char *, const char *, char [33]) _CUPS_DEPRECATED_MSG("Use cupsDoAuth or cupsHashData instead.");
+extern char            *httpMD5Final(const char *, const char *, const char *, char [33]) _CUPS_DEPRECATED_2_2_MSG("Use cupsDoAuth or cupsHashData instead.");
+extern char            *httpMD5String(const unsigned char *, char [33]) _CUPS_DEPRECATED_2_2_MSG("Use cupsHashString instead.");
 
 /**** New in CUPS 1.1.19 ****/
 extern void            httpClearCookie(http_t *http) _CUPS_API_1_1_19;
@@ -500,40 +496,21 @@ extern int                httpWait(http_t *http, int msec) _CUPS_API_1_1_19;
 
 /**** New in CUPS 1.1.21 ****/
 extern char            *httpDecode64_2(char *out, int *outlen, const char *in) _CUPS_API_1_1_21;
-extern char            *httpEncode64_2(char *out, int outlen, const char *in,
-                                       int inlen) _CUPS_API_1_1_21;
-extern void            httpSeparate2(const char *uri,
-                                     char *method, int methodlen,
-                                     char *username, int usernamelen,
-                                     char *host, int hostlen, int *port,
-                                     char *resource, int resourcelen) _CUPS_DEPRECATED_MSG("Use httpSeparateURI instead.");
-
-/**** New in CUPS 1.2/OS X 10.5 ****/
+extern char            *httpEncode64_2(char *out, int outlen, const char *in, int inlen) _CUPS_API_1_1_21;
+extern void            httpSeparate2(const char *uri, char *method, int methodlen, char *username, int usernamelen, char *host, int hostlen, int *port, char *resource, int resourcelen) _CUPS_DEPRECATED_1_2_MSG("Use httpSeparateURI instead.");
+
+/**** New in CUPS 1.2/macOS 10.5 ****/
 extern int             httpAddrAny(const http_addr_t *addr) _CUPS_API_1_2;
 extern http_addrlist_t *httpAddrConnect(http_addrlist_t *addrlist, int *sock) _CUPS_API_1_2;
-extern int             httpAddrEqual(const http_addr_t *addr1,
-                                     const http_addr_t *addr2) _CUPS_API_1_2;
+extern int             httpAddrEqual(const http_addr_t *addr1, const http_addr_t *addr2) _CUPS_API_1_2;
 extern void            httpAddrFreeList(http_addrlist_t *addrlist) _CUPS_API_1_2;
-extern http_addrlist_t *httpAddrGetList(const char *hostname, int family,
-                                        const char *service) _CUPS_API_1_2;
+extern http_addrlist_t *httpAddrGetList(const char *hostname, int family, const char *service) _CUPS_API_1_2;
 extern int             httpAddrLength(const http_addr_t *addr) _CUPS_API_1_2;
 extern int             httpAddrLocalhost(const http_addr_t *addr) _CUPS_API_1_2;
-extern char            *httpAddrLookup(const http_addr_t *addr,
-                                        char *name, int namelen) _CUPS_API_1_2;
-extern char            *httpAddrString(const http_addr_t *addr,
-                                       char *s, int slen) _CUPS_API_1_2;
-extern http_uri_status_t httpAssembleURI(http_uri_coding_t encoding,
-                                        char *uri, int urilen,
-                                        const char *scheme,
-                                        const char *username,
-                                        const char *host, int port,
-                                        const char *resource) _CUPS_API_1_2;
-extern http_uri_status_t httpAssembleURIf(http_uri_coding_t encoding,
-                                         char *uri, int urilen,
-                                         const char *scheme,
-                                         const char *username,
-                                         const char *host, int port,
-                                         const char *resourcef, ...) _CUPS_API_1_2;
+extern char            *httpAddrLookup(const http_addr_t *addr, char *name, int namelen) _CUPS_API_1_2;
+extern char            *httpAddrString(const http_addr_t *addr, char *s, int slen) _CUPS_API_1_2;
+extern http_uri_status_t httpAssembleURI(http_uri_coding_t encoding, char *uri, int urilen, const char *scheme, const char *username, const char *host, int port, const char *resource) _CUPS_API_1_2;
+extern http_uri_status_t httpAssembleURIf(http_uri_coding_t encoding, char *uri, int urilen, const char *scheme, const char *username, const char *host, int port, const char *resourcef, ...) _CUPS_FORMAT(8, 9) _CUPS_API_1_2;
 extern int             httpFlushWrite(http_t *http) _CUPS_API_1_2;
 extern int             httpGetBlocking(http_t *http) _CUPS_API_1_2;
 extern const char      *httpGetDateString2(time_t t, char *s, int slen) _CUPS_API_1_2;
@@ -541,77 +518,70 @@ extern int                httpGetFd(http_t *http) _CUPS_API_1_2;
 extern const char      *httpGetHostname(http_t *http, char *s, int slen) _CUPS_API_1_2;
 extern off_t           httpGetLength2(http_t *http) _CUPS_API_1_2;
 extern http_status_t   httpGetStatus(http_t *http) _CUPS_API_1_2;
-extern char            *httpGetSubField2(http_t *http, http_field_t field,
-                                         const char *name, char *value,
-                                         int valuelen) _CUPS_API_1_2;
+extern char            *httpGetSubField2(http_t *http, http_field_t field, const char *name, char *value, int valuelen) _CUPS_API_1_2;
 extern ssize_t         httpRead2(http_t *http, char *buffer, size_t length) _CUPS_API_1_2;
-extern http_uri_status_t httpSeparateURI(http_uri_coding_t decoding,
-                                        const char *uri,
-                                        char *scheme, int schemelen,
-                                        char *username, int usernamelen,
-                                        char *host, int hostlen, int *port,
-                                        char *resource, int resourcelen) _CUPS_API_1_2;
+extern http_uri_status_t httpSeparateURI(http_uri_coding_t decoding, const char *uri, char *scheme, int schemelen, char *username, int usernamelen, char *host, int hostlen, int *port, char *resource, int resourcelen) _CUPS_API_1_2;
 extern void            httpSetExpect(http_t *http, http_status_t expect) _CUPS_API_1_2;
 extern void            httpSetLength(http_t *http, size_t length) _CUPS_API_1_2;
-extern ssize_t         httpWrite2(http_t *http, const char *buffer,
-                                  size_t length) _CUPS_API_1_2;
+extern ssize_t         httpWrite2(http_t *http, const char *buffer, size_t length) _CUPS_API_1_2;
 
-/**** New in CUPS 1.3/OS X 10.5 ****/
+/**** New in CUPS 1.3/macOS 10.5 ****/
 extern char            *httpGetAuthString(http_t *http) _CUPS_API_1_3;
-extern void            httpSetAuthString(http_t *http, const char *scheme,
-                                         const char *data) _CUPS_API_1_3;
-
-/**** New in CUPS 1.5/OS X 10.7 ****/
-extern int             httpAddCredential(cups_array_t *credentials,
-                                         const void *data, size_t datalen)
-                                         _CUPS_API_1_5;
-extern int             httpCopyCredentials(http_t *http,
-                                           cups_array_t **credentials)
-                                           _CUPS_API_1_5;
+extern void            httpSetAuthString(http_t *http, const char *scheme, const char *data) _CUPS_API_1_3;
+
+/**** New in CUPS 1.5/macOS 10.7 ****/
+extern int             httpAddCredential(cups_array_t *credentials, const void *data, size_t datalen) _CUPS_API_1_5;
+extern int             httpCopyCredentials(http_t *http, cups_array_t **credentials) _CUPS_API_1_5;
 extern void            httpFreeCredentials(cups_array_t *certs) _CUPS_API_1_5;
-extern int             httpSetCredentials(http_t *http, cups_array_t *certs)
-                                          _CUPS_API_1_5;
-extern void            httpSetTimeout(http_t *http, double timeout,
-                                      http_timeout_cb_t cb, void *user_data)
-                                      _CUPS_API_1_5;
-
-/**** New in CUPS 1.6/OS X 10.8 ****/
-extern http_addrlist_t *httpAddrConnect2(http_addrlist_t *addrlist, int *sock,
-                                         int msec, int *cancel)
-                                         _CUPS_API_1_6;
+extern int             httpSetCredentials(http_t *http, cups_array_t *certs) _CUPS_API_1_5;
+extern void            httpSetTimeout(http_t *http, double timeout, http_timeout_cb_t cb, void *user_data) _CUPS_API_1_5;
+
+/**** New in CUPS 1.6/macOS 10.8 ****/
+extern http_addrlist_t *httpAddrConnect2(http_addrlist_t *addrlist, int *sock, int msec, int *cancel) _CUPS_API_1_6;
 extern http_state_t    httpGetState(http_t *http) _CUPS_API_1_6;
 extern http_version_t  httpGetVersion(http_t *http) _CUPS_API_1_6;
-extern int             httpReconnect2(http_t *http, int msec, int *cancel)
-                                      _CUPS_API_1_6;
+extern int             httpReconnect2(http_t *http, int msec, int *cancel) _CUPS_API_1_6;
 
 
-/**** New in CUPS 1.7 ****/
-extern http_t          *httpAcceptConnection(int fd, int blocking)
-                                             _CUPS_API_1_7;
+/**** New in CUPS 1.7/macOS 10.9 ****/
+extern http_t          *httpAcceptConnection(int fd, int blocking) _CUPS_API_1_7;
 extern http_addrlist_t *httpAddrCopyList(http_addrlist_t *src) _CUPS_API_1_7;
-extern int             httpAddrListen(http_addr_t *addr, int port)
-                                      _CUPS_API_1_7;
+extern int             httpAddrListen(http_addr_t *addr, int port) _CUPS_API_1_7;
 extern int             httpAddrPort(http_addr_t *addr) _CUPS_API_1_7;
-extern char            *httpAssembleUUID(const char *server, int port,
-                                         const char *name, int number,
-                                         char *buffer, size_t bufsize)
-                                         _CUPS_API_1_7;
-extern http_t          *httpConnect2(const char *host, int port,
-                                     http_addrlist_t *addrlist,
-                                     int family, http_encryption_t encryption,
-                                     int blocking, int msec, int *cancel)
-                                     _CUPS_API_1_7;
+extern char            *httpAssembleUUID(const char *server, int port, const char *name, int number, char *buffer, size_t bufsize) _CUPS_API_1_7;
+extern http_t          *httpConnect2(const char *host, int port, http_addrlist_t *addrlist, int family, http_encryption_t encryption, int blocking, int msec, int *cancel) _CUPS_API_1_7;
 extern const char      *httpGetContentEncoding(http_t *http) _CUPS_API_1_7;
 extern http_status_t   httpGetExpect(http_t *http) _CUPS_API_1_7;
-extern ssize_t         httpPeek(http_t *http, char *buffer, size_t length)
-                                _CUPS_API_1_7;
-extern http_state_t    httpReadRequest(http_t *http, char *resource,
-                                       size_t resourcelen) _CUPS_API_1_7;
-extern void            httpSetDefaultField(http_t *http, http_field_t field,
-                                           const char *value) _CUPS_API_1_7;
-extern http_state_t    httpWriteResponse(http_t *http,
-                                         http_status_t status) _CUPS_API_1_7;
-
+extern ssize_t         httpPeek(http_t *http, char *buffer, size_t length) _CUPS_API_1_7;
+extern http_state_t    httpReadRequest(http_t *http, char *resource, size_t resourcelen) _CUPS_API_1_7;
+extern void            httpSetDefaultField(http_t *http, http_field_t field, const char *value) _CUPS_API_1_7;
+extern http_state_t    httpWriteResponse(http_t *http, http_status_t status) _CUPS_API_1_7;
+
+/* New in CUPS 2.0/macOS 10.10 */
+extern int             httpAddrClose(http_addr_t *addr, int fd) _CUPS_API_2_0;
+extern int             httpAddrFamily(http_addr_t *addr) _CUPS_API_2_0;
+extern int             httpCompareCredentials(cups_array_t *cred1, cups_array_t *cred2) _CUPS_API_2_0;
+extern int             httpCredentialsAreValidForName(cups_array_t *credentials, const char *common_name);
+extern time_t          httpCredentialsGetExpiration(cups_array_t *credentials) _CUPS_API_2_0;
+extern http_trust_t    httpCredentialsGetTrust(cups_array_t *credentials, const char *common_name) _CUPS_API_2_0;
+extern size_t          httpCredentialsString(cups_array_t *credentials, char *buffer, size_t bufsize) _CUPS_API_2_0;
+extern http_field_t    httpFieldValue(const char *name) _CUPS_API_2_0;
+extern time_t          httpGetActivity(http_t *http) _CUPS_API_2_0;
+extern http_addr_t     *httpGetAddress(http_t *http) _CUPS_API_2_0;
+extern http_encryption_t httpGetEncryption(http_t *http) _CUPS_API_2_0;
+extern http_keepalive_t        httpGetKeepAlive(http_t *http) _CUPS_API_2_0;
+extern size_t          httpGetPending(http_t *http) _CUPS_API_2_0;
+extern size_t          httpGetReady(http_t *http) _CUPS_API_2_0;
+extern size_t          httpGetRemaining(http_t *http) _CUPS_API_2_0;
+extern int             httpIsChunked(http_t *http) _CUPS_API_2_0;
+extern int             httpIsEncrypted(http_t *http) _CUPS_API_2_0;
+extern int             httpLoadCredentials(const char *path, cups_array_t **credentials, const char *common_name) _CUPS_API_2_0;
+extern const char      *httpResolveHostname(http_t *http, char *buffer, size_t bufsize) _CUPS_API_2_0;
+extern int             httpSaveCredentials(const char *path, cups_array_t *credentials, const char *common_name) _CUPS_API_2_0;
+extern void            httpSetKeepAlive(http_t *http, http_keepalive_t keep_alive) _CUPS_API_2_0;
+extern void            httpShutdown(http_t *http) _CUPS_API_2_0;
+extern const char      *httpStateString(http_state_t state) _CUPS_API_2_0;
+extern const char      *httpURIStatusString(http_uri_status_t status) _CUPS_API_2_0;
 
 /*
  * C++ magic...
@@ -621,7 +591,3 @@ extern http_state_t httpWriteResponse(http_t *http,
 }
 #  endif /* __cplusplus */
 #endif /* !_CUPS_HTTP_H_ */
-
-/*
- * End of "$Id$".
- */