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