2 * "$Id: cups-private.h 9596 2011-03-11 18:26:36Z mike $"
4 * Private definitions for CUPS.
6 * Copyright 2007-2012 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_CUPS_PRIVATE_H_
19 # define _CUPS_CUPS_PRIVATE_H_
22 * Include necessary headers...
25 # include "string-private.h"
26 # include "debug-private.h"
27 # include "ipp-private.h"
28 # include "http-private.h"
29 # include "language-private.h"
30 # include "pwg-private.h"
31 # include "ppd-private.h"
32 # include "thread-private.h"
33 # include <cups/cups.h>
35 # include <sys/cdefs.h>
36 # include <CoreFoundation/CoreFoundation.h>
37 # endif /* __APPLE__ */
46 # endif /* __cplusplus */
53 typedef struct _cups_buffer_s
/**** Read/write buffer ****/
55 struct _cups_buffer_s
*next
; /* Next buffer in list */
56 size_t size
; /* Size of buffer */
57 char used
, /* Is this buffer used? */
58 d
[1]; /* Data buffer */
61 typedef struct _cups_globals_s
/**** CUPS global state data ****/
63 /* Multiple places... */
64 const char *cups_datadir
, /* CUPS_DATADIR environment var */
65 *cups_serverbin
,/* CUPS_SERVERBIN environment var */
67 /* CUPS_SERVERROOT environment var */
68 *cups_statedir
, /* CUPS_STATEDIR environment var */
69 *localedir
; /* LOCALDIR environment var */
72 time_t cupsd_update
; /* Last time we got or set cupsd.conf */
73 char cupsd_hostname
[HTTP_MAX_HOST
];
74 /* Hostname for connection */
75 int cupsd_num_settings
;
76 /* Number of server settings */
77 cups_option_t
*cupsd_settings
;/* Server settings */
81 char gss_service_name
[32];
82 /* Kerberos service name */
83 # endif /* HAVE_GSSAPI */
86 char resolved_uri
[1024];
87 /* Buffer for cupsBackendDeviceURI */
90 cups_file_t
*stdio_files
[3];/* stdin, stdout, stderr */
93 char http_date
[256]; /* Date+time buffer */
96 unsigned ip_addr
; /* Packed IPv4 address */
97 char *ip_ptrs
[2]; /* Pointer to packed address */
98 struct hostent hostent
; /* Host entry for IP address */
99 # ifdef HAVE_GETADDRINFO
100 char hostname
[1024]; /* Hostname */
101 # endif /* HAVE_GETADDRINFO */
102 int need_res_init
; /* Need to reinitialize resolver? */
105 ipp_uchar_t ipp_date
[11]; /* RFC-1903 date/time data */
106 _cups_buffer_t
*cups_buffers
; /* Buffer list */
109 int ipp_port
; /* IPP port number */
110 char ipp_unknown
[255];
111 /* Unknown error statuses */
114 cups_lang_t
*lang_default
; /* Default language */
116 char language
[32]; /* Cached language */
117 # endif /* __APPLE__ */
120 ppd_status_t ppd_status
; /* Status of last ppdOpen*() */
121 int ppd_line
; /* Current line number */
122 ppd_conform_t ppd_conform
; /* Level of conformance required */
125 cups_array_t
*leg_size_lut
, /* Lookup table for legacy names */
126 *ppd_size_lut
, /* Lookup table for PPD names */
127 *pwg_size_lut
; /* Lookup table for PWG names */
128 _pwg_media_t pwg_media
; /* PWG media data for custom size */
129 char pwg_name
[65]; /* PWG media name for custom size */
132 http_t
*http
; /* Current server connection */
133 ipp_status_t last_error
; /* Last IPP error */
134 char *last_status_message
;
135 /* Last IPP status-message */
138 char snmp_community
[255];
139 /* Default SNMP community name */
140 int snmp_debug
; /* Log SNMP IO to stderr? */
143 char tempfile
[1024]; /* cupsTempFd/File buffer */
146 http_encryption_t encryption
; /* Encryption setting */
147 char user
[65], /* User name */
148 server
[256], /* Server address */
149 servername
[256],/* Server hostname */
150 password
[128]; /* Password for default callback */
151 cups_password_cb2_t password_cb
; /* Password callback */
152 void *password_data
; /* Password user data */
153 http_tls_credentials_t tls_credentials
;
154 /* Default client credentials */
155 cups_client_cert_cb_t client_cert_cb
; /* Client certificate callback */
156 void *client_cert_data
;
157 /* Client certificate user data */
158 cups_server_cert_cb_t server_cert_cb
; /* Server certificate callback */
159 void *server_cert_data
;
160 /* Server certificate user data */
161 int any_root
, /* Allow any root */
162 expired_certs
, /* Allow expired certs */
163 expired_root
; /* Allow expired root */
166 char def_printer
[256];
167 /* Default printer */
168 char ppd_filename
[HTTP_MAX_URI
];
172 typedef struct _cups_media_db_s
/* Media database */
174 char *color
, /* Media color, if any */
175 *key
, /* Media key, if any */
176 *info
, /* Media human-readable name, if any */
177 *size_name
, /* Media PWG size name, if provided */
178 *source
, /* Media source, if any */
179 *type
; /* Media type, if any */
180 int width
, /* Width in hundredths of millimeters */
181 length
, /* Length in hundredths of
183 bottom
, /* Bottom margin in hundredths of
185 left
, /* Left margin in hundredths of
187 right
, /* Right margin in hundredths of
189 top
; /* Top margin in hundredths of
193 typedef struct _cups_dconstres_s
/* Constraint/resolver */
195 char *name
; /* Name of resolver */
196 ipp_t
*collection
; /* Collection containing attrs */
199 struct _cups_dinfo_s
/* Destination capability and status
202 const char *uri
; /* Printer URI */
203 char *resource
; /* Resource path */
204 ipp_t
*attrs
; /* Printer attributes */
205 int num_defaults
; /* Number of default options */
206 cups_option_t
*defaults
; /* Default options */
207 cups_array_t
*constraints
; /* Job constraints */
208 cups_array_t
*resolvers
; /* Job resolvers */
209 cups_array_t
*localizations
; /* Localization information */
210 cups_array_t
*media_db
; /* Media database */
211 _cups_media_db_t min_size
, /* Minimum size */
212 max_size
; /* Maximum size */
221 extern CFStringRef
_cupsAppleCopyDefaultPaperID(void);
222 extern CFStringRef
_cupsAppleCopyDefaultPrinter(void);
223 extern int _cupsAppleGetUseLastPrinter(void);
224 extern void _cupsAppleSetDefaultPaperID(CFStringRef name
);
225 extern void _cupsAppleSetDefaultPrinter(CFStringRef name
);
226 extern void _cupsAppleSetUseLastPrinter(int uselast
);
227 # endif /* __APPLE__ */
229 extern char *_cupsBufferGet(size_t size
);
230 extern void _cupsBufferRelease(char *b
);
232 extern http_t
*_cupsConnect(void);
233 extern int _cupsGet1284Values(const char *device_id
,
234 cups_option_t
**values
);
235 extern const char *_cupsGetDestResource(cups_dest_t
*dest
, char *resource
,
236 size_t resourcesize
);
237 extern int _cupsGetDests(http_t
*http
, ipp_op_t op
,
238 const char *name
, cups_dest_t
**dests
,
239 cups_ptype_t type
, cups_ptype_t mask
);
240 extern const char *_cupsGetPassword(const char *prompt
);
241 extern void _cupsGlobalLock(void);
242 extern _cups_globals_t
*_cupsGlobals(void);
243 extern void _cupsGlobalUnlock(void);
245 extern const char *_cupsGSSServiceName(void);
246 # endif /* HAVE_GSSAPI */
247 extern int _cupsNextDelay(int current
, int *previous
);
248 extern void _cupsSetDefaults(void);
249 extern void _cupsSetError(ipp_status_t status
, const char *message
,
251 extern void _cupsSetHTTPError(http_status_t status
);
253 extern int _cupsSetNegotiateAuthString(http_t
*http
,
255 const char *resource
);
256 # endif /* HAVE_GSSAPI */
257 extern char *_cupsUserDefault(char *name
, size_t namesize
);
266 # endif /* __cplusplus */
267 #endif /* !_CUPS_CUPS_PRIVATE_H_ */
270 * End of "$Id: cups-private.h 9596 2011-03-11 18:26:36Z mike $".