4 * Backend test program for the Common UNIX Printing System (CUPS).
6 * Copyright 2007-2009 by Apple Inc.
7 * Copyright 1997-2005 by Easy Software Products, all rights reserved.
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 * "LICENSE" which should have been included with this file. If this
13 * file is missing or damaged, see the license at "http://www.cups.org/".
15 * This file is subject to the Apple OS-Developed Software exception.
19 * main() - Run the named backend.
20 * usage() - Show usage information.
21 * walk_cb() - Show results of cupsSideChannelSNMPWalk...
25 * Include necessary headers.
30 #include <cups/string.h>
31 #include <cups/cups.h>
32 #include <cups/sidechannel.h>
43 static void usage(void);
44 static void walk_cb(const char *oid
, const char *data
, int datalen
,
49 * 'main()' - Run the named backend.
53 * betest [-s] [-t] device-uri job-id user title copies options [file]
56 int /* O - Exit status */
57 main(int argc
, /* I - Number of command-line args */
58 char *argv
[]) /* I - Command-line arguments */
60 int first_arg
, /* First argument for backend */
61 do_query
= 0, /* Do PostScript query? */
62 do_side_tests
= 0, /* Test side-channel ops? */
63 do_trickle
= 0, /* Trickle data to backend */
64 do_walk
= 0, /* Do OID lookup (0) or walking (1) */
65 show_log
= 0; /* Show log messages from backends? */
66 const char *oid
= ".1.3.6.1.2.1.43.10.2.1.4.1.1";
67 /* OID to lookup or walk */
68 char scheme
[255], /* Scheme in URI == backend */
69 backend
[1024]; /* Backend path */
70 const char *serverbin
; /* CUPS_SERVERBIN environment variable */
71 int back_fds
[2], /* Back-channel pipe */
72 side_fds
[2], /* Side-channel socket */
73 data_fds
[2], /* Data pipe */
75 status
; /* Exit status */
79 * See if we have side-channel tests to do...
83 argv
[first_arg
] && argv
[first_arg
][0] == '-';
85 if (!strcmp(argv
[first_arg
], "-d"))
87 else if (!strcmp(argv
[first_arg
], "-ps"))
89 else if (!strcmp(argv
[first_arg
], "-s"))
91 else if (!strcmp(argv
[first_arg
], "-t"))
93 else if (!strcmp(argv
[first_arg
], "-get") && (first_arg
+ 1) < argc
)
98 oid
= argv
[first_arg
];
100 else if (!strcmp(argv
[first_arg
], "-walk") && (first_arg
+ 1) < argc
)
106 oid
= argv
[first_arg
];
112 if (argc
< 6 || argc
> 7 || (argc
== 7 && do_trickle
))
116 * Extract the scheme from the device-uri - that's the program we want to
120 if (sscanf(argv
[first_arg
], "%254[^:]", scheme
) != 1)
122 fputs("testbackend: Bad device-uri - no colon!\n", stderr
);
126 if (!access(scheme
, X_OK
))
127 strlcpy(backend
, scheme
, sizeof(backend
));
130 if ((serverbin
= getenv("CUPS_SERVERBIN")) == NULL
)
131 serverbin
= CUPS_SERVERBIN
;
133 snprintf(backend
, sizeof(backend
), "%s/backend/%s", serverbin
, scheme
);
134 if (access(backend
, X_OK
))
136 fprintf(stderr
, "testbackend: Unknown device scheme \"%s\"!\n", scheme
);
142 * Create the back-channel pipe and side-channel socket...
145 open("/dev/null", O_WRONLY
); /* Make sure fd 3 and 4 are used */
146 open("/dev/null", O_WRONLY
);
149 fcntl(back_fds
[0], F_SETFL
, fcntl(back_fds
[0], F_GETFL
) | O_NONBLOCK
);
150 fcntl(back_fds
[1], F_SETFL
, fcntl(back_fds
[1], F_GETFL
) | O_NONBLOCK
);
152 socketpair(AF_LOCAL
, SOCK_STREAM
, 0, side_fds
);
153 fcntl(side_fds
[0], F_SETFL
, fcntl(side_fds
[0], F_GETFL
) | O_NONBLOCK
);
154 fcntl(side_fds
[1], F_SETFL
, fcntl(side_fds
[1], F_GETFL
) | O_NONBLOCK
);
157 * Execute the trickle process as needed...
160 if (do_trickle
|| do_query
)
164 if ((pid
= fork()) == 0)
167 * Trickle/query child comes here... Rearrange file descriptors so that
172 open("/dev/null", O_RDONLY
);
192 * Write 10 spaces, 1 per second...
195 int i
; /* Looping var */
197 for (i
= 0; i
< 10; i
++)
206 * Do a simple PostScript query job to get the default page size.
209 char buffer
[1024]; /* Buffer for response data */
210 ssize_t bytes
; /* Number of bytes of response data */
211 static const char *ps_query
= /* PostScript query file */
215 "currentpagedevice /PageSize get aload pop\n"
216 "2 copy gt {exch} if\n"
219 "dup [612 792] (Letter) put\n"
220 "dup [612 1008] (Legal) put\n"
221 "dup [612 935] (w612h935) put\n"
222 "dup [522 756] (Executive) put\n"
223 "dup [595 842] (A4) put\n"
224 "dup [420 595] (A5) put\n"
225 "dup [499 709] (ISOB5) put\n"
226 "dup [516 728] (B5) put\n"
227 "dup [612 936] (w612h936) put\n"
228 "dup [284 419] (Postcard) put\n"
229 "dup [419.5 567] (DoublePostcard) put\n"
230 "dup [558 774] (w558h774) put\n"
231 "dup [553 765] (w553h765) put\n"
232 "dup [522 737] (w522h737) put\n"
233 "dup [499 709] (EnvISOB5) put\n"
234 "dup [297 684] (Env10) put\n"
235 "dup [459 649] (EnvC5) put\n"
236 "dup [312 624] (EnvDL) put\n"
237 "dup [279 540] (EnvMonarch) put\n"
238 "{ exch aload pop 4 index sub abs 5 le exch\n"
239 " 5 index sub abs 5 le and\n"
240 " {exch pop exit} {pop} ifelse\n"
247 write(1, ps_query
, strlen(ps_query
));
248 write(2, "DEBUG: START\n", 13);
249 while ((bytes
= cupsBackChannelRead(buffer
, sizeof(buffer
), 5.0)) > 0)
250 write(2, buffer
, bytes
);
251 write(2, "\nDEBUG: END\n", 12);
258 perror("testbackend: Unable to fork");
263 data_fds
[0] = data_fds
[1] = -1;
266 * Execute the backend...
269 if ((pid
= fork()) == 0)
272 * Child comes here...
275 if (do_trickle
|| do_query
)
286 open("/dev/null", O_WRONLY
);
299 execv(backend
, argv
+ first_arg
);
300 fprintf(stderr
, "textbackend: Unable to execute \"%s\": %s\n", backend
,
306 perror("testbackend: Unable to fork");
311 * Parent comes here, setup back and side channel file descriptors...
314 if (do_trickle
|| do_query
)
331 * Do side-channel tests as needed, then wait for the backend...
336 int length
; /* Length of buffer */
337 char buffer
[2049]; /* Buffer for reponse */
338 cups_sc_status_t scstatus
; /* Status of side-channel command */
339 static const char * const statuses
[] =
341 "CUPS_SC_STATUS_NONE", /* No status */
342 "CUPS_SC_STATUS_OK", /* Operation succeeded */
343 "CUPS_SC_STATUS_IO_ERROR", /* An I/O error occurred */
344 "CUPS_SC_STATUS_TIMEOUT", /* The backend did not respond */
345 "CUPS_SC_STATUS_NO_RESPONSE", /* The device did not respond */
346 "CUPS_SC_STATUS_BAD_MESSAGE", /* The command/response message was invalid */
347 "CUPS_SC_STATUS_TOO_BIG", /* Response too big */
348 "CUPS_SC_STATUS_NOT_IMPLEMENTED" /* Command not implemented */
355 scstatus
= cupsSideChannelDoRequest(CUPS_SC_CMD_DRAIN_OUTPUT
, buffer
,
357 printf("CUPS_SC_CMD_DRAIN_OUTPUT returned %s\n", statuses
[scstatus
]);
360 scstatus
= cupsSideChannelDoRequest(CUPS_SC_CMD_GET_BIDI
, buffer
,
362 printf("CUPS_SC_CMD_GET_BIDI returned %s, %d\n", statuses
[scstatus
], buffer
[0]);
364 length
= sizeof(buffer
) - 1;
365 scstatus
= cupsSideChannelDoRequest(CUPS_SC_CMD_GET_DEVICE_ID
, buffer
,
367 buffer
[length
] = '\0';
368 printf("CUPS_SC_CMD_GET_DEVICE_ID returned %s, \"%s\"\n",
369 statuses
[scstatus
], buffer
);
372 scstatus
= cupsSideChannelDoRequest(CUPS_SC_CMD_GET_STATE
, buffer
,
374 printf("CUPS_SC_CMD_GET_STATE returned %s, %02X\n", statuses
[scstatus
],
380 * Walk the OID tree...
383 scstatus
= cupsSideChannelSNMPWalk(oid
, 5.0, walk_cb
, NULL
);
384 printf("CUPS_SC_CMD_SNMP_WALK returned %s\n", statuses
[scstatus
]);
389 * Lookup the same OID twice...
392 length
= sizeof(buffer
);
393 scstatus
= cupsSideChannelSNMPGet(oid
, buffer
, &length
, 5.0);
394 printf("CUPS_SC_CMD_SNMP_GET %s returned %s, %s\n", oid
,
395 statuses
[scstatus
], buffer
);
397 length
= sizeof(buffer
);
398 scstatus
= cupsSideChannelSNMPGet(oid
, buffer
, &length
, 5.0);
399 printf("CUPS_SC_CMD_SNMP_GET %s returned %s, %s\n", oid
,
400 statuses
[scstatus
], buffer
);
404 scstatus
= cupsSideChannelDoRequest(CUPS_SC_CMD_SOFT_RESET
, buffer
,
406 printf("CUPS_SC_CMD_SOFT_RESET returned %s\n", statuses
[scstatus
]);
409 while (wait(&status
) != pid
);
413 if (WIFEXITED(status
))
414 printf("%s exited with status %d!\n", backend
, WEXITSTATUS(status
));
416 printf("%s crashed with signal %d!\n", backend
, WTERMSIG(status
));
420 * Exit accordingly...
423 return (status
!= 0);
428 * 'usage()' - Show usage information.
434 puts("Usage: testbackend [-d] [-ps] [-s [-oid OID] [-walk OID]] [-t] "
435 "device-uri job-id user title copies options [file]");
438 puts(" -d Show log messages from backend.");
439 puts(" -oid OID Lookup the specified SNMP OID.");
440 puts(" -ps Send PostScript query code to backend.");
441 puts(" -s Do SNMP tests.");
442 puts(" -t Send spaces slowly to backend ('trickle').");
443 puts(" -walk OID Walk the specified SNMP OID.");
450 * 'walk_cb()' - Show results of cupsSideChannelSNMPWalk...
454 walk_cb(const char *oid
, /* I - OID */
455 const char *data
, /* I - Data */
456 int datalen
, /* I - Length of data */
457 void *context
) /* I - Context (unused) */
459 printf("CUPS_SC_CMD_SNMP_WALK %s=%s (%d bytes)\n", oid
, data
, datalen
);