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

/*
 * Private definitions for CUPS.
 *
 * Copyright © 2007-2018 by Apple Inc.
 * Copyright © 1997-2007 by Easy Software Products, all rights reserved.
 *
 * Licensed under Apache License v2.0.  See the file "LICENSE" for more
 * information.
 */

#ifndef _CUPS_CUPS_PRIVATE_H_
#  define _CUPS_CUPS_PRIVATE_H_

/*
 * Include necessary headers...
 */

#  include "string-private.h"
#  include "array-private.h"
#  include "ipp-private.h"
#  include "http-private.h"
#  include "language-private.h"
#  include "pwg-private.h"
#  include "thread-private.h"
#  include <cups/cups.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_buffer_s		/**** Read/write buffer ****/
{
  struct _cups_buffer_s	*next;		/* Next buffer in list */
  size_t		size;		/* Size of buffer */
  char			used,		/* Is this buffer used? */
			d[1];		/* Data buffer */
} _cups_buffer_t;

typedef struct _cups_raster_error_s	/**** Error buffer structure ****/
{
  char	*start,				/* Start of buffer */
	*current,			/* Current position in buffer */
	*end;				/* End of buffer */
} _cups_raster_error_t;

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 */

  /* debug.c */
#  ifdef DEBUG
  int			thread_id;	/* Friendly thread ID */
#  endif /* DEBUG */

  /* 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-2579 date/time data */
  _cups_buffer_t	*cups_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__ */

  /* 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 */
			ppd_name[41];	/* PPD media name for custom size */

  /* raster-error.c */
  _cups_raster_error_t	raster_error;	/* Raster error information */

  /* 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 */
			user_agent[256],/* User-Agent string */
			server[256],	/* Server address */
			servername[256],/* Server hostname */
			password[128];	/* Password for default callback */
  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			server_version,	/* Server IPP version */
			trust_first,	/* Trust on first use? */
			any_root,	/* Allow any (e.g., self-signed) root */
			expired_certs,	/* Allow expired certs */
			validate_certs;	/* Validate certificates */

  /* util.c */
  char			def_printer[256];
					/* Default printer */
} _cups_globals_t;

typedef struct _cups_media_db_s		/* Media database */
{
  char		*color,			/* Media color, if any */
		*key,			/* Media key, if any */
		*info,			/* Media human-readable name, if any */
		*size_name,		/* Media PWG size name, if provided */
		*source,		/* Media source, if any */
		*type;			/* Media type, if any */
  int		width,			/* Width in hundredths of millimeters */
		length,			/* Length in hundredths of
					 * millimeters */
		bottom,			/* Bottom margin in hundredths of
					 * millimeters */
		left,			/* Left margin in hundredths of
					 * millimeters */
		right,			/* Right margin in hundredths of
					 * millimeters */
		top;			/* Top margin in hundredths of
					 * millimeters */
} _cups_media_db_t;

typedef struct _cups_dconstres_s	/* Constraint/resolver */
{
  char	*name;				/* Name of resolver */
  ipp_t	*collection;			/* Collection containing attrs */
} _cups_dconstres_t;

struct _cups_dinfo_s			/* Destination capability and status
					 * information */
{
  int			version;	/* IPP version */
  const char		*uri;		/* Printer URI */
  char			*resource;	/* Resource path */
  ipp_t			*attrs;		/* Printer attributes */
  int			num_defaults;	/* Number of default options */
  cups_option_t		*defaults;	/* Default options */
  cups_array_t		*constraints;	/* Job constraints */
  cups_array_t		*resolvers;	/* Job resolvers */
  cups_array_t		*localizations;	/* Localization information */
  cups_array_t		*media_db;	/* Media database */
  _cups_media_db_t	min_size,	/* Minimum size */
			max_size;	/* Maximum size */
  unsigned		cached_flags;	/* Flags used for cached media */
  cups_array_t		*cached_db;	/* Cache of media from last index/default */
  time_t		ready_time;	/* When xxx-ready attributes were last queried */
  ipp_t			*ready_attrs;	/* xxx-ready attributes */
  cups_array_t		*ready_db;	/* media[-col]-ready media database */
};


/*
 * Prototypes...
 */

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

extern char		*_cupsBufferGet(size_t size) _CUPS_PRIVATE;
extern void		_cupsBufferRelease(char *b) _CUPS_PRIVATE;

extern http_t		*_cupsConnect(void) _CUPS_PRIVATE;
extern char		*_cupsCreateDest(const char *name, const char *info, const char *device_id, const char *device_uri, char *uri, size_t urisize) _CUPS_PRIVATE;
extern ipp_attribute_t	*_cupsEncodeOption(ipp_t *ipp, ipp_tag_t group_tag, _ipp_option_t *map, const char *name, const char *value) _CUPS_PRIVATE;
extern int		_cupsGet1284Values(const char *device_id, cups_option_t **values) _CUPS_PRIVATE;
extern const char	*_cupsGetDestResource(cups_dest_t *dest, unsigned flags, char *resource, size_t resourcesize) _CUPS_PRIVATE;
extern int		_cupsGetDests(http_t *http, ipp_op_t op, const char *name, cups_dest_t **dests, cups_ptype_t type, cups_ptype_t mask) _CUPS_PRIVATE;
extern const char	*_cupsGetPassword(const char *prompt) _CUPS_PRIVATE;
extern void		_cupsGlobalLock(void) _CUPS_PRIVATE;
extern _cups_globals_t	*_cupsGlobals(void) _CUPS_PRIVATE;
extern void		_cupsGlobalUnlock(void) _CUPS_PRIVATE;
#  ifdef HAVE_GSSAPI
extern const char	*_cupsGSSServiceName(void) _CUPS_PRIVATE;
#  endif /* HAVE_GSSAPI */
extern int		_cupsNextDelay(int current, int *previous) _CUPS_PRIVATE;
extern void		_cupsSetDefaults(void) _CUPS_INTERNAL;
extern void		_cupsSetError(ipp_status_t status, const char *message, int localize) _CUPS_PRIVATE;
extern void		_cupsSetHTTPError(http_status_t status) _CUPS_INTERNAL;
#  ifdef HAVE_GSSAPI
extern int		_cupsSetNegotiateAuthString(http_t *http, const char *method, const char *resource) _CUPS_PRIVATE;
#  endif /* HAVE_GSSAPI */
extern char		*_cupsUserDefault(char *name, size_t namesize) _CUPS_INTERNAL;


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

#  ifdef __cplusplus
}
#  endif /* __cplusplus */
#endif /* !_CUPS_CUPS_PRIVATE_H_ */
Commit	Line	Data
ef416fc2	1	/*
503b54c9	2	* Private definitions for CUPS.
ef416fc2	3	*
b969d5af MS	4	* Copyright © 2007-2018 by Apple Inc.
b969d5af MS	5	* Copyright © 1997-2007 by Easy Software Products, all rights reserved.
ef416fc2	6	*
b969d5af MS	7	* Licensed under Apache License v2.0. See the file "LICENSE" for more
b969d5af MS	8	* information.
ef416fc2	9	*/
ef416fc2	10
71e16022 MS	11	#ifndef _CUPS_CUPS_PRIVATE_H_
71e16022 MS	12	# define _CUPS_CUPS_PRIVATE_H_
ef416fc2	13
	14	/*
	15	* Include necessary headers...
	16	*/
	17
71e16022	18	# include "string-private.h"
5a9febac	19	# include "array-private.h"
71e16022	20	# include "ipp-private.h"
82cc1f9a	21	# include "http-private.h"
71e16022	22	# include "language-private.h"
54afec33	23	# include "pwg-private.h"
6d2f911b	24	# include "thread-private.h"
82cc1f9a	25	# include <cups/cups.h>
c8fef167 MS	26	# ifdef __APPLE__
	27	# include <sys/cdefs.h>
	28	# include <CoreFoundation/CoreFoundation.h>
	29	# endif /* __APPLE__ */
ef416fc2	30
	31
	32	/*
	33	* C++ magic...
	34	*/
	35
	36	# ifdef __cplusplus
	37	extern "C" {
	38	# endif /* __cplusplus */
	39
	40
	41	/*
71e16022	42	* Types...
ef416fc2	43	*/
ef416fc2	44
dcb445bc MS	45	typedef struct _cups_buffer_s /** Read/write buffer **/
	46	{
	47	struct _cups_buffer_s next; / Next buffer in list */
	48	size_t size; /* Size of buffer */
	49	char used, /* Is this buffer used? */
	50	d[1]; /* Data buffer */
	51	} _cups_buffer_t;
	52
dd204f7a MS	53	typedef struct _cups_raster_error_s /** Error buffer structure **/
	54	{
	55	char start, / Start of buffer */
	56	current, / Current position in buffer */
	57	end; / End of buffer */
	58	} _cups_raster_error_t;
	59
ef416fc2	60	typedef struct _cups_globals_s /** CUPS global state data **/
	61	{
	62	/* Multiple places... */
	63	const char cups_datadir, / CUPS_DATADIR environment var */
	64	cups_serverbin,/ CUPS_SERVERBIN environment var */
	65	*cups_serverroot,
	66	/* CUPS_SERVERROOT environment var */
	67	cups_statedir, / CUPS_STATEDIR environment var */
	68	localedir; / LOCALDIR environment var */
	69
757d2cad	70	/* adminutil.c */
	71	time_t cupsd_update; /* Last time we got or set cupsd.conf */
	72	char cupsd_hostname[HTTP_MAX_HOST];
	73	/* Hostname for connection */
	74	int cupsd_num_settings;
	75	/* Number of server settings */
	76	cups_option_t cupsd_settings;/ Server settings */
	77
07ed0e9a MS	78	/* auth.c */
	79	# ifdef HAVE_GSSAPI
	80	char gss_service_name[32];
	81	/* Kerberos service name */
	82	# endif /* HAVE_GSSAPI */
	83
5eb9da71 MS	84	/* backend.c */
	85	char resolved_uri[1024];
	86	/* Buffer for cupsBackendDeviceURI */
	87
a469f8a5 MS	88	/* debug.c */
	89	# ifdef DEBUG
	90	int thread_id; /* Friendly thread ID */
	91	# endif /* DEBUG */
	92
80ca4592	93	/* file.c */
	94	cups_file_t stdio_files[3];/ stdin, stdout, stderr */
	95
ef416fc2	96	/* http.c */
	97	char http_date[256]; /* Date+time buffer */
	98
	99	/* http-addr.c */
	100	unsigned ip_addr; /* Packed IPv4 address */
	101	char ip_ptrs[2]; / Pointer to packed address */
	102	struct hostent hostent; /* Host entry for IP address */
	103	# ifdef HAVE_GETADDRINFO
	104	char hostname[1024]; /* Hostname */
	105	# endif /* HAVE_GETADDRINFO */
49d87452	106	int need_res_init; /* Need to reinitialize resolver? */
ef416fc2	107
ef416fc2	108	/* ipp.c */
65bebeac	109	ipp_uchar_t ipp_date[11]; /* RFC-2579 date/time data */
dcb445bc	110	_cups_buffer_t cups_buffers; / Buffer list */
ef416fc2	111
	112	/* ipp-support.c */
	113	int ipp_port; /* IPP port number */
	114	char ipp_unknown[255];
	115	/* Unknown error statuses */
	116
ef416fc2	117	/* language.c */
fa73b229	118	cups_lang_t lang_default; / Default language */
ef416fc2	119	# ifdef __APPLE__
ef416fc2	120	char language[32]; /* Cached language */
ef416fc2	121	# endif /* __APPLE__ */
ef416fc2	122
54afec33 MS	123	/* pwg-media.c */
	124	cups_array_t leg_size_lut, / Lookup table for legacy names */
	125	ppd_size_lut, / Lookup table for PPD names */
	126	pwg_size_lut; / Lookup table for PWG names */
6961465f	127	pwg_media_t pwg_media; /* PWG media data for custom size */
23862bc6 MS	128	char pwg_name[65], /* PWG media name for custom size */
23862bc6 MS	129	ppd_name[41]; /* PPD media name for custom size */
c168a833	130
dd204f7a MS	131	/* raster-error.c */
	132	_cups_raster_error_t raster_error; /* Raster error information */
	133
5180a04c MS	134	/* request.c */
	135	http_t http; / Current server connection */
	136	ipp_status_t last_error; /* Last IPP error */
	137	char *last_status_message;
	138	/* Last IPP status-message */
	139
91c84a35	140	/* snmp.c */
ac884b6a MS	141	char snmp_community[255];
ac884b6a MS	142	/* Default SNMP community name */
91c84a35 MS	143	int snmp_debug; /* Log SNMP IO to stderr? */
91c84a35 MS	144
ef416fc2	145	/* tempfile.c */
	146	char tempfile[1024]; /* cupsTempFd/File buffer */
	147
ef416fc2	148	/* usersys.c */
	149	http_encryption_t encryption; /* Encryption setting */
	150	char user[65], /* User name */
db8b865d	151	user_agent[256],/* User-Agent string */
ef416fc2	152	server[256], /* Server address */
dcb445bc MS	153	servername[256],/* Server hostname */
dcb445bc MS	154	password[128]; /* Password for default callback */
f11a948a MS	155	cups_password_cb2_t password_cb; /* Password callback */
f11a948a MS	156	void password_data; / Password user data */
7cf5915e MS	157	http_tls_credentials_t tls_credentials;
	158	/* Default client credentials */
	159	cups_client_cert_cb_t client_cert_cb; /* Client certificate callback */
	160	void *client_cert_data;
	161	/* Client certificate user data */
	162	cups_server_cert_cb_t server_cert_cb; /* Server certificate callback */
	163	void *server_cert_data;
	164	/* Server certificate user data */
0cb67df3	165	int server_version, /* Server IPP version */
08d56b1f	166	trust_first, /* Trust on first use? */
9653cfdf	167	any_root, /* Allow any (e.g., self-signed) root */
f51f3773 MS	168	expired_certs, /* Allow expired certs */
f51f3773 MS	169	validate_certs; /* Validate certificates */
ef416fc2	170
ef416fc2	171	/* util.c */
ef416fc2	172	char def_printer[256];
ef416fc2	173	/* Default printer */
ef416fc2	174	} _cups_globals_t;
ef416fc2	175
dcb445bc MS	176	typedef struct _cups_media_db_s /* Media database */
	177	{
	178	char color, / Media color, if any */
	179	key, / Media key, if any */
	180	info, / Media human-readable name, if any */
	181	size_name, / Media PWG size name, if provided */
	182	source, / Media source, if any */
	183	type; / Media type, if any */
	184	int width, /* Width in hundredths of millimeters */
	185	length, /* Length in hundredths of
	186	* millimeters */
	187	bottom, /* Bottom margin in hundredths of
	188	* millimeters */
	189	left, /* Left margin in hundredths of
	190	* millimeters */
	191	right, /* Right margin in hundredths of
	192	* millimeters */
	193	top; /* Top margin in hundredths of
	194	* millimeters */
	195	} _cups_media_db_t;
	196
a29fd7dd MS	197	typedef struct _cups_dconstres_s /* Constraint/resolver */
	198	{
	199	char name; / Name of resolver */
	200	ipp_t collection; / Collection containing attrs */
	201	} _cups_dconstres_t;
	202
dcb445bc MS	203	struct _cups_dinfo_s /* Destination capability and status
	204	* information */
	205	{
6961465f	206	int version; /* IPP version */
dcb445bc MS	207	const char uri; / Printer URI */
	208	char resource; / Resource path */
	209	ipp_t attrs; / Printer attributes */
a29fd7dd MS	210	int num_defaults; /* Number of default options */
a29fd7dd MS	211	cups_option_t defaults; / Default options */
dcb445bc	212	cups_array_t constraints; / Job constraints */
a29fd7dd	213	cups_array_t resolvers; / Job resolvers */
dcb445bc MS	214	cups_array_t localizations; / Localization information */
	215	cups_array_t media_db; / Media database */
	216	_cups_media_db_t min_size, /* Minimum size */
	217	max_size; /* Maximum size */
6961465f MS	218	unsigned cached_flags; /* Flags used for cached media */
	219	cups_array_t cached_db; / Cache of media from last index/default */
	220	time_t ready_time; /* When xxx-ready attributes were last queried */
	221	ipp_t ready_attrs; / xxx-ready attributes */
	222	cups_array_t ready_db; / media[-col]-ready media database */
dcb445bc MS	223	};
dcb445bc MS	224
ef416fc2	225
	226	/*
	227	* Prototypes...
	228	*/
	229
c8fef167	230	# ifdef __APPLE__
e3586875 MS	231	extern CFStringRef _cupsAppleCopyDefaultPaperID(void) _CUPS_PRIVATE;
	232	extern CFStringRef _cupsAppleCopyDefaultPrinter(void) _CUPS_PRIVATE;
	233	extern int _cupsAppleGetUseLastPrinter(void) _CUPS_PRIVATE;
	234	extern void _cupsAppleSetDefaultPaperID(CFStringRef name) _CUPS_PRIVATE;
	235	extern void _cupsAppleSetDefaultPrinter(CFStringRef name) _CUPS_PRIVATE;
	236	extern void _cupsAppleSetUseLastPrinter(int uselast) _CUPS_PRIVATE;
c8fef167 MS	237	# endif /* __APPLE__ */
c8fef167 MS	238
e3586875 MS	239	extern char *_cupsBufferGet(size_t size) _CUPS_PRIVATE;
	240	extern void _cupsBufferRelease(char *b) _CUPS_PRIVATE;
	241
fb863569	242	extern http_t *_cupsConnect(void) _CUPS_PRIVATE;
e3586875 MS	243	extern char _cupsCreateDest(const char name, const char info, const char device_id, const char device_uri, char uri, size_t urisize) _CUPS_PRIVATE;
	244	extern ipp_attribute_t _cupsEncodeOption(ipp_t ipp, ipp_tag_t group_tag, _ipp_option_t map, const char name, const char *value) _CUPS_PRIVATE;
	245	extern int _cupsGet1284Values(const char device_id, cups_option_t *values) _CUPS_PRIVATE;
	246	extern const char _cupsGetDestResource(cups_dest_t dest, unsigned flags, char *resource, size_t resourcesize) _CUPS_PRIVATE;
	247	extern int _cupsGetDests(http_t http, ipp_op_t op, const char name, cups_dest_t **dests, cups_ptype_t type, cups_ptype_t mask) _CUPS_PRIVATE;
	248	extern const char _cupsGetPassword(const char prompt) _CUPS_PRIVATE;
	249	extern void _cupsGlobalLock(void) _CUPS_PRIVATE;
	250	extern _cups_globals_t *_cupsGlobals(void) _CUPS_PRIVATE;
	251	extern void _cupsGlobalUnlock(void) _CUPS_PRIVATE;
eac3a0a0	252	# ifdef HAVE_GSSAPI
e3586875	253	extern const char *_cupsGSSServiceName(void) _CUPS_PRIVATE;
eac3a0a0	254	# endif /* HAVE_GSSAPI */
e3586875	255	extern int _cupsNextDelay(int current, int *previous) _CUPS_PRIVATE;
11ea1663	256	extern void _cupsSetDefaults(void) _CUPS_INTERNAL;
e3586875	257	extern void _cupsSetError(ipp_status_t status, const char *message, int localize) _CUPS_PRIVATE;
11ea1663	258	extern void _cupsSetHTTPError(http_status_t status) _CUPS_INTERNAL;
f14324a7	259	# ifdef HAVE_GSSAPI
e3586875	260	extern int _cupsSetNegotiateAuthString(http_t http, const char method, const char *resource) _CUPS_PRIVATE;
f14324a7	261	# endif /* HAVE_GSSAPI */
11ea1663	262	extern char _cupsUserDefault(char name, size_t namesize) _CUPS_INTERNAL;
ef416fc2	263
	264
	265	/*
	266	* C++ magic...
	267	*/
	268
	269	# ifdef __cplusplus
	270	}
	271	# endif /* __cplusplus */
71e16022	272	#endif /* !_CUPS_CUPS_PRIVATE_H_ */