]> git.ipfire.org Git - thirdparty/cups.git/blame - cups/ipp-support.c
projects / thirdparty / cups.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Fix handling of "EXPECT foo/bar IN-GROUP group".
[thirdparty/cups.git] / cups / ipp-support.c
CommitLineData
ef416fc2 1/*
d21dc0ed 2 * Internet Printing Protocol support functions for CUPS.
ef416fc2 3 *
65bebeac 4 * Copyright 2007-2017 by Apple Inc.
d21dc0ed 5 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
ef416fc2 6 *
e3101897 7 * Licensed under Apache License v2.0. See the file "LICENSE" for more information.
ef416fc2 8 */
9
10/*
11 * Include necessary headers...
12 */
13
71e16022 14#include "cups-private.h"
ef416fc2 15
16
17/*
18 * Local globals...
19 */
20
d21dc0ed
MS		 21static const char * const ipp_states[] =
22 {
23 "IPP_STATE_ERROR",
24 "IPP_STATE_IDLE",
25 "IPP_STATE_HEADER",
26 "IPP_STATE_ATTRIBUTE",
27 "IPP_STATE_DATA"
28 };
ef416fc2 29static const char * const ipp_status_oks[] = /* "OK" status codes */
a2326b5b 30 { /* (name) = abandoned standard value */
ef416fc2 31 "successful-ok",
32 "successful-ok-ignored-or-substituted-attributes",
33 "successful-ok-conflicting-attributes",
34 "successful-ok-ignored-subscriptions",
a2326b5b 35 "(successful-ok-ignored-notifications)",
ef416fc2 36 "successful-ok-too-many-events",
a2326b5b 37 "(successful-ok-but-cancel-subscription)",
bd7854cb 38 "successful-ok-events-complete"
ef416fc2 39 },
40 * const ipp_status_400s[] = /* Client errors */
a2326b5b 41 { /* (name) = abandoned standard value */
ef416fc2 42 "client-error-bad-request",
43 "client-error-forbidden",
44 "client-error-not-authenticated",
45 "client-error-not-authorized",
46 "client-error-not-possible",
47 "client-error-timeout",
48 "client-error-not-found",
49 "client-error-gone",
50 "client-error-request-entity-too-large",
51 "client-error-request-value-too-long",
52 "client-error-document-format-not-supported",
53 "client-error-attributes-or-values-not-supported",
54 "client-error-uri-scheme-not-supported",
55 "client-error-charset-not-supported",
56 "client-error-conflicting-attributes",
57 "client-error-compression-not-supported",
58 "client-error-compression-error",
59 "client-error-document-format-error",
60 "client-error-document-access-error",
61 "client-error-attributes-not-settable",
62 "client-error-ignored-all-subscriptions",
63 "client-error-too-many-subscriptions",
a2326b5b 64 "(client-error-ignored-all-notifications)",
82cc1f9a
MS		 65 "(client-error-client-print-support-file-not-found)",
66 "client-error-document-password-error",
67 "client-error-document-permission-error",
68 "client-error-document-security-error",
6b13fa61
MS		 69 "client-error-document-unprintable-error",
70 "client-error-account-info-needed",
71 "client-error-account-closed",
72 "client-error-account-limit-reached",
c47d4869
MS		 73 "client-error-account-authorization-failed",
74 "client-error-not-fetchable"
ef416fc2 75 },
a469f8a5
MS		 76 * const ipp_status_480s[] = /* Vendor client errors */
77 {
78 /* 0x0480 - 0x048F */
79 "0x0480",
80 "0x0481",
81 "0x0482",
82 "0x0483",
83 "0x0484",
84 "0x0485",
85 "0x0486",
86 "0x0487",
87 "0x0488",
88 "0x0489",
89 "0x048A",
90 "0x048B",
91 "0x048C",
92 "0x048D",
93 "0x048E",
94 "0x048F",
95 /* 0x0490 - 0x049F */
96 "0x0490",
97 "0x0491",
98 "0x0492",
99 "0x0493",
100 "0x0494",
101 "0x0495",
102 "0x0496",
103 "0x0497",
104 "0x0498",
105 "0x0499",
106 "0x049A",
107 "0x049B",
108 "cups-error-account-info-needed",
109 "cups-error-account-closed",
110 "cups-error-account-limit-reached",
111 "cups-error-account-authorization-failed"
112 },
ef416fc2 113 * const ipp_status_500s[] = /* Server errors */
114 {
115 "server-error-internal-error",
116 "server-error-operation-not-supported",
117 "server-error-service-unavailable",
118 "server-error-version-not-supported",
119 "server-error-device-error",
120 "server-error-temporary-error",
121 "server-error-not-accepting-jobs",
122 "server-error-busy",
123 "server-error-job-canceled",
124 "server-error-multiple-document-jobs-not-supported",
a2326b5b
MS		 125 "server-error-printer-is-deactivated",
126 "server-error-too-many-jobs",
127 "server-error-too-many-documents"
7cf5915e
MS		 128 },
129 * const ipp_status_1000s[] = /* CUPS internal */
130 {
a469f8a5 131 "cups-authentication-canceled",
7cf5915e
MS		 132 "cups-pki-error",
133 "cups-upgrade-required"
ef416fc2 134 };
a2326b5b 135static const char * const ipp_std_ops[] =
ef416fc2 136 {
137 /* 0x0000 - 0x000f */
db8b865d
MS		 138 "0x0000",
139 "0x0001",
aaf19ab0
MS		 140 "Print-Job",
141 "Print-URI",
142 "Validate-Job",
143 "Create-Job",
144 "Send-Document",
145 "Send-URI",
146 "Cancel-Job",
147 "Get-Job-Attributes",
148 "Get-Jobs",
149 "Get-Printer-Attributes",
150 "Hold-Job",
151 "Release-Job",
152 "Restart-Job",
db8b865d 153 "0x000f",
ef416fc2 154
155 /* 0x0010 - 0x001f */
aaf19ab0
MS		 156 "Pause-Printer",
157 "Resume-Printer",
158 "Purge-Jobs",
159 "Set-Printer-Attributes",
ef416fc2 160 "Set-Job-Attributes",
161 "Get-Printer-Supported-Values",
42404685
MS		 162 "Create-Printer-Subscriptions",
163 "Create-Job-Subscriptions",
ef416fc2 164 "Get-Subscription-Attributes",
aaf19ab0
MS		 165 "Get-Subscriptions",
166 "Renew-Subscription",
167 "Cancel-Subscription",
168 "Get-Notifications",
a2326b5b
MS		 169 "(Send-Notifications)",
170 "(Get-Resource-Attributes)",
171 "(Get-Resource-Data)",
ef416fc2 172
173 /* 0x0020 - 0x002f */
a2326b5b
MS		 174 "(Get-Resources)",
175 "(Get-Printer-Support-Files)",
ef416fc2 176 "Enable-Printer",
177 "Disable-Printer",
178 "Pause-Printer-After-Current-Job",
179 "Hold-New-Jobs",
180 "Release-Held-New-Jobs",
181 "Deactivate-Printer",
182 "Activate-Printer",
183 "Restart-Printer",
184 "Shutdown-Printer",
185 "Startup-Printer",
186 "Reprocess-Job",
187 "Cancel-Current-Job",
188 "Suspend-Current-Job",
189 "Resume-Job",
190
9b4bd602 191 /* 0x0030 - 0x003f */
ef416fc2 192 "Promote-Job",
aaf19ab0 193 "Schedule-Job-After",
db8b865d 194 "0x0032",
aaf19ab0
MS		 195 "Cancel-Document",
196 "Get-Document-Attributes",
197 "Get-Documents",
198 "Delete-Document",
199 "Set-Document-Attributes",
200 "Cancel-Jobs",
201 "Cancel-My-Jobs",
202 "Resubmit-Job",
771bd8cb 203 "Close-Job",
82cc1f9a 204 "Identify-Printer",
9475ec92 205 "Validate-Document",
e06e4eb5 206 "Add-Document-Images",
9b4bd602
MS		 207 "Acknowledge-Document",
208
054eee9c 209 /* 0x0040 - 0x004f */
9b4bd602
MS		 210 "Acknowledge-Identify-Printer",
211 "Acknowledge-Job",
212 "Fetch-Document",
213 "Fetch-Job",
214 "Get-Output-Device-Attributes",
215 "Update-Active-Jobs",
216 "Deregister-Output-Device",
217 "Update-Document-Status",
218 "Update-Job-Status",
219 "Update-Output-Device-Attributes",
054eee9c
MS		 220 "Get-Next-Document-Data",
221 "Allocate-Printer-Resources",
222 "Create-Printer",
223 "Deallocate-Printer-Resources",
224 "Delete-Printer",
225 "Get-Printers",
226
227 /* 0x0050 - 0x005f */
228 "Shutdown-One-Printer",
229 "Startup-One-Printer",
230 "Cancel-Resource",
231 "Create-Resource",
232 "Install-Resource",
233 "Send-Resource-Data",
234 "Set-Resource-Attributes",
235 "Create-Resource-Subscriptions",
236 "Create-System-Subscriptions",
237 "Disable-All-Printers",
238 "Enable-All-Printers",
239 "Get-System-Attributes",
240 "Get-System-Supported-Values",
241 "Pause-All-Printers",
242 "Pause-All-Printers-After-Current-Job",
243 "Register-Output-Device",
244
245 /* 0x0060 - 0x0064 */
246 "Restart-System",
247 "Resume-All-Printers",
248 "Set-System-Attributes",
249 "Shutdown-All-Printers",
250 "Startup-All-Printers"
ef416fc2 251 },
252 * const ipp_cups_ops[] =
253 {
254 "CUPS-Get-Default",
255 "CUPS-Get-Printers",
480ef0fe 256 "CUPS-Add-Modify-Printer",
ef416fc2 257 "CUPS-Delete-Printer",
258 "CUPS-Get-Classes",
480ef0fe 259 "CUPS-Add-Modify-Class",
ef416fc2 260 "CUPS-Delete-Class",
261 "CUPS-Accept-Jobs",
262 "CUPS-Reject-Jobs",
263 "CUPS-Set-Default",
264 "CUPS-Get-Devices",
265 "CUPS-Get-PPDs",
266 "CUPS-Move-Job",
b94498cf 267 "CUPS-Authenticate-Job",
268 "CUPS-Get-PPD"
2e4ff8af
MS		 269 },
270 * const ipp_cups_ops2[] =
271 {
95ece0cb
MS		 272 "CUPS-Get-Document",
273 "CUPS-Create-Local-Printer"
1ff0402e
MS		 274 },
275 * const ipp_tag_names[] =
276 { /* Value/group tag names */
277 "zero", /* 0x00 */
278 "operation-attributes-tag",
279 /* 0x01 */
280 "job-attributes-tag", /* 0x02 */
281 "end-of-attributes-tag",
282 /* 0x03 */
283 "printer-attributes-tag",
284 /* 0x04 */
285 "unsupported-attributes-tag",
286 /* 0x05 */
287 "subscription-attributes-tag",
288 /* 0x06 */
289 "event-notification-attributes-tag",
290 /* 0x07 */
a2326b5b
MS		 291 "(resource-attributes-tag)",
292 /* 0x08 */
d7225fc2
MS		 293 "document-attributes-tag",
294 /* 0x09 */
295 "0x0a", /* 0x0a */
296 "0x0b", /* 0x0b */
297 "0x0c", /* 0x0c */
298 "0x0d", /* 0x0d */
299 "0x0e", /* 0x0e */
300 "0x0f", /* 0x0f */
1ff0402e
MS		 301 "unsupported", /* 0x10 */
302 "default", /* 0x11 */
303 "unknown", /* 0x12 */
304 "no-value", /* 0x13 */
d7225fc2 305 "0x14", /* 0x14 */
1ff0402e
MS		 306 "not-settable", /* 0x15 */
307 "delete-attribute", /* 0x16 */
308 "admin-define", /* 0x17 */
d7225fc2
MS		 309 "0x18", /* 0x18 */
310 "0x19", /* 0x19 */
311 "0x1a", /* 0x1a */
312 "0x1b", /* 0x1b */
313 "0x1c", /* 0x1c */
314 "0x1d", /* 0x1d */
315 "0x1e", /* 0x1e */
316 "0x1f", /* 0x1f */
317 "0x20", /* 0x20 */
1ff0402e
MS		 318 "integer", /* 0x21 */
319 "boolean", /* 0x22 */
320 "enum", /* 0x23 */
d7225fc2
MS		 321 "0x24", /* 0x24 */
322 "0x25", /* 0x25 */
323 "0x26", /* 0x26 */
324 "0x27", /* 0x27 */
325 "0x28", /* 0x28 */
326 "0x29", /* 0x29 */
327 "0x2a", /* 0x2a */
328 "0x2b", /* 0x2b */
329 "0x2c", /* 0x2c */
330 "0x2d", /* 0x2d */
331 "0x2e", /* 0x2e */
332 "0x2f", /* 0x2f */
1ff0402e
MS		 333 "octetString", /* 0x30 */
334 "dateTime", /* 0x31 */
335 "resolution", /* 0x32 */
336 "rangeOfInteger", /* 0x33 */
f8b3a85b 337 "collection", /* 0x34 */
1ff0402e
MS		 338 "textWithLanguage", /* 0x35 */
339 "nameWithLanguage", /* 0x36 */
340 "endCollection", /* 0x37 */
d7225fc2
MS		 341 "0x38", /* 0x38 */
342 "0x39", /* 0x39 */
343 "0x3a", /* 0x3a */
344 "0x3b", /* 0x3b */
345 "0x3c", /* 0x3c */
346 "0x3d", /* 0x3d */
347 "0x3e", /* 0x3e */
348 "0x3f", /* 0x3f */
349 "0x40", /* 0x40 */
1ff0402e
MS		 350 "textWithoutLanguage",/* 0x41 */
351 "nameWithoutLanguage",/* 0x42 */
d7225fc2 352 "0x43", /* 0x43 */
1ff0402e
MS		 353 "keyword", /* 0x44 */
354 "uri", /* 0x45 */
355 "uriScheme", /* 0x46 */
356 "charset", /* 0x47 */
357 "naturalLanguage", /* 0x48 */
358 "mimeMediaType", /* 0x49 */
359 "memberAttrName" /* 0x4a */
ef416fc2 360 };
a2326b5b
MS		 361static const char * const ipp_document_states[] =
362 { /* document-state-enums */
363 "pending",
364 "4",
365 "processing",
cd3614ae 366 "processing-stopped", /* IPPSIX */
a2326b5b
MS		 367 "canceled",
368 "aborted",
369 "completed"
370 },
371 * const ipp_finishings[] =
372 { /* finishings enums */
373 "none",
374 "staple",
375 "punch",
376 "cover",
377 "bind",
378 "saddle-stitch",
379 "edge-stitch",
380 "fold",
381 "trim",
382 "bale",
383 "booklet-maker",
384 "jog-offset",
cd3614ae
MS		 385 "coat", /* Finishings 2.0 */
386 "laminate", /* Finishings 2.0 */
a2326b5b
MS		 387 "17",
388 "18",
389 "19",
390 "staple-top-left",
391 "staple-bottom-left",
392 "staple-top-right",
393 "staple-bottom-right",
394 "edge-stitch-left",
395 "edge-stitch-top",
396 "edge-stitch-right",
397 "edge-stitch-bottom",
398 "staple-dual-left",
399 "staple-dual-top",
400 "staple-dual-right",
401 "staple-dual-bottom",
cd3614ae
MS		 402 "staple-triple-left", /* Finishings 2.0 */
403 "staple-triple-top", /* Finishings 2.0 */
404 "staple-triple-right",/* Finishings 2.0 */
405 "staple-triple-bottom",/* Finishings 2.0 */
a2326b5b
MS		 406 "36",
407 "37",
408 "38",
409 "39",
410 "40",
411 "41",
412 "42",
413 "43",
414 "44",
415 "45",
416 "46",
417 "47",
418 "48",
419 "49",
420 "bind-left",
421 "bind-top",
422 "bind-right",
423 "bind-bottom",
424 "54",
425 "55",
426 "56",
427 "57",
428 "58",
429 "59",
430 "trim-after-pages",
431 "trim-after-documents",
432 "trim-after-copies",
9475ec92
MS		 433 "trim-after-job",
434 "64",
435 "65",
436 "66",
437 "67",
438 "68",
439 "69",
cd3614ae
MS		 440 "punch-top-left", /* Finishings 2.0 */
441 "punch-bottom-left", /* Finishings 2.0 */
442 "punch-top-right", /* Finishings 2.0 */
443 "punch-bottom-right", /* Finishings 2.0 */
444 "punch-dual-left", /* Finishings 2.0 */
445 "punch-dual-top", /* Finishings 2.0 */
446 "punch-dual-right", /* Finishings 2.0 */
447 "punch-dual-bottom", /* Finishings 2.0 */
448 "punch-triple-left", /* Finishings 2.0 */
449 "punch-triple-top", /* Finishings 2.0 */
450 "punch-triple-right", /* Finishings 2.0 */
451 "punch-triple-bottom",/* Finishings 2.0 */
452 "punch-quad-left", /* Finishings 2.0 */
453 "punch-quad-top", /* Finishings 2.0 */
454 "punch-quad-right", /* Finishings 2.0 */
455 "punch-quad-bottom", /* Finishings 2.0 */
2a8afc20
MS		 456 "punch-multiple-left",/* Finishings 2.1/Canon */
457 "punch-multiple-top", /* Finishings 2.1/Canon */
458 "punch-multiple-right",/* Finishings 2.1/Canon */
459 "punch-multiple-bottom",/* Finishings 2.1/Canon */
cd3614ae
MS		 460 "fold-accordian", /* Finishings 2.0 */
461 "fold-double-gate", /* Finishings 2.0 */
462 "fold-gate", /* Finishings 2.0 */
463 "fold-half", /* Finishings 2.0 */
464 "fold-half-z", /* Finishings 2.0 */
465 "fold-left-gate", /* Finishings 2.0 */
466 "fold-letter", /* Finishings 2.0 */
467 "fold-parallel", /* Finishings 2.0 */
468 "fold-poster", /* Finishings 2.0 */
469 "fold-right-gate", /* Finishings 2.0 */
2a8afc20
MS		 470 "fold-z", /* Finishings 2.0 */
471 "fold-engineering-z" /* Finishings 2.1 */
a2326b5b 472 },
a469f8a5
MS		 473 * const ipp_finishings_vendor[] =
474 {
475 /* 0x40000000 to 0x4000000F */
476 "0x40000000",
477 "0x40000001",
478 "0x40000002",
479 "0x40000003",
480 "0x40000004",
481 "0x40000005",
482 "0x40000006",
483 "0x40000007",
484 "0x40000008",
485 "0x40000009",
486 "0x4000000A",
487 "0x4000000B",
488 "0x4000000C",
489 "0x4000000D",
490 "0x4000000E",
491 "0x4000000F",
492 /* 0x40000010 to 0x4000001F */
493 "0x40000010",
494 "0x40000011",
495 "0x40000012",
496 "0x40000013",
497 "0x40000014",
498 "0x40000015",
499 "0x40000016",
500 "0x40000017",
501 "0x40000018",
502 "0x40000019",
503 "0x4000001A",
504 "0x4000001B",
505 "0x4000001C",
506 "0x4000001D",
507 "0x4000001E",
508 "0x4000001F",
509 /* 0x40000020 to 0x4000002F */
510 "0x40000020",
511 "0x40000021",
512 "0x40000022",
513 "0x40000023",
514 "0x40000024",
515 "0x40000025",
516 "0x40000026",
517 "0x40000027",
518 "0x40000028",
519 "0x40000029",
520 "0x4000002A",
521 "0x4000002B",
522 "0x4000002C",
523 "0x4000002D",
524 "0x4000002E",
525 "0x4000002F",
526 /* 0x40000030 to 0x4000003F */
527 "0x40000030",
528 "0x40000031",
529 "0x40000032",
530 "0x40000033",
531 "0x40000034",
532 "0x40000035",
533 "0x40000036",
534 "0x40000037",
535 "0x40000038",
536 "0x40000039",
537 "0x4000003A",
538 "0x4000003B",
539 "0x4000003C",
540 "0x4000003D",
541 "0x4000003E",
542 "0x4000003F",
543 /* 0x40000040 - 0x4000004F */
544 "0x40000040",
545 "0x40000041",
546 "0x40000042",
547 "0x40000043",
548 "0x40000044",
549 "0x40000045",
9475ec92
MS		 550 "cups-punch-top-left",
551 "cups-punch-bottom-left",
552 "cups-punch-top-right",
553 "cups-punch-bottom-right",
554 "cups-punch-dual-left",
555 "cups-punch-dual-top",
556 "cups-punch-dual-right",
557 "cups-punch-dual-bottom",
558 "cups-punch-triple-left",
559 "cups-punch-triple-top",
6961465f 560 /* 0x40000050 - 0x4000005F */
9475ec92
MS		 561 "cups-punch-triple-right",
562 "cups-punch-triple-bottom",
563 "cups-punch-quad-left",
564 "cups-punch-quad-top",
565 "cups-punch-quad-right",
566 "cups-punch-quad-bottom",
6961465f
MS		 567 "0x40000056",
568 "0x40000057",
569 "0x40000058",
570 "0x40000059",
9475ec92
MS		 571 "cups-fold-accordian",
572 "cups-fold-double-gate",
573 "cups-fold-gate",
574 "cups-fold-half",
575 "cups-fold-half-z",
576 "cups-fold-left-gate",
6961465f 577 /* 0x40000060 - 0x40000064 */
9475ec92
MS		 578 "cups-fold-letter",
579 "cups-fold-parallel",
580 "cups-fold-poster",
581 "cups-fold-right-gate",
582 "cups-fold-z"
a469f8a5 583 },
a2326b5b
MS		 584 * const ipp_job_collation_types[] =
585 { /* job-collation-type enums */
586 "uncollated-sheets",
587 "collated-documents",
588 "uncollated-documents"
589 },
590 * const ipp_job_states[] =
591 { /* job-state enums */
592 "pending",
593 "pending-held",
594 "processing",
595 "processing-stopped",
596 "canceled",
597 "aborted",
598 "completed"
599 },
600 * const ipp_orientation_requesteds[] =
601 { /* orientation-requested enums */
602 "portrait",
603 "landscape",
604 "reverse-landscape",
8f787fca
MS		 605 "reverse-portrait",
606 "none"
a2326b5b
MS		 607 },
608 * const ipp_print_qualities[] =
609 { /* print-quality enums */
610 "draft",
611 "normal",
612 "high"
613 },
614 * const ipp_printer_states[] =
615 { /* printer-state enums */
616 "idle",
617 "processing",
618 "stopped",
619 };
aaf19ab0
MS		 620
621
622/*
623 * Local functions...
624 */
625
626static size_t ipp_col_string(ipp_t *col, char *buffer, size_t bufsize);
627
628
629/*
a2326b5b 630 * 'ippAttributeString()' - Convert the attribute's value to a string.
aaf19ab0
MS		 631 *
632 * Returns the number of bytes that would be written, not including the
633 * trailing nul. The buffer pointer can be NULL to get the required length,
634 * just like (v)snprintf.
a2326b5b 635 *
8072030b 636 * @since CUPS 1.6/macOS 10.8@
aaf19ab0
MS		 637 */
638
639size_t /* O - Number of bytes less nul */
a2326b5b
MS		 640ippAttributeString(
641 ipp_attribute_t *attr, /* I - Attribute */
642 char *buffer, /* I - String buffer or NULL */
643 size_t bufsize) /* I - Size of string buffer */
aaf19ab0
MS		 644{
645 int i; /* Looping var */
646 char *bufptr, /* Pointer into buffer */
647 *bufend, /* End of buffer */
648 temp[256]; /* Temporary string */
db8b865d
MS		 649 const char *ptr, /* Pointer into string */
650 *end; /* Pointer to end of string */
a2326b5b 651 _ipp_value_t *val; /* Current value */
aaf19ab0
MS		 652
653
654 if (!attr || !attr->name)
655 {
656 if (buffer)
657 *buffer = '\0';
658
659 return (0);
660 }
661
662 bufptr = buffer;
663 if (buffer)
664 bufend = buffer + bufsize - 1;
665 else
666 bufend = NULL;
667
668 for (i = attr->num_values, val = attr->values; i > 0; i --, val ++)
669 {
670 if (val > attr->values)
671 {
7cf5915e 672 if (buffer && bufptr < bufend)
aaf19ab0
MS		 673 *bufptr++ = ',';
674 else
675 bufptr ++;
676 }
677
cb7f98ee 678 switch (attr->value_tag & ~IPP_TAG_CUPS_CONST)
aaf19ab0
MS		 679 {
680 case IPP_TAG_ENUM :
a2326b5b 681 ptr = ippEnumString(attr->name, val->integer);
aaf19ab0 682
a2326b5b 683 if (buffer && bufptr < bufend)
07623986 684 strlcpy(bufptr, ptr, (size_t)(bufend - bufptr + 1));
9b66acc5 685
a2326b5b
MS		 686 bufptr += strlen(ptr);
687 break;
aaf19ab0
MS		 688
689 case IPP_TAG_INTEGER :
7cf5915e 690 if (buffer && bufptr < bufend)
07623986 691 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%d", val->integer);
aaf19ab0
MS		 692 else
693 bufptr += snprintf(temp, sizeof(temp), "%d", val->integer);
694 break;
695
696 case IPP_TAG_BOOLEAN :
7cf5915e 697 if (buffer && bufptr < bufend)
07623986 698 strlcpy(bufptr, val->boolean ? "true" : "false", (size_t)(bufend - bufptr + 1));
aaf19ab0
MS		 699
700 bufptr += val->boolean ? 4 : 5;
701 break;
702
703 case IPP_TAG_RANGE :
7cf5915e 704 if (buffer && bufptr < bufend)
07623986 705 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%d-%d", val->range.lower, val->range.upper);
aaf19ab0 706 else
07623986 707 bufptr += snprintf(temp, sizeof(temp), "%d-%d", val->range.lower, val->range.upper);
aaf19ab0
MS		 708 break;
709
710 case IPP_TAG_RESOLUTION :
4a838088
MS		 711 if (val->resolution.xres == val->resolution.yres)
712 {
713 if (buffer && bufptr < bufend)
714 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%d%s", val->resolution.xres, val->resolution.units == IPP_RES_PER_INCH ? "dpi" : "dpcm");
715 else
716 bufptr += snprintf(temp, sizeof(temp), "%d%s", val->resolution.xres, val->resolution.units == IPP_RES_PER_INCH ? "dpi" : "dpcm");
717 }
718 else if (buffer && bufptr < bufend)
07623986 719 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%dx%d%s", val->resolution.xres, val->resolution.yres, val->resolution.units == IPP_RES_PER_INCH ? "dpi" : "dpcm");
aaf19ab0 720 else
07623986 721 bufptr += snprintf(temp, sizeof(temp), "%dx%d%s", val->resolution.xres, val->resolution.yres, val->resolution.units == IPP_RES_PER_INCH ? "dpi" : "dpcm");
aaf19ab0
MS		 722 break;
723
724 case IPP_TAG_DATE :
725 {
726 unsigned year; /* Year */
727
7e86f2f6 728 year = ((unsigned)val->date[0] << 8) + (unsigned)val->date[1];
aaf19ab0
MS		 729
730 if (val->date[9] == 0 && val->date[10] == 0)
731 snprintf(temp, sizeof(temp), "%04u-%02u-%02uT%02u:%02u:%02uZ",
732 year, val->date[2], val->date[3], val->date[4],
733 val->date[5], val->date[6]);
734 else
735 snprintf(temp, sizeof(temp),
736 "%04u-%02u-%02uT%02u:%02u:%02u%c%02u%02u",
737 year, val->date[2], val->date[3], val->date[4],
738 val->date[5], val->date[6], val->date[8], val->date[9],
739 val->date[10]);
740
7cf5915e 741 if (buffer && bufptr < bufend)
07623986 742 strlcpy(bufptr, temp, (size_t)(bufend - bufptr + 1));
aaf19ab0
MS		 743
744 bufptr += strlen(temp);
745 }
746 break;
747
748 case IPP_TAG_TEXT :
749 case IPP_TAG_NAME :
750 case IPP_TAG_KEYWORD :
751 case IPP_TAG_CHARSET :
752 case IPP_TAG_URI :
d7225fc2 753 case IPP_TAG_URISCHEME :
aaf19ab0
MS		 754 case IPP_TAG_MIMETYPE :
755 case IPP_TAG_LANGUAGE :
756 case IPP_TAG_TEXTLANG :
757 case IPP_TAG_NAMELANG :
7cf5915e
MS		 758 if (!val->string.text)
759 break;
760
aaf19ab0
MS		 761 for (ptr = val->string.text; *ptr; ptr ++)
762 {
a2326b5b 763 if (*ptr == '\\' || *ptr == '\"' || *ptr == '[')
aaf19ab0 764 {
7cf5915e 765 if (buffer && bufptr < bufend)
aaf19ab0
MS		 766 *bufptr = '\\';
767 bufptr ++;
768 }
769
7cf5915e 770 if (buffer && bufptr < bufend)
aaf19ab0
MS		 771 *bufptr = *ptr;
772 bufptr ++;
773 }
a2326b5b
MS		 774
775 if (val->string.language)
776 {
777 /*
778 * Add "[language]" to end of string...
779 */
780
781 if (buffer && bufptr < bufend)
782 *bufptr = '[';
783 bufptr ++;
784
785 if (buffer && bufptr < bufend)
07623986 786 strlcpy(bufptr, val->string.language, (size_t)(bufend - bufptr));
a2326b5b
MS		 787 bufptr += strlen(val->string.language);
788
789 if (buffer && bufptr < bufend)
790 *bufptr = ']';
791 bufptr ++;
792 }
aaf19ab0
MS		 793 break;
794
795 case IPP_TAG_BEGIN_COLLECTION :
7cf5915e 796 if (buffer && bufptr < bufend)
7e86f2f6 797 bufptr += ipp_col_string(val->collection, bufptr, (size_t)(bufend - bufptr + 1));
aaf19ab0
MS		 798 else
799 bufptr += ipp_col_string(val->collection, NULL, 0);
800 break;
801
802 case IPP_TAG_STRING :
db8b865d
MS		 803 for (ptr = val->unknown.data, end = ptr + val->unknown.length;
804 ptr < end; ptr ++)
aaf19ab0 805 {
7cf5915e 806 if (*ptr == '\\' || _cups_isspace(*ptr))
aaf19ab0 807 {
7cf5915e 808 if (buffer && bufptr < bufend)
aaf19ab0
MS		 809 *bufptr = '\\';
810 bufptr ++;
811
7cf5915e 812 if (buffer && bufptr < bufend)
aaf19ab0
MS		 813 *bufptr = *ptr;
814 bufptr ++;
815 }
816 else if (!isprint(*ptr & 255))
817 {
7cf5915e 818 if (buffer && bufptr < bufend)
07623986 819 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "\\%03o", *ptr & 255);
aaf19ab0 820 else
07623986 821 bufptr += snprintf(temp, sizeof(temp), "\\%03o", *ptr & 255);
aaf19ab0
MS		 822 }
823 else
824 {
7cf5915e 825 if (buffer && bufptr < bufend)
aaf19ab0
MS		 826 *bufptr = *ptr;
827 bufptr ++;
828 }
829 }
830 break;
831
832 default :
833 ptr = ippTagString(attr->value_tag);
7cf5915e 834 if (buffer && bufptr < bufend)
07623986 835 strlcpy(bufptr, ptr, (size_t)(bufend - bufptr + 1));
aaf19ab0
MS		 836 bufptr += strlen(ptr);
837 break;
838 }
839 }
840
7cf5915e 841 if (buffer && bufptr < bufend)
aaf19ab0
MS		 842 *bufptr = '\0';
843 else if (bufend)
844 *bufend = '\0';
845
7e86f2f6 846 return ((size_t)(bufptr - buffer));
aaf19ab0 847}
ef416fc2 848
849
db8b865d
MS		 850/*
851 * 'ippCreateRequestedArray()' - Create a CUPS array of attribute names from the
852 * given requested-attributes attribute.
853 *
854 * This function creates a (sorted) CUPS array of attribute names matching the
855 * list of "requested-attribute" values supplied in an IPP request. All IANA-
856 * registered values are supported in addition to the CUPS IPP extension
857 * attributes.
858 *
859 * The @code request@ parameter specifies the request message that was read from
860 * the client.
861 *
862 * @code NULL@ is returned if all attributes should be returned. Otherwise, the
863 * result is a sorted array of attribute names, where @code cupsArrayFind(array,
864 * "attribute-name")@ will return a non-NULL pointer. The array must be freed
865 * using the @code cupsArrayDelete@ function.
866 *
8072030b 867 * @since CUPS 1.7/macOS 10.9@
db8b865d
MS		 868 */
869
870cups_array_t * /* O - CUPS array or @code NULL@ if all */
871ippCreateRequestedArray(ipp_t *request) /* I - IPP request */
872{
873 int i, j, /* Looping vars */
874 count, /* Number of values */
875 added; /* Was name added? */
876 ipp_attribute_t *requested; /* requested-attributes attribute */
877 cups_array_t *ra; /* Requested attributes array */
878 const char *value; /* Current value */
879 /* The following lists come from the current IANA IPP registry of attributes */
880 static const char * const document_description[] =
881 { /* document-description group */
882 "compression",
883 "copies-actual",
884 "cover-back-actual",
885 "cover-front-actual",
886 "current-page-order",
887 "date-time-at-completed",
888 "date-time-at-creation",
889 "date-time-at-processing",
890 "detailed-status-messages",
891 "document-access-errors",
892 "document-charset",
893 "document-digital-signature",
894 "document-format",
895 "document-format-details",
896 "document-format-detected",
897 "document-format-version",
898 "document-format-version-detected",
899 "document-job-id",
900 "document-job-uri",
901 "document-message",
902 "document-metadata",
903 "document-name",
904 "document-natural-language",
905 "document-number",
906 "document-printer-uri",
907 "document-state",
908 "document-state-message",
909 "document-state-reasons",
910 "document-uri",
911 "document-uuid",
912 "errors-count",
913 "finishings-actual",
914 "finishings-col-actual",
915 "force-front-side-actual",
916 "imposition-template-actual",
917 "impressions",
918 "impressions-completed",
919 "impressions-completed-current-copy",
920 "insert-sheet-actual",
921 "k-octets",
922 "k-octets-processed",
923 "last-document",
87e9bb55 924 "materials-col-actual", /* IPP 3D */
db8b865d
MS		 925 "media-actual",
926 "media-col-actual",
927 "media-input-tray-check-actual",
928 "media-sheets",
929 "media-sheets-completed",
930 "more-info",
87e9bb55 931 "multiple-object-handling-actual", /* IPP 3D */
db8b865d
MS		 932 "number-up-actual",
933 "orientation-requested-actual",
934 "output-bin-actual",
935 "output-device-assigned",
936 "overrides-actual",
937 "page-delivery-actual",
938 "page-order-received-actual",
939 "page-ranges-actual",
940 "pages",
941 "pages-completed",
942 "pages-completed-current-copy",
87e9bb55 943 "platform-temperature-actual", /* IPP 3D */
db8b865d 944 "presentation-direction-number-up-actual",
87e9bb55
MS		 945 "print-accuracy-actual", /* IPP 3D */
946 "print-base-actual", /* IPP 3D */
db8b865d
MS		 947 "print-color-mode-actual",
948 "print-content-optimize-actual",
87e9bb55 949 "print-objects-actual", /* IPP 3D */
db8b865d
MS		 950 "print-quality-actual",
951 "print-rendering-intent-actual",
6961465f 952 "print-scaling-actual", /* IPP Paid Printing */
87e9bb55 953 "print-supports-actual", /* IPP 3D */
db8b865d
MS		 954 "printer-resolution-actual",
955 "printer-up-time",
956 "separator-sheets-actual",
957 "sheet-completed-copy-number",
958 "sides-actual",
959 "time-at-completed",
960 "time-at-creation",
961 "time-at-processing",
962 "x-image-position-actual",
963 "x-image-shift-actual",
964 "x-side1-image-shift-actual",
965 "x-side2-image-shift-actual",
966 "y-image-position-actual",
967 "y-image-shift-actual",
968 "y-side1-image-shift-actual",
969 "y-side2-image-shift-actual"
970 };
971 static const char * const document_template[] =
972 { /* document-template group */
973 "copies",
974 "copies-default",
975 "copies-supported",
976 "cover-back",
977 "cover-back-default",
978 "cover-back-supported",
979 "cover-front",
980 "cover-front-default",
981 "cover-front-supported",
982 "feed-orientation",
983 "feed-orientation-default",
984 "feed-orientation-supported",
985 "finishings",
986 "finishings-col",
253dc4fc 987 "finishings-col-database",
db8b865d 988 "finishings-col-default",
253dc4fc 989 "finishings-col-ready",
db8b865d
MS		 990 "finishings-col-supported",
991 "finishings-default",
253dc4fc 992 "finishings-ready",
db8b865d
MS		 993 "finishings-supported",
994 "font-name-requested",
995 "font-name-requested-default",
996 "font-name-requested-supported",
997 "font-size-requested",
998 "font-size-requested-default",
999 "font-size-requested-supported",
1000 "force-front-side",
1001 "force-front-side-default",
1002 "force-front-side-supported",
1003 "imposition-template",
1004 "imposition-template-default",
1005 "imposition-template-supported",
1006 "insert-after-page-number-supported",
1007 "insert-count-supported",
1008 "insert-sheet",
1009 "insert-sheet-default",
1010 "insert-sheet-supported",
87e9bb55
MS		 1011 "material-amount-units-supported", /* IPP 3D */
1012 "material-diameter-supported", /* IPP 3D */
1013 "material-purpose-supported", /* IPP 3D */
1014 "material-rate-supported", /* IPP 3D */
1015 "material-rate-units-supported", /* IPP 3D */
1016 "material-shell-thickness-supported",/* IPP 3D */
1017 "material-temperature-supported", /* IPP 3D */
1018 "material-type-supported", /* IPP 3D */
1019 "materials-col", /* IPP 3D */
1020 "materials-col-database", /* IPP 3D */
1021 "materials-col-default", /* IPP 3D */
1022 "materials-col-ready", /* IPP 3D */
1023 "materials-col-supported", /* IPP 3D */
1024 "max-materials-col-supported", /* IPP 3D */
db8b865d
MS		 1025 "max-stitching-locations-supported",
1026 "media",
1027 "media-back-coating-supported",
1028 "media-bottom-margin-supported",
1029 "media-col",
1030 "media-col-default",
253dc4fc 1031 "media-col-ready",
db8b865d
MS		 1032 "media-col-supported",
1033 "media-color-supported",
1034 "media-default",
1035 "media-front-coating-supported",
1036 "media-grain-supported",
1037 "media-hole-count-supported",
1038 "media-info-supported",
1039 "media-input-tray-check",
1040 "media-input-tray-check-default",
1041 "media-input-tray-check-supported",
1042 "media-key-supported",
1043 "media-left-margin-supported",
1044 "media-order-count-supported",
1045 "media-pre-printed-supported",
253dc4fc 1046 "media-ready",
db8b865d
MS		 1047 "media-recycled-supported",
1048 "media-right-margin-supported",
1049 "media-size-supported",
1050 "media-source-supported",
1051 "media-supported",
1052 "media-thickness-supported",
1053 "media-top-margin-supported",
1054 "media-type-supported",
1055 "media-weight-metric-supported",
1056 "multiple-document-handling",
1057 "multiple-document-handling-default",
1058 "multiple-document-handling-supported",
87e9bb55
MS		 1059 "multiple-object-handling", /* IPP 3D */
1060 "multiple-object-handling-default", /* IPP 3D */
1061 "multiple-object-handling-supported",/* IPP 3D */
db8b865d
MS		 1062 "number-up",
1063 "number-up-default",
1064 "number-up-supported",
1065 "orientation-requested",
1066 "orientation-requested-default",
1067 "orientation-requested-supported",
6961465f
MS		 1068 "output-mode", /* CUPS extension */
1069 "output-mode-default", /* CUPS extension */
1070 "output-mode-supported", /* CUPS extension */
db8b865d
MS		 1071 "overrides",
1072 "overrides-supported",
1073 "page-delivery",
1074 "page-delivery-default",
1075 "page-delivery-supported",
1076 "page-order-received",
1077 "page-order-received-default",
1078 "page-order-received-supported",
1079 "page-ranges",
1080 "page-ranges-supported",
1081 "pages-per-subset",
1082 "pages-per-subset-supported",
1083 "pdl-init-file",
1084 "pdl-init-file-default",
1085 "pdl-init-file-entry-supported",
1086 "pdl-init-file-location-supported",
1087 "pdl-init-file-name-subdirectory-supported",
1088 "pdl-init-file-name-supported",
1089 "pdl-init-file-supported",
87e9bb55
MS		 1090 "platform-temperature", /* IPP 3D */
1091 "platform-temperature-default", /* IPP 3D */
1092 "platform-temperature-supported", /* IPP 3D */
db8b865d
MS		 1093 "presentation-direction-number-up",
1094 "presentation-direction-number-up-default",
1095 "presentation-direction-number-up-supported",
87e9bb55
MS		 1096 "print-accuracy", /* IPP 3D */
1097 "print-accuracy-default", /* IPP 3D */
1098 "print-accuracy-supported", /* IPP 3D */
1099 "print-base", /* IPP 3D */
1100 "print-base-default", /* IPP 3D */
1101 "print-base-supported", /* IPP 3D */
db8b865d
MS		 1102 "print-color-mode",
1103 "print-color-mode-default",
1104 "print-color-mode-supported",
1105 "print-content-optimize",
1106 "print-content-optimize-default",
1107 "print-content-optimize-supported",
87e9bb55
MS		 1108 "print-objects", /* IPP 3D */
1109 "print-objects-default", /* IPP 3D */
1110 "print-objects-supported", /* IPP 3D */
db8b865d
MS		 1111 "print-quality",
1112 "print-quality-default",
1113 "print-quality-supported",
1114 "print-rendering-intent",
1115 "print-rendering-intent-default",
1116 "print-rendering-intent-supported",
6961465f
MS		 1117 "print-scaling", /* IPP Paid Printing */
1118 "print-scaling-default", /* IPP Paid Printing */
1119 "print-scaling-supported", /* IPP Paid Printing */
87e9bb55
MS		 1120 "print-supports", /* IPP 3D */
1121 "print-supports-default", /* IPP 3D */
1122 "print-supports-supported", /* IPP 3D */
db8b865d
MS		 1123 "printer-resolution",
1124 "printer-resolution-default",
1125 "printer-resolution-supported",
1126 "separator-sheets",
1127 "separator-sheets-default",
1128 "separator-sheets-supported",
1129 "sheet-collate",
1130 "sheet-collate-default",
1131 "sheet-collate-supported",
1132 "sides",
1133 "sides-default",
1134 "sides-supported",
1135 "stitching-locations-supported",
1136 "stitching-offset-supported",
1137 "x-image-position",
1138 "x-image-position-default",
1139 "x-image-position-supported",
1140 "x-image-shift",
1141 "x-image-shift-default",
1142 "x-image-shift-supported",
1143 "x-side1-image-shift",
1144 "x-side1-image-shift-default",
1145 "x-side1-image-shift-supported",
1146 "x-side2-image-shift",
1147 "x-side2-image-shift-default",
1148 "x-side2-image-shift-supported",
1149 "y-image-position",
1150 "y-image-position-default",
1151 "y-image-position-supported",
1152 "y-image-shift",
1153 "y-image-shift-default",
1154 "y-image-shift-supported",
1155 "y-side1-image-shift",
1156 "y-side1-image-shift-default",
1157 "y-side1-image-shift-supported",
1158 "y-side2-image-shift",
1159 "y-side2-image-shift-default",
1160 "y-side2-image-shift-supported"
1161 };
1162 static const char * const job_description[] =
1163 { /* job-description group */
1164 "compression-supplied",
1165 "copies-actual",
1166 "cover-back-actual",
1167 "cover-front-actual",
1168 "current-page-order",
1169 "date-time-at-completed",
1170 "date-time-at-creation",
1171 "date-time-at-processing",
1172 "destination-statuses",
1173 "document-charset-supplied",
1174 "document-digital-signature-supplied",
1175 "document-format-details-supplied",
1176 "document-format-supplied",
1177 "document-message-supplied",
1178 "document-metadata",
1179 "document-name-supplied",
1180 "document-natural-language-supplied",
1181 "document-overrides-actual",
1182 "errors-count",
1183 "finishings-actual",
1184 "finishings-col-actual",
1185 "force-front-side-actual",
1186 "imposition-template-actual",
1187 "impressions-completed-current-copy",
1188 "insert-sheet-actual",
1189 "job-account-id-actual",
1190 "job-accounting-sheets-actual",
1191 "job-accounting-user-id-actual",
1192 "job-attribute-fidelity",
1193 "job-charge-info", /* CUPS extension */
1194 "job-collation-type",
1195 "job-collation-type-actual",
1196 "job-copies-actual",
1197 "job-cover-back-actual",
1198 "job-cover-front-actual",
1199 "job-detailed-status-message",
1200 "job-document-access-errors",
1201 "job-error-sheet-actual",
1202 "job-finishings-actual",
1203 "job-finishings-col-actual",
1204 "job-hold-until-actual",
1205 "job-id",
1206 "job-impressions",
1207 "job-impressions-completed",
1208 "job-k-octets",
1209 "job-k-octets-processed",
1210 "job-mandatory-attributes",
1211 "job-media-progress", /* CUPS extension */
1212 "job-media-sheets",
1213 "job-media-sheets-completed",
1214 "job-message-from-operator",
1215 "job-more-info",
1216 "job-name",
1217 "job-originating-host-name", /* CUPS extension */
1218 "job-originating-user-name",
1219 "job-originating-user-uri",
1220 "job-pages",
1221 "job-pages-completed",
1222 "job-pages-completed-current-copy",
1223 "job-printer-state-message", /* CUPS extension */
1224 "job-printer-state-reasons", /* CUPS extension */
1225 "job-printer-up-time",
1226 "job-printer-uri",
1227 "job-priority-actual",
1228 "job-save-printer-make-and-model",
1229 "job-sheet-message-actual",
1230 "job-sheets-actual",
1231 "job-sheets-col-actual",
1232 "job-state",
1233 "job-state-message",
1234 "job-state-reasons",
1235 "job-uri",
1236 "job-uuid",
87e9bb55 1237 "materials-col-actual", /* IPP 3D */
db8b865d
MS		 1238 "media-actual",
1239 "media-col-actual",
1240 "media-check-input-tray-actual",
1241 "multiple-document-handling-actual",
87e9bb55 1242 "multiple-object-handling-actual", /* IPP 3D */
db8b865d
MS		 1243 "number-of-documents",
1244 "number-of-intervening-jobs",
1245 "number-up-actual",
1246 "orientation-requested-actual",
1247 "original-requesting-user-name",
1248 "output-bin-actual",
1249 "output-device-assigned",
1250 "overrides-actual",
1251 "page-delivery-actual",
1252 "page-order-received-actual",
1253 "page-ranges-actual",
87e9bb55 1254 "platform-temperature-actual", /* IPP 3D */
db8b865d 1255 "presentation-direction-number-up-actual",
87e9bb55
MS		 1256 "print-accuracy-actual", /* IPP 3D */
1257 "print-base-actual", /* IPP 3D */
db8b865d
MS		 1258 "print-color-mode-actual",
1259 "print-content-optimize-actual",
87e9bb55 1260 "print-objects-actual", /* IPP 3D */
db8b865d
MS		 1261 "print-quality-actual",
1262 "print-rendering-intent-actual",
6961465f 1263 "print-scaling-actual", /* IPP Paid Printing */
87e9bb55 1264 "print-supports-actual", /* IPP 3D */
db8b865d
MS		 1265 "printer-resolution-actual",
1266 "separator-sheets-actual",
1267 "sheet-collate-actual",
1268 "sheet-completed-copy-number",
1269 "sheet-completed-document-number",
1270 "sides-actual",
1271 "time-at-completed",
1272 "time-at-creation",
1273 "time-at-processing",
1274 "warnings-count",
1275 "x-image-position-actual",
1276 "x-image-shift-actual",
1277 "x-side1-image-shift-actual",
1278 "x-side2-image-shift-actual",
1279 "y-image-position-actual",
1280 "y-image-shift-actual",
1281 "y-side1-image-shift-actual",
1282 "y-side2-image-shift-actual"
1283 };
1284 static const char * const job_template[] =
1285 { /* job-template group */
87e9bb55 1286 "accuracy-units-supported", /* IPP 3D */
db8b865d
MS		 1287 "confirmation-sheet-print", /* IPP FaxOut */
1288 "confirmation-sheet-print-default",
1289 "copies",
1290 "copies-default",
1291 "copies-supported",
1292 "cover-back",
1293 "cover-back-default",
1294 "cover-back-supported",
1295 "cover-front",
1296 "cover-front-default",
1297 "cover-front-supported",
1298 "cover-sheet-info", /* IPP FaxOut */
1299 "cover-sheet-info-default",
1300 "cover-sheet-info-supported",
1301 "destination-uri-schemes-supported",/* IPP FaxOut */
1302 "destination-uris", /* IPP FaxOut */
1303 "destination-uris-supported",
1304 "feed-orientation",
1305 "feed-orientation-default",
1306 "feed-orientation-supported",
1307 "finishings",
1308 "finishings-col",
253dc4fc 1309 "finishings-col-database",
db8b865d 1310 "finishings-col-default",
253dc4fc 1311 "finishings-col-ready",
db8b865d
MS		 1312 "finishings-col-supported",
1313 "finishings-default",
253dc4fc 1314 "finishings-ready",
db8b865d
MS		 1315 "finishings-supported",
1316 "font-name-requested",
1317 "font-name-requested-default",
1318 "font-name-requested-supported",
1319 "font-size-requested",
1320 "font-size-requested-default",
1321 "font-size-requested-supported",
1322 "force-front-side",
1323 "force-front-side-default",
1324 "force-front-side-supported",
1325 "imposition-template",
1326 "imposition-template-default",
1327 "imposition-template-supported",
1328 "insert-after-page-number-supported",
1329 "insert-count-supported",
1330 "insert-sheet",
1331 "insert-sheet-default",
1332 "insert-sheet-supported",
1333 "job-account-id",
1334 "job-account-id-default",
1335 "job-account-id-supported",
1336 "job-accounting-sheets"
1337 "job-accounting-sheets-default"
1338 "job-accounting-sheets-supported"
1339 "job-accounting-user-id",
1340 "job-accounting-user-id-default",
1341 "job-accounting-user-id-supported",
1342 "job-copies",
1343 "job-copies-default",
1344 "job-copies-supported",
1345 "job-cover-back",
1346 "job-cover-back-default",
1347 "job-cover-back-supported",
1348 "job-cover-front",
1349 "job-cover-front-default",
1350 "job-cover-front-supported",
1351 "job-delay-output-until",
1352 "job-delay-output-until-default",
1353 "job-delay-output-until-supported",
1354 "job-delay-output-until-time",
1355 "job-delay-output-until-time-default",
1356 "job-delay-output-until-time-supported",
1357 "job-error-action",
1358 "job-error-action-default",
1359 "job-error-action-supported",
1360 "job-error-sheet",
1361 "job-error-sheet-default",
1362 "job-error-sheet-supported",
1363 "job-finishings",
1364 "job-finishings-col",
1365 "job-finishings-col-default",
1366 "job-finishings-col-supported",
1367 "job-finishings-default",
1368 "job-finishings-supported",
1369 "job-hold-until",
1370 "job-hold-until-default",
1371 "job-hold-until-supported",
1372 "job-hold-until-time",
1373 "job-hold-until-time-default",
1374 "job-hold-until-time-supported",
1375 "job-message-to-operator",
1376 "job-message-to-operator-default",
1377 "job-message-to-operator-supported",
1378 "job-phone-number",
1379 "job-phone-number-default",
1380 "job-phone-number-supported",
1381 "job-priority",
1382 "job-priority-default",
1383 "job-priority-supported",
1384 "job-recipient-name",
1385 "job-recipient-name-default",
1386 "job-recipient-name-supported",
1387 "job-save-disposition",
1388 "job-save-disposition-default",
1389 "job-save-disposition-supported",
1390 "job-sheets",
1391 "job-sheets-col",
1392 "job-sheets-col-default",
1393 "job-sheets-col-supported",
1394 "job-sheets-default",
1395 "job-sheets-supported",
1396 "logo-uri-schemes-supported",
87e9bb55
MS		 1397 "material-amount-units-supported", /* IPP 3D */
1398 "material-diameter-supported", /* IPP 3D */
1399 "material-purpose-supported", /* IPP 3D */
1400 "material-rate-supported", /* IPP 3D */
1401 "material-rate-units-supported", /* IPP 3D */
1402 "material-shell-thickness-supported",/* IPP 3D */
1403 "material-temperature-supported", /* IPP 3D */
1404 "material-type-supported", /* IPP 3D */
1405 "materials-col", /* IPP 3D */
1406 "materials-col-database", /* IPP 3D */
1407 "materials-col-default", /* IPP 3D */
1408 "materials-col-ready", /* IPP 3D */
1409 "materials-col-supported", /* IPP 3D */
1410 "max-materials-col-supported", /* IPP 3D */
db8b865d
MS		 1411 "max-save-info-supported",
1412 "max-stitching-locations-supported",
1413 "media",
1414 "media-back-coating-supported",
1415 "media-bottom-margin-supported",
1416 "media-col",
1417 "media-col-default",
253dc4fc 1418 "media-col-ready",
db8b865d
MS		 1419 "media-col-supported",
1420 "media-color-supported",
1421 "media-default",
1422 "media-front-coating-supported",
1423 "media-grain-supported",
1424 "media-hole-count-supported",
1425 "media-info-supported",
1426 "media-input-tray-check",
1427 "media-input-tray-check-default",
1428 "media-input-tray-check-supported",
1429 "media-key-supported",
1430 "media-left-margin-supported",
1431 "media-order-count-supported",
1432 "media-pre-printed-supported",
253dc4fc 1433 "media-ready",
db8b865d
MS		 1434 "media-recycled-supported",
1435 "media-right-margin-supported",
1436 "media-size-supported",
1437 "media-source-supported",
1438 "media-supported",
1439 "media-thickness-supported",
1440 "media-top-margin-supported",
1441 "media-type-supported",
1442 "media-weight-metric-supported",
1443 "multiple-document-handling",
1444 "multiple-document-handling-default",
1445 "multiple-document-handling-supported",
87e9bb55
MS		 1446 "multiple-object-handling", /* IPP 3D */
1447 "multiple-object-handling-default", /* IPP 3D */
1448 "multiple-object-handling-supported",/* IPP 3D */
db8b865d
MS		 1449 "number-of-retries", /* IPP FaxOut */
1450 "number-of-retries-default",
1451 "number-of-retries-supported",
1452 "number-up",
1453 "number-up-default",
1454 "number-up-supported",
1455 "orientation-requested",
1456 "orientation-requested-default",
1457 "orientation-requested-supported",
1458 "output-bin",
1459 "output-bin-default",
1460 "output-bin-supported",
1461 "output-device",
1462 "output-device-default",
1463 "output-device-supported",
6961465f
MS		 1464 "output-mode", /* CUPS extension */
1465 "output-mode-default", /* CUPS extension */
1466 "output-mode-supported", /* CUPS extension */
db8b865d
MS		 1467 "overrides",
1468 "overrides-supported",
1469 "page-delivery",
1470 "page-delivery-default",
1471 "page-delivery-supported",
1472 "page-order-received",
1473 "page-order-received-default",
1474 "page-order-received-supported",
1475 "page-ranges",
1476 "page-ranges-supported",
1477 "pages-per-subset",
1478 "pages-per-subset-supported",
1479 "pdl-init-file",
1480 "pdl-init-file-default",
1481 "pdl-init-file-entry-supported",
1482 "pdl-init-file-location-supported",
1483 "pdl-init-file-name-subdirectory-supported",
1484 "pdl-init-file-name-supported",
1485 "pdl-init-file-supported",
87e9bb55
MS		 1486 "platform-temperature", /* IPP 3D */
1487 "platform-temperature-default", /* IPP 3D */
1488 "platform-temperature-supported", /* IPP 3D */
db8b865d
MS		 1489 "presentation-direction-number-up",
1490 "presentation-direction-number-up-default",
1491 "presentation-direction-number-up-supported",
87e9bb55
MS		 1492 "print-accuracy", /* IPP 3D */
1493 "print-accuracy-default", /* IPP 3D */
1494 "print-accuracy-supported", /* IPP 3D */
1495 "print-base", /* IPP 3D */
1496 "print-base-default", /* IPP 3D */
1497 "print-base-supported", /* IPP 3D */
db8b865d
MS		 1498 "print-color-mode",
1499 "print-color-mode-default",
1500 "print-color-mode-supported",
1501 "print-content-optimize",
1502 "print-content-optimize-default",
1503 "print-content-optimize-supported",
87e9bb55
MS		 1504 "print-objects", /* IPP 3D */
1505 "print-objects-default", /* IPP 3D */
1506 "print-objects-supported", /* IPP 3D */
db8b865d
MS		 1507 "print-quality",
1508 "print-quality-default",
1509 "print-quality-supported",
1510 "print-rendering-intent",
1511 "print-rendering-intent-default",
1512 "print-rendering-intent-supported",
6961465f
MS		 1513 "print-scaling", /* IPP Paid Printing */
1514 "print-scaling-default", /* IPP Paid Printing */
1515 "print-scaling-supported", /* IPP Paid Printing */
87e9bb55
MS		 1516 "print-supports", /* IPP 3D */
1517 "print-supports-default", /* IPP 3D */
1518 "print-supports-supported", /* IPP 3D */
db8b865d
MS		 1519 "printer-resolution",
1520 "printer-resolution-default",
1521 "printer-resolution-supported",
1522 "proof-print",
1523 "proof-print-default",
1524 "proof-print-supported",
1525 "retry-interval", /* IPP FaxOut */
1526 "retry-interval-default",
1527 "retry-interval-supported",
1528 "retry-timeout", /* IPP FaxOut */
1529 "retry-timeout-default",
1530 "retry-timeout-supported",
1531 "save-disposition-supported",
1532 "save-document-format-default",
1533 "save-document-format-supported",
1534 "save-location-default",
1535 "save-location-supported",
1536 "save-name-subdirectory-supported",
1537 "save-name-supported",
1538 "separator-sheets",
1539 "separator-sheets-default",
1540 "separator-sheets-supported",
1541 "sheet-collate",
1542 "sheet-collate-default",
1543 "sheet-collate-supported",
1544 "sides",
1545 "sides-default",
1546 "sides-supported",
1547 "stitching-locations-supported",
1548 "stitching-offset-supported",
1549 "x-image-position",
1550 "x-image-position-default",
1551 "x-image-position-supported",
1552 "x-image-shift",
1553 "x-image-shift-default",
1554 "x-image-shift-supported",
1555 "x-side1-image-shift",
1556 "x-side1-image-shift-default",
1557 "x-side1-image-shift-supported",
1558 "x-side2-image-shift",
1559 "x-side2-image-shift-default",
1560 "x-side2-image-shift-supported",
1561 "y-image-position",
1562 "y-image-position-default",
1563 "y-image-position-supported",
1564 "y-image-shift",
1565 "y-image-shift-default",
1566 "y-image-shift-supported",
1567 "y-side1-image-shift",
1568 "y-side1-image-shift-default",
1569 "y-side1-image-shift-supported",
1570 "y-side2-image-shift",
1571 "y-side2-image-shift-default",
1572 "y-side2-image-shift-supported"
1573 };
1574 static const char * const printer_description[] =
1575 { /* printer-description group */
1576 "auth-info-required", /* CUPS extension */
1577 "charset-configured",
1578 "charset-supported",
1579 "color-supported",
1580 "compression-supported",
1581 "device-service-count",
1582 "device-uri", /* CUPS extension */
1583 "device-uuid",
1584 "document-charset-default",
1585 "document-charset-supported",
1586 "document-creation-attributes-supported",
1587 "document-digital-signature-default",
1588 "document-digital-signature-supported",
1589 "document-format-default",
1590 "document-format-details-default",
1591 "document-format-details-supported",
1592 "document-format-supported",
1593 "document-format-varying-attributes",
1594 "document-format-version-default",
1595 "document-format-version-supported",
1596 "document-natural-language-default",
1597 "document-natural-language-supported",
1598 "document-password-supported",
1599 "generated-natural-language-supported",
1600 "identify-actions-default",
1601 "identify-actions-supported",
1602 "input-source-supported",
1603 "ipp-features-supported",
1604 "ipp-versions-supported",
1605 "ippget-event-life",
1606 "job-authorization-uri-supported", /* CUPS extension */
1607 "job-constraints-supported",
1608 "job-creation-attributes-supported",
1609 "job-finishings-col-ready",
1610 "job-finishings-ready",
1611 "job-ids-supported",
1612 "job-impressions-supported",
1613 "job-k-limit", /* CUPS extension */
1614 "job-k-octets-supported",
1615 "job-media-sheets-supported",
1616 "job-page-limit", /* CUPS extension */
1617 "job-password-encryption-supported",
1618 "job-password-supported",
060016a0 1619 "job-presets-supported", /* IPP Presets */
db8b865d
MS		 1620 "job-quota-period", /* CUPS extension */
1621 "job-resolvers-supported",
1622 "job-settable-attributes-supported",
1623 "job-spooling-supported",
060016a0 1624 "job-triggers-supported", /* IPP Presets */
c5b24bfa
MS		 1625 "jpeg-k-octets-supported", /* CUPS extension */
1626 "jpeg-x-dimension-supported", /* CUPS extension */
1627 "jpeg-y-dimension-supported", /* CUPS extension */
1628 "landscape-orientation-requested-preferred",
1629 /* CUPS extension */
db8b865d
MS		 1630 "marker-change-time", /* CUPS extension */
1631 "marker-colors", /* CUPS extension */
1632 "marker-high-levels", /* CUPS extension */
1633 "marker-levels", /* CUPS extension */
1634 "marker-low-levels", /* CUPS extension */
1635 "marker-message", /* CUPS extension */
1636 "marker-names", /* CUPS extension */
1637 "marker-types", /* CUPS extension */
db8b865d
MS		 1638 "member-names", /* CUPS extension */
1639 "member-uris", /* CUPS extension */
1640 "multiple-destination-uris-supported",/* IPP FaxOut */
1641 "multiple-document-jobs-supported",
1642 "multiple-operation-time-out",
1643 "multiple-operation-time-out-action",
1644 "natural-language-configured",
1645 "operations-supported",
1646 "pages-per-minute",
1647 "pages-per-minute-color",
c5b24bfa 1648 "pdf-k-octets-supported", /* CUPS extension */
87e9bb55 1649 "pdf-features-supported", /* IPP 3D */
c5b24bfa 1650 "pdf-versions-supported", /* CUPS extension */
db8b865d
MS		 1651 "pdl-override-supported",
1652 "port-monitor", /* CUPS extension */
1653 "port-monitor-supported", /* CUPS extension */
1654 "preferred-attributes-supported",
1655 "printer-alert",
1656 "printer-alert-description",
1657 "printer-charge-info",
1658 "printer-charge-info-uri",
1659 "printer-commands", /* CUPS extension */
1660 "printer-current-time",
1661 "printer-detailed-status-messages",
1662 "printer-device-id",
1663 "printer-dns-sd-name", /* CUPS extension */
1664 "printer-driver-installer",
1665 "printer-fax-log-uri", /* IPP FaxOut */
1666 "printer-fax-modem-info", /* IPP FaxOut */
1667 "printer-fax-modem-name", /* IPP FaxOut */
1668 "printer-fax-modem-number", /* IPP FaxOut */
8f787fca
MS		 1669 "printer-firmware-name", /* PWG 5110.1 */
1670 "printer-firmware-patches", /* PWG 5110.1 */
1671 "printer-firmware-string-version", /* PWG 5110.1 */
1672 "printer-firmware-version", /* PWG 5110.1 */
db8b865d
MS		 1673 "printer-geo-location",
1674 "printer-get-attributes-supported",
1675 "printer-icc-profiles",
1676 "printer-icons",
cd3a0368 1677 "printer-id", /* CUPS extension */
db8b865d 1678 "printer-info",
8f787fca 1679 "printer-input-tray", /* IPP JPS3 */
db8b865d 1680 "printer-is-accepting-jobs",
6961465f 1681 "printer-is-shared", /* CUPS extension */
7ae00c35 1682 "printer-is-temporary", /* CUPS extension */
6961465f 1683 "printer-kind", /* IPP Paid Printing */
db8b865d
MS		 1684 "printer-location",
1685 "printer-make-and-model",
1686 "printer-mandatory-job-attributes",
1687 "printer-message-date-time",
1688 "printer-message-from-operator",
1689 "printer-message-time",
1690 "printer-more-info",
1691 "printer-more-info-manufacturer",
1692 "printer-name",
6961465f 1693 "printer-native-formats",
db8b865d
MS		 1694 "printer-organization",
1695 "printer-organizational-unit",
8f787fca 1696 "printer-output-tray", /* IPP JPS3 */
34a63bd9 1697 "printer-queue-id", /* CUPS extension */
db8b865d
MS		 1698 "printer-settable-attributes-supported",
1699 "printer-state",
1700 "printer-state-change-date-time",
1701 "printer-state-change-time",
1702 "printer-state-message",
1703 "printer-state-reasons",
1704 "printer-supply",
1705 "printer-supply-description",
1706 "printer-supply-info-uri",
1707 "printer-type", /* CUPS extension */
1708 "printer-up-time",
1709 "printer-uri-supported",
1710 "printer-uuid",
1711 "printer-xri-supported",
1712 "pwg-raster-document-resolution-supported",
1713 "pwg-raster-document-sheet-back",
1714 "pwg-raster-document-type-supported",
1715 "queued-job-count",
1716 "reference-uri-schemes-supported",
1717 "repertoire-supported",
1718 "requesting-user-name-allowed", /* CUPS extension */
1719 "requesting-user-name-denied", /* CUPS extension */
1720 "requesting-user-uri-supported",
1721 "subordinate-printers-supported",
6961465f 1722 "urf-supported", /* CUPS extension */
db8b865d
MS		 1723 "uri-authentication-supported",
1724 "uri-security-supported",
1725 "user-defined-value-supported",
1726 "which-jobs-supported",
1727 "xri-authentication-supported",
1728 "xri-security-supported",
1729 "xri-uri-scheme-supported"
1730 };
1731 static const char * const subscription_description[] =
1732 { /* subscription-description group */
1733 "notify-job-id",
1734 "notify-lease-expiration-time",
1735 "notify-printer-up-time",
1736 "notify-printer-uri",
1737 "notify-sequence-number",
1738 "notify-subscriber-user-name",
1739 "notify-subscriber-user-uri",
1740 "notify-subscription-id",
1741 "subscriptions-uuid"
1742 };
1743 static const char * const subscription_template[] =
1744 { /* subscription-template group */
1745 "notify-attributes",
1746 "notify-attributes-supported",
1747 "notify-charset",
1748 "notify-events",
1749 "notify-events-default",
1750 "notify-events-supported",
1751 "notify-lease-duration",
1752 "notify-lease-duration-default",
1753 "notify-lease-duration-supported",
1754 "notify-max-events-supported",
1755 "notify-natural-language",
1756 "notify-pull-method",
1757 "notify-pull-method-supported",
1758 "notify-recipient-uri",
1759 "notify-schemes-supported",
1760 "notify-time-interval",
1761 "notify-user-data"
1762 };
1763
1764
1765 /*
1766 * Get the requested-attributes attribute...
1767 */
1768
1769 if ((requested = ippFindAttribute(request, "requested-attributes",
1770 IPP_TAG_KEYWORD)) == NULL)
1771 {
1772 /*
1773 * The Get-Jobs operation defaults to "job-id" and "job-uri", all others
1774 * default to "all"...
1775 */
1776
cb7f98ee 1777 if (ippGetOperation(request) == IPP_OP_GET_JOBS)
db8b865d
MS		 1778 {
1779 ra = cupsArrayNew((cups_array_func_t)strcmp, NULL);
1780 cupsArrayAdd(ra, "job-id");
1781 cupsArrayAdd(ra, "job-uri");
1782
1783 return (ra);
1784 }
1785 else
1786 return (NULL);
1787 }
1788
1789 /*
1790 * If the attribute contains a single "all" keyword, return NULL...
1791 */
1792
1793 count = ippGetCount(requested);
1794 if (count == 1 && !strcmp(ippGetString(requested, 0, NULL), "all"))
1795 return (NULL);
1796
1797 /*
1798 * Create an array using "strcmp" as the comparison function...
1799 */
1800
1801 ra = cupsArrayNew((cups_array_func_t)strcmp, NULL);
1802
1803 for (i = 0; i < count; i ++)
1804 {
1805 added = 0;
1806 value = ippGetString(requested, i, NULL);
1807
1808 if (!strcmp(value, "document-description") || !strcmp(value, "all"))
1809 {
1810 for (j = 0;
1811 j < (int)(sizeof(document_description) /
1812 sizeof(document_description[0]));
1813 j ++)
1814 cupsArrayAdd(ra, (void *)document_description[j]);
1815
1816 added = 1;
1817 }
1818
1819 if (!strcmp(value, "document-template") || !strcmp(value, "all"))
1820 {
1821 for (j = 0;
1822 j < (int)(sizeof(document_template) / sizeof(document_template[0]));
1823 j ++)
1824 cupsArrayAdd(ra, (void *)document_template[j]);
1825
1826 added = 1;
1827 }
1828
1829 if (!strcmp(value, "job-description") || !strcmp(value, "all"))
1830 {
1831 for (j = 0;
1832 j < (int)(sizeof(job_description) / sizeof(job_description[0]));
1833 j ++)
1834 cupsArrayAdd(ra, (void *)job_description[j]);
1835
1836 added = 1;
1837 }
1838
1839 if (!strcmp(value, "job-template") || !strcmp(value, "all"))
1840 {
1841 for (j = 0;
1842 j < (int)(sizeof(job_template) / sizeof(job_template[0]));
1843 j ++)
1844 cupsArrayAdd(ra, (void *)job_template[j]);
1845
1846 added = 1;
1847 }
1848
1849 if (!strcmp(value, "printer-description") || !strcmp(value, "all"))
1850 {
1851 for (j = 0;
1852 j < (int)(sizeof(printer_description) /
1853 sizeof(printer_description[0]));
1854 j ++)
1855 cupsArrayAdd(ra, (void *)printer_description[j]);
1856
1857 added = 1;
1858 }
1859
1860 if (!strcmp(value, "subscription-description") || !strcmp(value, "all"))
1861 {
1862 for (j = 0;
1863 j < (int)(sizeof(subscription_description) /
1864 sizeof(subscription_description[0]));
1865 j ++)
1866 cupsArrayAdd(ra, (void *)subscription_description[j]);
1867
1868 added = 1;
1869 }
1870
1871 if (!strcmp(value, "subscription-template") || !strcmp(value, "all"))
1872 {
1873 for (j = 0;
1874 j < (int)(sizeof(subscription_template) /
1875 sizeof(subscription_template[0]));
1876 j ++)
1877 cupsArrayAdd(ra, (void *)subscription_template[j]);
1878
1879 added = 1;
1880 }
1881
1882 if (!added)
1883 cupsArrayAdd(ra, (void *)value);
1884 }
1885
1886 return (ra);
1887}
1888
1889
a2326b5b
MS		 1890/*
1891 * 'ippEnumString()' - Return a string corresponding to the enum value.
1892 */
1893
1894const char * /* O - Enum string */
1895ippEnumString(const char *attrname, /* I - Attribute name */
1896 int enumvalue) /* I - Enum value */
1897{
1898 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
1899
1900
1901 /*
1902 * Check for standard enum values...
1903 */
1904
1905 if (!strcmp(attrname, "document-state") &&
1906 enumvalue >= 3 &&
0fa6c7fa
MS		 1907 enumvalue < (3 + (int)(sizeof(ipp_document_states) /
1908 sizeof(ipp_document_states[0]))))
a2326b5b 1909 return (ipp_document_states[enumvalue - 3]);
a469f8a5
MS		 1910 else if (!strcmp(attrname, "finishings") ||
1911 !strcmp(attrname, "finishings-actual") ||
1912 !strcmp(attrname, "finishings-default") ||
1913 !strcmp(attrname, "finishings-ready") ||
6961465f
MS		 1914 !strcmp(attrname, "finishings-supported") ||
1915 !strcmp(attrname, "job-finishings") ||
1916 !strcmp(attrname, "job-finishings-default") ||
1917 !strcmp(attrname, "job-finishings-supported"))
a469f8a5
MS		 1918 {
1919 if (enumvalue >= 3 &&
0fa6c7fa
MS		 1920 enumvalue < (3 + (int)(sizeof(ipp_finishings) /
1921 sizeof(ipp_finishings[0]))))
a469f8a5
MS		 1922 return (ipp_finishings[enumvalue - 3]);
1923 else if (enumvalue >= 0x40000000 &&
1924 enumvalue <= (0x40000000 + (int)(sizeof(ipp_finishings_vendor) /
1925 sizeof(ipp_finishings_vendor[0]))))
1926 return (ipp_finishings_vendor[enumvalue - 0x40000000]);
1927 }
a2326b5b
MS		 1928 else if ((!strcmp(attrname, "job-collation-type") ||
1929 !strcmp(attrname, "job-collation-type-actual")) &&
1930 enumvalue >= 3 &&
0fa6c7fa
MS		 1931 enumvalue < (3 + (int)(sizeof(ipp_job_collation_types) /
1932 sizeof(ipp_job_collation_types[0]))))
a2326b5b
MS		 1933 return (ipp_job_collation_types[enumvalue - 3]);
1934 else if (!strcmp(attrname, "job-state") &&
cb7f98ee
MS		 1935 enumvalue >= IPP_JSTATE_PENDING && enumvalue <= IPP_JSTATE_COMPLETED)
1936 return (ipp_job_states[enumvalue - IPP_JSTATE_PENDING]);
a2326b5b
MS		 1937 else if (!strcmp(attrname, "operations-supported"))
1938 return (ippOpString((ipp_op_t)enumvalue));
1939 else if ((!strcmp(attrname, "orientation-requested") ||
1940 !strcmp(attrname, "orientation-requested-actual") ||
1941 !strcmp(attrname, "orientation-requested-default") ||
1942 !strcmp(attrname, "orientation-requested-supported")) &&
1943 enumvalue >= 3 &&
0fa6c7fa
MS		 1944 enumvalue < (3 + (int)(sizeof(ipp_orientation_requesteds) /
1945 sizeof(ipp_orientation_requesteds[0]))))
a2326b5b
MS		 1946 return (ipp_orientation_requesteds[enumvalue - 3]);
1947 else if ((!strcmp(attrname, "print-quality") ||
1948 !strcmp(attrname, "print-quality-actual") ||
1949 !strcmp(attrname, "print-quality-default") ||
1950 !strcmp(attrname, "print-quality-supported")) &&
1951 enumvalue >= 3 &&
0fa6c7fa
MS		 1952 enumvalue < (3 + (int)(sizeof(ipp_print_qualities) /
1953 sizeof(ipp_print_qualities[0]))))
a2326b5b
MS		 1954 return (ipp_print_qualities[enumvalue - 3]);
1955 else if (!strcmp(attrname, "printer-state") &&
cb7f98ee
MS		 1956 enumvalue >= IPP_PSTATE_IDLE && enumvalue <= IPP_PSTATE_STOPPED)
1957 return (ipp_printer_states[enumvalue - IPP_PSTATE_IDLE]);
a2326b5b
MS		 1958
1959 /*
1960 * Not a standard enum value, just return the decimal equivalent...
1961 */
1962
1963 snprintf(cg->ipp_unknown, sizeof(cg->ipp_unknown), "%d", enumvalue);
1964 return (cg->ipp_unknown);
1965}
1966
1967
1968/*
1969 * 'ippEnumValue()' - Return the value associated with a given enum string.
1970 */
1971
1972int /* O - Enum value or -1 if unknown */
1973ippEnumValue(const char *attrname, /* I - Attribute name */
1974 const char *enumstring) /* I - Enum string */
1975{
1976 int i, /* Looping var */
1977 num_strings; /* Number of strings to compare */
1978 const char * const *strings; /* Strings to compare */
1979
1980
1981 /*
1982 * If the string is just a number, return it...
1983 */
1984
1985 if (isdigit(*enumstring & 255))
7e86f2f6 1986 return ((int)strtol(enumstring, NULL, 0));
a2326b5b
MS		 1987
1988 /*
1989 * Otherwise look up the string...
1990 */
1991
1992 if (!strcmp(attrname, "document-state"))
1993 {
1994 num_strings = (int)(sizeof(ipp_document_states) / sizeof(ipp_document_states[0]));
1995 strings = ipp_document_states;
1996 }
1997 else if (!strcmp(attrname, "finishings") ||
1998 !strcmp(attrname, "finishings-actual") ||
1999 !strcmp(attrname, "finishings-default") ||
2000 !strcmp(attrname, "finishings-ready") ||
2001 !strcmp(attrname, "finishings-supported"))
2002 {
a469f8a5
MS		 2003 for (i = 0;
2004 i < (int)(sizeof(ipp_finishings_vendor) /
2005 sizeof(ipp_finishings_vendor[0]));
2006 i ++)
2007 if (!strcmp(enumstring, ipp_finishings_vendor[i]))
2008 return (i + 0x40000000);
2009
a2326b5b
MS		 2010 num_strings = (int)(sizeof(ipp_finishings) / sizeof(ipp_finishings[0]));
2011 strings = ipp_finishings;
2012 }
2013 else if (!strcmp(attrname, "job-collation-type") ||
2014 !strcmp(attrname, "job-collation-type-actual"))
2015 {
2016 num_strings = (int)(sizeof(ipp_job_collation_types) /
2017 sizeof(ipp_job_collation_types[0]));
2018 strings = ipp_job_collation_types;
2019 }
2020 else if (!strcmp(attrname, "job-state"))
2021 {
2022 num_strings = (int)(sizeof(ipp_job_states) / sizeof(ipp_job_states[0]));
2023 strings = ipp_job_states;
2024 }
2025 else if (!strcmp(attrname, "operations-supported"))
2026 return (ippOpValue(enumstring));
2027 else if (!strcmp(attrname, "orientation-requested") ||
2028 !strcmp(attrname, "orientation-requested-actual") ||
2029 !strcmp(attrname, "orientation-requested-default") ||
2030 !strcmp(attrname, "orientation-requested-supported"))
2031 {
2032 num_strings = (int)(sizeof(ipp_orientation_requesteds) /
2033 sizeof(ipp_orientation_requesteds[0]));
2034 strings = ipp_orientation_requesteds;
2035 }
2036 else if (!strcmp(attrname, "print-quality") ||
2037 !strcmp(attrname, "print-quality-actual") ||
2038 !strcmp(attrname, "print-quality-default") ||
2039 !strcmp(attrname, "print-quality-supported"))
2040 {
2041 num_strings = (int)(sizeof(ipp_print_qualities) / sizeof(ipp_print_qualities[0]));
2042 strings = ipp_print_qualities;
2043 }
2044 else if (!strcmp(attrname, "printer-state"))
2045 {
2046 num_strings = (int)(sizeof(ipp_printer_states) / sizeof(ipp_printer_states[0]));
2047 strings = ipp_printer_states;
2048 }
2049 else
2050 return (-1);
2051
2052 for (i = 0; i < num_strings; i ++)
2053 if (!strcmp(enumstring, strings[i]))
2054 return (i + 3);
2055
2056 return (-1);
2057}
2058
2059
ef416fc2 2060/*
2061 * 'ippErrorString()' - Return a name for the given status code.
2062 */
2063
2064const char * /* O - Text string */
2065ippErrorString(ipp_status_t error) /* I - Error status */
2066{
2067 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
2068
2069
2070 /*
2071 * See if the error code is a known value...
2072 */
2073
a469f8a5 2074 if (error >= IPP_STATUS_OK && error <= IPP_STATUS_OK_EVENTS_COMPLETE)
ef416fc2 2075 return (ipp_status_oks[error]);
a469f8a5 2076 else if (error == IPP_STATUS_REDIRECTION_OTHER_SITE)
ef416fc2 2077 return ("redirection-other-site");
a469f8a5 2078 else if (error == IPP_STATUS_CUPS_SEE_OTHER)
b94498cf 2079 return ("cups-see-other");
a469f8a5 2080 else if (error >= IPP_STATUS_ERROR_BAD_REQUEST &&
6b13fa61 2081 error <= IPP_STATUS_ERROR_ACCOUNT_AUTHORIZATION_FAILED)
a469f8a5
MS		 2082 return (ipp_status_400s[error - IPP_STATUS_ERROR_BAD_REQUEST]);
2083 else if (error >= 0x480 &&
2084 error <= IPP_STATUS_ERROR_CUPS_ACCOUNT_AUTHORIZATION_FAILED)
2085 return (ipp_status_480s[error - 0x0480]);
2086 else if (error >= IPP_STATUS_ERROR_INTERNAL &&
2087 error <= IPP_STATUS_ERROR_TOO_MANY_DOCUMENTS)
2088 return (ipp_status_500s[error - IPP_STATUS_ERROR_INTERNAL]);
2089 else if (error >= IPP_STATUS_ERROR_CUPS_AUTHENTICATION_CANCELED &&
2090 error <= IPP_STATUS_ERROR_CUPS_UPGRADE_REQUIRED)
2091 return (ipp_status_1000s[error -
2092 IPP_STATUS_ERROR_CUPS_AUTHENTICATION_CANCELED]);
ef416fc2 2093
2094 /*
d7225fc2 2095 * No, build an "0xxxxx" error string...
ef416fc2 2096 */
2097
d7225fc2 2098 sprintf(cg->ipp_unknown, "0x%04x", error);
ef416fc2 2099
2100 return (cg->ipp_unknown);
2101}
2102
2103
2104/*
2105 * 'ippErrorValue()' - Return a status code for the given name.
2106 *
8072030b 2107 * @since CUPS 1.2/macOS 10.5@
ef416fc2 2108 */
2109
2110ipp_status_t /* O - IPP status code */
2111ippErrorValue(const char *name) /* I - Name */
2112{
7e86f2f6 2113 size_t i; /* Looping var */
ef416fc2 2114
2115
2116 for (i = 0; i < (sizeof(ipp_status_oks) / sizeof(ipp_status_oks[0])); i ++)
88f9aafc 2117 if (!_cups_strcasecmp(name, ipp_status_oks[i]))
ef416fc2 2118 return ((ipp_status_t)i);
2119
88f9aafc 2120 if (!_cups_strcasecmp(name, "redirection-other-site"))
a469f8a5 2121 return (IPP_STATUS_REDIRECTION_OTHER_SITE);
ef416fc2 2122
88f9aafc 2123 if (!_cups_strcasecmp(name, "cups-see-other"))
a469f8a5 2124 return (IPP_STATUS_CUPS_SEE_OTHER);
b94498cf 2125
ef416fc2 2126 for (i = 0; i < (sizeof(ipp_status_400s) / sizeof(ipp_status_400s[0])); i ++)
88f9aafc 2127 if (!_cups_strcasecmp(name, ipp_status_400s[i]))
ef416fc2 2128 return ((ipp_status_t)(i + 0x400));
2129
a469f8a5
MS		 2130 for (i = 0; i < (sizeof(ipp_status_480s) / sizeof(ipp_status_480s[0])); i ++)
2131 if (!_cups_strcasecmp(name, ipp_status_480s[i]))
2132 return ((ipp_status_t)(i + 0x480));
2133
ef416fc2 2134 for (i = 0; i < (sizeof(ipp_status_500s) / sizeof(ipp_status_500s[0])); i ++)
88f9aafc 2135 if (!_cups_strcasecmp(name, ipp_status_500s[i]))
ef416fc2 2136 return ((ipp_status_t)(i + 0x500));
2137
7cf5915e 2138 for (i = 0; i < (sizeof(ipp_status_1000s) / sizeof(ipp_status_1000s[0])); i ++)
88f9aafc 2139 if (!_cups_strcasecmp(name, ipp_status_1000s[i]))
7cf5915e
MS		 2140 return ((ipp_status_t)(i + 0x1000));
2141
ef416fc2 2142 return ((ipp_status_t)-1);
2143}
2144
2145
2146/*
2147 * 'ippOpString()' - Return a name for the given operation id.
2148 *
8072030b 2149 * @since CUPS 1.2/macOS 10.5@
ef416fc2 2150 */
2151
2152const char * /* O - Name */
2153ippOpString(ipp_op_t op) /* I - Operation ID */
2154{
2155 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
2156
2157
2158 /*
2159 * See if the operation ID is a known value...
2160 */
2161
4888dff9 2162 if (op >= IPP_OP_PRINT_JOB && op < (ipp_op_t)(sizeof(ipp_std_ops) / sizeof(ipp_std_ops[0])))
ef416fc2 2163 return (ipp_std_ops[op]);
a469f8a5 2164 else if (op == IPP_OP_PRIVATE)
ef416fc2 2165 return ("windows-ext");
a469f8a5 2166 else if (op >= IPP_OP_CUPS_GET_DEFAULT && op <= IPP_OP_CUPS_GET_PPD)
cb7f98ee 2167 return (ipp_cups_ops[op - IPP_OP_CUPS_GET_DEFAULT]);
c585706d
MS		 2168 else if (op >= IPP_OP_CUPS_GET_DOCUMENT && op <= IPP_OP_CUPS_CREATE_LOCAL_PRINTER)
2169 return (ipp_cups_ops2[op - IPP_OP_CUPS_GET_DOCUMENT]);
ef416fc2 2170
2171 /*
d7225fc2 2172 * No, build an "0xxxxx" operation string...
ef416fc2 2173 */
2174
9b66acc5 2175 sprintf(cg->ipp_unknown, "0x%04x", op);
ef416fc2 2176
2177 return (cg->ipp_unknown);
2178}
2179
2180
2181/*
2182 * 'ippOpValue()' - Return an operation id for the given name.
2183 *
8072030b 2184 * @since CUPS 1.2/macOS 10.5@
ef416fc2 2185 */
2186
2187ipp_op_t /* O - Operation ID */
2188ippOpValue(const char *name) /* I - Textual name */
2189{
7e86f2f6 2190 size_t i; /* Looping var */
ef416fc2 2191
2192
9b66acc5
MS		 2193 if (!strncmp(name, "0x", 2))
2194 return ((ipp_op_t)strtol(name + 2, NULL, 16));
2195
ef416fc2 2196 for (i = 0; i < (sizeof(ipp_std_ops) / sizeof(ipp_std_ops[0])); i ++)
88f9aafc 2197 if (!_cups_strcasecmp(name, ipp_std_ops[i]))
ef416fc2 2198 return ((ipp_op_t)i);
2199
88f9aafc 2200 if (!_cups_strcasecmp(name, "windows-ext"))
a469f8a5 2201 return (IPP_OP_PRIVATE);
ef416fc2 2202
2203 for (i = 0; i < (sizeof(ipp_cups_ops) / sizeof(ipp_cups_ops[0])); i ++)
88f9aafc 2204 if (!_cups_strcasecmp(name, ipp_cups_ops[i]))
ef416fc2 2205 return ((ipp_op_t)(i + 0x4001));
2206
2e4ff8af 2207 for (i = 0; i < (sizeof(ipp_cups_ops2) / sizeof(ipp_cups_ops2[0])); i ++)
88f9aafc 2208 if (!_cups_strcasecmp(name, ipp_cups_ops2[i]))
2e4ff8af
MS		 2209 return ((ipp_op_t)(i + 0x4027));
2210
42404685
MS		 2211 if (!_cups_strcasecmp(name, "Create-Job-Subscription"))
2212 return (IPP_OP_CREATE_JOB_SUBSCRIPTIONS);
2213
2214 if (!_cups_strcasecmp(name, "Create-Printer-Subscription"))
2215 return (IPP_OP_CREATE_PRINTER_SUBSCRIPTIONS);
2216
88f9aafc 2217 if (!_cups_strcasecmp(name, "CUPS-Add-Class"))
a469f8a5 2218 return (IPP_OP_CUPS_ADD_MODIFY_CLASS);
480ef0fe 2219
88f9aafc 2220 if (!_cups_strcasecmp(name, "CUPS-Add-Printer"))
a469f8a5 2221 return (IPP_OP_CUPS_ADD_MODIFY_PRINTER);
480ef0fe 2222
a469f8a5 2223 return (IPP_OP_CUPS_INVALID);
ef416fc2 2224}
2225
2226
2227/*
2228 * 'ippPort()' - Return the default IPP port number.
2229 */
2230
2231int /* O - Port number */
2232ippPort(void)
2233{
ef416fc2 2234 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
2235
2236
d09495fa 2237 DEBUG_puts("ippPort()");
2238
2239 if (!cg->ipp_port)
e07d4801 2240 _cupsSetDefaults();
d09495fa 2241
e07d4801 2242 DEBUG_printf(("1ippPort: Returning %d...", cg->ipp_port));
d09495fa 2243
ef416fc2 2244 return (cg->ipp_port);
2245}
2246
2247
2248/*
2249 * 'ippSetPort()' - Set the default port number.
2250 */
2251
2252void
2253ippSetPort(int p) /* I - Port number to use */
2254{
e07d4801 2255 DEBUG_printf(("ippSetPort(p=%d)", p));
d09495fa 2256
ef416fc2 2257 _cupsGlobals()->ipp_port = p;
2258}
2259
2260
d21dc0ed
MS		 2261/*
2262 * 'ippStateString()' - Return the name corresponding to a state value.
2263 *
e1f19878 2264 * @since CUPS 2.0/OS 10.10@
d21dc0ed
MS		 2265 */
2266
2267const char * /* O - State name */
2268ippStateString(ipp_state_t state) /* I - State value */
2269{
2270 if (state >= IPP_STATE_ERROR && state <= IPP_STATE_DATA)
2271 return (ipp_states[state - IPP_STATE_ERROR]);
2272 else
2273 return ("UNKNOWN");
2274}
2275
2276
ef416fc2 2277/*
1ff0402e
MS		 2278 * 'ippTagString()' - Return the tag name corresponding to a tag value.
2279 *
65bebeac 2280 * The returned names are defined in RFC 8011 and the IANA IPP Registry.
1ff0402e 2281 *
8072030b 2282 * @since CUPS 1.4/macOS 10.6@
1ff0402e
MS		 2283 */
2284
2285const char * /* O - Tag name */
2286ippTagString(ipp_tag_t tag) /* I - Tag value */
2287{
cb7f98ee 2288 tag &= IPP_TAG_CUPS_MASK;
ed6e7faf 2289
1ff0402e
MS		 2290 if (tag < (ipp_tag_t)(sizeof(ipp_tag_names) / sizeof(ipp_tag_names[0])))
2291 return (ipp_tag_names[tag]);
2292 else
2293 return ("UNKNOWN");
2294}
2295
2296
2297/*
2298 * 'ippTagValue()' - Return the tag value corresponding to a tag name.
2299 *
65bebeac 2300 * The tag names are defined in RFC 8011 and the IANA IPP Registry.
1ff0402e 2301 *
8072030b 2302 * @since CUPS 1.4/macOS 10.6@
1ff0402e
MS		 2303 */
2304
2305ipp_tag_t /* O - Tag value */
2306ippTagValue(const char *name) /* I - Tag name */
2307{
7e86f2f6 2308 size_t i; /* Looping var */
1ff0402e
MS		 2309
2310
2311 for (i = 0; i < (sizeof(ipp_tag_names) / sizeof(ipp_tag_names[0])); i ++)
88f9aafc 2312 if (!_cups_strcasecmp(name, ipp_tag_names[i]))
1ff0402e
MS		 2313 return ((ipp_tag_t)i);
2314
88f9aafc 2315 if (!_cups_strcasecmp(name, "operation"))
1ff0402e 2316 return (IPP_TAG_OPERATION);
88f9aafc 2317 else if (!_cups_strcasecmp(name, "job"))
1ff0402e 2318 return (IPP_TAG_JOB);
88f9aafc 2319 else if (!_cups_strcasecmp(name, "printer"))
1ff0402e 2320 return (IPP_TAG_PRINTER);
88f9aafc 2321 else if (!_cups_strcasecmp(name, "unsupported"))
5a6b583a 2322 return (IPP_TAG_UNSUPPORTED_GROUP);
88f9aafc 2323 else if (!_cups_strcasecmp(name, "subscription"))
1ff0402e 2324 return (IPP_TAG_SUBSCRIPTION);
88f9aafc 2325 else if (!_cups_strcasecmp(name, "event"))
5a6b583a 2326 return (IPP_TAG_EVENT_NOTIFICATION);
88f9aafc 2327 else if (!_cups_strcasecmp(name, "language"))
1ff0402e 2328 return (IPP_TAG_LANGUAGE);
88f9aafc 2329 else if (!_cups_strcasecmp(name, "mimetype"))
1ff0402e 2330 return (IPP_TAG_MIMETYPE);
88f9aafc 2331 else if (!_cups_strcasecmp(name, "name"))
1ff0402e 2332 return (IPP_TAG_NAME);
88f9aafc 2333 else if (!_cups_strcasecmp(name, "text"))
1ff0402e 2334 return (IPP_TAG_TEXT);
88f9aafc 2335 else if (!_cups_strcasecmp(name, "begCollection"))
5a6b583a 2336 return (IPP_TAG_BEGIN_COLLECTION);
1ff0402e
MS		 2337 else
2338 return (IPP_TAG_ZERO);
2339}
2340
2341
2342/*
1106b00e
MS		 2343 * 'ipp_col_string()' - Convert a collection to a string.
2344 */
2345
2346static size_t /* O - Number of bytes */
2347ipp_col_string(ipp_t *col, /* I - Collection attribute */
2348 char *buffer, /* I - Buffer or NULL */
2349 size_t bufsize) /* I - Size of buffer */
2350{
2351 char *bufptr, /* Position in buffer */
2352 *bufend, /* End of buffer */
9c80ffa2 2353 prefix = '{', /* Prefix character */
1106b00e
MS		 2354 temp[256]; /* Temporary string */
2355 ipp_attribute_t *attr; /* Current member attribute */
2356
2357
2c69d462
MS		 2358 if (!col)
2359 {
2360 if (buffer)
2361 *buffer = '\0';
2362
2363 return (0);
2364 }
2365
1106b00e
MS		 2366 bufptr = buffer;
2367 bufend = buffer + bufsize - 1;
2368
1106b00e
MS		 2369 for (attr = col->attrs; attr; attr = attr->next)
2370 {
2371 if (!attr->name)
2372 continue;
2373
9c80ffa2
MS		 2374 if (buffer && bufptr < bufend)
2375 *bufptr = prefix;
2376 bufptr ++;
2377 prefix = ' ';
2378
1106b00e 2379 if (buffer && bufptr < bufend)
07623986 2380 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%s=", attr->name);
1106b00e
MS		 2381 else
2382 bufptr += strlen(attr->name) + 1;
2383
2384 if (buffer && bufptr < bufend)
7e86f2f6 2385 bufptr += ippAttributeString(attr, bufptr, (size_t)(bufend - bufptr + 1));
1106b00e 2386 else
a2326b5b 2387 bufptr += ippAttributeString(attr, temp, sizeof(temp));
1106b00e
MS		 2388 }
2389
9c80ffa2
MS		 2390 if (prefix == '{')
2391 {
2392 if (buffer && bufptr < bufend)
2393 *bufptr = prefix;
2394 bufptr ++;
2395 }
2396
1106b00e
MS		 2397 if (buffer && bufptr < bufend)
2398 *bufptr = '}';
2399 bufptr ++;
2400
7e86f2f6 2401 return ((size_t)(bufptr - buffer));
1106b00e 2402}
Unnamed repository; edit this file 'description' to name the repository.