]> 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
Update documentation for cupsd - "-s" option was not mentioned (STR #4772)
[thirdparty/cups.git] / cups / ipp-support.c
CommitLineData
ef416fc2 1/*
f2d18633 2 * "$Id$"
ef416fc2 3 *
d21dc0ed 4 * Internet Printing Protocol support functions for CUPS.
ef416fc2 5 *
7e86f2f6 6 * Copyright 2007-2014 by Apple Inc.
d21dc0ed 7 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
ef416fc2 8 *
d21dc0ed
MS		 9 * These coded instructions, statements, and computer programs are the
10 * property of Apple Inc. and are protected by Federal copyright
11 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 * which should have been included with this file. If this file is
13 * file is missing or damaged, see the license at "http://www.cups.org/".
ef416fc2 14 *
d21dc0ed 15 * This file is subject to the Apple OS-Developed Software exception.
ef416fc2 16 */
17
18/*
19 * Include necessary headers...
20 */
21
71e16022 22#include "cups-private.h"
ef416fc2 23
24
25/*
26 * Local globals...
27 */
28
d21dc0ed
MS		 29static const char * const ipp_states[] =
30 {
31 "IPP_STATE_ERROR",
32 "IPP_STATE_IDLE",
33 "IPP_STATE_HEADER",
34 "IPP_STATE_ATTRIBUTE",
35 "IPP_STATE_DATA"
36 };
ef416fc2 37static const char * const ipp_status_oks[] = /* "OK" status codes */
a2326b5b 38 { /* (name) = abandoned standard value */
ef416fc2 39 "successful-ok",
40 "successful-ok-ignored-or-substituted-attributes",
41 "successful-ok-conflicting-attributes",
42 "successful-ok-ignored-subscriptions",
a2326b5b 43 "(successful-ok-ignored-notifications)",
ef416fc2 44 "successful-ok-too-many-events",
a2326b5b 45 "(successful-ok-but-cancel-subscription)",
bd7854cb 46 "successful-ok-events-complete"
ef416fc2 47 },
48 * const ipp_status_400s[] = /* Client errors */
a2326b5b 49 { /* (name) = abandoned standard value */
ef416fc2 50 "client-error-bad-request",
51 "client-error-forbidden",
52 "client-error-not-authenticated",
53 "client-error-not-authorized",
54 "client-error-not-possible",
55 "client-error-timeout",
56 "client-error-not-found",
57 "client-error-gone",
58 "client-error-request-entity-too-large",
59 "client-error-request-value-too-long",
60 "client-error-document-format-not-supported",
61 "client-error-attributes-or-values-not-supported",
62 "client-error-uri-scheme-not-supported",
63 "client-error-charset-not-supported",
64 "client-error-conflicting-attributes",
65 "client-error-compression-not-supported",
66 "client-error-compression-error",
67 "client-error-document-format-error",
68 "client-error-document-access-error",
69 "client-error-attributes-not-settable",
70 "client-error-ignored-all-subscriptions",
71 "client-error-too-many-subscriptions",
a2326b5b 72 "(client-error-ignored-all-notifications)",
82cc1f9a
MS		 73 "(client-error-client-print-support-file-not-found)",
74 "client-error-document-password-error",
75 "client-error-document-permission-error",
76 "client-error-document-security-error",
6b13fa61
MS		 77 "client-error-document-unprintable-error",
78 "client-error-account-info-needed",
79 "client-error-account-closed",
80 "client-error-account-limit-reached",
c47d4869
MS		 81 "client-error-account-authorization-failed",
82 "client-error-not-fetchable"
ef416fc2 83 },
a469f8a5
MS		 84 * const ipp_status_480s[] = /* Vendor client errors */
85 {
86 /* 0x0480 - 0x048F */
87 "0x0480",
88 "0x0481",
89 "0x0482",
90 "0x0483",
91 "0x0484",
92 "0x0485",
93 "0x0486",
94 "0x0487",
95 "0x0488",
96 "0x0489",
97 "0x048A",
98 "0x048B",
99 "0x048C",
100 "0x048D",
101 "0x048E",
102 "0x048F",
103 /* 0x0490 - 0x049F */
104 "0x0490",
105 "0x0491",
106 "0x0492",
107 "0x0493",
108 "0x0494",
109 "0x0495",
110 "0x0496",
111 "0x0497",
112 "0x0498",
113 "0x0499",
114 "0x049A",
115 "0x049B",
116 "cups-error-account-info-needed",
117 "cups-error-account-closed",
118 "cups-error-account-limit-reached",
119 "cups-error-account-authorization-failed"
120 },
ef416fc2 121 * const ipp_status_500s[] = /* Server errors */
122 {
123 "server-error-internal-error",
124 "server-error-operation-not-supported",
125 "server-error-service-unavailable",
126 "server-error-version-not-supported",
127 "server-error-device-error",
128 "server-error-temporary-error",
129 "server-error-not-accepting-jobs",
130 "server-error-busy",
131 "server-error-job-canceled",
132 "server-error-multiple-document-jobs-not-supported",
a2326b5b
MS		 133 "server-error-printer-is-deactivated",
134 "server-error-too-many-jobs",
135 "server-error-too-many-documents"
7cf5915e
MS		 136 },
137 * const ipp_status_1000s[] = /* CUPS internal */
138 {
a469f8a5 139 "cups-authentication-canceled",
7cf5915e
MS		 140 "cups-pki-error",
141 "cups-upgrade-required"
ef416fc2 142 };
a2326b5b 143static const char * const ipp_std_ops[] =
ef416fc2 144 {
145 /* 0x0000 - 0x000f */
db8b865d
MS		 146 "0x0000",
147 "0x0001",
aaf19ab0
MS		 148 "Print-Job",
149 "Print-URI",
150 "Validate-Job",
151 "Create-Job",
152 "Send-Document",
153 "Send-URI",
154 "Cancel-Job",
155 "Get-Job-Attributes",
156 "Get-Jobs",
157 "Get-Printer-Attributes",
158 "Hold-Job",
159 "Release-Job",
160 "Restart-Job",
db8b865d 161 "0x000f",
ef416fc2 162
163 /* 0x0010 - 0x001f */
aaf19ab0
MS		 164 "Pause-Printer",
165 "Resume-Printer",
166 "Purge-Jobs",
167 "Set-Printer-Attributes",
ef416fc2 168 "Set-Job-Attributes",
169 "Get-Printer-Supported-Values",
42404685
MS		 170 "Create-Printer-Subscriptions",
171 "Create-Job-Subscriptions",
ef416fc2 172 "Get-Subscription-Attributes",
aaf19ab0
MS		 173 "Get-Subscriptions",
174 "Renew-Subscription",
175 "Cancel-Subscription",
176 "Get-Notifications",
a2326b5b
MS		 177 "(Send-Notifications)",
178 "(Get-Resource-Attributes)",
179 "(Get-Resource-Data)",
ef416fc2 180
181 /* 0x0020 - 0x002f */
a2326b5b
MS		 182 "(Get-Resources)",
183 "(Get-Printer-Support-Files)",
ef416fc2 184 "Enable-Printer",
185 "Disable-Printer",
186 "Pause-Printer-After-Current-Job",
187 "Hold-New-Jobs",
188 "Release-Held-New-Jobs",
189 "Deactivate-Printer",
190 "Activate-Printer",
191 "Restart-Printer",
192 "Shutdown-Printer",
193 "Startup-Printer",
194 "Reprocess-Job",
195 "Cancel-Current-Job",
196 "Suspend-Current-Job",
197 "Resume-Job",
198
9b4bd602 199 /* 0x0030 - 0x003f */
ef416fc2 200 "Promote-Job",
aaf19ab0 201 "Schedule-Job-After",
db8b865d 202 "0x0032",
aaf19ab0
MS		 203 "Cancel-Document",
204 "Get-Document-Attributes",
205 "Get-Documents",
206 "Delete-Document",
207 "Set-Document-Attributes",
208 "Cancel-Jobs",
209 "Cancel-My-Jobs",
210 "Resubmit-Job",
771bd8cb 211 "Close-Job",
82cc1f9a 212 "Identify-Printer",
9475ec92 213 "Validate-Document",
9b4bd602
MS		 214 "Send-Hardcopy-Document",
215 "Acknowledge-Document",
216
217 /* 0x0040 - 0x004a */
218 "Acknowledge-Identify-Printer",
219 "Acknowledge-Job",
220 "Fetch-Document",
221 "Fetch-Job",
222 "Get-Output-Device-Attributes",
223 "Update-Active-Jobs",
224 "Deregister-Output-Device",
225 "Update-Document-Status",
226 "Update-Job-Status",
227 "Update-Output-Device-Attributes",
228 "Get-Next-Document-Data"
ef416fc2 229 },
230 * const ipp_cups_ops[] =
231 {
232 "CUPS-Get-Default",
233 "CUPS-Get-Printers",
480ef0fe 234 "CUPS-Add-Modify-Printer",
ef416fc2 235 "CUPS-Delete-Printer",
236 "CUPS-Get-Classes",
480ef0fe 237 "CUPS-Add-Modify-Class",
ef416fc2 238 "CUPS-Delete-Class",
239 "CUPS-Accept-Jobs",
240 "CUPS-Reject-Jobs",
241 "CUPS-Set-Default",
242 "CUPS-Get-Devices",
243 "CUPS-Get-PPDs",
244 "CUPS-Move-Job",
b94498cf 245 "CUPS-Authenticate-Job",
246 "CUPS-Get-PPD"
2e4ff8af
MS		 247 },
248 * const ipp_cups_ops2[] =
249 {
250 "CUPS-Get-Document"
1ff0402e
MS		 251 },
252 * const ipp_tag_names[] =
253 { /* Value/group tag names */
254 "zero", /* 0x00 */
255 "operation-attributes-tag",
256 /* 0x01 */
257 "job-attributes-tag", /* 0x02 */
258 "end-of-attributes-tag",
259 /* 0x03 */
260 "printer-attributes-tag",
261 /* 0x04 */
262 "unsupported-attributes-tag",
263 /* 0x05 */
264 "subscription-attributes-tag",
265 /* 0x06 */
266 "event-notification-attributes-tag",
267 /* 0x07 */
a2326b5b
MS		 268 "(resource-attributes-tag)",
269 /* 0x08 */
d7225fc2
MS		 270 "document-attributes-tag",
271 /* 0x09 */
272 "0x0a", /* 0x0a */
273 "0x0b", /* 0x0b */
274 "0x0c", /* 0x0c */
275 "0x0d", /* 0x0d */
276 "0x0e", /* 0x0e */
277 "0x0f", /* 0x0f */
1ff0402e
MS		 278 "unsupported", /* 0x10 */
279 "default", /* 0x11 */
280 "unknown", /* 0x12 */
281 "no-value", /* 0x13 */
d7225fc2 282 "0x14", /* 0x14 */
1ff0402e
MS		 283 "not-settable", /* 0x15 */
284 "delete-attribute", /* 0x16 */
285 "admin-define", /* 0x17 */
d7225fc2
MS		 286 "0x18", /* 0x18 */
287 "0x19", /* 0x19 */
288 "0x1a", /* 0x1a */
289 "0x1b", /* 0x1b */
290 "0x1c", /* 0x1c */
291 "0x1d", /* 0x1d */
292 "0x1e", /* 0x1e */
293 "0x1f", /* 0x1f */
294 "0x20", /* 0x20 */
1ff0402e
MS		 295 "integer", /* 0x21 */
296 "boolean", /* 0x22 */
297 "enum", /* 0x23 */
d7225fc2
MS		 298 "0x24", /* 0x24 */
299 "0x25", /* 0x25 */
300 "0x26", /* 0x26 */
301 "0x27", /* 0x27 */
302 "0x28", /* 0x28 */
303 "0x29", /* 0x29 */
304 "0x2a", /* 0x2a */
305 "0x2b", /* 0x2b */
306 "0x2c", /* 0x2c */
307 "0x2d", /* 0x2d */
308 "0x2e", /* 0x2e */
309 "0x2f", /* 0x2f */
1ff0402e
MS		 310 "octetString", /* 0x30 */
311 "dateTime", /* 0x31 */
312 "resolution", /* 0x32 */
313 "rangeOfInteger", /* 0x33 */
f8b3a85b 314 "collection", /* 0x34 */
1ff0402e
MS		 315 "textWithLanguage", /* 0x35 */
316 "nameWithLanguage", /* 0x36 */
317 "endCollection", /* 0x37 */
d7225fc2
MS		 318 "0x38", /* 0x38 */
319 "0x39", /* 0x39 */
320 "0x3a", /* 0x3a */
321 "0x3b", /* 0x3b */
322 "0x3c", /* 0x3c */
323 "0x3d", /* 0x3d */
324 "0x3e", /* 0x3e */
325 "0x3f", /* 0x3f */
326 "0x40", /* 0x40 */
1ff0402e
MS		 327 "textWithoutLanguage",/* 0x41 */
328 "nameWithoutLanguage",/* 0x42 */
d7225fc2 329 "0x43", /* 0x43 */
1ff0402e
MS		 330 "keyword", /* 0x44 */
331 "uri", /* 0x45 */
332 "uriScheme", /* 0x46 */
333 "charset", /* 0x47 */
334 "naturalLanguage", /* 0x48 */
335 "mimeMediaType", /* 0x49 */
336 "memberAttrName" /* 0x4a */
ef416fc2 337 };
a2326b5b
MS		 338static const char * const ipp_document_states[] =
339 { /* document-state-enums */
340 "pending",
341 "4",
342 "processing",
cd3614ae 343 "processing-stopped", /* IPPSIX */
a2326b5b
MS		 344 "canceled",
345 "aborted",
346 "completed"
347 },
348 * const ipp_finishings[] =
349 { /* finishings enums */
350 "none",
351 "staple",
352 "punch",
353 "cover",
354 "bind",
355 "saddle-stitch",
356 "edge-stitch",
357 "fold",
358 "trim",
359 "bale",
360 "booklet-maker",
361 "jog-offset",
cd3614ae
MS		 362 "coat", /* Finishings 2.0 */
363 "laminate", /* Finishings 2.0 */
a2326b5b
MS		 364 "17",
365 "18",
366 "19",
367 "staple-top-left",
368 "staple-bottom-left",
369 "staple-top-right",
370 "staple-bottom-right",
371 "edge-stitch-left",
372 "edge-stitch-top",
373 "edge-stitch-right",
374 "edge-stitch-bottom",
375 "staple-dual-left",
376 "staple-dual-top",
377 "staple-dual-right",
378 "staple-dual-bottom",
cd3614ae
MS		 379 "staple-triple-left", /* Finishings 2.0 */
380 "staple-triple-top", /* Finishings 2.0 */
381 "staple-triple-right",/* Finishings 2.0 */
382 "staple-triple-bottom",/* Finishings 2.0 */
a2326b5b
MS		 383 "36",
384 "37",
385 "38",
386 "39",
387 "40",
388 "41",
389 "42",
390 "43",
391 "44",
392 "45",
393 "46",
394 "47",
395 "48",
396 "49",
397 "bind-left",
398 "bind-top",
399 "bind-right",
400 "bind-bottom",
401 "54",
402 "55",
403 "56",
404 "57",
405 "58",
406 "59",
407 "trim-after-pages",
408 "trim-after-documents",
409 "trim-after-copies",
9475ec92
MS		 410 "trim-after-job",
411 "64",
412 "65",
413 "66",
414 "67",
415 "68",
416 "69",
cd3614ae
MS		 417 "punch-top-left", /* Finishings 2.0 */
418 "punch-bottom-left", /* Finishings 2.0 */
419 "punch-top-right", /* Finishings 2.0 */
420 "punch-bottom-right", /* Finishings 2.0 */
421 "punch-dual-left", /* Finishings 2.0 */
422 "punch-dual-top", /* Finishings 2.0 */
423 "punch-dual-right", /* Finishings 2.0 */
424 "punch-dual-bottom", /* Finishings 2.0 */
425 "punch-triple-left", /* Finishings 2.0 */
426 "punch-triple-top", /* Finishings 2.0 */
427 "punch-triple-right", /* Finishings 2.0 */
428 "punch-triple-bottom",/* Finishings 2.0 */
429 "punch-quad-left", /* Finishings 2.0 */
430 "punch-quad-top", /* Finishings 2.0 */
431 "punch-quad-right", /* Finishings 2.0 */
432 "punch-quad-bottom", /* Finishings 2.0 */
9475ec92
MS		 433 "86",
434 "87",
435 "88",
436 "89",
cd3614ae
MS		 437 "fold-accordian", /* Finishings 2.0 */
438 "fold-double-gate", /* Finishings 2.0 */
439 "fold-gate", /* Finishings 2.0 */
440 "fold-half", /* Finishings 2.0 */
441 "fold-half-z", /* Finishings 2.0 */
442 "fold-left-gate", /* Finishings 2.0 */
443 "fold-letter", /* Finishings 2.0 */
444 "fold-parallel", /* Finishings 2.0 */
445 "fold-poster", /* Finishings 2.0 */
446 "fold-right-gate", /* Finishings 2.0 */
447 "fold-z" /* Finishings 2.0 */
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 *
f3c17241 612 * @since CUPS 1.6/OS X 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 *
9c0e8e5d 843 * @since CUPS 1.7/OS X 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",
900 "media-actual",
901 "media-col-actual",
902 "media-input-tray-check-actual",
903 "media-sheets",
904 "media-sheets-completed",
905 "more-info",
906 "number-up-actual",
907 "orientation-requested-actual",
908 "output-bin-actual",
909 "output-device-assigned",
910 "overrides-actual",
911 "page-delivery-actual",
912 "page-order-received-actual",
913 "page-ranges-actual",
914 "pages",
915 "pages-completed",
916 "pages-completed-current-copy",
917 "presentation-direction-number-up-actual",
918 "print-color-mode-actual",
919 "print-content-optimize-actual",
920 "print-quality-actual",
921 "print-rendering-intent-actual",
6961465f 922 "print-scaling-actual", /* IPP Paid Printing */
db8b865d
MS		 923 "printer-resolution-actual",
924 "printer-up-time",
925 "separator-sheets-actual",
926 "sheet-completed-copy-number",
927 "sides-actual",
928 "time-at-completed",
929 "time-at-creation",
930 "time-at-processing",
931 "x-image-position-actual",
932 "x-image-shift-actual",
933 "x-side1-image-shift-actual",
934 "x-side2-image-shift-actual",
935 "y-image-position-actual",
936 "y-image-shift-actual",
937 "y-side1-image-shift-actual",
938 "y-side2-image-shift-actual"
939 };
940 static const char * const document_template[] =
941 { /* document-template group */
942 "copies",
943 "copies-default",
944 "copies-supported",
945 "cover-back",
946 "cover-back-default",
947 "cover-back-supported",
948 "cover-front",
949 "cover-front-default",
950 "cover-front-supported",
951 "feed-orientation",
952 "feed-orientation-default",
953 "feed-orientation-supported",
954 "finishings",
955 "finishings-col",
956 "finishings-col-default",
957 "finishings-col-supported",
958 "finishings-default",
959 "finishings-supported",
960 "font-name-requested",
961 "font-name-requested-default",
962 "font-name-requested-supported",
963 "font-size-requested",
964 "font-size-requested-default",
965 "font-size-requested-supported",
966 "force-front-side",
967 "force-front-side-default",
968 "force-front-side-supported",
969 "imposition-template",
970 "imposition-template-default",
971 "imposition-template-supported",
972 "insert-after-page-number-supported",
973 "insert-count-supported",
974 "insert-sheet",
975 "insert-sheet-default",
976 "insert-sheet-supported",
977 "max-stitching-locations-supported",
978 "media",
979 "media-back-coating-supported",
980 "media-bottom-margin-supported",
981 "media-col",
982 "media-col-default",
983 "media-col-supported",
984 "media-color-supported",
985 "media-default",
986 "media-front-coating-supported",
987 "media-grain-supported",
988 "media-hole-count-supported",
989 "media-info-supported",
990 "media-input-tray-check",
991 "media-input-tray-check-default",
992 "media-input-tray-check-supported",
993 "media-key-supported",
994 "media-left-margin-supported",
995 "media-order-count-supported",
996 "media-pre-printed-supported",
997 "media-recycled-supported",
998 "media-right-margin-supported",
999 "media-size-supported",
1000 "media-source-supported",
1001 "media-supported",
1002 "media-thickness-supported",
1003 "media-top-margin-supported",
1004 "media-type-supported",
1005 "media-weight-metric-supported",
1006 "multiple-document-handling",
1007 "multiple-document-handling-default",
1008 "multiple-document-handling-supported",
1009 "number-up",
1010 "number-up-default",
1011 "number-up-supported",
1012 "orientation-requested",
1013 "orientation-requested-default",
1014 "orientation-requested-supported",
6961465f
MS		 1015 "output-mode", /* CUPS extension */
1016 "output-mode-default", /* CUPS extension */
1017 "output-mode-supported", /* CUPS extension */
db8b865d
MS		 1018 "overrides",
1019 "overrides-supported",
1020 "page-delivery",
1021 "page-delivery-default",
1022 "page-delivery-supported",
1023 "page-order-received",
1024 "page-order-received-default",
1025 "page-order-received-supported",
1026 "page-ranges",
1027 "page-ranges-supported",
1028 "pages-per-subset",
1029 "pages-per-subset-supported",
1030 "pdl-init-file",
1031 "pdl-init-file-default",
1032 "pdl-init-file-entry-supported",
1033 "pdl-init-file-location-supported",
1034 "pdl-init-file-name-subdirectory-supported",
1035 "pdl-init-file-name-supported",
1036 "pdl-init-file-supported",
1037 "presentation-direction-number-up",
1038 "presentation-direction-number-up-default",
1039 "presentation-direction-number-up-supported",
1040 "print-color-mode",
1041 "print-color-mode-default",
1042 "print-color-mode-supported",
1043 "print-content-optimize",
1044 "print-content-optimize-default",
1045 "print-content-optimize-supported",
1046 "print-quality",
1047 "print-quality-default",
1048 "print-quality-supported",
1049 "print-rendering-intent",
1050 "print-rendering-intent-default",
1051 "print-rendering-intent-supported",
6961465f
MS		 1052 "print-scaling", /* IPP Paid Printing */
1053 "print-scaling-default", /* IPP Paid Printing */
1054 "print-scaling-supported", /* IPP Paid Printing */
db8b865d
MS		 1055 "printer-resolution",
1056 "printer-resolution-default",
1057 "printer-resolution-supported",
1058 "separator-sheets",
1059 "separator-sheets-default",
1060 "separator-sheets-supported",
1061 "sheet-collate",
1062 "sheet-collate-default",
1063 "sheet-collate-supported",
1064 "sides",
1065 "sides-default",
1066 "sides-supported",
1067 "stitching-locations-supported",
1068 "stitching-offset-supported",
1069 "x-image-position",
1070 "x-image-position-default",
1071 "x-image-position-supported",
1072 "x-image-shift",
1073 "x-image-shift-default",
1074 "x-image-shift-supported",
1075 "x-side1-image-shift",
1076 "x-side1-image-shift-default",
1077 "x-side1-image-shift-supported",
1078 "x-side2-image-shift",
1079 "x-side2-image-shift-default",
1080 "x-side2-image-shift-supported",
1081 "y-image-position",
1082 "y-image-position-default",
1083 "y-image-position-supported",
1084 "y-image-shift",
1085 "y-image-shift-default",
1086 "y-image-shift-supported",
1087 "y-side1-image-shift",
1088 "y-side1-image-shift-default",
1089 "y-side1-image-shift-supported",
1090 "y-side2-image-shift",
1091 "y-side2-image-shift-default",
1092 "y-side2-image-shift-supported"
1093 };
1094 static const char * const job_description[] =
1095 { /* job-description group */
1096 "compression-supplied",
1097 "copies-actual",
1098 "cover-back-actual",
1099 "cover-front-actual",
1100 "current-page-order",
1101 "date-time-at-completed",
1102 "date-time-at-creation",
1103 "date-time-at-processing",
1104 "destination-statuses",
1105 "document-charset-supplied",
1106 "document-digital-signature-supplied",
1107 "document-format-details-supplied",
1108 "document-format-supplied",
1109 "document-message-supplied",
1110 "document-metadata",
1111 "document-name-supplied",
1112 "document-natural-language-supplied",
1113 "document-overrides-actual",
1114 "errors-count",
1115 "finishings-actual",
1116 "finishings-col-actual",
1117 "force-front-side-actual",
1118 "imposition-template-actual",
1119 "impressions-completed-current-copy",
1120 "insert-sheet-actual",
1121 "job-account-id-actual",
1122 "job-accounting-sheets-actual",
1123 "job-accounting-user-id-actual",
1124 "job-attribute-fidelity",
1125 "job-charge-info", /* CUPS extension */
1126 "job-collation-type",
1127 "job-collation-type-actual",
1128 "job-copies-actual",
1129 "job-cover-back-actual",
1130 "job-cover-front-actual",
1131 "job-detailed-status-message",
1132 "job-document-access-errors",
1133 "job-error-sheet-actual",
1134 "job-finishings-actual",
1135 "job-finishings-col-actual",
1136 "job-hold-until-actual",
1137 "job-id",
1138 "job-impressions",
1139 "job-impressions-completed",
1140 "job-k-octets",
1141 "job-k-octets-processed",
1142 "job-mandatory-attributes",
1143 "job-media-progress", /* CUPS extension */
1144 "job-media-sheets",
1145 "job-media-sheets-completed",
1146 "job-message-from-operator",
1147 "job-more-info",
1148 "job-name",
1149 "job-originating-host-name", /* CUPS extension */
1150 "job-originating-user-name",
1151 "job-originating-user-uri",
1152 "job-pages",
1153 "job-pages-completed",
1154 "job-pages-completed-current-copy",
1155 "job-printer-state-message", /* CUPS extension */
1156 "job-printer-state-reasons", /* CUPS extension */
1157 "job-printer-up-time",
1158 "job-printer-uri",
1159 "job-priority-actual",
1160 "job-save-printer-make-and-model",
1161 "job-sheet-message-actual",
1162 "job-sheets-actual",
1163 "job-sheets-col-actual",
1164 "job-state",
1165 "job-state-message",
1166 "job-state-reasons",
1167 "job-uri",
1168 "job-uuid",
1169 "media-actual",
1170 "media-col-actual",
1171 "media-check-input-tray-actual",
1172 "multiple-document-handling-actual",
1173 "number-of-documents",
1174 "number-of-intervening-jobs",
1175 "number-up-actual",
1176 "orientation-requested-actual",
1177 "original-requesting-user-name",
1178 "output-bin-actual",
1179 "output-device-assigned",
1180 "overrides-actual",
1181 "page-delivery-actual",
1182 "page-order-received-actual",
1183 "page-ranges-actual",
1184 "presentation-direction-number-up-actual",
1185 "print-color-mode-actual",
1186 "print-content-optimize-actual",
1187 "print-quality-actual",
1188 "print-rendering-intent-actual",
6961465f 1189 "print-scaling-actual", /* IPP Paid Printing */
db8b865d
MS		 1190 "printer-resolution-actual",
1191 "separator-sheets-actual",
1192 "sheet-collate-actual",
1193 "sheet-completed-copy-number",
1194 "sheet-completed-document-number",
1195 "sides-actual",
1196 "time-at-completed",
1197 "time-at-creation",
1198 "time-at-processing",
1199 "warnings-count",
1200 "x-image-position-actual",
1201 "x-image-shift-actual",
1202 "x-side1-image-shift-actual",
1203 "x-side2-image-shift-actual",
1204 "y-image-position-actual",
1205 "y-image-shift-actual",
1206 "y-side1-image-shift-actual",
1207 "y-side2-image-shift-actual"
1208 };
1209 static const char * const job_template[] =
1210 { /* job-template group */
1211 "confirmation-sheet-print", /* IPP FaxOut */
1212 "confirmation-sheet-print-default",
1213 "copies",
1214 "copies-default",
1215 "copies-supported",
1216 "cover-back",
1217 "cover-back-default",
1218 "cover-back-supported",
1219 "cover-front",
1220 "cover-front-default",
1221 "cover-front-supported",
1222 "cover-sheet-info", /* IPP FaxOut */
1223 "cover-sheet-info-default",
1224 "cover-sheet-info-supported",
1225 "destination-uri-schemes-supported",/* IPP FaxOut */
1226 "destination-uris", /* IPP FaxOut */
1227 "destination-uris-supported",
1228 "feed-orientation",
1229 "feed-orientation-default",
1230 "feed-orientation-supported",
1231 "finishings",
1232 "finishings-col",
1233 "finishings-col-default",
1234 "finishings-col-supported",
1235 "finishings-default",
1236 "finishings-supported",
1237 "font-name-requested",
1238 "font-name-requested-default",
1239 "font-name-requested-supported",
1240 "font-size-requested",
1241 "font-size-requested-default",
1242 "font-size-requested-supported",
1243 "force-front-side",
1244 "force-front-side-default",
1245 "force-front-side-supported",
1246 "imposition-template",
1247 "imposition-template-default",
1248 "imposition-template-supported",
1249 "insert-after-page-number-supported",
1250 "insert-count-supported",
1251 "insert-sheet",
1252 "insert-sheet-default",
1253 "insert-sheet-supported",
1254 "job-account-id",
1255 "job-account-id-default",
1256 "job-account-id-supported",
1257 "job-accounting-sheets"
1258 "job-accounting-sheets-default"
1259 "job-accounting-sheets-supported"
1260 "job-accounting-user-id",
1261 "job-accounting-user-id-default",
1262 "job-accounting-user-id-supported",
1263 "job-copies",
1264 "job-copies-default",
1265 "job-copies-supported",
1266 "job-cover-back",
1267 "job-cover-back-default",
1268 "job-cover-back-supported",
1269 "job-cover-front",
1270 "job-cover-front-default",
1271 "job-cover-front-supported",
1272 "job-delay-output-until",
1273 "job-delay-output-until-default",
1274 "job-delay-output-until-supported",
1275 "job-delay-output-until-time",
1276 "job-delay-output-until-time-default",
1277 "job-delay-output-until-time-supported",
1278 "job-error-action",
1279 "job-error-action-default",
1280 "job-error-action-supported",
1281 "job-error-sheet",
1282 "job-error-sheet-default",
1283 "job-error-sheet-supported",
1284 "job-finishings",
1285 "job-finishings-col",
1286 "job-finishings-col-default",
1287 "job-finishings-col-supported",
1288 "job-finishings-default",
1289 "job-finishings-supported",
1290 "job-hold-until",
1291 "job-hold-until-default",
1292 "job-hold-until-supported",
1293 "job-hold-until-time",
1294 "job-hold-until-time-default",
1295 "job-hold-until-time-supported",
1296 "job-message-to-operator",
1297 "job-message-to-operator-default",
1298 "job-message-to-operator-supported",
1299 "job-phone-number",
1300 "job-phone-number-default",
1301 "job-phone-number-supported",
1302 "job-priority",
1303 "job-priority-default",
1304 "job-priority-supported",
1305 "job-recipient-name",
1306 "job-recipient-name-default",
1307 "job-recipient-name-supported",
1308 "job-save-disposition",
1309 "job-save-disposition-default",
1310 "job-save-disposition-supported",
1311 "job-sheets",
1312 "job-sheets-col",
1313 "job-sheets-col-default",
1314 "job-sheets-col-supported",
1315 "job-sheets-default",
1316 "job-sheets-supported",
1317 "logo-uri-schemes-supported",
1318 "max-save-info-supported",
1319 "max-stitching-locations-supported",
1320 "media",
1321 "media-back-coating-supported",
1322 "media-bottom-margin-supported",
1323 "media-col",
1324 "media-col-default",
1325 "media-col-supported",
1326 "media-color-supported",
1327 "media-default",
1328 "media-front-coating-supported",
1329 "media-grain-supported",
1330 "media-hole-count-supported",
1331 "media-info-supported",
1332 "media-input-tray-check",
1333 "media-input-tray-check-default",
1334 "media-input-tray-check-supported",
1335 "media-key-supported",
1336 "media-left-margin-supported",
1337 "media-order-count-supported",
1338 "media-pre-printed-supported",
1339 "media-recycled-supported",
1340 "media-right-margin-supported",
1341 "media-size-supported",
1342 "media-source-supported",
1343 "media-supported",
1344 "media-thickness-supported",
1345 "media-top-margin-supported",
1346 "media-type-supported",
1347 "media-weight-metric-supported",
1348 "multiple-document-handling",
1349 "multiple-document-handling-default",
1350 "multiple-document-handling-supported",
1351 "number-of-retries", /* IPP FaxOut */
1352 "number-of-retries-default",
1353 "number-of-retries-supported",
1354 "number-up",
1355 "number-up-default",
1356 "number-up-supported",
1357 "orientation-requested",
1358 "orientation-requested-default",
1359 "orientation-requested-supported",
1360 "output-bin",
1361 "output-bin-default",
1362 "output-bin-supported",
1363 "output-device",
1364 "output-device-default",
1365 "output-device-supported",
6961465f
MS		 1366 "output-mode", /* CUPS extension */
1367 "output-mode-default", /* CUPS extension */
1368 "output-mode-supported", /* CUPS extension */
db8b865d
MS		 1369 "overrides",
1370 "overrides-supported",
1371 "page-delivery",
1372 "page-delivery-default",
1373 "page-delivery-supported",
1374 "page-order-received",
1375 "page-order-received-default",
1376 "page-order-received-supported",
1377 "page-ranges",
1378 "page-ranges-supported",
1379 "pages-per-subset",
1380 "pages-per-subset-supported",
1381 "pdl-init-file",
1382 "pdl-init-file-default",
1383 "pdl-init-file-entry-supported",
1384 "pdl-init-file-location-supported",
1385 "pdl-init-file-name-subdirectory-supported",
1386 "pdl-init-file-name-supported",
1387 "pdl-init-file-supported",
1388 "presentation-direction-number-up",
1389 "presentation-direction-number-up-default",
1390 "presentation-direction-number-up-supported",
1391 "print-color-mode",
1392 "print-color-mode-default",
1393 "print-color-mode-supported",
1394 "print-content-optimize",
1395 "print-content-optimize-default",
1396 "print-content-optimize-supported",
1397 "print-quality",
1398 "print-quality-default",
1399 "print-quality-supported",
1400 "print-rendering-intent",
1401 "print-rendering-intent-default",
1402 "print-rendering-intent-supported",
6961465f
MS		 1403 "print-scaling", /* IPP Paid Printing */
1404 "print-scaling-default", /* IPP Paid Printing */
1405 "print-scaling-supported", /* IPP Paid Printing */
db8b865d
MS		 1406 "printer-resolution",
1407 "printer-resolution-default",
1408 "printer-resolution-supported",
1409 "proof-print",
1410 "proof-print-default",
1411 "proof-print-supported",
1412 "retry-interval", /* IPP FaxOut */
1413 "retry-interval-default",
1414 "retry-interval-supported",
1415 "retry-timeout", /* IPP FaxOut */
1416 "retry-timeout-default",
1417 "retry-timeout-supported",
1418 "save-disposition-supported",
1419 "save-document-format-default",
1420 "save-document-format-supported",
1421 "save-location-default",
1422 "save-location-supported",
1423 "save-name-subdirectory-supported",
1424 "save-name-supported",
1425 "separator-sheets",
1426 "separator-sheets-default",
1427 "separator-sheets-supported",
1428 "sheet-collate",
1429 "sheet-collate-default",
1430 "sheet-collate-supported",
1431 "sides",
1432 "sides-default",
1433 "sides-supported",
1434 "stitching-locations-supported",
1435 "stitching-offset-supported",
1436 "x-image-position",
1437 "x-image-position-default",
1438 "x-image-position-supported",
1439 "x-image-shift",
1440 "x-image-shift-default",
1441 "x-image-shift-supported",
1442 "x-side1-image-shift",
1443 "x-side1-image-shift-default",
1444 "x-side1-image-shift-supported",
1445 "x-side2-image-shift",
1446 "x-side2-image-shift-default",
1447 "x-side2-image-shift-supported",
1448 "y-image-position",
1449 "y-image-position-default",
1450 "y-image-position-supported",
1451 "y-image-shift",
1452 "y-image-shift-default",
1453 "y-image-shift-supported",
1454 "y-side1-image-shift",
1455 "y-side1-image-shift-default",
1456 "y-side1-image-shift-supported",
1457 "y-side2-image-shift",
1458 "y-side2-image-shift-default",
1459 "y-side2-image-shift-supported"
1460 };
1461 static const char * const printer_description[] =
1462 { /* printer-description group */
1463 "auth-info-required", /* CUPS extension */
1464 "charset-configured",
1465 "charset-supported",
1466 "color-supported",
1467 "compression-supported",
1468 "device-service-count",
1469 "device-uri", /* CUPS extension */
1470 "device-uuid",
1471 "document-charset-default",
1472 "document-charset-supported",
1473 "document-creation-attributes-supported",
1474 "document-digital-signature-default",
1475 "document-digital-signature-supported",
1476 "document-format-default",
1477 "document-format-details-default",
1478 "document-format-details-supported",
1479 "document-format-supported",
1480 "document-format-varying-attributes",
1481 "document-format-version-default",
1482 "document-format-version-supported",
1483 "document-natural-language-default",
1484 "document-natural-language-supported",
1485 "document-password-supported",
1486 "generated-natural-language-supported",
1487 "identify-actions-default",
1488 "identify-actions-supported",
1489 "input-source-supported",
1490 "ipp-features-supported",
1491 "ipp-versions-supported",
1492 "ippget-event-life",
1493 "job-authorization-uri-supported", /* CUPS extension */
1494 "job-constraints-supported",
1495 "job-creation-attributes-supported",
1496 "job-finishings-col-ready",
1497 "job-finishings-ready",
1498 "job-ids-supported",
1499 "job-impressions-supported",
1500 "job-k-limit", /* CUPS extension */
1501 "job-k-octets-supported",
1502 "job-media-sheets-supported",
1503 "job-page-limit", /* CUPS extension */
1504 "job-password-encryption-supported",
1505 "job-password-supported",
1506 "job-quota-period", /* CUPS extension */
1507 "job-resolvers-supported",
1508 "job-settable-attributes-supported",
1509 "job-spooling-supported",
c5b24bfa
MS		 1510 "jpeg-k-octets-supported", /* CUPS extension */
1511 "jpeg-x-dimension-supported", /* CUPS extension */
1512 "jpeg-y-dimension-supported", /* CUPS extension */
1513 "landscape-orientation-requested-preferred",
1514 /* CUPS extension */
db8b865d
MS		 1515 "marker-change-time", /* CUPS extension */
1516 "marker-colors", /* CUPS extension */
1517 "marker-high-levels", /* CUPS extension */
1518 "marker-levels", /* CUPS extension */
1519 "marker-low-levels", /* CUPS extension */
1520 "marker-message", /* CUPS extension */
1521 "marker-names", /* CUPS extension */
1522 "marker-types", /* CUPS extension */
1523 "media-col-ready",
1524 "media-ready",
1525 "member-names", /* CUPS extension */
1526 "member-uris", /* CUPS extension */
1527 "multiple-destination-uris-supported",/* IPP FaxOut */
1528 "multiple-document-jobs-supported",
1529 "multiple-operation-time-out",
1530 "multiple-operation-time-out-action",
1531 "natural-language-configured",
1532 "operations-supported",
1533 "pages-per-minute",
1534 "pages-per-minute-color",
c5b24bfa
MS		 1535 "pdf-k-octets-supported", /* CUPS extension */
1536 "pdf-versions-supported", /* CUPS extension */
db8b865d
MS		 1537 "pdl-override-supported",
1538 "port-monitor", /* CUPS extension */
1539 "port-monitor-supported", /* CUPS extension */
1540 "preferred-attributes-supported",
1541 "printer-alert",
1542 "printer-alert-description",
1543 "printer-charge-info",
1544 "printer-charge-info-uri",
1545 "printer-commands", /* CUPS extension */
1546 "printer-current-time",
1547 "printer-detailed-status-messages",
1548 "printer-device-id",
1549 "printer-dns-sd-name", /* CUPS extension */
1550 "printer-driver-installer",
1551 "printer-fax-log-uri", /* IPP FaxOut */
1552 "printer-fax-modem-info", /* IPP FaxOut */
1553 "printer-fax-modem-name", /* IPP FaxOut */
1554 "printer-fax-modem-number", /* IPP FaxOut */
8f787fca
MS		 1555 "printer-firmware-name", /* PWG 5110.1 */
1556 "printer-firmware-patches", /* PWG 5110.1 */
1557 "printer-firmware-string-version", /* PWG 5110.1 */
1558 "printer-firmware-version", /* PWG 5110.1 */
db8b865d
MS		 1559 "printer-geo-location",
1560 "printer-get-attributes-supported",
1561 "printer-icc-profiles",
1562 "printer-icons",
1563 "printer-info",
8f787fca 1564 "printer-input-tray", /* IPP JPS3 */
db8b865d 1565 "printer-is-accepting-jobs",
6961465f
MS		 1566 "printer-is-shared", /* CUPS extension */
1567 "printer-kind", /* IPP Paid Printing */
db8b865d
MS		 1568 "printer-location",
1569 "printer-make-and-model",
1570 "printer-mandatory-job-attributes",
1571 "printer-message-date-time",
1572 "printer-message-from-operator",
1573 "printer-message-time",
1574 "printer-more-info",
1575 "printer-more-info-manufacturer",
1576 "printer-name",
6961465f 1577 "printer-native-formats",
db8b865d
MS		 1578 "printer-organization",
1579 "printer-organizational-unit",
8f787fca 1580 "printer-output-tray", /* IPP JPS3 */
34a63bd9 1581 "printer-queue-id", /* CUPS extension */
db8b865d
MS		 1582 "printer-settable-attributes-supported",
1583 "printer-state",
1584 "printer-state-change-date-time",
1585 "printer-state-change-time",
1586 "printer-state-message",
1587 "printer-state-reasons",
1588 "printer-supply",
1589 "printer-supply-description",
1590 "printer-supply-info-uri",
1591 "printer-type", /* CUPS extension */
1592 "printer-up-time",
1593 "printer-uri-supported",
1594 "printer-uuid",
1595 "printer-xri-supported",
1596 "pwg-raster-document-resolution-supported",
1597 "pwg-raster-document-sheet-back",
1598 "pwg-raster-document-type-supported",
1599 "queued-job-count",
1600 "reference-uri-schemes-supported",
1601 "repertoire-supported",
1602 "requesting-user-name-allowed", /* CUPS extension */
1603 "requesting-user-name-denied", /* CUPS extension */
1604 "requesting-user-uri-supported",
1605 "subordinate-printers-supported",
6961465f 1606 "urf-supported", /* CUPS extension */
db8b865d
MS		 1607 "uri-authentication-supported",
1608 "uri-security-supported",
1609 "user-defined-value-supported",
1610 "which-jobs-supported",
1611 "xri-authentication-supported",
1612 "xri-security-supported",
1613 "xri-uri-scheme-supported"
1614 };
1615 static const char * const subscription_description[] =
1616 { /* subscription-description group */
1617 "notify-job-id",
1618 "notify-lease-expiration-time",
1619 "notify-printer-up-time",
1620 "notify-printer-uri",
1621 "notify-sequence-number",
1622 "notify-subscriber-user-name",
1623 "notify-subscriber-user-uri",
1624 "notify-subscription-id",
1625 "subscriptions-uuid"
1626 };
1627 static const char * const subscription_template[] =
1628 { /* subscription-template group */
1629 "notify-attributes",
1630 "notify-attributes-supported",
1631 "notify-charset",
1632 "notify-events",
1633 "notify-events-default",
1634 "notify-events-supported",
1635 "notify-lease-duration",
1636 "notify-lease-duration-default",
1637 "notify-lease-duration-supported",
1638 "notify-max-events-supported",
1639 "notify-natural-language",
1640 "notify-pull-method",
1641 "notify-pull-method-supported",
1642 "notify-recipient-uri",
1643 "notify-schemes-supported",
1644 "notify-time-interval",
1645 "notify-user-data"
1646 };
1647
1648
1649 /*
1650 * Get the requested-attributes attribute...
1651 */
1652
1653 if ((requested = ippFindAttribute(request, "requested-attributes",
1654 IPP_TAG_KEYWORD)) == NULL)
1655 {
1656 /*
1657 * The Get-Jobs operation defaults to "job-id" and "job-uri", all others
1658 * default to "all"...
1659 */
1660
cb7f98ee 1661 if (ippGetOperation(request) == IPP_OP_GET_JOBS)
db8b865d
MS		 1662 {
1663 ra = cupsArrayNew((cups_array_func_t)strcmp, NULL);
1664 cupsArrayAdd(ra, "job-id");
1665 cupsArrayAdd(ra, "job-uri");
1666
1667 return (ra);
1668 }
1669 else
1670 return (NULL);
1671 }
1672
1673 /*
1674 * If the attribute contains a single "all" keyword, return NULL...
1675 */
1676
1677 count = ippGetCount(requested);
1678 if (count == 1 && !strcmp(ippGetString(requested, 0, NULL), "all"))
1679 return (NULL);
1680
1681 /*
1682 * Create an array using "strcmp" as the comparison function...
1683 */
1684
1685 ra = cupsArrayNew((cups_array_func_t)strcmp, NULL);
1686
1687 for (i = 0; i < count; i ++)
1688 {
1689 added = 0;
1690 value = ippGetString(requested, i, NULL);
1691
1692 if (!strcmp(value, "document-description") || !strcmp(value, "all"))
1693 {
1694 for (j = 0;
1695 j < (int)(sizeof(document_description) /
1696 sizeof(document_description[0]));
1697 j ++)
1698 cupsArrayAdd(ra, (void *)document_description[j]);
1699
1700 added = 1;
1701 }
1702
1703 if (!strcmp(value, "document-template") || !strcmp(value, "all"))
1704 {
1705 for (j = 0;
1706 j < (int)(sizeof(document_template) / sizeof(document_template[0]));
1707 j ++)
1708 cupsArrayAdd(ra, (void *)document_template[j]);
1709
1710 added = 1;
1711 }
1712
1713 if (!strcmp(value, "job-description") || !strcmp(value, "all"))
1714 {
1715 for (j = 0;
1716 j < (int)(sizeof(job_description) / sizeof(job_description[0]));
1717 j ++)
1718 cupsArrayAdd(ra, (void *)job_description[j]);
1719
1720 added = 1;
1721 }
1722
1723 if (!strcmp(value, "job-template") || !strcmp(value, "all"))
1724 {
1725 for (j = 0;
1726 j < (int)(sizeof(job_template) / sizeof(job_template[0]));
1727 j ++)
1728 cupsArrayAdd(ra, (void *)job_template[j]);
1729
1730 added = 1;
1731 }
1732
1733 if (!strcmp(value, "printer-description") || !strcmp(value, "all"))
1734 {
1735 for (j = 0;
1736 j < (int)(sizeof(printer_description) /
1737 sizeof(printer_description[0]));
1738 j ++)
1739 cupsArrayAdd(ra, (void *)printer_description[j]);
1740
1741 added = 1;
1742 }
1743
1744 if (!strcmp(value, "subscription-description") || !strcmp(value, "all"))
1745 {
1746 for (j = 0;
1747 j < (int)(sizeof(subscription_description) /
1748 sizeof(subscription_description[0]));
1749 j ++)
1750 cupsArrayAdd(ra, (void *)subscription_description[j]);
1751
1752 added = 1;
1753 }
1754
1755 if (!strcmp(value, "subscription-template") || !strcmp(value, "all"))
1756 {
1757 for (j = 0;
1758 j < (int)(sizeof(subscription_template) /
1759 sizeof(subscription_template[0]));
1760 j ++)
1761 cupsArrayAdd(ra, (void *)subscription_template[j]);
1762
1763 added = 1;
1764 }
1765
1766 if (!added)
1767 cupsArrayAdd(ra, (void *)value);
1768 }
1769
1770 return (ra);
1771}
1772
1773
a2326b5b
MS		 1774/*
1775 * 'ippEnumString()' - Return a string corresponding to the enum value.
1776 */
1777
1778const char * /* O - Enum string */
1779ippEnumString(const char *attrname, /* I - Attribute name */
1780 int enumvalue) /* I - Enum value */
1781{
1782 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
1783
1784
1785 /*
1786 * Check for standard enum values...
1787 */
1788
1789 if (!strcmp(attrname, "document-state") &&
1790 enumvalue >= 3 &&
0fa6c7fa
MS		 1791 enumvalue < (3 + (int)(sizeof(ipp_document_states) /
1792 sizeof(ipp_document_states[0]))))
a2326b5b 1793 return (ipp_document_states[enumvalue - 3]);
a469f8a5
MS		 1794 else if (!strcmp(attrname, "finishings") ||
1795 !strcmp(attrname, "finishings-actual") ||
1796 !strcmp(attrname, "finishings-default") ||
1797 !strcmp(attrname, "finishings-ready") ||
6961465f
MS		 1798 !strcmp(attrname, "finishings-supported") ||
1799 !strcmp(attrname, "job-finishings") ||
1800 !strcmp(attrname, "job-finishings-default") ||
1801 !strcmp(attrname, "job-finishings-supported"))
a469f8a5
MS		 1802 {
1803 if (enumvalue >= 3 &&
0fa6c7fa
MS		 1804 enumvalue < (3 + (int)(sizeof(ipp_finishings) /
1805 sizeof(ipp_finishings[0]))))
a469f8a5
MS		 1806 return (ipp_finishings[enumvalue - 3]);
1807 else if (enumvalue >= 0x40000000 &&
1808 enumvalue <= (0x40000000 + (int)(sizeof(ipp_finishings_vendor) /
1809 sizeof(ipp_finishings_vendor[0]))))
1810 return (ipp_finishings_vendor[enumvalue - 0x40000000]);
1811 }
a2326b5b
MS		 1812 else if ((!strcmp(attrname, "job-collation-type") ||
1813 !strcmp(attrname, "job-collation-type-actual")) &&
1814 enumvalue >= 3 &&
0fa6c7fa
MS		 1815 enumvalue < (3 + (int)(sizeof(ipp_job_collation_types) /
1816 sizeof(ipp_job_collation_types[0]))))
a2326b5b
MS		 1817 return (ipp_job_collation_types[enumvalue - 3]);
1818 else if (!strcmp(attrname, "job-state") &&
cb7f98ee
MS		 1819 enumvalue >= IPP_JSTATE_PENDING && enumvalue <= IPP_JSTATE_COMPLETED)
1820 return (ipp_job_states[enumvalue - IPP_JSTATE_PENDING]);
a2326b5b
MS		 1821 else if (!strcmp(attrname, "operations-supported"))
1822 return (ippOpString((ipp_op_t)enumvalue));
1823 else if ((!strcmp(attrname, "orientation-requested") ||
1824 !strcmp(attrname, "orientation-requested-actual") ||
1825 !strcmp(attrname, "orientation-requested-default") ||
1826 !strcmp(attrname, "orientation-requested-supported")) &&
1827 enumvalue >= 3 &&
0fa6c7fa
MS		 1828 enumvalue < (3 + (int)(sizeof(ipp_orientation_requesteds) /
1829 sizeof(ipp_orientation_requesteds[0]))))
a2326b5b
MS		 1830 return (ipp_orientation_requesteds[enumvalue - 3]);
1831 else if ((!strcmp(attrname, "print-quality") ||
1832 !strcmp(attrname, "print-quality-actual") ||
1833 !strcmp(attrname, "print-quality-default") ||
1834 !strcmp(attrname, "print-quality-supported")) &&
1835 enumvalue >= 3 &&
0fa6c7fa
MS		 1836 enumvalue < (3 + (int)(sizeof(ipp_print_qualities) /
1837 sizeof(ipp_print_qualities[0]))))
a2326b5b
MS		 1838 return (ipp_print_qualities[enumvalue - 3]);
1839 else if (!strcmp(attrname, "printer-state") &&
cb7f98ee
MS		 1840 enumvalue >= IPP_PSTATE_IDLE && enumvalue <= IPP_PSTATE_STOPPED)
1841 return (ipp_printer_states[enumvalue - IPP_PSTATE_IDLE]);
a2326b5b
MS		 1842
1843 /*
1844 * Not a standard enum value, just return the decimal equivalent...
1845 */
1846
1847 snprintf(cg->ipp_unknown, sizeof(cg->ipp_unknown), "%d", enumvalue);
1848 return (cg->ipp_unknown);
1849}
1850
1851
1852/*
1853 * 'ippEnumValue()' - Return the value associated with a given enum string.
1854 */
1855
1856int /* O - Enum value or -1 if unknown */
1857ippEnumValue(const char *attrname, /* I - Attribute name */
1858 const char *enumstring) /* I - Enum string */
1859{
1860 int i, /* Looping var */
1861 num_strings; /* Number of strings to compare */
1862 const char * const *strings; /* Strings to compare */
1863
1864
1865 /*
1866 * If the string is just a number, return it...
1867 */
1868
1869 if (isdigit(*enumstring & 255))
7e86f2f6 1870 return ((int)strtol(enumstring, NULL, 0));
a2326b5b
MS		 1871
1872 /*
1873 * Otherwise look up the string...
1874 */
1875
1876 if (!strcmp(attrname, "document-state"))
1877 {
1878 num_strings = (int)(sizeof(ipp_document_states) / sizeof(ipp_document_states[0]));
1879 strings = ipp_document_states;
1880 }
1881 else if (!strcmp(attrname, "finishings") ||
1882 !strcmp(attrname, "finishings-actual") ||
1883 !strcmp(attrname, "finishings-default") ||
1884 !strcmp(attrname, "finishings-ready") ||
1885 !strcmp(attrname, "finishings-supported"))
1886 {
a469f8a5
MS		 1887 for (i = 0;
1888 i < (int)(sizeof(ipp_finishings_vendor) /
1889 sizeof(ipp_finishings_vendor[0]));
1890 i ++)
1891 if (!strcmp(enumstring, ipp_finishings_vendor[i]))
1892 return (i + 0x40000000);
1893
a2326b5b
MS		 1894 num_strings = (int)(sizeof(ipp_finishings) / sizeof(ipp_finishings[0]));
1895 strings = ipp_finishings;
1896 }
1897 else if (!strcmp(attrname, "job-collation-type") ||
1898 !strcmp(attrname, "job-collation-type-actual"))
1899 {
1900 num_strings = (int)(sizeof(ipp_job_collation_types) /
1901 sizeof(ipp_job_collation_types[0]));
1902 strings = ipp_job_collation_types;
1903 }
1904 else if (!strcmp(attrname, "job-state"))
1905 {
1906 num_strings = (int)(sizeof(ipp_job_states) / sizeof(ipp_job_states[0]));
1907 strings = ipp_job_states;
1908 }
1909 else if (!strcmp(attrname, "operations-supported"))
1910 return (ippOpValue(enumstring));
1911 else if (!strcmp(attrname, "orientation-requested") ||
1912 !strcmp(attrname, "orientation-requested-actual") ||
1913 !strcmp(attrname, "orientation-requested-default") ||
1914 !strcmp(attrname, "orientation-requested-supported"))
1915 {
1916 num_strings = (int)(sizeof(ipp_orientation_requesteds) /
1917 sizeof(ipp_orientation_requesteds[0]));
1918 strings = ipp_orientation_requesteds;
1919 }
1920 else if (!strcmp(attrname, "print-quality") ||
1921 !strcmp(attrname, "print-quality-actual") ||
1922 !strcmp(attrname, "print-quality-default") ||
1923 !strcmp(attrname, "print-quality-supported"))
1924 {
1925 num_strings = (int)(sizeof(ipp_print_qualities) / sizeof(ipp_print_qualities[0]));
1926 strings = ipp_print_qualities;
1927 }
1928 else if (!strcmp(attrname, "printer-state"))
1929 {
1930 num_strings = (int)(sizeof(ipp_printer_states) / sizeof(ipp_printer_states[0]));
1931 strings = ipp_printer_states;
1932 }
1933 else
1934 return (-1);
1935
1936 for (i = 0; i < num_strings; i ++)
1937 if (!strcmp(enumstring, strings[i]))
1938 return (i + 3);
1939
1940 return (-1);
1941}
1942
1943
ef416fc2 1944/*
1945 * 'ippErrorString()' - Return a name for the given status code.
1946 */
1947
1948const char * /* O - Text string */
1949ippErrorString(ipp_status_t error) /* I - Error status */
1950{
1951 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
1952
1953
1954 /*
1955 * See if the error code is a known value...
1956 */
1957
a469f8a5 1958 if (error >= IPP_STATUS_OK && error <= IPP_STATUS_OK_EVENTS_COMPLETE)
ef416fc2 1959 return (ipp_status_oks[error]);
a469f8a5 1960 else if (error == IPP_STATUS_REDIRECTION_OTHER_SITE)
ef416fc2 1961 return ("redirection-other-site");
a469f8a5 1962 else if (error == IPP_STATUS_CUPS_SEE_OTHER)
b94498cf 1963 return ("cups-see-other");
a469f8a5 1964 else if (error >= IPP_STATUS_ERROR_BAD_REQUEST &&
6b13fa61 1965 error <= IPP_STATUS_ERROR_ACCOUNT_AUTHORIZATION_FAILED)
a469f8a5
MS		 1966 return (ipp_status_400s[error - IPP_STATUS_ERROR_BAD_REQUEST]);
1967 else if (error >= 0x480 &&
1968 error <= IPP_STATUS_ERROR_CUPS_ACCOUNT_AUTHORIZATION_FAILED)
1969 return (ipp_status_480s[error - 0x0480]);
1970 else if (error >= IPP_STATUS_ERROR_INTERNAL &&
1971 error <= IPP_STATUS_ERROR_TOO_MANY_DOCUMENTS)
1972 return (ipp_status_500s[error - IPP_STATUS_ERROR_INTERNAL]);
1973 else if (error >= IPP_STATUS_ERROR_CUPS_AUTHENTICATION_CANCELED &&
1974 error <= IPP_STATUS_ERROR_CUPS_UPGRADE_REQUIRED)
1975 return (ipp_status_1000s[error -
1976 IPP_STATUS_ERROR_CUPS_AUTHENTICATION_CANCELED]);
ef416fc2 1977
1978 /*
d7225fc2 1979 * No, build an "0xxxxx" error string...
ef416fc2 1980 */
1981
d7225fc2 1982 sprintf(cg->ipp_unknown, "0x%04x", error);
ef416fc2 1983
1984 return (cg->ipp_unknown);
1985}
1986
1987
1988/*
1989 * 'ippErrorValue()' - Return a status code for the given name.
1990 *
f3c17241 1991 * @since CUPS 1.2/OS X 10.5@
ef416fc2 1992 */
1993
1994ipp_status_t /* O - IPP status code */
1995ippErrorValue(const char *name) /* I - Name */
1996{
7e86f2f6 1997 size_t i; /* Looping var */
ef416fc2 1998
1999
2000 for (i = 0; i < (sizeof(ipp_status_oks) / sizeof(ipp_status_oks[0])); i ++)
88f9aafc 2001 if (!_cups_strcasecmp(name, ipp_status_oks[i]))
ef416fc2 2002 return ((ipp_status_t)i);
2003
88f9aafc 2004 if (!_cups_strcasecmp(name, "redirection-other-site"))
a469f8a5 2005 return (IPP_STATUS_REDIRECTION_OTHER_SITE);
ef416fc2 2006
88f9aafc 2007 if (!_cups_strcasecmp(name, "cups-see-other"))
a469f8a5 2008 return (IPP_STATUS_CUPS_SEE_OTHER);
b94498cf 2009
ef416fc2 2010 for (i = 0; i < (sizeof(ipp_status_400s) / sizeof(ipp_status_400s[0])); i ++)
88f9aafc 2011 if (!_cups_strcasecmp(name, ipp_status_400s[i]))
ef416fc2 2012 return ((ipp_status_t)(i + 0x400));
2013
a469f8a5
MS		 2014 for (i = 0; i < (sizeof(ipp_status_480s) / sizeof(ipp_status_480s[0])); i ++)
2015 if (!_cups_strcasecmp(name, ipp_status_480s[i]))
2016 return ((ipp_status_t)(i + 0x480));
2017
ef416fc2 2018 for (i = 0; i < (sizeof(ipp_status_500s) / sizeof(ipp_status_500s[0])); i ++)
88f9aafc 2019 if (!_cups_strcasecmp(name, ipp_status_500s[i]))
ef416fc2 2020 return ((ipp_status_t)(i + 0x500));
2021
7cf5915e 2022 for (i = 0; i < (sizeof(ipp_status_1000s) / sizeof(ipp_status_1000s[0])); i ++)
88f9aafc 2023 if (!_cups_strcasecmp(name, ipp_status_1000s[i]))
7cf5915e
MS		 2024 return ((ipp_status_t)(i + 0x1000));
2025
ef416fc2 2026 return ((ipp_status_t)-1);
2027}
2028
2029
2030/*
2031 * 'ippOpString()' - Return a name for the given operation id.
2032 *
f3c17241 2033 * @since CUPS 1.2/OS X 10.5@
ef416fc2 2034 */
2035
2036const char * /* O - Name */
2037ippOpString(ipp_op_t op) /* I - Operation ID */
2038{
2039 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
2040
2041
2042 /*
2043 * See if the operation ID is a known value...
2044 */
2045
db8b865d 2046 if (op >= IPP_OP_PRINT_JOB && op <= IPP_OP_VALIDATE_DOCUMENT)
ef416fc2 2047 return (ipp_std_ops[op]);
a469f8a5 2048 else if (op == IPP_OP_PRIVATE)
ef416fc2 2049 return ("windows-ext");
a469f8a5 2050 else if (op >= IPP_OP_CUPS_GET_DEFAULT && op <= IPP_OP_CUPS_GET_PPD)
cb7f98ee 2051 return (ipp_cups_ops[op - IPP_OP_CUPS_GET_DEFAULT]);
a469f8a5 2052 else if (op == IPP_OP_CUPS_GET_DOCUMENT)
2e4ff8af 2053 return (ipp_cups_ops2[0]);
ef416fc2 2054
2055 /*
d7225fc2 2056 * No, build an "0xxxxx" operation string...
ef416fc2 2057 */
2058
9b66acc5 2059 sprintf(cg->ipp_unknown, "0x%04x", op);
ef416fc2 2060
2061 return (cg->ipp_unknown);
2062}
2063
2064
2065/*
2066 * 'ippOpValue()' - Return an operation id for the given name.
2067 *
f3c17241 2068 * @since CUPS 1.2/OS X 10.5@
ef416fc2 2069 */
2070
2071ipp_op_t /* O - Operation ID */
2072ippOpValue(const char *name) /* I - Textual name */
2073{
7e86f2f6 2074 size_t i; /* Looping var */
ef416fc2 2075
2076
9b66acc5
MS		 2077 if (!strncmp(name, "0x", 2))
2078 return ((ipp_op_t)strtol(name + 2, NULL, 16));
2079
ef416fc2 2080 for (i = 0; i < (sizeof(ipp_std_ops) / sizeof(ipp_std_ops[0])); i ++)
88f9aafc 2081 if (!_cups_strcasecmp(name, ipp_std_ops[i]))
ef416fc2 2082 return ((ipp_op_t)i);
2083
88f9aafc 2084 if (!_cups_strcasecmp(name, "windows-ext"))
a469f8a5 2085 return (IPP_OP_PRIVATE);
ef416fc2 2086
2087 for (i = 0; i < (sizeof(ipp_cups_ops) / sizeof(ipp_cups_ops[0])); i ++)
88f9aafc 2088 if (!_cups_strcasecmp(name, ipp_cups_ops[i]))
ef416fc2 2089 return ((ipp_op_t)(i + 0x4001));
2090
2e4ff8af 2091 for (i = 0; i < (sizeof(ipp_cups_ops2) / sizeof(ipp_cups_ops2[0])); i ++)
88f9aafc 2092 if (!_cups_strcasecmp(name, ipp_cups_ops2[i]))
2e4ff8af
MS		 2093 return ((ipp_op_t)(i + 0x4027));
2094
42404685
MS		 2095 if (!_cups_strcasecmp(name, "Create-Job-Subscription"))
2096 return (IPP_OP_CREATE_JOB_SUBSCRIPTIONS);
2097
2098 if (!_cups_strcasecmp(name, "Create-Printer-Subscription"))
2099 return (IPP_OP_CREATE_PRINTER_SUBSCRIPTIONS);
2100
88f9aafc 2101 if (!_cups_strcasecmp(name, "CUPS-Add-Class"))
a469f8a5 2102 return (IPP_OP_CUPS_ADD_MODIFY_CLASS);
480ef0fe 2103
88f9aafc 2104 if (!_cups_strcasecmp(name, "CUPS-Add-Printer"))
a469f8a5 2105 return (IPP_OP_CUPS_ADD_MODIFY_PRINTER);
480ef0fe 2106
a469f8a5 2107 return (IPP_OP_CUPS_INVALID);
ef416fc2 2108}
2109
2110
2111/*
2112 * 'ippPort()' - Return the default IPP port number.
2113 */
2114
2115int /* O - Port number */
2116ippPort(void)
2117{
ef416fc2 2118 _cups_globals_t *cg = _cupsGlobals(); /* Pointer to library globals */
2119
2120
d09495fa 2121 DEBUG_puts("ippPort()");
2122
2123 if (!cg->ipp_port)
e07d4801 2124 _cupsSetDefaults();
d09495fa 2125
e07d4801 2126 DEBUG_printf(("1ippPort: Returning %d...", cg->ipp_port));
d09495fa 2127
ef416fc2 2128 return (cg->ipp_port);
2129}
2130
2131
2132/*
2133 * 'ippSetPort()' - Set the default port number.
2134 */
2135
2136void
2137ippSetPort(int p) /* I - Port number to use */
2138{
e07d4801 2139 DEBUG_printf(("ippSetPort(p=%d)", p));
d09495fa 2140
ef416fc2 2141 _cupsGlobals()->ipp_port = p;
2142}
2143
2144
d21dc0ed
MS		 2145/*
2146 * 'ippStateString()' - Return the name corresponding to a state value.
2147 *
e1f19878 2148 * @since CUPS 2.0/OS 10.10@
d21dc0ed
MS		 2149 */
2150
2151const char * /* O - State name */
2152ippStateString(ipp_state_t state) /* I - State value */
2153{
2154 if (state >= IPP_STATE_ERROR && state <= IPP_STATE_DATA)
2155 return (ipp_states[state - IPP_STATE_ERROR]);
2156 else
2157 return ("UNKNOWN");
2158}
2159
2160
ef416fc2 2161/*
1ff0402e
MS		 2162 * 'ippTagString()' - Return the tag name corresponding to a tag value.
2163 *
2164 * The returned names are defined in RFC 2911 and 3382.
2165 *
f3c17241 2166 * @since CUPS 1.4/OS X 10.6@
1ff0402e
MS		 2167 */
2168
2169const char * /* O - Tag name */
2170ippTagString(ipp_tag_t tag) /* I - Tag value */
2171{
cb7f98ee 2172 tag &= IPP_TAG_CUPS_MASK;
ed6e7faf 2173
1ff0402e
MS		 2174 if (tag < (ipp_tag_t)(sizeof(ipp_tag_names) / sizeof(ipp_tag_names[0])))
2175 return (ipp_tag_names[tag]);
2176 else
2177 return ("UNKNOWN");
2178}
2179
2180
2181/*
2182 * 'ippTagValue()' - Return the tag value corresponding to a tag name.
2183 *
2184 * The tag names are defined in RFC 2911 and 3382.
2185 *
f3c17241 2186 * @since CUPS 1.4/OS X 10.6@
1ff0402e
MS		 2187 */
2188
2189ipp_tag_t /* O - Tag value */
2190ippTagValue(const char *name) /* I - Tag name */
2191{
7e86f2f6 2192 size_t i; /* Looping var */
1ff0402e
MS		 2193
2194
2195 for (i = 0; i < (sizeof(ipp_tag_names) / sizeof(ipp_tag_names[0])); i ++)
88f9aafc 2196 if (!_cups_strcasecmp(name, ipp_tag_names[i]))
1ff0402e
MS		 2197 return ((ipp_tag_t)i);
2198
88f9aafc 2199 if (!_cups_strcasecmp(name, "operation"))
1ff0402e 2200 return (IPP_TAG_OPERATION);
88f9aafc 2201 else if (!_cups_strcasecmp(name, "job"))
1ff0402e 2202 return (IPP_TAG_JOB);
88f9aafc 2203 else if (!_cups_strcasecmp(name, "printer"))
1ff0402e 2204 return (IPP_TAG_PRINTER);
88f9aafc 2205 else if (!_cups_strcasecmp(name, "unsupported"))
5a6b583a 2206 return (IPP_TAG_UNSUPPORTED_GROUP);
88f9aafc 2207 else if (!_cups_strcasecmp(name, "subscription"))
1ff0402e 2208 return (IPP_TAG_SUBSCRIPTION);
88f9aafc 2209 else if (!_cups_strcasecmp(name, "event"))
5a6b583a 2210 return (IPP_TAG_EVENT_NOTIFICATION);
88f9aafc 2211 else if (!_cups_strcasecmp(name, "language"))
1ff0402e 2212 return (IPP_TAG_LANGUAGE);
88f9aafc 2213 else if (!_cups_strcasecmp(name, "mimetype"))
1ff0402e 2214 return (IPP_TAG_MIMETYPE);
88f9aafc 2215 else if (!_cups_strcasecmp(name, "name"))
1ff0402e 2216 return (IPP_TAG_NAME);
88f9aafc 2217 else if (!_cups_strcasecmp(name, "text"))
1ff0402e 2218 return (IPP_TAG_TEXT);
88f9aafc 2219 else if (!_cups_strcasecmp(name, "begCollection"))
5a6b583a 2220 return (IPP_TAG_BEGIN_COLLECTION);
1ff0402e
MS		 2221 else
2222 return (IPP_TAG_ZERO);
2223}
2224
2225
2226/*
1106b00e
MS		 2227 * 'ipp_col_string()' - Convert a collection to a string.
2228 */
2229
2230static size_t /* O - Number of bytes */
2231ipp_col_string(ipp_t *col, /* I - Collection attribute */
2232 char *buffer, /* I - Buffer or NULL */
2233 size_t bufsize) /* I - Size of buffer */
2234{
2235 char *bufptr, /* Position in buffer */
2236 *bufend, /* End of buffer */
9c80ffa2 2237 prefix = '{', /* Prefix character */
1106b00e
MS		 2238 temp[256]; /* Temporary string */
2239 ipp_attribute_t *attr; /* Current member attribute */
2240
2241
2c69d462
MS		 2242 if (!col)
2243 {
2244 if (buffer)
2245 *buffer = '\0';
2246
2247 return (0);
2248 }
2249
1106b00e
MS		 2250 bufptr = buffer;
2251 bufend = buffer + bufsize - 1;
2252
1106b00e
MS		 2253 for (attr = col->attrs; attr; attr = attr->next)
2254 {
2255 if (!attr->name)
2256 continue;
2257
9c80ffa2
MS		 2258 if (buffer && bufptr < bufend)
2259 *bufptr = prefix;
2260 bufptr ++;
2261 prefix = ' ';
2262
1106b00e 2263 if (buffer && bufptr < bufend)
07623986 2264 bufptr += snprintf(bufptr, (size_t)(bufend - bufptr + 1), "%s=", attr->name);
1106b00e
MS		 2265 else
2266 bufptr += strlen(attr->name) + 1;
2267
2268 if (buffer && bufptr < bufend)
7e86f2f6 2269 bufptr += ippAttributeString(attr, bufptr, (size_t)(bufend - bufptr + 1));
1106b00e 2270 else
a2326b5b 2271 bufptr += ippAttributeString(attr, temp, sizeof(temp));
1106b00e
MS		 2272 }
2273
9c80ffa2
MS		 2274 if (prefix == '{')
2275 {
2276 if (buffer && bufptr < bufend)
2277 *bufptr = prefix;
2278 bufptr ++;
2279 }
2280
1106b00e
MS		 2281 if (buffer && bufptr < bufend)
2282 *bufptr = '}';
2283 bufptr ++;
2284
7e86f2f6 2285 return ((size_t)(bufptr - buffer));
1106b00e
MS		 2286}
2287
2288
2289/*
f2d18633 2290 * End of "$Id$".
ef416fc2 2291 */
Unnamed repository; edit this file 'description' to name the repository.