2 * Printer definitions for the CUPS scheduler.
4 * Copyright 2007-2017 by Apple Inc.
5 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
7 * Licensed under Apache License v2.0. See the file "LICENSE" for more information.
12 #elif defined(HAVE_AVAHI)
13 # include <avahi-client/client.h>
14 # include <avahi-client/publish.h>
15 # include <avahi-common/error.h>
16 # include <avahi-common/thread-watch.h>
17 #endif /* HAVE_DNSSD */
18 #include <cups/pwg-private.h>
27 char username
[33]; /* User data */
28 time_t next_update
; /* Next update time */
29 int page_count
, /* Count of pages */
30 k_count
; /* Count of kilobytes */
35 * DNS-SD types to make the code cleaner/clearer...
39 typedef DNSServiceRef cupsd_srv_t
; /* Service reference */
40 typedef TXTRecordRef cupsd_txt_t
; /* TXT record */
42 #elif defined(HAVE_AVAHI)
43 typedef AvahiEntryGroup
*cupsd_srv_t
; /* Service reference */
44 typedef AvahiStringList
*cupsd_txt_t
; /* TXT record */
45 #endif /* HAVE_DNSSD */
49 * Printer/class information structure...
52 typedef struct cupsd_job_s cupsd_job_t
;
54 struct cupsd_printer_s
56 _cups_rwlock_t lock
; /* Concurrency lock for background updates */
57 int printer_id
; /* Printer ID */
58 char *uri
, /* Printer URI */
59 *uuid
, /* Printer UUID */
60 *hostname
, /* Host printer resides on */
61 *name
, /* Printer name */
62 *location
, /* Location string */
63 *geo_location
, /* Geographic location URI */
64 *make_model
, /* Make and model */
65 *info
, /* Description */
66 *organization
, /* Organization name */
67 *organizational_unit
, /* Organizational unit (department, etc.) */
68 *strings
, /* Strings file, if any */
69 *op_policy
, /* Operation policy name */
70 *error_policy
; /* Error policy */
71 cupsd_policy_t
*op_policy_ptr
; /* Pointer to operation policy */
72 int shared
; /* Shared? */
73 int temporary
; /* Temporary queue? */
74 int accepting
; /* Accepting jobs? */
75 int holding_new_jobs
; /* Holding new jobs for printing? */
76 int in_implicit_class
; /* In an implicit class? */
77 ipp_pstate_t state
; /* Printer state */
78 char state_message
[1024]; /* Printer state message */
79 int num_reasons
; /* Number of printer-state-reasons */
80 char *reasons
[64]; /* printer-state-reasons strings */
81 time_t config_time
, /* Time at this configuration */
82 state_time
; /* Time at this state */
83 char *job_sheets
[2]; /* Banners/job sheets */
84 cups_ptype_t type
; /* Printer type (color, small, etc.) */
85 char *device_uri
; /* Device URI */
86 char *sanitized_device_uri
; /* Sanitized device URI */
87 char *port_monitor
; /* Port monitor */
88 int raw
; /* Raw queue? */
89 int remote
; /* Remote queue? */
90 mime_type_t
*filetype
, /* Pseudo-filetype for printer */
91 *prefiltertype
; /* Pseudo-filetype for pre-filters */
92 cups_array_t
*filetypes
, /* Supported file types */
93 *dest_types
; /* Destination types for queue */
94 cupsd_job_t
*job
; /* Current job in queue */
95 ipp_t
*attrs
, /* Attributes supported by this printer */
96 *ppd_attrs
; /* Attributes based on the PPD */
97 int num_printers
, /* Number of printers in class */
98 last_printer
; /* Last printer job was sent to */
99 struct cupsd_printer_s
**printers
; /* Printers in class */
100 int quota_period
, /* Period for quotas */
101 page_limit
, /* Maximum number of pages */
102 k_limit
; /* Maximum number of kilobytes */
103 cups_array_t
*quotas
; /* Quota records */
104 int deny_users
; /* 1 = deny, 0 = allow */
105 cups_array_t
*users
; /* Allowed/denied users */
106 int sequence_number
; /* Increasing sequence number */
107 int num_options
; /* Number of default options */
108 cups_option_t
*options
; /* Default options */
109 int num_auth_info_required
; /* Number of required auth fields */
110 const char *auth_info_required
[4]; /* Required authentication fields */
111 char *alert
, /* PSX printer-alert value */
112 *alert_description
; /* PSX printer-alert-description value */
113 time_t marker_time
; /* Last time marker attributes were updated */
114 _ppd_cache_t
*pc
; /* PPD cache and mapping data */
116 #if defined(HAVE_DNSSD) || defined(HAVE_AVAHI)
117 char *reg_name
, /* Name used for service registration */
118 *pdl
; /* pdl value for TXT record */
119 cupsd_srv_t ipp_srv
; /* IPP service(s) */
122 cupsd_srv_t ipps_srv
; /* IPPS service(s) */
123 # endif /* HAVE_SSL */
124 cupsd_srv_t printer_srv
; /* LPD service */
125 # endif /* HAVE_DNSSD */
126 #endif /* HAVE_DNSSD || HAVE_AVAHI */
134 VAR ipp_t
*CommonData
VALUE(NULL
);
135 /* Common printer object attrs */
136 VAR cups_array_t
*CommonDefaults
VALUE(NULL
);
137 /* Common -default option names */
138 VAR
int NextPrinterId
VALUE(1);
139 /* Next printer-id value */
140 VAR cups_array_t
*Printers
VALUE(NULL
);
142 VAR cupsd_printer_t
*DefaultPrinter
VALUE(NULL
);
143 /* Default printer */
144 VAR
char *DefaultPolicy
VALUE(NULL
);
145 /* Default policy name */
146 VAR cupsd_policy_t
*DefaultPolicyPtr
148 /* Pointer to default policy */
155 extern cupsd_printer_t
*cupsdAddPrinter(const char *name
);
156 extern void cupsdCreateCommonData(void);
157 extern void cupsdDeleteAllPrinters(void);
158 extern int cupsdDeletePrinter(cupsd_printer_t
*p
, int update
);
159 extern void cupsdDeleteTemporaryPrinters(int force
);
160 extern cupsd_printer_t
*cupsdFindDest(const char *name
);
161 extern cupsd_printer_t
*cupsdFindPrinter(const char *name
);
162 extern cupsd_quota_t
*cupsdFindQuota(cupsd_printer_t
*p
,
163 const char *username
);
164 extern void cupsdFreeQuotas(cupsd_printer_t
*p
);
165 extern void cupsdLoadAllPrinters(void);
166 extern void cupsdRenamePrinter(cupsd_printer_t
*p
,
168 extern void cupsdSaveAllPrinters(void);
169 extern int cupsdSetAuthInfoRequired(cupsd_printer_t
*p
,
171 ipp_attribute_t
*attr
);
172 extern void cupsdSetDeviceURI(cupsd_printer_t
*p
, const char *uri
);
173 extern void cupsdSetPrinterAttr(cupsd_printer_t
*p
,
176 extern void cupsdSetPrinterAttrs(cupsd_printer_t
*p
);
177 extern int cupsdSetPrinterReasons(cupsd_printer_t
*p
,
179 extern void cupsdSetPrinterState(cupsd_printer_t
*p
, ipp_pstate_t s
,
181 #define cupsdStartPrinter(p,u) cupsdSetPrinterState((p), \
182 IPP_PRINTER_IDLE, (u))
183 extern void cupsdStopPrinter(cupsd_printer_t
*p
, int update
);
184 extern int cupsdUpdatePrinterPPD(cupsd_printer_t
*p
,
186 cups_option_t
*keywords
);
187 extern void cupsdUpdatePrinters(void);
188 extern cupsd_quota_t
*cupsdUpdateQuota(cupsd_printer_t
*p
,
189 const char *username
, int pages
,
191 extern const char *cupsdValidateDest(const char *uri
,
193 cupsd_printer_t
**printer
);
194 extern void cupsdWritePrintcap(void);