[thirdparty/cups.git] / scheduler / cupsd.h

/*
 * "$Id: cupsd.h 5046 2006-02-01 22:11:58Z mike $"
 *
 *   Main header file for the Common UNIX Printing System (CUPS) scheduler.
 *
 *   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" 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
 */


/*
 * Include necessary headers.
 */

#include <cups/http-private.h>
#include <cups/string.h>
#include <stdlib.h>
#include <limits.h>
#include <errno.h>
#include <time.h>
#include <signal.h>
#include <fcntl.h>
#include <math.h>
#include <sys/types.h>
#include <sys/time.h>
#include <sys/stat.h>
#include <sys/wait.h>

#ifdef WIN32
#  include <direct.h>
#else
#  include <unistd.h>
#endif /* WIN32 */

#include <cups/array.h>
#include <cups/cups.h>
#include "mime.h"
#include <cups/http.h>
#include <cups/ipp.h>
#include <cups/i18n.h>
#include <cups/debug.h>

#if defined(HAVE_CDSASSL)
#  include <CoreFoundation/CoreFoundation.h>
#endif /* HAVE_CDSASSL */


/*
 * Some OS's don't have hstrerror(), most notably Solaris...
 */

#ifndef HAVE_HSTRERROR
#  define hstrerror cups_hstrerror

extern const char *cups_hstrerror(int);
#endif /* !HAVE_HSTRERROR */


/*
 * Common constants.
 */

#ifndef FALSE
#  define FALSE		0
#  define TRUE		(!FALSE)
#endif /* !FALSE */


/*
 * Implementation limits...
 */

#define MAX_ENV			100	/* Maximum number of environment strings */
#define MAX_USERPASS		33	/* Maximum size of username/password */
#define MAX_FILTERS		20	/* Maximum number of filters */
#define MAX_SYSTEM_GROUPS	32	/* Maximum number of system groups */


/*
 * Defaults...
 */

#define DEFAULT_HISTORY		1	/* Preserve job history? */
#define DEFAULT_FILES		0	/* Preserve job files? */
#define DEFAULT_TIMEOUT		300	/* Timeout during requests/updates */
#define DEFAULT_KEEPALIVE	60	/* Timeout between requests */
#define DEFAULT_INTERVAL	30	/* Interval between browse updates */
#define DEFAULT_CHARSET		"utf-8"	/* Default charset */


/*
 * Global variable macros...
 */

#ifdef _MAIN_C_
#  define VAR
#  define VALUE(x) =x
#  define VALUE2(x,y) ={x,y}
#else
#  define VAR      extern
#  define VALUE(x)
#  define VALUE2(x,y)
#endif /* _MAIN_C */


/*
 * Other stuff for the scheduler...
 */

#include "sysman.h"
#include "statbuf.h"
#include "cert.h"
#include "auth.h"
#include "client.h"
#include "policy.h"
#include "printers.h"
#include "classes.h"
#include "job.h"
#include "conf.h"
#include "banners.h"
#include "dirsvc.h"
#include "network.h"
#include "subscriptions.h"


/*
 * Reload types...
 */

#define RELOAD_NONE	0		/* No reload needed */
#define RELOAD_ALL	1		/* Reload everything */
#define RELOAD_CUPSD	2		/* Reload only cupsd.conf */


/*
 * Globals...
 */

VAR int			MaxFDs,		/* Maximum number of files */
			SetSize;	/* The size of the input/output sets */
VAR fd_set		*InputSet,	/* Input files for select() */
			*OutputSet;	/* Output files for select() */

VAR time_t		ReloadTime	VALUE(0);
					/* Time of reload request... */
VAR int			NeedReload	VALUE(RELOAD_ALL);
					/* Need to load configuration? */


/*
 * Prototypes...
 */

extern void	cupsdCatchChildSignals(void);
extern void	cupsdClearString(char **s);
extern void	cupsdHoldSignals(void);
extern void	cupsdIgnoreChildSignals(void);
extern void	cupsdReleaseSignals(void);
extern void	cupsdSetString(char **s, const char *v);
extern void	cupsdSetStringf(char **s, const char *f, ...)
#ifdef __GNUC__
__attribute__ ((__format__ (__printf__, 2, 3)))
#endif /* __GNUC__ */
;
extern void	cupsdStartServer(void);
extern void	cupsdStopServer(void);
extern void	cupsdClosePipe(int *fds);
extern int	cupsdOpenPipe(int *fds);

extern void	cupsdClearEnv(void);
extern void	cupsdInitEnv(void);
extern int	cupsdLoadEnv(char *envp[], int envmax);
extern void	cupsdSetEnv(const char *name, const char *value);
extern void	cupsdSetEnvf(const char *name, const char *value, ...)
#ifdef __GNUC__
__attribute__ ((__format__ (__printf__, 2, 3)))
#endif /* __GNUC__ */
;

extern int	cupsdEndProcess(int pid, int force);
extern const char *cupsdFinishProcess(int pid, char *name, int namelen);
extern int	cupsdStartProcess(const char *command, char *argv[],
				  char *envp[], int infd, int outfd,
				  int errfd, int backfd, int root, int *pid);


/*
 * End of "$Id: cupsd.h 5046 2006-02-01 22:11:58Z mike $".
 */
Commit	Line	Data
ef416fc2	1	/*
e00b005a	2	* "$Id: cupsd.h 5046 2006-02-01 22:11:58Z mike $"
ef416fc2	3	*
	4	* Main header file for the Common UNIX Printing System (CUPS) scheduler.
	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" 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
	25
	26	/*
	27	* Include necessary headers.
	28	*/
	29
	30	#include <cups/http-private.h>
	31	#include <cups/string.h>
	32	#include <stdlib.h>
	33	#include <limits.h>
	34	#include <errno.h>
	35	#include <time.h>
	36	#include <signal.h>
	37	#include <fcntl.h>
	38	#include <math.h>
	39	#include <sys/types.h>
	40	#include <sys/time.h>
	41	#include <sys/stat.h>
	42	#include <sys/wait.h>
	43
	44	#ifdef WIN32
	45	# include <direct.h>
	46	#else
	47	# include <unistd.h>
	48	#endif /* WIN32 */
	49
	50	#include <cups/array.h>
	51	#include <cups/cups.h>
	52	#include "mime.h"
	53	#include <cups/http.h>
	54	#include <cups/ipp.h>
	55	#include <cups/i18n.h>
	56	#include <cups/debug.h>
	57
	58	#if defined(HAVE_CDSASSL)
	59	# include <CoreFoundation/CoreFoundation.h>
	60	#endif /* HAVE_CDSASSL */
	61
	62
	63	/*
	64	* Some OS's don't have hstrerror(), most notably Solaris...
	65	*/
	66
67	#ifndef HAVE_HSTRERROR
68	# define hstrerror cups_hstrerror
69
70	extern const char *cups_hstrerror(int);
71	#endif /* !HAVE_HSTRERROR */
72
73
74	/*
75	* Common constants.
76	*/
77
78	#ifndef FALSE
79	# define FALSE 0
80	# define TRUE (!FALSE)
81	#endif /* !FALSE */
82
83
84	/*
85	* Implementation limits...
86	*/
87
e00b005a	88	#define MAX_ENV 100 /* Maximum number of environment strings */
ef416fc2	89	#define MAX_USERPASS 33 /* Maximum size of username/password */
	90	#define MAX_FILTERS 20 /* Maximum number of filters */
	91	#define MAX_SYSTEM_GROUPS 32 /* Maximum number of system groups */
	92
	93
	94	/*
	95	* Defaults...
	96	*/
	97
	98	#define DEFAULT_HISTORY 1 /* Preserve job history? */
	99	#define DEFAULT_FILES 0 /* Preserve job files? */
	100	#define DEFAULT_TIMEOUT 300 /* Timeout during requests/updates */
	101	#define DEFAULT_KEEPALIVE 60 /* Timeout between requests */
	102	#define DEFAULT_INTERVAL 30 /* Interval between browse updates */
	103	#define DEFAULT_CHARSET "utf-8" /* Default charset */
	104
	105
	106	/*
	107	* Global variable macros...
	108	*/
	109
	110	#ifdef _MAIN_C_
	111	# define VAR
	112	# define VALUE(x) =x
	113	# define VALUE2(x,y) ={x,y}
	114	#else
	115	# define VAR extern
	116	# define VALUE(x)
	117	# define VALUE2(x,y)
	118	#endif /* _MAIN_C */
	119
	120
	121	/*
	122	* Other stuff for the scheduler...
	123	*/
	124
09ec0018	125	#include "sysman.h"
ef416fc2	126	#include "statbuf.h"
	127	#include "cert.h"
	128	#include "auth.h"
	129	#include "client.h"
	130	#include "policy.h"
	131	#include "printers.h"
	132	#include "classes.h"
	133	#include "job.h"
	134	#include "conf.h"
	135	#include "banners.h"
	136	#include "dirsvc.h"
	137	#include "network.h"
	138	#include "subscriptions.h"
	139
	140
	141	/*
	142	* Reload types...
	143	*/
	144
	145	#define RELOAD_NONE 0 /* No reload needed */
	146	#define RELOAD_ALL 1 /* Reload everything */
	147	#define RELOAD_CUPSD 2 /* Reload only cupsd.conf */
	148
	149
	150	/*
	151	* Globals...
	152	*/
	153
	154	VAR int MaxFDs, /* Maximum number of files */
	155	SetSize; /* The size of the input/output sets */
	156	VAR fd_set InputSet, / Input files for select() */
	157	OutputSet; / Output files for select() */
	158
	159	VAR time_t ReloadTime VALUE(0);
	160	/* Time of reload request... */
	161	VAR int NeedReload VALUE(RELOAD_ALL);
	162	/* Need to load configuration? */
	163
	164
	165	/*
	166	* Prototypes...
	167	*/
	168
	169	extern void cupsdCatchChildSignals(void);
	170	extern void cupsdClearString(char **s);
	171	extern void cupsdHoldSignals(void);
	172	extern void cupsdIgnoreChildSignals(void);
	173	extern void cupsdReleaseSignals(void);
	174	extern void cupsdSetString(char *s, const char v);
	175	extern void cupsdSetStringf(char *s, const char f, ...)
	176	#ifdef __GNUC__
	177	__attribute__ ((__format__ (__printf__, 2, 3)))
	178	#endif /* __GNUC__ */
	179	;
	180	extern void cupsdStartServer(void);
	181	extern void cupsdStopServer(void);
	182	extern void cupsdClosePipe(int *fds);
	183	extern int cupsdOpenPipe(int *fds);
	184
	185	extern void cupsdClearEnv(void);
	186	extern void cupsdInitEnv(void);
	187	extern int cupsdLoadEnv(char *envp[], int envmax);
	188	extern void cupsdSetEnv(const char name, const char value);
	189	extern void cupsdSetEnvf(const char name, const char value, ...)
190	#ifdef __GNUC__
191	__attribute__ ((__format__ (__printf__, 2, 3)))
192	#endif /* __GNUC__ */
193	;
194
195	extern int cupsdEndProcess(int pid, int force);
e00b005a	196	extern const char cupsdFinishProcess(int pid, char name, int namelen);
ef416fc2	197	extern int cupsdStartProcess(const char command, char argv[],
	198	char *envp[], int infd, int outfd,
	199	int errfd, int backfd, int root, int *pid);
	200
	201
	202	/*
e00b005a	203	* End of "$Id: cupsd.h 5046 2006-02-01 22:11:58Z mike $".
ef416fc2	204	*/