2 * "$Id: parallel.c 7810 2008-07-29 01:11:15Z mike $"
4 * Parallel port backend for the Common UNIX Printing System (CUPS).
6 * Copyright 2007-2008 by Apple Inc.
7 * Copyright 1997-2007 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() - Send a file to the specified parallel port.
20 * list_devices() - List all parallel devices.
21 * side_cb() - Handle side-channel requests...
25 * Include necessary headers.
28 #include "backend-private.h"
31 # include <sys/time.h>
33 # include <sys/select.h>
42 # include <sys/socket.h>
47 # ifndef INV_EPP_ECP_PLP
48 # define INV_EPP_ECP_PLP 6 /* From 6.3/6.4/6.5 sys/invent.h */
49 # define INV_ASO_SERIAL 14 /* serial portion of SGI ASO board */
50 # define INV_IOC3_DMA 16 /* DMA mode IOC3 serial */
51 # define INV_IOC3_PIO 17 /* PIO mode IOC3 serial */
52 # define INV_ISA_DMA 19 /* DMA mode ISA serial -- O2 */
53 # endif /* !INV_EPP_ECP_PLP */
61 static void list_devices(void);
62 static int side_cb(int print_fd
, int device_fd
, int snmp_fd
,
63 http_addr_t
*addr
, int use_bc
);
67 * 'main()' - Send a file to the specified parallel port.
71 * printer-uri job-id user title copies options [file]
74 int /* O - Exit status */
75 main(int argc
, /* I - Number of command-line arguments (6 or 7) */
76 char *argv
[]) /* I - Command-line arguments */
78 char method
[255], /* Method in URI */
79 hostname
[1024], /* Hostname */
80 username
[255], /* Username info (not used) */
81 resource
[1024], /* Resource info (device and options) */
82 *options
; /* Pointer to options */
83 int port
; /* Port number (not used) */
84 int print_fd
, /* Print file */
85 device_fd
, /* Parallel device */
86 use_bc
; /* Read back-channel data? */
87 int copies
; /* Number of copies to print */
88 size_t tbytes
; /* Total number of bytes written */
89 struct termios opts
; /* Parallel port options */
90 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
91 struct sigaction action
; /* Actions for POSIX signals */
92 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
96 * Make sure status messages are not buffered...
102 * Ignore SIGPIPE signals...
106 sigset(SIGPIPE
, SIG_IGN
);
107 #elif defined(HAVE_SIGACTION)
108 memset(&action
, 0, sizeof(action
));
109 action
.sa_handler
= SIG_IGN
;
110 sigaction(SIGPIPE
, &action
, NULL
);
112 signal(SIGPIPE
, SIG_IGN
);
113 #endif /* HAVE_SIGSET */
116 * Check command-line...
122 return (CUPS_BACKEND_OK
);
124 else if (argc
< 6 || argc
> 7)
126 _cupsLangPrintf(stderr
,
127 _("Usage: %s job-id user title copies options [file]\n"),
129 return (CUPS_BACKEND_FAILED
);
133 * If we have 7 arguments, print the file named on the command-line.
134 * Otherwise, send stdin instead...
145 * Try to open the print file...
148 if ((print_fd
= open(argv
[6], O_RDONLY
)) < 0)
150 _cupsLangPrintf(stderr
,
151 _("ERROR: Unable to open print file \"%s\": %s\n"),
152 argv
[6], strerror(errno
));
153 return (CUPS_BACKEND_FAILED
);
156 copies
= atoi(argv
[4]);
160 * Extract the device name and options from the URI...
163 httpSeparateURI(HTTP_URI_CODING_ALL
, cupsBackendDeviceURI(argv
),
164 method
, sizeof(method
), username
, sizeof(username
),
165 hostname
, sizeof(hostname
), &port
,
166 resource
, sizeof(resource
));
169 * See if there are any options...
172 if ((options
= strchr(resource
, '?')) != NULL
)
175 * Yup, terminate the device name string and move to the first
176 * character of the options...
183 * Open the parallel port device...
186 fputs("STATE: +connecting-to-device\n", stderr
);
190 #if defined(__linux) || defined(__FreeBSD__)
192 * The Linux and FreeBSD parallel port drivers currently are broken WRT
193 * select() and bidirection I/O...
196 device_fd
= open(resource
, O_WRONLY
| O_EXCL
);
200 if ((device_fd
= open(resource
, O_RDWR
| O_EXCL
)) < 0)
202 device_fd
= open(resource
, O_WRONLY
| O_EXCL
);
207 #endif /* __linux || __FreeBSD__ */
211 if (getenv("CLASS") != NULL
)
214 * If the CLASS environment variable is set, the job was submitted
215 * to a class and not to a specific queue. In this case, we want
216 * to abort immediately so that the job can be requeued on the next
217 * available printer in the class.
220 _cupsLangPuts(stderr
,
221 _("INFO: Unable to contact printer, queuing on next "
222 "printer in class...\n"));
225 * Sleep 5 seconds to keep the job from requeuing too rapidly...
230 return (CUPS_BACKEND_FAILED
);
235 _cupsLangPuts(stderr
,
236 _("INFO: Printer busy; will retry in 30 seconds...\n"));
239 else if (errno
== ENXIO
|| errno
== EIO
|| errno
== ENOENT
)
241 _cupsLangPuts(stderr
,
242 _("INFO: Printer not connected; will retry in 30 "
248 _cupsLangPrintf(stderr
,
249 _("ERROR: Unable to open device file \"%s\": %s\n"),
250 resource
, strerror(errno
));
251 return (CUPS_BACKEND_FAILED
);
255 while (device_fd
< 0);
257 fputs("STATE: -connecting-to-device\n", stderr
);
260 * Set any options provided...
263 tcgetattr(device_fd
, &opts
);
265 opts
.c_lflag
&= ~(ICANON
| ECHO
| ISIG
); /* Raw mode */
267 /**** No options supported yet ****/
269 tcsetattr(device_fd
, TCSANOW
, &opts
);
272 * Finally, send the print file...
277 while (copies
> 0 && tbytes
>= 0)
283 fputs("PAGE: 1 1\n", stderr
);
284 lseek(print_fd
, 0, SEEK_SET
);
287 tbytes
= backendRunLoop(print_fd
, device_fd
, -1, NULL
, use_bc
, 1, side_cb
);
289 if (print_fd
!= 0 && tbytes
>= 0)
290 _cupsLangPrintf(stderr
,
291 #ifdef HAVE_LONG_LONG
292 _("INFO: Sent print file, %lld bytes...\n"),
294 _("INFO: Sent print file, %ld bytes...\n"),
295 #endif /* HAVE_LONG_LONG */
300 * Close the socket connection and input file and return...
308 return (tbytes
< 0 ? CUPS_BACKEND_FAILED
: CUPS_BACKEND_OK
);
313 * 'list_devices()' - List all parallel devices.
319 #if defined(__hpux) || defined(__sgi) || defined(__sun)
320 static char *funky_hex
= "0123456789abcdefghijklmnopqrstuvwxyz";
321 /* Funky hex numbering used for some devices */
322 #endif /* __hpux || __sgi || __sun */
325 int i
; /* Looping var */
326 int fd
; /* File descriptor */
327 char device
[255], /* Device filename */
328 basedevice
[255], /* Base device filename for ports */
329 device_id
[1024], /* Device ID string */
330 make_model
[1024], /* Make and model */
331 info
[1024], /* Info string */
332 uri
[1024]; /* Device URI */
335 if (!access("/dev/parallel/", 0))
336 strcpy(basedevice
, "/dev/parallel/");
337 else if (!access("/dev/printers/", 0))
338 strcpy(basedevice
, "/dev/printers/");
340 strcpy(basedevice
, "/dev/lp");
342 for (i
= 0; i
< 4; i
++)
345 * Open the port, if available...
348 sprintf(device
, "%s%d", basedevice
, i
);
349 if ((fd
= open(device
, O_RDWR
| O_EXCL
)) < 0)
350 fd
= open(device
, O_WRONLY
);
355 * Now grab the IEEE 1284 device ID string...
358 snprintf(uri
, sizeof(uri
), "parallel:%s", device
);
360 if (!backendGetDeviceID(fd
, device_id
, sizeof(device_id
),
361 make_model
, sizeof(make_model
),
362 NULL
, uri
, sizeof(uri
)))
364 snprintf(info
, sizeof(info
), "%s LPT #%d", make_model
, i
+ 1);
365 cupsBackendReport("direct", uri
, make_model
, info
, device_id
, NULL
);
369 snprintf(info
, sizeof(info
), "LPT #%d", i
+ 1);
370 cupsBackendReport("direct", uri
, NULL
, info
, NULL
, NULL
);
377 int i
, j
, n
; /* Looping vars */
378 char device
[255]; /* Device filename */
379 inventory_t
*inv
; /* Hardware inventory info */
383 * IRIX maintains a hardware inventory of most devices...
388 while ((inv
= getinvent()) != NULL
)
390 if (inv
->inv_class
== INV_PARALLEL
&&
391 (inv
->inv_type
== INV_ONBOARD_PLP
||
392 inv
->inv_type
== INV_EPP_ECP_PLP
))
395 * Standard parallel port...
398 puts("direct parallel:/dev/plp \"Unknown\" \"Onboard Parallel Port\"");
400 else if (inv
->inv_class
== INV_PARALLEL
&&
401 inv
->inv_type
== INV_EPC_PLP
)
404 * EPC parallel port...
407 printf("direct parallel:/dev/plp%d \"Unknown\" \"Integral EPC parallel port, Ebus slot %d\"\n",
408 inv
->inv_controller
, inv
->inv_controller
);
415 * Central Data makes serial and parallel "servers" that can be
416 * connected in a number of ways. Look for ports...
419 for (i
= 0; i
< 10; i
++)
420 for (j
= 0; j
< 8; j
++)
421 for (n
= 0; n
< 32; n
++)
423 if (i
== 8) /* EtherLite */
424 sprintf(device
, "/dev/lpn%d%c", j
, funky_hex
[n
]);
425 else if (i
== 9) /* PCI */
426 sprintf(device
, "/dev/lpp%d%c", j
, funky_hex
[n
]);
428 sprintf(device
, "/dev/lp%d%d%c", i
, j
, funky_hex
[n
]);
430 if (access(device
, 0) == 0)
433 printf("direct parallel:%s \"Unknown\" \"Central Data EtherLite Parallel Port, ID %d, port %d\"\n",
436 printf("direct parallel:%s \"Unknown\" \"Central Data PCI Parallel Port, ID %d, port %d\"\n",
439 printf("direct parallel:%s \"Unknown\" \"Central Data SCSI Parallel Port, logical bus %d, ID %d, port %d\"\n",
444 int i
, j
, n
; /* Looping vars */
445 char device
[255]; /* Device filename */
449 * Standard parallel ports...
452 for (i
= 0; i
< 10; i
++)
454 sprintf(device
, "/dev/ecpp%d", i
);
455 if (access(device
, 0) == 0)
456 printf("direct parallel:%s \"Unknown\" \"Sun IEEE-1284 Parallel Port #%d\"\n",
460 for (i
= 0; i
< 10; i
++)
462 sprintf(device
, "/dev/bpp%d", i
);
463 if (access(device
, 0) == 0)
464 printf("direct parallel:%s \"Unknown\" \"Sun Standard Parallel Port #%d\"\n",
468 for (i
= 0; i
< 3; i
++)
470 sprintf(device
, "/dev/lp%d", i
);
472 if (access(device
, 0) == 0)
473 printf("direct parallel:%s \"Unknown\" \"PC Parallel Port #%d\"\n",
478 * MAGMA parallel ports...
481 for (i
= 0; i
< 40; i
++)
483 sprintf(device
, "/dev/pm%02d", i
);
484 if (access(device
, 0) == 0)
485 printf("direct parallel:%s \"Unknown\" \"MAGMA Parallel Board #%d Port #%d\"\n",
486 device
, (i
/ 10) + 1, (i
% 10) + 1);
490 * Central Data parallel ports...
493 for (i
= 0; i
< 9; i
++)
494 for (j
= 0; j
< 8; j
++)
495 for (n
= 0; n
< 32; n
++)
497 if (i
== 8) /* EtherLite */
498 sprintf(device
, "/dev/sts/lpN%d%c", j
, funky_hex
[n
]);
500 sprintf(device
, "/dev/sts/lp%c%d%c", i
+ 'C', j
,
503 if (access(device
, 0) == 0)
506 printf("direct parallel:%s \"Unknown\" \"Central Data EtherLite Parallel Port, ID %d, port %d\"\n",
509 printf("direct parallel:%s \"Unknown\" \"Central Data SCSI Parallel Port, logical bus %d, ID %d, port %d\"\n",
513 #elif defined(__hpux)
514 int i
, j
, n
; /* Looping vars */
515 char device
[255]; /* Device filename */
519 * Standard parallel ports...
522 if (access("/dev/rlp", 0) == 0)
523 puts("direct parallel:/dev/rlp \"Unknown\" \"Standard Parallel Port (/dev/rlp)\"");
525 for (i
= 0; i
< 7; i
++)
526 for (j
= 0; j
< 7; j
++)
528 sprintf(device
, "/dev/c%dt%dd0_lp", i
, j
);
529 if (access(device
, 0) == 0)
530 printf("direct parallel:%s \"Unknown\" \"Parallel Port #%d,%d\"\n",
535 * Central Data parallel ports...
538 for (i
= 0; i
< 9; i
++)
539 for (j
= 0; j
< 8; j
++)
540 for (n
= 0; n
< 32; n
++)
542 if (i
== 8) /* EtherLite */
543 sprintf(device
, "/dev/lpN%d%c", j
, funky_hex
[n
]);
545 sprintf(device
, "/dev/lp%c%d%c", i
+ 'C', j
,
548 if (access(device
, 0) == 0)
551 printf("direct parallel:%s \"Unknown\" \"Central Data EtherLite Parallel Port, ID %d, port %d\"\n",
554 printf("direct parallel:%s \"Unknown\" \"Central Data SCSI Parallel Port, logical bus %d, ID %d, port %d\"\n",
558 #elif defined(__osf__)
559 int i
; /* Looping var */
560 int fd
; /* File descriptor */
561 char device
[255]; /* Device filename */
564 for (i
= 0; i
< 3; i
++)
566 sprintf(device
, "/dev/lp%d", i
);
567 if ((fd
= open(device
, O_WRONLY
)) >= 0)
570 printf("direct parallel:%s \"Unknown\" \"Parallel Port #%d\"\n", device
, i
+ 1);
573 #elif defined(__FreeBSD__) || defined(__OpenBSD__) || defined(__NetBSD__) || defined(__DragonFly__) || defined(__FreeBSD_kernel__)
574 int i
; /* Looping var */
575 int fd
; /* File descriptor */
576 char device
[255]; /* Device filename */
579 for (i
= 0; i
< 3; i
++)
581 sprintf(device
, "/dev/lpt%d", i
);
582 if ((fd
= open(device
, O_WRONLY
)) >= 0)
585 printf("direct parallel:%s \"Unknown\" \"Parallel Port #%d (interrupt-driven)\"\n", device
, i
+ 1);
588 sprintf(device
, "/dev/lpa%d", i
);
589 if ((fd
= open(device
, O_WRONLY
)) >= 0)
592 printf("direct parallel:%s \"Unknown\" \"Parallel Port #%d (polled)\"\n", device
, i
+ 1);
596 int i
; /* Looping var */
597 int fd
; /* File descriptor */
598 char device
[255]; /* Device filename */
601 for (i
= 0; i
< 8; i
++)
603 sprintf(device
, "/dev/lp%d", i
);
604 if ((fd
= open(device
, O_WRONLY
)) >= 0)
607 printf("direct parallel:%s \"Unknown\" \"Parallel Port #%d\"\n", device
, i
+ 1);
615 * 'side_cb()' - Handle side-channel requests...
618 static int /* O - 0 on success, -1 on error */
619 side_cb(int print_fd
, /* I - Print file */
620 int device_fd
, /* I - Device file */
621 int snmp_fd
, /* I - SNMP socket (unused) */
622 http_addr_t
*addr
, /* I - Device address (unused) */
623 int use_bc
) /* I - Using back-channel? */
625 cups_sc_command_t command
; /* Request command */
626 cups_sc_status_t status
; /* Request/response status */
627 char data
[2048]; /* Request/response data */
628 int datalen
; /* Request/response data size */
634 datalen
= sizeof(data
);
636 if (cupsSideChannelRead(&command
, &status
, data
, &datalen
, 1.0))
641 case CUPS_SC_CMD_DRAIN_OUTPUT
:
642 if (backendDrainOutput(print_fd
, device_fd
))
643 status
= CUPS_SC_STATUS_IO_ERROR
;
644 else if (tcdrain(device_fd
))
645 status
= CUPS_SC_STATUS_IO_ERROR
;
647 status
= CUPS_SC_STATUS_OK
;
652 case CUPS_SC_CMD_GET_BIDI
:
653 status
= CUPS_SC_STATUS_OK
;
658 case CUPS_SC_CMD_GET_DEVICE_ID
:
659 memset(data
, 0, sizeof(data
));
661 if (backendGetDeviceID(device_fd
, data
, sizeof(data
) - 1,
662 NULL
, 0, NULL
, NULL
, 0))
664 status
= CUPS_SC_STATUS_NOT_IMPLEMENTED
;
669 status
= CUPS_SC_STATUS_OK
;
670 datalen
= strlen(data
);
675 status
= CUPS_SC_STATUS_NOT_IMPLEMENTED
;
680 return (cupsSideChannelWrite(command
, status
, data
, datalen
, 1.0));
685 * End of "$Id: parallel.c 7810 2008-07-29 01:11:15Z mike $".