]>
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 | * |
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 | */ |
15 | ||
f7deaa1a | 16 | #ifdef HAVE_DNSSD |
17 | # include <dns_sd.h> | |
18 | #endif /* HAVE_DNSSD */ | |
54afec33 MS |
19 | #include <cups/pwg-private.h> |
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; |
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 */ |
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 */ |
64 | time_t browse_expire; /* Expiration time for printer */ | |
ef416fc2 | 65 | time_t browse_time; /* Last time update was sent/received */ |
66 | char *device_uri; /* Device URI */ | |
0af14961 | 67 | char *sanitized_device_uri; /* Sanitized device URI */ |
ef416fc2 | 68 | char *port_monitor; /* Port monitor */ |
69 | int raw; /* Raw queue? */ | |
d09495fa | 70 | int remote; /* Remote queue? */ |
f7deaa1a | 71 | mime_type_t *filetype, /* Pseudo-filetype for printer */ |
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 */ |
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 */ |
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 */ |
91 | cups_option_t *options; /* Default options */ | |
f7deaa1a | 92 | int num_auth_info_required; /* Number of required auth fields */ |
93 | const char *auth_info_required[4]; /* Required authentication fields */ | |
323c5de1 | 94 | char *alert, /* PSX printer-alert value */ |
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 */ |
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); |
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, |
143 | const char *username); | |
ef416fc2 | 144 | extern void cupsdCreateCommonData(void); |
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); |
148 | extern cupsd_printer_t *cupsdFindPrinter(const char *name); | |
3d8365b8 | 149 | extern cupsd_quota_t *cupsdFindQuota(cupsd_printer_t *p, |
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, |
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, |
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)) |
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 | |
183 | /* | |
75bd9771 | 184 | * End of "$Id: printers.h 7564 2008-05-15 00:57:43Z mike $". |
ef416fc2 | 185 | */ |