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

/*
 * "$Id: printers.h 7564 2008-05-15 00:57:43Z mike $"
 *
 *   Printer definitions for the Common UNIX Printing System (CUPS) scheduler.
 *
 *   Copyright 2007-2008 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/".
 */

#ifdef HAVE_DNSSD
#  include <dns_sd.h>
#endif /* HAVE_DNSSD */
#include <cups/pwg-private.h>


/*
 * Quota data...
 */

typedef struct
{
  char		username[33];		/* User data */
  time_t	next_update;		/* Next update time */
  int		page_count,		/* Count of pages */
		k_count;		/* Count of kilobytes */
} cupsd_quota_t;


/*
 * Printer/class information structure...
 */

typedef struct cupsd_job_s cupsd_job_t;

typedef struct cupsd_printer_s
{
  char		*uri,			/* Printer URI */
		*hostname,		/* Host printer resides on */
		*name,			/* Printer name */
		*location,		/* Location code */
		*make_model,		/* Make and model */
		*info,			/* Description */
		*op_policy,		/* Operation policy name */
		*error_policy;		/* Error policy */
  cupsd_policy_t *op_policy_ptr;	/* Pointer to operation policy */
  int		shared;			/* Shared? */
  int		accepting;		/* Accepting jobs? */
  int		holding_new_jobs;	/* Holding new jobs for printing? */
  int		in_implicit_class;	/* In an implicit class? */
  ipp_pstate_t	state;			/* Printer state */
  char		state_message[1024];	/* Printer state message */
  int		num_reasons;		/* Number of printer-state-reasons */
  char		*reasons[64];		/* printer-state-reasons strings */
  time_t	state_time;		/* Time at this state */
  char		*job_sheets[2];		/* Banners/job sheets */
  cups_ptype_t	type;			/* Printer type (color, small, etc.) */
  char		*browse_attrs;		/* Attributes sent with browse data */
  time_t	browse_expire;		/* Expiration time for printer */
  time_t	browse_time;		/* Last time update was sent/received */
  char		*device_uri;		/* Device URI */
  char		*sanitized_device_uri;	/* Sanitized device URI */
  char		*port_monitor;		/* Port monitor */
  int		raw;			/* Raw queue? */
  int		remote;			/* Remote queue? */
  mime_type_t	*filetype,		/* Pseudo-filetype for printer */
		*prefiltertype;		/* Pseudo-filetype for pre-filters */
  cups_array_t	*filetypes;		/* Supported file types */
  cupsd_job_t	*job;			/* Current job in queue */
  ipp_t		*attrs,			/* Attributes supported by this printer */
		*ppd_attrs;		/* Attributes based on the PPD */
  int		num_printers,		/* Number of printers in class */
		last_printer;		/* Last printer job was sent to */
  struct cupsd_printer_s **printers;	/* Printers in class */
  int		quota_period,		/* Period for quotas */
		page_limit,		/* Maximum number of pages */
		k_limit;		/* Maximum number of kilobytes */
  cups_array_t	*quotas;		/* Quota records */
  int		deny_users,		/* 1 = deny, 0 = allow */
		num_users;		/* Number of allowed/denied users */
  const char	**users;		/* Allowed/denied users */
  int		num_history;		/* Number of history collections */
  ipp_t		**history;		/* History data */
  int		sequence_number;	/* Increasing sequence number */
  int		num_options;		/* Number of default options */
  cups_option_t	*options;		/* Default options */
  int		num_auth_info_required;	/* Number of required auth fields */
  const char	*auth_info_required[4];	/* Required authentication fields */
  char		*alert,			/* PSX printer-alert value */
		*alert_description;	/* PSX printer-alert-description value */
  time_t	marker_time;		/* Last time marker attributes were updated */
  cups_array_t	*filters,		/* Filters for queue */
		*pre_filters;		/* Pre-filters for queue */
  _pwg_t	*pwg;			/* PWG<->PPD mapping data */

#ifdef HAVE_DNSSD
  char		*reg_name,		/* Name used for service registration */
		*product,		/* PPD Product string */
		*pdl,			/* pdl value for TXT record */
		*ipp_txt,		/* IPP TXT record contents */
		*printer_txt;		/* LPD TXT record contents */
  int		ipp_len,		/* IPP TXT record length */
		printer_len;		/* LPD TXT record length */
  DNSServiceRef	ipp_ref,		/* Reference for _ipp._tcp,_cups */
		printer_ref;		/* Reference for _printer._tcp */
#endif /* HAVE_DNSSD */
} cupsd_printer_t;


/*
 * Globals...
 */

VAR ipp_t		*CommonData	VALUE(NULL);
					/* Common printer object attrs */
VAR cups_array_t	*CommonDefaults	VALUE(NULL);
					/* Common -default option names */
VAR cups_array_t	*Printers	VALUE(NULL),
					/* Printer list */
			*ImplicitPrinters VALUE(NULL);
					/* Implicit class printers */
VAR cupsd_printer_t	*DefaultPrinter	VALUE(NULL);
					/* Default printer */
VAR char		*DefaultPolicy	VALUE(NULL);
					/* Default policy name */
VAR cupsd_policy_t	*DefaultPolicyPtr
					VALUE(NULL);
					/* Pointer to default policy */


/*
 * Prototypes...
 */

extern cupsd_printer_t	*cupsdAddPrinter(const char *name);
extern void		cupsdAddPrinterHistory(cupsd_printer_t *p);
extern void		cupsdAddPrinterUser(cupsd_printer_t *p,
			                    const char *username);
extern void		cupsdCreateCommonData(void);
extern void		cupsdDeleteAllPrinters(void);
extern int		cupsdDeletePrinter(cupsd_printer_t *p, int update);
extern cupsd_printer_t	*cupsdFindDest(const char *name);
extern cupsd_printer_t	*cupsdFindPrinter(const char *name);
extern cupsd_quota_t	*cupsdFindQuota(cupsd_printer_t *p,
			                const char *username);
extern void		cupsdFreePrinterUsers(cupsd_printer_t *p);
extern void		cupsdFreeQuotas(cupsd_printer_t *p);
extern void		cupsdLoadAllPrinters(void);
extern void		cupsdRenamePrinter(cupsd_printer_t *p,
			                   const char *name);
extern void		cupsdSaveAllPrinters(void);
extern int		cupsdSetAuthInfoRequired(cupsd_printer_t *p,
			                         const char *values,
						 ipp_attribute_t *attr);
extern void		cupsdSetDeviceURI(cupsd_printer_t *p, const char *uri);
extern void		cupsdSetPrinterAttr(cupsd_printer_t *p,
			                    const char *name, char *value);
extern void		cupsdSetPrinterAttrs(cupsd_printer_t *p);
extern int		cupsdSetPrinterReasons(cupsd_printer_t *p,
			                       const char *s);
extern void		cupsdSetPrinterState(cupsd_printer_t *p, ipp_pstate_t s,
			                     int update);
#define			cupsdStartPrinter(p,u) cupsdSetPrinterState((p), IPP_PRINTER_IDLE, (u))
extern void		cupsdStopPrinter(cupsd_printer_t *p, int update);
extern int		cupsdUpdatePrinterPPD(cupsd_printer_t *p,
			                      int num_keywords,
					      cups_option_t *keywords);
extern void		cupsdUpdatePrinters(void);
extern cupsd_quota_t	*cupsdUpdateQuota(cupsd_printer_t *p,
			                  const char *username, int pages,
					  int k);
extern const char	*cupsdValidateDest(const char *uri,
			        	   cups_ptype_t *dtype,
					   cupsd_printer_t **printer);
extern void		cupsdWritePrintcap(void);


/*
 * End of "$Id: printers.h 7564 2008-05-15 00:57:43Z mike $".
 */
Commit	Line	Data
ef416fc2	1	/*
75bd9771	2	* "$Id: printers.h 7564 2008-05-15 00:57:43Z mike $"
ef416fc2	3	*
	4	* Printer definitions for the Common UNIX Printing System (CUPS) scheduler.
	5	*
61cf44e2	6	* Copyright 2007-2008 by Apple Inc.
f7deaa1a	7	* Copyright 1997-2007 by Easy Software Products, all rights reserved.
ef416fc2	8	*
ef416fc2	9	* These coded instructions, statements, and computer programs are the
bc44d920	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/".
ef416fc2	14	*/
ef416fc2	15
f7deaa1a	16	#ifdef HAVE_DNSSD
	17	# include <dns_sd.h>
	18	#endif /* HAVE_DNSSD */
54afec33 MS	19	#include <cups/pwg-private.h>
54afec33 MS	20
f7deaa1a	21
ef416fc2	22	/*
	23	* Quota data...
	24	*/
	25
	26	typedef struct
	27	{
	28	char username[33]; /* User data */
	29	time_t next_update; /* Next update time */
	30	int page_count, /* Count of pages */
	31	k_count; /* Count of kilobytes */
	32	} cupsd_quota_t;
	33
	34
	35	/*
	36	* Printer/class information structure...
	37	*/
	38
f11a948a MS	39	typedef struct cupsd_job_s cupsd_job_t;
f11a948a MS	40
ef416fc2	41	typedef struct cupsd_printer_s
	42	{
	43	char uri, / Printer URI */
	44	hostname, / Host printer resides on */
	45	name, / Printer name */
	46	location, / Location code */
	47	make_model, / Make and model */
	48	info, / Description */
	49	op_policy, / Operation policy name */
	50	error_policy; / Error policy */
	51	cupsd_policy_t op_policy_ptr; / Pointer to operation policy */
	52	int shared; /* Shared? */
	53	int accepting; /* Accepting jobs? */
61cf44e2	54	int holding_new_jobs; /* Holding new jobs for printing? */
ef416fc2	55	int in_implicit_class; /* In an implicit class? */
	56	ipp_pstate_t state; /* Printer state */
	57	char state_message[1024]; /* Printer state message */
	58	int num_reasons; /* Number of printer-state-reasons */
d1c13e16	59	char reasons[64]; / printer-state-reasons strings */
ef416fc2	60	time_t state_time; /* Time at this state */
ef416fc2	61	char job_sheets[2]; / Banners/job sheets */
09a101d6	62	cups_ptype_t type; /* Printer type (color, small, etc.) */
b423cd4c	63	char browse_attrs; / Attributes sent with browse data */
b423cd4c	64	time_t browse_expire; /* Expiration time for printer */
ef416fc2	65	time_t browse_time; /* Last time update was sent/received */
ef416fc2	66	char device_uri; / Device URI */
0af14961	67	char sanitized_device_uri; / Sanitized device URI */
ef416fc2	68	char port_monitor; / Port monitor */
ef416fc2	69	int raw; /* Raw queue? */
d09495fa	70	int remote; /* Remote queue? */
f7deaa1a	71	mime_type_t filetype, / Pseudo-filetype for printer */
f7deaa1a	72	prefiltertype; / Pseudo-filetype for pre-filters */
80ca4592	73	cups_array_t filetypes; / Supported file types */
f11a948a	74	cupsd_job_t job; / Current job in queue */
61cf44e2 MS	75	ipp_t attrs, / Attributes supported by this printer */
61cf44e2 MS	76	ppd_attrs; / Attributes based on the PPD */
ef416fc2	77	int num_printers, /* Number of printers in class */
	78	last_printer; /* Last printer job was sent to */
	79	struct cupsd_printer_s *printers; / Printers in class */
	80	int quota_period, /* Period for quotas */
	81	page_limit, /* Maximum number of pages */
fa73b229	82	k_limit; /* Maximum number of kilobytes */
fa73b229	83	cups_array_t quotas; / Quota records */
ef416fc2	84	int deny_users, /* 1 = deny, 0 = allow */
	85	num_users; /* Number of allowed/denied users */
	86	const char *users; / Allowed/denied users */
	87	int num_history; /* Number of history collections */
	88	ipp_t *history; / History data */
	89	int sequence_number; /* Increasing sequence number */
b423cd4c	90	int num_options; /* Number of default options */
b423cd4c	91	cups_option_t options; / Default options */
f7deaa1a	92	int num_auth_info_required; /* Number of required auth fields */
f7deaa1a	93	const char auth_info_required[4]; / Required authentication fields */
323c5de1	94	char alert, / PSX printer-alert value */
323c5de1	95	alert_description; / PSX printer-alert-description value */
5a738aea	96	time_t marker_time; /* Last time marker attributes were updated */
58dc1933 MS	97	cups_array_t filters, / Filters for queue */
58dc1933 MS	98	pre_filters; / Pre-filters for queue */
54afec33	99	_pwg_t pwg; / PWG<->PPD mapping data */
f7deaa1a	100
	101	#ifdef HAVE_DNSSD
	102	char reg_name, / Name used for service registration */
	103	product, / PPD Product string */
	104	pdl, / pdl value for TXT record */
7a14d768 MS	105	ipp_txt, / IPP TXT record contents */
	106	printer_txt; / LPD TXT record contents */
	107	int ipp_len, /* IPP TXT record length */
	108	printer_len; /* LPD TXT record length */
	109	DNSServiceRef ipp_ref, /* Reference for _ipp._tcp,_cups */
	110	printer_ref; /* Reference for _printer._tcp */
f7deaa1a	111	#endif /* HAVE_DNSSD */
ef416fc2	112	} cupsd_printer_t;
	113
	114
	115	/*
	116	* Globals...
	117	*/
	118
	119	VAR ipp_t *CommonData VALUE(NULL);
	120	/* Common printer object attrs */
f7deaa1a	121	VAR cups_array_t *CommonDefaults VALUE(NULL);
f7deaa1a	122	/* Common -default option names */
ef416fc2	123	VAR cups_array_t *Printers VALUE(NULL),
	124	/* Printer list */
	125	*ImplicitPrinters VALUE(NULL);
	126	/* Implicit class printers */
	127	VAR cupsd_printer_t *DefaultPrinter VALUE(NULL);
	128	/* Default printer */
	129	VAR char *DefaultPolicy VALUE(NULL);
	130	/* Default policy name */
	131	VAR cupsd_policy_t *DefaultPolicyPtr
	132	VALUE(NULL);
	133	/* Pointer to default policy */
	134
	135
	136	/*
	137	* Prototypes...
	138	*/
	139
	140	extern cupsd_printer_t cupsdAddPrinter(const char name);
ef416fc2	141	extern void cupsdAddPrinterHistory(cupsd_printer_t *p);
f7deaa1a	142	extern void cupsdAddPrinterUser(cupsd_printer_t *p,
f7deaa1a	143	const char *username);
ef416fc2	144	extern void cupsdCreateCommonData(void);
ef416fc2	145	extern void cupsdDeleteAllPrinters(void);
f8b3a85b	146	extern int cupsdDeletePrinter(cupsd_printer_t *p, int update);
ef416fc2	147	extern cupsd_printer_t cupsdFindDest(const char name);
ef416fc2	148	extern cupsd_printer_t cupsdFindPrinter(const char name);
3d8365b8	149	extern cupsd_quota_t cupsdFindQuota(cupsd_printer_t p,
3d8365b8	150	const char *username);
ef416fc2	151	extern void cupsdFreePrinterUsers(cupsd_printer_t *p);
	152	extern void cupsdFreeQuotas(cupsd_printer_t *p);
	153	extern void cupsdLoadAllPrinters(void);
f7deaa1a	154	extern void cupsdRenamePrinter(cupsd_printer_t *p,
f7deaa1a	155	const char *name);
ef416fc2	156	extern void cupsdSaveAllPrinters(void);
f7deaa1a	157	extern int cupsdSetAuthInfoRequired(cupsd_printer_t *p,
	158	const char *values,
	159	ipp_attribute_t *attr);
0af14961	160	extern void cupsdSetDeviceURI(cupsd_printer_t p, const char uri);
5a738aea MS	161	extern void cupsdSetPrinterAttr(cupsd_printer_t *p,
5a738aea MS	162	const char name, char value);
ef416fc2	163	extern void cupsdSetPrinterAttrs(cupsd_printer_t *p);
e07d4801	164	extern int cupsdSetPrinterReasons(cupsd_printer_t *p,
f7deaa1a	165	const char *s);
	166	extern void cupsdSetPrinterState(cupsd_printer_t *p, ipp_pstate_t s,
	167	int update);
ef416fc2	168	#define cupsdStartPrinter(p,u) cupsdSetPrinterState((p), IPP_PRINTER_IDLE, (u))
ef416fc2	169	extern void cupsdStopPrinter(cupsd_printer_t *p, int update);
c9fc04c6 MS	170	extern int cupsdUpdatePrinterPPD(cupsd_printer_t *p,
	171	int num_keywords,
	172	cups_option_t *keywords);
ef416fc2	173	extern void cupsdUpdatePrinters(void);
f7deaa1a	174	extern cupsd_quota_t cupsdUpdateQuota(cupsd_printer_t p,
	175	const char *username, int pages,
	176	int k);
	177	extern const char cupsdValidateDest(const char uri,
ef416fc2	178	cups_ptype_t *dtype,
	179	cupsd_printer_t **printer);
	180	extern void cupsdWritePrintcap(void);
	181
ef416fc2	182
ef416fc2	183	/*
75bd9771	184	* End of "$Id: printers.h 7564 2008-05-15 00:57:43Z mike $".
ef416fc2	185	*/