]>
Commit | Line | Data |
---|---|---|
104fd4ae MS |
1 | /* |
2 | * "$Id$" | |
3 | * | |
4 | * CUPS destination API test program for CUPS. | |
5 | * | |
6 | * Copyright 2014 by Apple Inc. | |
7 | * | |
8 | * These coded instructions, statements, and computer programs are the | |
9 | * property of Apple Inc. and are protected by Federal copyright | |
10 | * law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
11 | * which should have been included with this file. If this file is | |
12 | * file is missing or damaged, see the license at "http://www.cups.org/". | |
13 | * | |
14 | * This file is subject to the Apple OS-Developed Software exception. | |
15 | */ | |
16 | ||
17 | /* | |
18 | * Include necessary headers... | |
19 | */ | |
20 | ||
21 | #include <stdio.h> | |
22 | #include "cups.h" | |
23 | ||
24 | ||
25 | /* | |
26 | * Local functions... | |
27 | */ | |
28 | ||
29 | static void localize(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, const char *option, const char *value); | |
30 | static void print_file(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, const char *filename, int num_options, cups_option_t *options); | |
31 | static void show_conflicts(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, int num_options, cups_option_t *options); | |
32 | static void show_default(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, const char *option); | |
33 | static void show_media(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, unsigned flags, const char *name); | |
34 | static void show_supported(http_t *http, cups_dest_t *dest, cups_dinfo_t *dinfo, const char *option, const char *value); | |
35 | static void usage(const char *arg) __attribute__((noreturn)); | |
36 | ||
37 | ||
38 | /* | |
39 | * 'main()' - Main entry. | |
40 | */ | |
41 | ||
42 | int /* O - Exit status */ | |
43 | main(int argc, /* I - Number of command-line arguments */ | |
44 | char *argv[]) /* I - Command-line arguments */ | |
45 | { | |
46 | http_t *http; /* Connection to destination */ | |
47 | cups_dest_t *dest = NULL; /* Destination */ | |
48 | cups_dinfo_t *dinfo; /* Destination info */ | |
49 | ||
50 | ||
51 | if (argc < 2) | |
52 | usage(NULL); | |
53 | ||
54 | if (!strcmp(argv[1], "--enum")) | |
55 | { | |
56 | return (0); | |
57 | } | |
58 | else if (!strncmp(argv[1], "ipp://", 6) || !strncmp(argv[1], "ipps://", 7)) | |
59 | dest = cupsGetDestWithURI(NULL, argv[1]); | |
60 | else | |
61 | dest = cupsGetNamedDest(CUPS_HTTP_DEFAULT, argv[1], NULL); | |
62 | ||
63 | if (!dest) | |
64 | { | |
65 | printf("testdest: Unable to get destination \"%s\": %s\n", argv[1], cupsLastErrorString()); | |
66 | return (1); | |
67 | } | |
68 | ||
69 | if ((http = cupsConnectDest(dest, CUPS_DEST_FLAGS_NONE, 30000, NULL, NULL, 0, NULL, NULL)) == NULL) | |
70 | { | |
71 | printf("testdest: Unable to connect to destination \"%s\": %s\n", argv[1], cupsLastErrorString()); | |
72 | return (1); | |
73 | } | |
74 | ||
75 | if ((dinfo = cupsCopyDestInfo(http, dest)) == NULL) | |
76 | { | |
77 | printf("testdest: Unable to get information for destination \"%s\": %s\n", argv[1], cupsLastErrorString()); | |
78 | return (1); | |
79 | } | |
80 | ||
81 | if (argc == 2 || (!strcmp(argv[2], "supported") && argc < 6)) | |
82 | { | |
83 | if (argc > 3) | |
84 | show_supported(http, dest, dinfo, argv[3], argv[4]); | |
85 | else if (argc > 2) | |
86 | show_supported(http, dest, dinfo, argv[3], NULL); | |
87 | else | |
88 | show_supported(http, dest, dinfo, NULL, NULL); | |
89 | } | |
90 | else if (!strcmp(argv[2], "conflicts") && argc > 3) | |
91 | { | |
92 | int i, /* Looping var */ | |
93 | num_options = 0;/* Number of options */ | |
94 | cups_option_t *options = NULL;/* Options */ | |
95 | ||
96 | for (i = 3; i < argc; i ++) | |
97 | num_options = cupsParseOptions(argv[i], num_options, &options); | |
98 | ||
99 | show_conflicts(http, dest, dinfo, num_options, options); | |
100 | } | |
101 | else if (!strcmp(argv[2], "default") && argc == 4) | |
102 | { | |
103 | show_default(http, dest, dinfo, argv[3]); | |
104 | } | |
105 | else if (!strcmp(argv[2], "localize") && argc > 3 && argc < 6) | |
106 | { | |
107 | localize(http, dest, dinfo, argv[3], argv[4]); | |
108 | } | |
109 | else if (!strcmp(argv[2], "media")) | |
110 | { | |
111 | int i; /* Looping var */ | |
112 | const char *name = NULL; /* Media name, if any */ | |
113 | unsigned flags = CUPS_MEDIA_FLAGS_DEFAULT; | |
114 | /* Media selection flags */ | |
115 | ||
116 | for (i = 3; i < argc; i ++) | |
117 | { | |
118 | if (!strcmp(argv[i], "borderless")) | |
119 | flags = CUPS_MEDIA_FLAGS_BORDERLESS; | |
120 | else if (!strcmp(argv[i], "duplex")) | |
121 | flags = CUPS_MEDIA_FLAGS_DUPLEX; | |
122 | else if (!strcmp(argv[i], "exact")) | |
123 | flags = CUPS_MEDIA_FLAGS_EXACT; | |
124 | else if (!strcmp(argv[i], "ready")) | |
125 | flags = CUPS_MEDIA_FLAGS_READY; | |
126 | else if (name) | |
127 | usage(argv[i]); | |
128 | else | |
129 | name = argv[i]; | |
130 | } | |
131 | ||
132 | show_media(http, dest, dinfo, flags, name); | |
133 | } | |
134 | else if (!strcmp(argv[2], "print") && argc > 3) | |
135 | { | |
136 | int i, /* Looping var */ | |
137 | num_options = 0;/* Number of options */ | |
138 | cups_option_t *options = NULL;/* Options */ | |
139 | ||
140 | for (i = 4; i < argc; i ++) | |
141 | num_options = cupsParseOptions(argv[i], num_options, &options); | |
142 | ||
143 | print_file(http, dest, dinfo, argv[3], num_options, options); | |
144 | } | |
145 | else | |
146 | usage(argv[2]); | |
147 | ||
148 | return (0); | |
149 | } | |
150 | ||
151 | ||
152 | /* | |
153 | * 'localize()' - Localize an option and value. | |
154 | */ | |
155 | ||
156 | static void | |
157 | localize(http_t *http, /* I - Connection to destination */ | |
158 | cups_dest_t *dest, /* I - Destination */ | |
159 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
160 | const char *option, /* I - Option */ | |
161 | const char *value) /* I - Value, if any */ | |
162 | { | |
163 | (void)http; | |
164 | (void)dest; | |
165 | (void)dinfo; | |
166 | (void)option; | |
167 | (void)value; | |
168 | } | |
169 | ||
170 | ||
171 | /* | |
172 | * 'print_file()' - Print a file. | |
173 | */ | |
174 | ||
175 | static void | |
176 | print_file(http_t *http, /* I - Connection to destination */ | |
177 | cups_dest_t *dest, /* I - Destination */ | |
178 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
179 | const char *filename, /* I - File to print */ | |
180 | int num_options, /* I - Number of options */ | |
181 | cups_option_t *options) /* I - Options */ | |
182 | { | |
183 | (void)http; | |
184 | (void)dest; | |
185 | (void)dinfo; | |
186 | (void)filename; | |
187 | (void)num_options; | |
188 | (void)options; | |
189 | } | |
190 | ||
191 | ||
192 | /* | |
193 | * 'show_conflicts()' - Show conflicts for selected options. | |
194 | */ | |
195 | ||
196 | static void | |
197 | show_conflicts( | |
198 | http_t *http, /* I - Connection to destination */ | |
199 | cups_dest_t *dest, /* I - Destination */ | |
200 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
201 | int num_options, /* I - Number of options */ | |
202 | cups_option_t *options) /* I - Options */ | |
203 | { | |
204 | (void)http; | |
205 | (void)dest; | |
206 | (void)dinfo; | |
207 | (void)num_options; | |
208 | (void)options; | |
209 | } | |
210 | ||
211 | ||
212 | /* | |
213 | * 'show_default()' - Show default value for option. | |
214 | */ | |
215 | ||
216 | static void | |
217 | show_default(http_t *http, /* I - Connection to destination */ | |
218 | cups_dest_t *dest, /* I - Destination */ | |
219 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
220 | const char *option) /* I - Option */ | |
221 | { | |
222 | (void)http; | |
223 | (void)dest; | |
224 | (void)dinfo; | |
225 | (void)option; | |
226 | } | |
227 | ||
228 | ||
229 | /* | |
230 | * 'show_media()' - Show available media. | |
231 | */ | |
232 | ||
233 | static void | |
234 | show_media(http_t *http, /* I - Connection to destination */ | |
235 | cups_dest_t *dest, /* I - Destination */ | |
236 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
237 | unsigned flags, /* I - Media flags */ | |
238 | const char *name) /* I - Size name */ | |
239 | { | |
240 | int i, /* Looping var */ | |
241 | count; /* Number of sizes */ | |
242 | cups_size_t size; /* Media size info */ | |
243 | ||
244 | ||
245 | if (name) | |
246 | { | |
247 | double dw, dl; /* Width and length from name */ | |
248 | char units[32]; /* Units */ | |
249 | int width, /* Width in 100ths of millimeters */ | |
250 | length; /* Length in 100ths of millimeters */ | |
251 | ||
252 | ||
253 | if (sscanf(name, "%lfx%lf%31s", &dw, &dl, units) == 3) | |
254 | { | |
255 | if (!strcmp(units, "in")) | |
256 | { | |
257 | width = (int)(dw * 2540.0); | |
258 | length = (int)(dl * 2540.0); | |
259 | } | |
260 | else if (!strcmp(units, "mm")) | |
261 | { | |
262 | width = (int)(dw * 100.0); | |
263 | length = (int)(dl * 100.0); | |
264 | } | |
265 | else | |
266 | { | |
267 | puts(" bad units in size"); | |
268 | return; | |
269 | } | |
270 | ||
271 | if (cupsGetDestMediaBySize(http, dest, dinfo, width, length, flags, &size)) | |
272 | { | |
273 | printf(" %s (%s) %dx%d B%d L%d R%d T%d\n", size.media, cupsLocalizeDestMedia(http, dest, dinfo, flags, &size), size.width, size.length, size.bottom, size.left, size.right, size.top); | |
274 | } | |
275 | else | |
276 | { | |
277 | puts(" not supported"); | |
278 | } | |
279 | } | |
280 | else if (cupsGetDestMediaByName(http, dest, dinfo, name, flags, &size)) | |
281 | { | |
282 | printf(" %s (%s) %dx%d B%d L%d R%d T%d\n", size.media, cupsLocalizeDestMedia(http, dest, dinfo, flags, &size), size.width, size.length, size.bottom, size.left, size.right, size.top); | |
283 | } | |
284 | else | |
285 | { | |
286 | puts(" not supported"); | |
287 | } | |
288 | } | |
289 | else | |
290 | { | |
291 | count = cupsGetDestMediaCount(http, dest, dinfo, flags); | |
292 | printf("%d size%s:\n", count, count == 1 ? "" : "s"); | |
293 | ||
294 | for (i = 0; i < count; i ++) | |
295 | { | |
296 | if (cupsGetDestMediaByIndex(http, dest, dinfo, i, flags, &size)) | |
297 | printf(" %s (%s) %dx%d B%d L%d R%d T%d\n", size.media, cupsLocalizeDestMedia(http, dest, dinfo, flags, &size), size.width, size.length, size.bottom, size.left, size.right, size.top); | |
298 | else | |
299 | puts(" error"); | |
300 | } | |
301 | } | |
302 | } | |
303 | ||
304 | ||
305 | /* | |
306 | * 'show_supported()' - Show supported options, values, etc. | |
307 | */ | |
308 | ||
309 | static void | |
310 | show_supported(http_t *http, /* I - Connection to destination */ | |
311 | cups_dest_t *dest, /* I - Destination */ | |
312 | cups_dinfo_t *dinfo, /* I - Destination information */ | |
313 | const char *option, /* I - Option, if any */ | |
314 | const char *value) /* I - Value, if any */ | |
315 | { | |
316 | ipp_attribute_t *attr; /* Attribute */ | |
317 | int i, /* Looping var */ | |
318 | count; /* Number of values */ | |
319 | ||
320 | ||
321 | if (!option) | |
322 | { | |
323 | attr = cupsFindDestSupported(http, dest, dinfo, "job-creation-attributes"); | |
324 | if (attr) | |
325 | { | |
326 | count = ippGetCount(attr); | |
327 | for (i = 0; i < count; i ++) | |
328 | show_supported(http, dest, dinfo, ippGetString(attr, i, NULL), NULL); | |
329 | } | |
330 | else | |
331 | { | |
332 | static const char * const options[] = | |
333 | { /* List of standard options */ | |
334 | CUPS_COPIES, | |
335 | CUPS_FINISHINGS, | |
336 | CUPS_MEDIA, | |
337 | CUPS_NUMBER_UP, | |
338 | CUPS_ORIENTATION, | |
339 | CUPS_PRINT_COLOR_MODE, | |
340 | CUPS_PRINT_QUALITY, | |
341 | CUPS_SIDES | |
342 | }; | |
343 | ||
344 | puts("No job-creation-attributes-supported attribute, probing instead."); | |
345 | ||
346 | for (i = 0; i < (int)(sizeof(options) / sizeof(options[0])); i ++) | |
347 | if (cupsCheckDestSupported(http, dest, dinfo, options[i], NULL)) | |
348 | show_supported(http, dest, dinfo, options[i], NULL); | |
349 | } | |
350 | } | |
351 | else if (!value) | |
352 | { | |
353 | puts(option); | |
354 | if ((attr = cupsFindDestSupported(http, dest, dinfo, option)) != NULL) | |
355 | { | |
356 | count = ippGetCount(attr); | |
357 | ||
358 | switch (ippGetValueTag(attr)) | |
359 | { | |
360 | case IPP_TAG_INTEGER : | |
361 | for (i = 0; i < count; i ++) | |
362 | printf(" %d\n", ippGetInteger(attr, i)); | |
363 | break; | |
364 | ||
365 | case IPP_TAG_ENUM : | |
366 | for (i = 0; i < count; i ++) | |
367 | printf(" %s\n", ippEnumString(option, ippGetInteger(attr, i))); | |
368 | break; | |
369 | ||
370 | case IPP_TAG_RANGE : | |
371 | for (i = 0; i < count; i ++) | |
372 | { | |
373 | int upper, lower = ippGetRange(attr, i, &upper); | |
374 | ||
375 | printf(" %d-%d\n", lower, upper); | |
376 | } | |
377 | break; | |
378 | ||
379 | case IPP_TAG_TEXTLANG : | |
380 | case IPP_TAG_NAMELANG : | |
381 | case IPP_TAG_TEXT : | |
382 | case IPP_TAG_NAME : | |
383 | case IPP_TAG_KEYWORD : | |
384 | case IPP_TAG_URI : | |
385 | case IPP_TAG_URISCHEME : | |
386 | case IPP_TAG_CHARSET : | |
387 | case IPP_TAG_LANGUAGE : | |
388 | case IPP_TAG_MIMETYPE : | |
389 | for (i = 0; i < count; i ++) | |
390 | printf(" %s\n", ippGetString(attr, i, NULL)); | |
391 | break; | |
392 | ||
393 | case IPP_TAG_STRING : | |
394 | for (i = 0; i < count; i ++) | |
395 | { | |
396 | int j, len; | |
397 | unsigned char *data = ippGetOctetString(attr, i, &len); | |
398 | ||
399 | fputs(" ", stdout); | |
400 | for (j = 0; j < len; j ++) | |
401 | { | |
402 | if (data[j] < ' ' || data[j] >= 0x7f) | |
403 | printf("<%02X>", data[j]); | |
404 | else | |
405 | putchar(data[j]); | |
406 | } | |
407 | putchar('\n'); | |
408 | } | |
409 | break; | |
410 | ||
411 | case IPP_TAG_BOOLEAN : | |
412 | break; | |
413 | ||
414 | default : | |
415 | printf(" %s\n", ippTagString(ippGetValueTag(attr))); | |
416 | break; | |
417 | } | |
418 | } | |
419 | ||
420 | } | |
421 | else if (cupsCheckDestSupported(http, dest, dinfo, option, value)) | |
422 | puts("YES"); | |
423 | else | |
424 | puts("NO"); | |
425 | ||
426 | } | |
427 | ||
428 | ||
429 | /* | |
430 | * 'usage()' - Show program usage. | |
431 | */ | |
432 | ||
433 | static void | |
434 | usage(const char *arg) /* I - Argument for usage message */ | |
435 | { | |
436 | if (arg) | |
437 | printf("testdest: Unknown option \"%s\".\n", arg); | |
438 | ||
439 | puts("Usage:"); | |
440 | puts(" ./testdest name [operation ...]"); | |
441 | puts(" ./testdest ipp://... [operation ...]"); | |
442 | puts(" ./testdest ipps://... [operation ...]"); | |
443 | puts(" ./testdest --enum [grayscale] [color] [duplex] [staple] [small]\n" | |
444 | " [medium] [large]"); | |
445 | puts(""); | |
446 | puts("Operations:"); | |
447 | puts(" conflicts options"); | |
448 | puts(" default option"); | |
449 | puts(" localize option [value]"); | |
450 | puts(" media [borderless] [duplex] [exact] [ready] [name or size]"); | |
451 | puts(" print filename [options]"); | |
452 | puts(" supported [option [value]]"); | |
453 | ||
454 | exit(arg != NULL); | |
455 | } | |
456 | ||
457 | ||
458 | /* | |
459 | * End of "$Id$". | |
460 | */ |