[thirdparty/cups.git] / cups / globals.h

/*
 * "$Id: globals.h 5047 2006-02-02 05:14:15Z mike $"
 *
 *   Global variable definitions for the Common UNIX Printing System (CUPS).
 *
 *   Copyright 1997-2006 by Easy Software Products, all rights reserved.
 *
 *   These coded instructions, statements, and computer programs are the
 *   property of Easy Software Products 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 missing or damaged please contact Easy Software Products
 *   at:
 *
 *       Attn: CUPS Licensing Information
 *       Easy Software Products
 *       44141 Airport View Drive, Suite 204
 *       Hollywood, Maryland 20636 USA
 *
 *       Voice: (301) 373-9600
 *       EMail: cups-info@cups.org
 *         WWW: http://www.cups.org
 *
 *   This file is subject to the Apple OS-Developed Software exception.
 */

#ifndef _CUPS_GLOBALS_H_
#  define _CUPS_GLOBALS_H_

/*
 * Include necessary headers...
 */

#  include "string.h"
#  include "cups.h"
#  include "i18n.h"
#  include "normalize.h"
#  include "transcode.h"

#  ifdef HAVE_PTHREAD_H
#    include <pthread.h>
#  endif /* HAVE_PTHREAD_H */


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

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


/*
 * To make libcups thread safe, define thread safe globals (aka thread-
 * specific data) for the static variables used in the library.
 */

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

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

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

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

  /* normalize.c */
  _cups_norm_map_t	*normmap_cache;	/* Normalize Map cache */
  _cups_fold_map_t	*foldmap_cache;	/* Case Fold cache */
  _cups_prop_map_t	*propmap_cache;	/* Char Prop Map Cache */
  _cups_comb_map_t	*combmap_cache;	/* Comb Class Map Cache */
  _cups_break_map_t	*breakmap_cache;/* Line Break Map Cache */

  /* language.c */
  cups_lang_t		*lang_cache;	/* Language string cache */
  cups_lang_t		*lang_default;	/* Default language */
#  ifdef __APPLE__
#    ifdef HAVE_CF_LOCALE_ID
  char			language[32];	/* Cached language */
#    else
  const char		*language;	/* Cached language */
#    endif /* HAVE_CF_LOCALE_ID */
#  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 */

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

  /* transcode.c */
  _cups_cmap_t		*cmap_cache;	/* SBCS Charmap Cache */
  _cups_vmap_t		*vmap_cache;	/* VBCS Charmap Cache */

  /* usersys.c */
  http_encryption_t	encryption;	/* Encryption setting */
  char			user[65],	/* User name */
			server[256],	/* Server address */
			servername[256];/* Server hostname */
  cups_password_cb_t	password_cb;	/* Password callback */

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

  char			def_printer[256];
					/* Default printer */
  char			ppd_filename[HTTP_MAX_URI];
					/* PPD filename */

  /* string.c */
  cups_array_t		*stringpool;	/* String pool */
} _cups_globals_t;


/*
 * Prototypes...
 */

extern const char	*_cupsGetPassword(const char *prompt);
extern _cups_globals_t	*_cupsGlobals(void);
extern void		_cupsLangFlush(_cups_globals_t *cg);
extern void		_cupsCharmapFlush(_cups_globals_t *cg);
extern void		_cupsNormalizeMapsFlush(_cups_globals_t *cg);
extern void		_cups_sp_flush(_cups_globals_t *cg);


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

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

/*
 * End of "$Id: globals.h 5047 2006-02-02 05:14:15Z mike $".
 */
Commit	Line	Data
ef416fc2	1	/*
4400e98d	2	* "$Id: globals.h 5047 2006-02-02 05:14:15Z mike $"
ef416fc2	3	*
	4	* Global variable definitions for the Common UNIX Printing System (CUPS).
	5	*
	6	* Copyright 1997-2006 by Easy Software Products, all rights reserved.
	7	*
	8	* These coded instructions, statements, and computer programs are the
	9	* property of Easy Software Products and are protected by Federal
	10	* copyright law. Distribution and use rights are outlined in the file
	11	* "LICENSE.txt" which should have been included with this file. If this
	12	* file is missing or damaged please contact Easy Software Products
	13	* at:
	14	*
	15	* Attn: CUPS Licensing Information
	16	* Easy Software Products
	17	* 44141 Airport View Drive, Suite 204
	18	* Hollywood, Maryland 20636 USA
	19	*
	20	* Voice: (301) 373-9600
	21	* EMail: cups-info@cups.org
	22	* WWW: http://www.cups.org
	23	*
	24	* This file is subject to the Apple OS-Developed Software exception.
	25	*/
	26
	27	#ifndef _CUPS_GLOBALS_H_
	28	# define _CUPS_GLOBALS_H_
	29
	30	/*
	31	* Include necessary headers...
	32	*/
	33
	34	# include "string.h"
	35	# include "cups.h"
	36	# include "i18n.h"
	37	# include "normalize.h"
	38	# include "transcode.h"
	39
	40	# ifdef HAVE_PTHREAD_H
	41	# include <pthread.h>
	42	# endif /* HAVE_PTHREAD_H */
	43
	44
	45	/*
	46	* C++ magic...
	47	*/
	48
	49	# ifdef __cplusplus
	50	extern "C" {
	51	# endif /* __cplusplus */
	52
	53
	54	/*
	55	* To make libcups thread safe, define thread safe globals (aka thread-
	56	* specific data) for the static variables used in the library.
	57	*/
	58
	59	typedef struct _cups_globals_s /** CUPS global state data **/
	60	{
	61	/* Multiple places... */
	62	const char cups_datadir, / CUPS_DATADIR environment var */
	63	cups_serverbin,/ CUPS_SERVERBIN environment var */
	64	*cups_serverroot,
	65	/* CUPS_SERVERROOT environment var */
	66	cups_statedir, / CUPS_STATEDIR environment var */
67	localedir; / LOCALDIR environment var */
68
69	/* http.c */
70	char http_date[256]; /* Date+time buffer */
71
72	/* http-addr.c */
73	unsigned ip_addr; /* Packed IPv4 address */
74	char ip_ptrs[2]; / Pointer to packed address */
75	struct hostent hostent; /* Host entry for IP address */
76	# ifdef HAVE_GETADDRINFO
77	char hostname[1024]; /* Hostname */
78	# endif /* HAVE_GETADDRINFO */
79
80	/* ipp.c */
81	ipp_uchar_t ipp_date[11]; /* RFC-1903 date/time data */
82
83	/* ipp-support.c */
84	int ipp_port; /* IPP port number */
85	char ipp_unknown[255];
86	/* Unknown error statuses */
87
88	/* normalize.c */
89	_cups_norm_map_t normmap_cache; / Normalize Map cache */
90	_cups_fold_map_t foldmap_cache; / Case Fold cache */
91	_cups_prop_map_t propmap_cache; / Char Prop Map Cache */
92	_cups_comb_map_t combmap_cache; / Comb Class Map Cache */
93	_cups_break_map_t breakmap_cache;/ Line Break Map Cache */
94
95	/* language.c */
96	cups_lang_t lang_cache; / Language string cache */
fa73b229	97	cups_lang_t lang_default; / Default language */
ef416fc2	98	# ifdef __APPLE__
	99	# ifdef HAVE_CF_LOCALE_ID
	100	char language[32]; /* Cached language */
	101	# else
	102	const char language; / Cached language */
	103	# endif /* HAVE_CF_LOCALE_ID */
	104	# endif /* __APPLE__ */
	105
	106	/* ppd.c */
	107	ppd_status_t ppd_status; /* Status of last ppdOpen() /
	108	int ppd_line; /* Current line number */
	109	ppd_conform_t ppd_conform; /* Level of conformance required */
	110
	111	/* tempfile.c */
	112	char tempfile[1024]; /* cupsTempFd/File buffer */
	113
	114	/* transcode.c */
	115	_cups_cmap_t cmap_cache; / SBCS Charmap Cache */
	116	_cups_vmap_t vmap_cache; / VBCS Charmap Cache */
	117
	118	/* usersys.c */
	119	http_encryption_t encryption; /* Encryption setting */
	120	char user[65], /* User name */
	121	server[256], /* Server address */
	122	servername[256];/* Server hostname */
	123	cups_password_cb_t password_cb; /* Password callback */
	124
	125	/* util.c */
	126	http_t http; / Current server connection */
	127	ipp_status_t last_error; /* Last IPP error */
	128	char *last_status_message;
	129	/* Last IPP status-message */
	130
	131	char def_printer[256];
	132	/* Default printer */
	133	char ppd_filename[HTTP_MAX_URI];
	134	/* PPD filename */
4400e98d	135
	136	/* string.c */
	137	cups_array_t stringpool; / String pool */
ef416fc2	138	} _cups_globals_t;
	139
	140
	141	/*
	142	* Prototypes...
	143	*/
	144
	145	extern const char _cupsGetPassword(const char prompt);
	146	extern _cups_globals_t *_cupsGlobals(void);
fa73b229	147	extern void _cupsLangFlush(_cups_globals_t *cg);
	148	extern void _cupsCharmapFlush(_cups_globals_t *cg);
	149	extern void _cupsNormalizeMapsFlush(_cups_globals_t *cg);
4400e98d	150	extern void _cups_sp_flush(_cups_globals_t *cg);
ef416fc2	151
	152
	153	/*
	154	* C++ magic...
	155	*/
	156
	157	# ifdef __cplusplus
	158	}
	159	# endif /* __cplusplus */
	160	#endif /* !_CUPS_GLOBALS_H_ */
	161
	162	/*
4400e98d	163	* End of "$Id: globals.h 5047 2006-02-02 05:14:15Z mike $".
ef416fc2	164	*/