[thirdparty/cups.git] / cups / cups-private.h

/*
 * "$Id$"
 *
 *   Private definitions for CUPS.
 *
 *   Copyright 2007-2011 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.
 */

#ifndef _CUPS_CUPS_PRIVATE_H_
#  define _CUPS_CUPS_PRIVATE_H_

/*
 * Include necessary headers...
 */

#  include <cups/cups.h>
#  include "string-private.h"
#  include "debug-private.h"
#  include "ppd-private.h"
#  include "http-private.h"
#  include "ipp-private.h"
#  include "language-private.h"
#  include "pwg-private.h"
#  include "thread-private.h"
#  ifdef __APPLE__
#    include <sys/cdefs.h>
#    include <CoreFoundation/CoreFoundation.h>
#  endif /* __APPLE__ */


/*
 * C++ magic...
 */

#  ifdef __cplusplus
extern "C" {
#  endif /* __cplusplus */


/*
 * Types...
 */

typedef struct _cups_globals_s		/**** CUPS global state data ****/
{
  /* Multiple places... */
  const char		*cups_datadir,	/* CUPS_DATADIR environment var */
			*cups_serverbin,/* CUPS_SERVERBIN environment var */
			*cups_serverroot,
					/* CUPS_SERVERROOT environment var */
			*cups_statedir,	/* CUPS_STATEDIR environment var */
			*localedir;	/* LOCALDIR environment var */

  /* adminutil.c */
  time_t		cupsd_update;	/* Last time we got or set cupsd.conf */
  char			cupsd_hostname[HTTP_MAX_HOST];
					/* Hostname for connection */
  int			cupsd_num_settings;
					/* Number of server settings */
  cups_option_t		*cupsd_settings;/* Server settings */

  /* auth.c */
#  ifdef HAVE_GSSAPI
  char			gss_service_name[32];
  					/* Kerberos service name */
#  endif /* HAVE_GSSAPI */

  /* backend.c */
  char			resolved_uri[1024];
					/* Buffer for cupsBackendDeviceURI */

  /* file.c */
  cups_file_t		*stdio_files[3];/* stdin, stdout, stderr */

  /* http.c */
  char			http_date[256];	/* Date+time buffer */

  /* http-addr.c */
  unsigned		ip_addr;	/* Packed IPv4 address */
  char			*ip_ptrs[2];	/* Pointer to packed address */
  struct hostent	hostent;	/* Host entry for IP address */
#  ifdef HAVE_GETADDRINFO
  char			hostname[1024];	/* Hostname */
#  endif /* HAVE_GETADDRINFO */
  int			need_res_init;	/* Need to reinitialize resolver? */

  /* ipp.c */
  ipp_uchar_t		ipp_date[11];	/* RFC-1903 date/time data */
  _ipp_buffer_t		*ipp_buffers;	/* Buffer list */

  /* ipp-support.c */
  int			ipp_port;	/* IPP port number */
  char			ipp_unknown[255];
					/* Unknown error statuses */

  /* language.c */
  cups_lang_t		*lang_default;	/* Default language */
#  ifdef __APPLE__
  char			language[32];	/* Cached language */
#  endif /* __APPLE__ */

  /* ppd.c */
  ppd_status_t		ppd_status;	/* Status of last ppdOpen*() */
  int			ppd_line;	/* Current line number */
  ppd_conform_t		ppd_conform;	/* Level of conformance required */

  /* pwg-media.c */
  cups_array_t		*leg_size_lut,	/* Lookup table for legacy names */
			*ppd_size_lut,	/* Lookup table for PPD names */
			*pwg_size_lut;	/* Lookup table for PWG names */
  _pwg_media_t		pwg_media;	/* PWG media data for custom size */
  char			pwg_name[65];	/* PWG media name for custom size */

  /* request.c */
  http_t		*http;		/* Current server connection */
  ipp_status_t		last_error;	/* Last IPP error */
  char			*last_status_message;
					/* Last IPP status-message */

  /* snmp.c */
  char			snmp_community[255];
					/* Default SNMP community name */
  int			snmp_debug;	/* Log SNMP IO to stderr? */

  /* tempfile.c */
  char			tempfile[1024];	/* cupsTempFd/File buffer */

  /* usersys.c */
  http_encryption_t	encryption;	/* Encryption setting */
  char			user[65],	/* User name */
			server[256],	/* Server address */
			servername[256];/* Server hostname */
  cups_password_cb2_t	password_cb;	/* Password callback */
  void			*password_data;	/* Password user data */
  http_tls_credentials_t tls_credentials;
					/* Default client credentials */
  cups_client_cert_cb_t	client_cert_cb;	/* Client certificate callback */
  void			*client_cert_data;
					/* Client certificate user data */
  cups_server_cert_cb_t	server_cert_cb;	/* Server certificate callback */
  void			*server_cert_data;
					/* Server certificate user data */
  int			any_root,	/* Allow any root */
			expired_certs,	/* Allow expired certs */
			expired_root;	/* Allow expired root */

  /* util.c */
  char			def_printer[256];
					/* Default printer */
  char			ppd_filename[HTTP_MAX_URI];
					/* PPD filename */
} _cups_globals_t;


/*
 * Prototypes...
 */

#  ifdef __APPLE__
extern CFStringRef	_cupsAppleCopyDefaultPaperID(void);
extern CFStringRef	_cupsAppleCopyDefaultPrinter(void);
extern int		_cupsAppleGetUseLastPrinter(void);
extern void		_cupsAppleSetDefaultPaperID(CFStringRef name);
extern void		_cupsAppleSetDefaultPrinter(CFStringRef name);
extern void		_cupsAppleSetUseLastPrinter(int uselast);
#  endif /* __APPLE__ */

extern http_t		*_cupsConnect(void);
extern int		_cupsGet1284Values(const char *device_id,
			                   cups_option_t **values);
extern int		_cupsGetDests(http_t *http, ipp_op_t op,
			              const char *name, cups_dest_t **dests);
extern const char	*_cupsGetPassword(const char *prompt);
extern void		_cupsGlobalLock(void);
extern _cups_globals_t	*_cupsGlobals(void);
extern void		_cupsGlobalUnlock(void);
extern int		_cupsNextDelay(int current, int *previous);
extern void		_cupsSetDefaults(void);
extern void		_cupsSetError(ipp_status_t status, const char *message,
			              int localize);
extern void		_cupsSetHTTPError(http_status_t status);
#  ifdef HAVE_GSSAPI
extern int		_cupsSetNegotiateAuthString(http_t *http,
			                            const char *method,
						    const char *resource);
#  endif /* HAVE_GSSAPI */
extern char		*_cupsUserDefault(char *name, size_t namesize);


/*
 * C++ magic...
 */

#  ifdef __cplusplus
}
#  endif /* __cplusplus */
#endif /* !_CUPS_CUPS_PRIVATE_H_ */

/*
 * End of "$Id$".
 */
Commit	Line	Data
03f61bf3	1	/*
	2	* "$Id$"
	3	*
3d94661a	4	* Private definitions for CUPS.
03f61bf3	5	*
181f5167	6	* Copyright 2007-2011 by Apple Inc.
753db4fd	7	* Copyright 1997-2007 by Easy Software Products, all rights reserved.
03f61bf3	8	*
03f61bf3	9	* These coded instructions, statements, and computer programs are the
4e8d321f	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/".
03f61bf3	14	*
	15	* This file is subject to the Apple OS-Developed Software exception.
	16	*/
	17
3d94661a	18	#ifndef _CUPS_CUPS_PRIVATE_H_
3d94661a	19	# define _CUPS_CUPS_PRIVATE_H_
03f61bf3	20
	21	/*
	22	* Include necessary headers...
	23	*/
	24
3d94661a	25	# include <cups/cups.h>
	26	# include "string-private.h"
	27	# include "debug-private.h"
c14eaf92	28	# include "ppd-private.h"
72510b94	29	# include "http-private.h"
3d94661a	30	# include "ipp-private.h"
3d94661a	31	# include "language-private.h"
64dd1836	32	# include "pwg-private.h"
fa7e8544	33	# include "thread-private.h"
181f5167	34	# ifdef __APPLE__
	35	# include <sys/cdefs.h>
	36	# include <CoreFoundation/CoreFoundation.h>
	37	# endif /* __APPLE__ */
03f61bf3	38
	39
	40	/*
	41	* C++ magic...
	42	*/
	43
	44	# ifdef __cplusplus
	45	extern "C" {
	46	# endif /* __cplusplus */
	47
	48
03f61bf3	49	/*
3d94661a	50	* Types...
03f61bf3	51	*/
03f61bf3	52
2625096f	53	typedef struct _cups_globals_s /** CUPS global state data **/
03f61bf3	54	{
a501ad17	55	/* Multiple places... */
	56	const char cups_datadir, / CUPS_DATADIR environment var */
	57	cups_serverbin,/ CUPS_SERVERBIN environment var */
	58	*cups_serverroot,
	59	/* CUPS_SERVERROOT environment var */
	60	cups_statedir, / CUPS_STATEDIR environment var */
	61	localedir; / LOCALDIR environment var */
	62
7701ffe8	63	/* adminutil.c */
	64	time_t cupsd_update; /* Last time we got or set cupsd.conf */
	65	char cupsd_hostname[HTTP_MAX_HOST];
	66	/* Hostname for connection */
	67	int cupsd_num_settings;
	68	/* Number of server settings */
	69	cups_option_t cupsd_settings;/ Server settings */
	70
9200f229	71	/* auth.c */
	72	# ifdef HAVE_GSSAPI
	73	char gss_service_name[32];
	74	/* Kerberos service name */
	75	# endif /* HAVE_GSSAPI */
	76
012d7a28	77	/* backend.c */
	78	char resolved_uri[1024];
	79	/* Buffer for cupsBackendDeviceURI */
	80
5cc5c44f	81	/* file.c */
	82	cups_file_t stdio_files[3];/ stdin, stdout, stderr */
	83
03f61bf3	84	/* http.c */
	85	char http_date[256]; /* Date+time buffer */
	86
	87	/* http-addr.c */
086c584d	88	unsigned ip_addr; /* Packed IPv4 address */
086c584d	89	char ip_ptrs[2]; / Pointer to packed address */
03f61bf3	90	struct hostent hostent; /* Host entry for IP address */
	91	# ifdef HAVE_GETADDRINFO
	92	char hostname[1024]; /* Hostname */
	93	# endif /* HAVE_GETADDRINFO */
36b81b47	94	int need_res_init; /* Need to reinitialize resolver? */
03f61bf3	95
	96	/* ipp.c */
	97	ipp_uchar_t ipp_date[11]; /* RFC-1903 date/time data */
d6371bd7	98	_ipp_buffer_t ipp_buffers; / Buffer list */
03f61bf3	99
	100	/* ipp-support.c */
	101	int ipp_port; /* IPP port number */
	102	char ipp_unknown[255];
	103	/* Unknown error statuses */
	104
03f61bf3	105	/* language.c */
89fd567e	106	cups_lang_t lang_default; / Default language */
03f61bf3	107	# ifdef __APPLE__
03f61bf3	108	char language[32]; /* Cached language */
03f61bf3	109	# endif /* __APPLE__ */
	110
	111	/* ppd.c */
	112	ppd_status_t ppd_status; /* Status of last ppdOpen() /
	113	int ppd_line; /* Current line number */
	114	ppd_conform_t ppd_conform; /* Level of conformance required */
	115
64dd1836	116	/* pwg-media.c */
	117	cups_array_t leg_size_lut, / Lookup table for legacy names */
	118	ppd_size_lut, / Lookup table for PPD names */
	119	pwg_size_lut; / Lookup table for PWG names */
	120	_pwg_media_t pwg_media; /* PWG media data for custom size */
	121	char pwg_name[65]; /* PWG media name for custom size */
22d59a30	122
29a3a9e6	123	/* request.c */
	124	http_t http; / Current server connection */
	125	ipp_status_t last_error; /* Last IPP error */
	126	char *last_status_message;
	127	/* Last IPP status-message */
	128
958bdaa3	129	/* snmp.c */
896cc0e8	130	char snmp_community[255];
896cc0e8	131	/* Default SNMP community name */
958bdaa3	132	int snmp_debug; /* Log SNMP IO to stderr? */
958bdaa3	133
03f61bf3	134	/* tempfile.c */
	135	char tempfile[1024]; /* cupsTempFd/File buffer */
	136
03f61bf3	137	/* usersys.c */
	138	http_encryption_t encryption; /* Encryption setting */
	139	char user[65], /* User name */
086c584d	140	server[256], /* Server address */
c94f4aa9	141	servername[256];/* Server hostname */
c890e5ea	142	cups_password_cb2_t password_cb; /* Password callback */
c890e5ea	143	void password_data; / Password user data */
b9738d7c	144	http_tls_credentials_t tls_credentials;
	145	/* Default client credentials */
	146	cups_client_cert_cb_t client_cert_cb; /* Client certificate callback */
	147	void *client_cert_data;
	148	/* Client certificate user data */
	149	cups_server_cert_cb_t server_cert_cb; /* Server certificate callback */
	150	void *server_cert_data;
	151	/* Server certificate user data */
	152	int any_root, /* Allow any root */
	153	expired_certs, /* Allow expired certs */
	154	expired_root; /* Allow expired root */
03f61bf3	155
03f61bf3	156	/* util.c */
03f61bf3	157	char def_printer[256];
	158	/* Default printer */
	159	char ppd_filename[HTTP_MAX_URI];
	160	/* PPD filename */
2625096f	161	} _cups_globals_t;
03f61bf3	162
	163
	164	/*
	165	* Prototypes...
	166	*/
	167
181f5167	168	# ifdef __APPLE__
181f5167	169	extern CFStringRef _cupsAppleCopyDefaultPaperID(void);
56c4a391	170	extern CFStringRef _cupsAppleCopyDefaultPrinter(void);
181f5167	171	extern int _cupsAppleGetUseLastPrinter(void);
181f5167	172	extern void _cupsAppleSetDefaultPaperID(CFStringRef name);
56c4a391	173	extern void _cupsAppleSetDefaultPrinter(CFStringRef name);
181f5167	174	extern void _cupsAppleSetUseLastPrinter(int uselast);
	175	# endif /* __APPLE__ */
	176
36883182	177	extern http_t *_cupsConnect(void);
2256cc12	178	extern int _cupsGet1284Values(const char *device_id,
2256cc12	179	cups_option_t **values);
181f5167	180	extern int _cupsGetDests(http_t *http, ipp_op_t op,
56c4a391	181	const char name, cups_dest_t *dests);
03f61bf3	182	extern const char _cupsGetPassword(const char prompt);
fa7e8544	183	extern void _cupsGlobalLock(void);
2625096f	184	extern _cups_globals_t *_cupsGlobals(void);
fa7e8544	185	extern void _cupsGlobalUnlock(void);
fc596e79	186	extern int _cupsNextDelay(int current, int *previous);
d4c4cd54	187	extern void _cupsSetDefaults(void);
e6f60272	188	extern void _cupsSetError(ipp_status_t status, const char *message,
e6f60272	189	int localize);
64e79e51	190	extern void _cupsSetHTTPError(http_status_t status);
f5259d8c	191	# ifdef HAVE_GSSAPI
ec6e3e5a	192	extern int _cupsSetNegotiateAuthString(http_t *http,
	193	const char *method,
	194	const char *resource);
f5259d8c	195	# endif /* HAVE_GSSAPI */
fec07f7a	196	extern char _cupsUserDefault(char name, size_t namesize);
03f61bf3	197
	198
	199	/*
	200	* C++ magic...
	201	*/
	202
	203	# ifdef __cplusplus
	204	}
	205	# endif /* __cplusplus */
3d94661a	206	#endif /* !_CUPS_CUPS_PRIVATE_H_ */
03f61bf3	207
	208	/*
	209	* End of "$Id$".
	210	*/