2 * "$Id: pap.c 7010 2007-10-10 21:08:51Z mike $"
4 * © Copyright 2004 Apple Computer, Inc. All rights reserved.
6 * IMPORTANT: This Apple software is supplied to you by Apple Computer,
7 * Inc. ("Apple") in consideration of your agreement to the following
8 * terms, and your use, installation, modification or redistribution of
9 * this Apple software constitutes acceptance of these terms. If you do
10 * not agree with these terms, please do not use, install, modify or
11 * redistribute this Apple software.
13 * In consideration of your agreement to abide by the following terms, and
14 * subject to these terms, Apple grants you a personal, non-exclusive
15 * license, under AppleÕs copyrights in this original Apple software (the
16 * "Apple Software"), to use, reproduce, modify and redistribute the Apple
17 * Software, with or without modifications, in source and/or binary forms;
18 * provided that if you redistribute the Apple Software in its entirety and
19 * without modifications, you must retain this notice and the following
20 * text and disclaimers in all such redistributions of the Apple Software.
21 * Neither the name, trademarks, service marks or logos of Apple Computer,
22 * Inc. may be used to endorse or promote products derived from the Apple
23 * Software without specific prior written permission from Apple. Except
24 * as expressly stated in this notice, no other rights or licenses, express
25 * or implied, are granted by Apple herein, including but not limited to
26 * any patent rights that may be infringed by your derivative works or by
27 * other works in which the Apple Software may be incorporated.
29 * The Apple Software is provided by Apple on an "AS IS" basis. APPLE
30 * MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION
31 * THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS
32 * FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND
33 * OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS.
35 * IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL
36 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
37 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
38 * INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION,
39 * MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED
40 * AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE),
41 * STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE
42 * POSSIBILITY OF SUCH DAMAGE.
45 * This program implements the Printer Access Protocol (PAP) on top of AppleTalk
46 * Transaction Protocol (ATP). If it were to use the blocking pap functions of
47 * the AppleTalk library it would need seperate threads for reading, writing
52 * main() - Send a file to the specified Appletalk printer.
53 * listDevices() - List all LaserWriter printers in the local zone.
54 * printFile() - Print file.
55 * papOpen() - Open a pap session to a printer.
56 * papClose() - Close a pap session.
57 * papWrite() - Write bytes to a printer.
58 * papCloseResp() - Send a pap close response.
59 * papSendRequest() - Fomrat and send a pap packet.
60 * papCancelRequest() - Cancel a pending pap request.
61 * sidechannel_request() - Handle side-channel requests.
62 * statusUpdate() - Print printer status to stderr.
63 * parseUri() - Extract the print name and zone from a uri.
64 * addPercentEscapes() - Encode a string with percent escapes.
65 * removePercentEscapes - Remove percent escape sequences from a string.
66 * nbptuple_compare() - Compare routine for qsort.
67 * okayToUseAppleTalk() - Returns true if AppleTalk is available and enabled.
68 * packet_name() - Returns packet name string.
69 * connectTimeout() - Returns the connect timeout preference value.
70 * signalHandler() - handle SIGINT to close the session before quiting.
83 #include <sys/fcntl.h>
84 #include <sys/param.h>
86 #include <sys/errno.h>
88 #include <netat/appletalk.h>
89 #include <netat/atp.h>
90 #include <netat/ddp.h>
91 #include <netat/nbp.h>
92 #include <netat/pap.h>
94 #include <cups/cups.h>
95 #include <cups/backend.h>
96 #include <cups/sidechannel.h>
97 #include <cups/i18n.h>
99 #include <libkern/OSByteOrder.h>
101 #ifdef HAVE_APPLETALK_AT_PROTO_H
102 # include <AppleTalk/at_proto.h>
104 /* These definitions come from at_proto.h... */
105 # define ZIP_DEF_INTERFACE NULL
106 enum { RUNNING
, NOTLOADED
, LOADED
, OTHERERROR
};
108 extern int atp_abort(int fd
, at_inet_t
*dest
, u_short tid
);
109 extern int atp_close(int fd
);
110 extern int atp_getreq(int fd
, at_inet_t
*src
, char *buf
, int *len
, int *userdata
,
111 int *xo
, u_short
*tid
, u_char
*bitmap
, int nowait
);
112 extern int atp_getresp(int fd
, u_short
*tid
, at_resp_t
*resp
);
113 extern int atp_look(int fd
);
114 extern int atp_open(at_socket
*sock
);
115 extern int atp_sendreq(int fd
, at_inet_t
*dest
, char *buf
, int len
,
116 int userdata
, int xo
, int xo_relt
, u_short
*tid
,
117 at_resp_t
*resp
, at_retry_t
*retry
, int nowait
);
118 extern int atp_sendrsp(int fd
, at_inet_t
*dest
, int xo
, u_short tid
,
120 extern int checkATStack();
121 extern int nbp_lookup(at_entity_t
*entity
, at_nbptuple_t
*buf
, int max
,
123 extern int nbp_make_entity(at_entity_t
*entity
, char *obj
, char *type
,
125 extern int zip_getmyzone(char *ifName
, at_nvestr_t
*zone
);
126 #endif /* HAVE_APPLETALK_AT_PROTO_H */
128 #include <CoreFoundation/CFURL.h>
129 #include <CoreFoundation/CFNumber.h>
130 #include <CoreFoundation/CFPreferences.h>
133 #define MAX_PRINTERS 500 /* Max number of printers we can lookup */
138 #define CONNID_OF(p) (((u_char *)&p)[0])
139 #define TYPE_OF(p) (((u_char *)&p)[1])
140 #define SEQUENCE_NUM(p) (((u_char *)&p)[2])
141 #define IS_PAP_EOF(p) (((u_char *)&p)[2])
149 int gSockfd
= 0; /* Socket descriptor */
150 at_inet_t gSessionAddr
= { 0 }; /* Address of the session responding socket */
151 u_char gConnID
= 0; /* PAP session connection id */
152 u_short gSendDataID
= 0; /* Transaction id of pending send-data request */
153 u_short gTickleID
= 0; /* Transaction id of outstanding tickle request*/
154 int gWaitEOF
= false; /* Option: wait for a remote's EOF */
155 int gStatusInterval
= 5; /* Option: 0=off else seconds between status requests*/
156 int gErrorlogged
= false; /* If an error was logged don't send any more INFO messages */
157 int gDebug
= 0; /* Option: emit debugging info */
159 /* Local functions */
160 static int listDevices(void);
161 static int printFile(char* name
, char* type
, char* zone
, int fdin
, int fdout
,
162 int fderr
, int copies
, int argc
);
163 static int papOpen(at_nbptuple_t
* tuple
, u_char
* connID
, int* fd
,
164 at_inet_t
* pap_to
, u_char
* flowQuantum
);
165 static int papClose();
166 static int papWrite(int sockfd
, at_inet_t
* dest
, u_short tid
, u_char connID
,
167 u_char flowQuantum
, char* data
, int len
, int eof
);
168 static int papCloseResp(int sockfd
, at_inet_t
* dest
, int xo
, u_short tid
,
170 static int papSendRequest(int sockfd
, at_inet_t
* dest
, u_char connID
,
171 int function
, u_char bitmap
, int xo
, int seqno
);
172 static int papCancelRequest(int sockfd
, u_short tid
);
173 static void sidechannel_request();
174 static void statusUpdate(char* status
, u_char statusLen
);
175 static int parseUri(const char* argv0
, char* name
, char* type
, char* zone
);
176 static int addPercentEscapes(const char* src
, char* dst
, int dstMax
);
177 static int removePercentEscapes(const char* src
, char* dst
, int dstMax
);
178 static int nbptuple_compare(const void *p1
, const void *p2
);
179 static int okayToUseAppleTalk(void);
180 static const char *packet_name(u_char x
);
181 static int connectTimeout(void);
182 static void signalHandler(int sigraised
);
187 * @abstract Send a file to the specified AppleTalk PAP address.
189 * Usage: printer-uri job-id user title copies options [file]
191 * @param argc # of arguments
192 * @param argv array of arguments
194 * @result A non-zero return value for errors
196 int main (int argc
, const char * argv
[])
199 FILE *fp
; /* Print file */
200 int copies
; /* Number of copies to print */
201 char name
[NBP_NVE_STR_SIZE
+ 1]; /* +1 for a nul */
202 char type
[NBP_NVE_STR_SIZE
+ 1]; /* +1 for a nul */
203 char zone
[NBP_NVE_STR_SIZE
+ 1]; /* +1 for a nul */
205 /* Make sure status messages are not buffered... */
206 setbuf(stderr
, NULL
);
208 if (argc
== 1 || (argc
== 2 && strcmp(argv
[1], "-discover") == 0))
215 if (argc
< 6 || argc
> 7)
217 fprintf(stderr
, "argc = %d\n", argc
);
218 for (err
= 0; err
< argc
; err
++) {
219 fprintf(stderr
, "%02d:%s\n", err
, argv
[err
]);
221 fprintf(stderr
, "Usage: pap job-id user title copies options [file]\n");
225 /* If we have 7 arguments, print the file named on the command-line.
226 * Otherwise, send stdin instead...
235 fprintf(stderr
, "DEBUG: opening print file \"%s\"\n", argv
[6]);
237 /* Try to open the print file... */
238 if ((fp
= fopen(argv
[6], "rb")) == NULL
)
240 _cupsLangPrintf(stderr
,
241 _("ERROR: Unable to open print file \"%s\": %s\n"),
242 argv
[6], strerror(errno
));
246 copies
= atoi(argv
[4]);
249 /* Extract the device name and options from the URI... */
250 parseUri(cupsBackendDeviceURI((char **)argv
), name
, type
, zone
);
252 err
= printFile(name
, type
, zone
, fileno(fp
), STDOUT_FILENO
, STDERR_FILENO
, copies
, argc
);
257 /* Only clear the last status if there wasn't an error */
258 if (err
== noErr
&& !gErrorlogged
)
259 fprintf(stderr
, "INFO:\n");
266 * @function listDevices
267 * @abstract Print a list of all LaserWriter type devices registered in the default zone.
269 * @result A non-zero return value for errors
271 static int listDevices(void)
279 at_nbptuple_t buf
[MAX_PRINTERS
];
281 char name
[NBP_NVE_STR_SIZE
+1];
282 char encodedName
[(3 * NBP_NVE_STR_SIZE
) + 1];
283 char zone
[NBP_NVE_STR_SIZE
+1];
284 char encodedZone
[(3 * NBP_NVE_STR_SIZE
) + 1];
286 /* Make sure it's okay to use appletalk */
287 if (!okayToUseAppleTalk())
289 fprintf(stderr
, "INFO: AppleTalk disabled in System Preferences\n");
290 return -1; /* Network is down */
293 if ((err
= zip_getmyzone(ZIP_DEF_INTERFACE
, &at_zone
)) != 0)
295 perror("ERROR: Unable to get default AppleTalk zone");
299 memcpy(zone
, at_zone
.str
, MIN(at_zone
.len
, sizeof(zone
)-1));
300 zone
[MIN(at_zone
.len
, sizeof(zone
)-1)] = '\0';
302 fprintf(stderr
, "INFO: Using default AppleTalk zone \"%s\"\n", zone
);
304 addPercentEscapes(zone
, encodedZone
, sizeof(encodedZone
));
306 /* Look up all the printers in our zone */
307 nbp_make_entity(&entity
, "=", "LaserWriter", zone
);
312 if ((numberFound
= nbp_lookup(&entity
, buf
, MAX_PRINTERS
, &retry
)) < 0)
314 perror("ERROR: Unable to lookup AppleTalk printers");
318 if (numberFound
>= MAX_PRINTERS
)
319 fprintf(stderr
, "WARNING: Adding only the first %d printers found", MAX_PRINTERS
);
321 /* Not required but sort them so they look nice */
322 qsort(buf
, numberFound
, sizeof(at_nbptuple_t
), nbptuple_compare
);
324 for (i
= 0; i
< numberFound
; i
++)
326 memcpy(name
, buf
[i
].enu_entity
.object
.str
, MIN(buf
[i
].enu_entity
.object
.len
, sizeof(name
)-1));
327 name
[MIN(buf
[i
].enu_entity
.object
.len
, sizeof(name
)-1)] = '\0';
329 if (addPercentEscapes(name
, encodedName
, sizeof(encodedName
)) == 0)
331 /* Each line is of the form: "class URI "make model" "info" */
332 char make_model
[128], /* Make and model */
336 if ((ptr
= strchr(name
, ' ')) != NULL
)
339 * If the printer name contains spaces, it is probably a make and
343 if (!strncmp(name
, "ET00", 4))
346 * Drop leading ethernet address info...
349 strlcpy(make_model
, ptr
+ 1, sizeof(make_model
));
352 strlcpy(make_model
, name
, sizeof(make_model
));
355 strcpy(make_model
, "Unknown");
357 printf("network pap://%s/%s/LaserWriter \"%s\" \"%s AppleTalk\"\n",
358 encodedZone
, encodedName
, make_model
, name
);
366 * @function printFile
367 * @abstract Open a PAP session and send the data from the input socket to the printer.
369 * @param name NBP name
370 * @param zone NBP zone
371 * @param type NBP type
372 * @param fdin File descriptor to read data from
373 * @param fdout File descriptor to write printer responses to
374 * @param fderr File descriptor to write printer status to
375 * @param copies # of copies to send (in case in the converter couldn't handle this for us).
376 * @param argc # of command line arguments.
378 * @result A non-zero return value for errors
380 static int printFile(char* name
, char* type
, char* zone
, int fdin
, int fdout
, int fderr
, int copies
, int argc
)
387 char fileBuffer
[4096]; /* File buffer */
388 int fileBufferNbytes
;
393 char sockBuffer
[4096 + 1]; /* Socket buffer with room for nul */
394 char atpReqBuf
[AT_PAP_DATA_SIZE
];
396 int use_sidechannel
; /* Use side channel? */
399 at_inet_t sendDataAddr
;
402 int userdata
, xo
, reqlen
;
407 struct timeval timeout
, *timeoutPtr
;
408 u_char flowQuantum
= 1;
409 u_short recvSequence
= 0;
414 connect_timeout
= -1,
419 #if defined(HAVE_SIGACTION) && !defined(HAVE_SIGSET)
420 struct sigaction action
; /* Actions for POSIX signals */
421 #endif /* HAVE_SIGACTION && !HAVE_SIGSET */
424 * Test the side channel descriptor before calling papOpen() since it may open
425 * an unused fd 4 (a.k.a. CUPS_SC_FD)...
429 FD_SET(CUPS_SC_FD
, &readSet
);
434 if ((select(CUPS_SC_FD
+1, &readSet
, NULL
, NULL
, &timeout
)) >= 0)
439 /* try to find our printer */
440 if ((err
= nbp_make_entity(&entity
, name
, type
, zone
)) != noErr
)
442 fprintf(stderr
, "ERROR: Unable to make AppleTalk address: %s\n", strerror(errno
));
447 * Remember when we started looking for the printer.
450 start_time
= time(NULL
);
456 fprintf(stderr
, "STATE: +connecting-to-device\n");
458 /* Loop forever trying to get an open session with the printer. */
461 /* Make sure it's okay to use appletalk */
462 if (okayToUseAppleTalk())
464 /* Clear this printer-state-reason in case we've set it */
465 fprintf(stderr
, "STATE: -apple-appletalk-disabled-warning\n");
467 /* Resolve the name into an address. Returns the number found or an error */
468 if ((err
= nbp_lookup(&entity
, &tuple
, 1, &retry
)) > 0)
471 fprintf(stderr
, "DEBUG: Found more than one printer with the name \"%s\"\n", name
);
475 fprintf(stderr
, "STATE: -apple-nbp-lookup-warning\n");
479 /* Open a connection to the device */
480 if ((err
= papOpen(&tuple
, &gConnID
, &gSockfd
, &gSessionAddr
, &flowQuantum
)) == 0)
483 fprintf(stderr
, "WARNING: Unable to open \"%s:%s\": %s\n", name
, zone
, strerror(err
));
487 /* It's not unusual to have to call nbp_lookup() twice before it's sucessful... */
488 if (++nbp_failures
> 2)
492 fprintf(stderr
, "STATE: +apple-nbp-lookup-warning\n");
493 fprintf(stderr
, "WARNING: Printer not responding\n");
499 fprintf(stderr
, "STATE: +apple-appletalk-disabled-warning\n");
500 fprintf(stderr
, "INFO: AppleTalk disabled in System Preferences.\n");
503 elasped_time
= time(NULL
) - start_time
;
505 if (connect_timeout
== -1)
506 connect_timeout
= connectTimeout();
508 if (connect_timeout
&& elasped_time
> connect_timeout
)
510 fprintf(stderr
, "ERROR: Printer not responding\n");
512 goto Exit
; /* Waiting too long... */
514 else if (elasped_time
< (30 * 60))
515 sleep_time
= 10; /* Waiting < 30 minutes */
516 else if (elasped_time
< (24 * 60 * 60))
517 sleep_time
= 30; /* Waiting < 24 hours */
519 sleep_time
= 60; /* Waiting > 24 hours */
521 fprintf(stderr
, "DEBUG: sleeping %d seconds...\n", (int)sleep_time
);
525 fprintf(stderr
, "STATE: -connecting-to-device\n");
528 * Now that we are connected to the printer ignore SIGTERM so that we
529 * can finish out any page data the driver sends (e.g. to eject the
530 * current page... if we are printing data from a file then catch the
531 * signal so we can send a PAP Close packet (otherwise you can't cancel
535 #ifdef HAVE_SIGSET /* Use System V signals over POSIX to avoid bugs */
536 sigset(SIGTERM
, (argc
< 7) ? SIG_IGN
: signalHandler
);
537 #elif defined(HAVE_SIGACTION)
538 memset(&action
, 0, sizeof(action
));
540 sigemptyset(&action
.sa_mask
);
541 action
.sa_handler
= (argc
< 7) ? SIG_IGN
: signalHandler
;
542 sigaction(SIGTERM
, &action
, NULL
);
544 signal(SIGTERM
, (argc
< 7) ? SIG_IGN
: signalHandler
);
547 /* Makes debugging easier; otherwise printer will be busy for several minutes */
548 signal(SIGINT
, signalHandler
);
551 #endif /* HAVE_SIGSET */
553 fprintf(stderr
, "INFO: Sending data\n");
555 sendDataAddr
= tuple
.enu_addr
;
557 /* Start the tickle packets and set a timeout alarm */
558 if ((err
= papSendRequest(gSockfd
, &gSessionAddr
, gConnID
, AT_PAP_TYPE_TICKLE
, 0, false, false)) < 0)
560 perror("ERROR: Unable to send PAP tickle request");
563 signal(SIGALRM
, signalHandler
);
566 /* Prime the pump with an initial send-data packet */
567 if ((err
= papSendRequest(gSockfd
, &gSessionAddr
, gConnID
, AT_PAP_TYPE_SEND_DATA
, 0xFF, true, true)) < 0)
569 perror("ERROR: Unable to send initial PAP send data request");
573 /* Set non-blocking mode on our data source descriptor */
574 val
= fcntl(fdin
, F_GETFL
, 0);
575 fcntl(fdin
, F_SETFL
, val
| O_NONBLOCK
);
577 fileBufferNbytes
= 0;
579 fileEOFRead
= fileEOFSent
= false;
581 maxfdp1
= MAX(fdin
, gSockfd
) + 1;
583 if (use_sidechannel
&& CUPS_SC_FD
>= maxfdp1
)
584 maxfdp1
= CUPS_SC_FD
+ 1;
586 if (gStatusInterval
!= 0)
589 nextStatusTime
= time(NULL
) + gStatusInterval
;
590 timeoutPtr
= &timeout
;
598 /* Set up our descriptors for the select */
600 FD_SET(gSockfd
, &readSet
);
602 if (fileBufferNbytes
== 0 && fileEOFRead
== false)
603 FD_SET(fdin
, &readSet
);
606 FD_SET(CUPS_SC_FD
, &readSet
);
608 /* Set the select timeout value based on the next status interval */
609 if (gStatusInterval
!= 0)
612 timeout
.tv_sec
= (nextStatusTime
> now
) ? nextStatusTime
- now
: 1;
615 /* Wait here for something interesting to happen */
616 if ((err
= select(maxfdp1
, &readSet
, 0, 0, timeoutPtr
)) < 0)
618 perror("ERROR: select");
622 if (err
== 0 || (gStatusInterval
!= 0 && time(NULL
) >= nextStatusTime
))
624 /* Time to send a status request */
625 if ((err
= papSendRequest(gSockfd
, &tuple
.enu_addr
, 0, AT_PAP_TYPE_SEND_STATUS
, 0x01, false, false)) < 0)
626 perror("WARNING: Unable to send PAP status request");
629 nextStatusTime
= time(NULL
) + gStatusInterval
;
633 * Check if we have a side-channel request ready...
636 if (use_sidechannel
&& FD_ISSET(CUPS_SC_FD
, &readSet
))
637 sidechannel_request();
639 /* Was there an event on the input stream? */
640 if (FD_ISSET(fdin
, &readSet
))
642 FD_CLR(fdin
, &readSet
);
644 assert(fileBufferNbytes
== 0);
645 fileBufferNbytes
= read(fdin
, fileBuffer
, MIN(sizeof(fileBuffer
), AT_PAP_DATA_SIZE
* flowQuantum
));
646 if (fileBufferNbytes
== 0)
649 if (fileEOFSent
== false && fileBufferNbytes
>= 0 && gSendDataID
!= 0)
651 fprintf(stderr
, "DEBUG: -> PAP_DATA %d bytes %s\n", fileBufferNbytes
, fileEOFRead
? "with EOF" : "");
652 papWrite(gSockfd
, &sendDataAddr
, gSendDataID
, gConnID
, flowQuantum
, fileBuffer
, fileBufferNbytes
, fileEOFRead
);
654 fileTbytes
+= fileBufferNbytes
;
655 if (argc
> 6 && !gErrorlogged
)
656 fprintf(stderr
, "DEBUG: Sending print file, %qd bytes\n", (off_t
)fileTbytes
);
658 fileBufferNbytes
= 0;
663 if (gWaitEOF
== false || fileTbytes
== 0)
672 /* Was there an event on the output stream? */
673 if (FD_ISSET(gSockfd
, &readSet
))
675 if ((rc
= atp_look(gSockfd
)) < 0)
677 perror("ERROR: Unable to look for PAP response");
683 /* It's an ATP response */
684 resp
.resp
[0].iov_base
= sockBuffer
;
685 resp
.resp
[0].iov_len
= sizeof(sockBuffer
) - 1;
688 if ((err
= atp_getresp(gSockfd
, &tid
, &resp
)) < 0)
690 perror("ERROR: Unable to get PAP response");
693 userdata
= resp
.userdata
[0];
697 /* It's an ATP request */
698 reqlen
= sizeof(atpReqBuf
);
699 if ((err
= atp_getreq(gSockfd
, &src
, atpReqBuf
, &reqlen
, &userdata
, &xo
, &tid
, &bitmap
, 0)) < 0)
701 perror("ERROR: Unable to get PAP request");
706 fprintf(stderr
, "DEBUG: <- %s\n", packet_name(TYPE_OF(userdata
)));
708 switch (TYPE_OF(userdata
))
710 case AT_PAP_TYPE_SEND_STS_REPLY
: /* Send-Status-Reply packet */
713 char *iov_base
= (char *)resp
.resp
[0].iov_base
;
714 statusUpdate(&iov_base
[5], iov_base
[4]);
718 case AT_PAP_TYPE_SEND_DATA
: /* Send-Data packet */
719 sendDataAddr
.socket
= src
.socket
;
721 recvSequence
= OSReadBigInt16(&SEQUENCE_NUM(userdata
), 0);
723 if ((fileBufferNbytes
> 0 || fileEOFRead
) && fileEOFSent
== false)
725 fprintf(stderr
, "DEBUG: -> PAP_DATA %d bytes %s\n", fileBufferNbytes
, fileEOFRead
? "with EOF" : "");
726 papWrite(gSockfd
, &sendDataAddr
, gSendDataID
, gConnID
, flowQuantum
, fileBuffer
, fileBufferNbytes
, fileEOFRead
);
728 fileTbytes
+= fileBufferNbytes
;
729 if (argc
> 6 && !gErrorlogged
)
730 fprintf(stderr
, "DEBUG: Sending print file, %qd bytes\n", (off_t
)fileTbytes
);
732 fileBufferNbytes
= 0;
737 if (gWaitEOF
== false)
746 case AT_PAP_TYPE_DATA
: /* Data packet */
747 for (len
=0, i
=0; i
< ATP_TRESP_MAX
; i
++)
749 if (resp
.bitmap
& (1 << i
))
750 len
+= resp
.resp
[i
].iov_len
;
753 fprintf(stderr
, "DEBUG: <- PAP_DATA %d bytes %s\n", len
, IS_PAP_EOF(userdata
) ? "with EOF" : "");
757 char *pLineBegin
, *pCommentEnd
, *pChar
;
762 cupsBackChannelWrite(sockBuffer
, len
, 1.0);
764 sockBuffer
[len
] = '\0'; /* We always reserve room for the nul so we can use strstr() below*/
765 pLineBegin
= sockBuffer
;
767 /* If there are PostScript status comments in the buffer log them.
769 * This logic shouldn't be in the backend but until we get backchannel
770 * data in CUPS 1.2 it has to live here.
772 while (pLineBegin
< sockBuffer
+ len
&&
773 (pLineBegin
= strstr(pLineBegin
, "%%[")) != NULL
&&
774 (pCommentEnd
= strstr(pLineBegin
, "]%%")) != NULL
)
776 pCommentEnd
+= 3; /* Skip past "]%%" */
777 *pCommentEnd
= '\0'; /* There's always room for the nul */
779 /* Strip the CRs & LFs before writing it to stderr */
780 for (pChar
= pLineBegin
; pChar
< pCommentEnd
; pChar
++)
781 if (*pChar
== '\r' || *pChar
== '\n')
784 if (strncasecmp(pLineBegin
, "%%[ Error:", 10) == 0)
786 /* logLevel should be "ERROR" here but this causes PrintCenter
787 * to pause the queue which in turn clears this error, which
788 * restarts the job. So the job ends up in an infinite loop with
789 * the queue being held/un-held. Just make it DEBUG for now until
790 * we fix notifications later.
795 else if (strncasecmp(pLineBegin
, "%%[ Flushing", 12) == 0)
800 if ((logstrlen
= snprintf(logstr
, sizeof(logstr
), "%s: %s\n", logLevel
, pLineBegin
)) >= sizeof(logstr
))
802 /* If the string was trucnated make sure it has a linefeed before the nul */
803 logstrlen
= sizeof(logstr
) - 1;
804 logstr
[logstrlen
- 1] = '\n';
807 write(fderr
, logstr
, logstrlen
);
809 pLineBegin
= pCommentEnd
+ 1;
813 if (IS_PAP_EOF(userdata
) != 0)
815 /* If this is EOF then were we expecting it? */
816 if (fileEOFSent
== true)
820 fprintf(stderr
, "WARNING: Printer sent unexpected EOF\n");
824 if ((err
= papSendRequest(gSockfd
, &gSessionAddr
, gConnID
, AT_PAP_TYPE_SEND_DATA
, 0xFF, true, true)) < 0)
826 fprintf(stderr
, "ERROR: Error %d sending PAPSendData resuest: %s\n", err
, strerror(errno
));
831 case AT_PAP_TYPE_TICKLE
: /* Tickle packet */
834 case AT_PAP_TYPE_CLOSE_CONN
: /* Close-Connection packet */
835 /* We shouldn't normally see this. */
836 papCloseResp(gSockfd
, &gSessionAddr
, xo
, tid
, gConnID
);
838 /* If this is EOF then were we expecting it? */
839 if (fileEOFSent
== true)
841 fprintf(stderr
, "WARNING: Printer sent unexpected EOF\n");
845 fprintf(stderr
, "ERROR: Printer sent unexpected EOF\n");
850 case AT_PAP_TYPE_OPEN_CONN
: /* Open-Connection packet */
851 case AT_PAP_TYPE_OPEN_CONN_REPLY
: /* Open-Connection-Reply packet */
852 case AT_PAP_TYPE_SEND_STATUS
: /* Send-Status packet */
853 case AT_PAP_TYPE_CLOSE_CONN_REPLY
: /* Close-Connection-Reply packet */
854 fprintf(stderr
, "WARNING: Unexpected PAP packet of type %d\n", TYPE_OF(userdata
));
858 fprintf(stderr
, "WARNING: Unknown PAP packet of type %d\n", TYPE_OF(userdata
));
862 if (CONNID_OF(userdata
) == gConnID
)
864 /* Reset tickle timer */
873 * Close the socket and return...
884 * @abstract Open a pap session to a printer.
886 * @param tuple nbp address of printer
887 * @param connID returned pap connection id
888 * @param fd returned socket descriptor
889 * @param sessionAddr returned session address
890 * @param flowQuantum returned flow quantum (usually 8)
892 * @result A non-zero return value for errors
894 static int papOpen(at_nbptuple_t
* tuple
, u_char
* connID
, int* fd
,
895 at_inet_t
* sessionAddr
, u_char
* flowQuantum
)
904 rdata
[ATP_DATA_SIZE
];
912 puserdata
= (u_char
*)&userdata
;
914 fprintf(stderr
, "INFO: Opening connection\n");
916 if ((*fd
= atp_open(&socketfd
)) < 0)
920 * Build the open connection request packet.
926 *connID
= (rand()&0xff) | 0x01;
927 puserdata
[0] = *connID
;
928 puserdata
[1] = AT_PAP_TYPE_OPEN_CONN
;
936 resp
.resp
[0].iov_base
= rdata
;
937 resp
.resp
[0].iov_len
= sizeof(rdata
);
944 waitTime
= time(NULL
) - tm
;
945 OSWriteBigInt16(&data
[2], 0, (u_short
)waitTime
);
947 fprintf(stderr
, "DEBUG: -> %s\n", packet_name(AT_PAP_TYPE_OPEN_CONN
));
949 if ((atp_err
= atp_sendreq(*fd
, &tuple
->enu_addr
, data
, 4, userdata
, 1, 0,
950 0, &resp
, &retry
, 0)) < 0)
952 statusUpdate("Destination unreachable", 23);
953 result
= EHOSTUNREACH
;
957 puserdata
= (u_char
*)&resp
.userdata
[0];
958 open_result
= OSReadBigInt16(&rdata
[2], 0);
960 fprintf(stderr
, "DEBUG: <- %s, status %d\n", packet_name(puserdata
[1]),
964 * Just for the sake of our sanity check the other fields in the packet
967 if (puserdata
[1] != AT_PAP_TYPE_OPEN_CONN_REPLY
||
968 (open_result
== 0 && (puserdata
[0] & 0xff) != *connID
))
974 statusUpdate(&rdata
[5], rdata
[4] & 0xff);
977 * if the connection established okay exit from the loop
980 if (open_result
== 0)
988 /* Update the session address
990 sessionAddr
->net
= tuple
->enu_addr
.net
;
991 sessionAddr
->node
= tuple
->enu_addr
.node
;
992 sessionAddr
->socket
= rdata
[0];
993 *flowQuantum
= rdata
[1];
1007 * @function papClose
1008 * @abstract End a PAP session by canceling outstanding send-data & tickle
1009 * transactions and sending a PAP close request.
1011 * @result A non-zero return value for errors
1013 static int papClose()
1018 unsigned char rdata
[ATP_DATA_SIZE
];
1020 u_char
*puserdata
= (u_char
*)&userdata
;
1031 /* Cancel the pending send-data and tickle trnsactions
1035 tmpID
= gSendDataID
;
1037 papCancelRequest(fd
, tmpID
);
1044 papCancelRequest(fd
, tmpID
);
1047 /* This is a workaround for bug #2735145. The problem is papWrite()
1048 * returns before the ATP TRel arrives for it. If we send the pap close packet
1049 * before this release then the printer can drop the last data packets.
1050 * The effect on an Epson printer is the last page doesn't print, on HP it
1051 * doesn't close the pap session.
1053 if (gWaitEOF
== false)
1056 fprintf(stderr
, "DEBUG: -> %s\n", packet_name(AT_PAP_TYPE_CLOSE_CONN
));
1058 puserdata
[0] = gConnID
;
1059 puserdata
[1] = AT_PAP_TYPE_CLOSE_CONN
;
1067 resp
.resp
[0].iov_base
= rdata
;
1068 resp
.resp
[0].iov_len
= sizeof(rdata
);
1070 result
= atp_sendreq(fd
, &gSessionAddr
, 0, 0, userdata
, 1, 0, 0, &resp
, &retry
, 0);
1079 * @function papWrite
1080 * @abstract Write bytes to a printer.
1082 * @param sockfd socket descriptor
1083 * @param dest destination address
1084 * @param tid transaction id
1085 * @param connID connection id
1086 * @param flowQuantum returned flow quantum (usually 8)
1087 * @param data pointer to the data
1088 * @param len number of bytes to send
1089 * @param eof pap eof flag
1091 * @result A non-zero return value for errors
1093 static int papWrite(int sockfd
, at_inet_t
* dest
, u_short tid
, u_char connID
, u_char flowQuantum
, char* data
, int len
, int eof
)
1100 /* fprintf(stderr, "DEBUG: papWrite(%d%s) to %d,%d,%d; %d\n", len, eof ? " EOF":"", dest->net, dest->node, dest->socket, connID); */
1102 if (len
> AT_PAP_DATA_SIZE
* flowQuantum
)
1104 fprintf(stderr
, "DEBUG: papWrite() len of %d is too big!\n", len
);
1110 * Break up the outgoing data into a set of
1111 * response packets to reply to an incoming
1112 * PAP 'SENDDATA' request
1114 for (i
= 0; i
< flowQuantum
; i
++)
1116 resp
.userdata
[i
] = 0;
1117 puserdata
= (u_char
*)&resp
.userdata
[i
];
1119 puserdata
[PAP_CONNID
] = connID
;
1120 puserdata
[PAP_TYPE
] = AT_PAP_TYPE_DATA
;
1121 puserdata
[PAP_EOF
] = eof
? 1 : 0;
1123 resp
.resp
[i
].iov_base
= (caddr_t
)data
;
1126 data
+= AT_PAP_DATA_SIZE
;
1128 resp
.resp
[i
].iov_len
= MIN((int)len
, (int)AT_PAP_DATA_SIZE
);
1129 len
-= resp
.resp
[i
].iov_len
;
1133 resp
.bitmap
= (1 << (i
+ 1)) - 1;
1136 * Write out the data as a PAP 'DATA' response
1139 if ((result
= atp_sendrsp(sockfd
, dest
, true, tid
, &resp
)) < 0)
1141 fprintf(stderr
, "DEBUG: atp_sendrsp() returns %d, errno %d \"%s\"\n", result
, errno
, strerror(errno
));
1149 * @function papCloseResp
1150 * @abstract Send a pap close response in the rare case we receive a close connection request.
1152 * @param sockfd socket descriptor
1153 * @param dest destination address
1154 * @param tid transaction id
1155 * @param connID connection id
1157 * @result A non-zero return value for errors
1159 static int papCloseResp(int sockfd
, at_inet_t
* dest
, int xo
, u_short tid
, u_char connID
)
1165 resp
.userdata
[0] = 0;
1167 ((u_char
*)&resp
.userdata
[0])[PAP_CONNID
] = connID
;
1168 ((u_char
*)&resp
.userdata
[0])[PAP_TYPE
] = AT_PAP_TYPE_CLOSE_CONN_REPLY
;
1170 resp
.resp
[0].iov_base
= NULL
;
1171 resp
.resp
[0].iov_len
= 0;
1173 if ((result
= atp_sendrsp(sockfd
, dest
, xo
, tid
, &resp
)) < 0)
1175 fprintf(stderr
, "DEBUG: atp_sendrsp() returns %d, errno %d \"%s\"\n", result
, errno
, strerror(errno
));
1183 * @function papSendRequest
1184 * @abstract Send a pap close response in the rare case we receive a close connection request.
1186 * @param sockfd socket descriptor
1187 * @param dest destination address
1188 * @param function pap function
1189 * @param bitmap bitmap
1190 * @param xo exactly once
1191 * @param seqno sequence number
1193 * @result A non-zero return value for errors
1195 static int papSendRequest(int sockfd
, at_inet_t
* dest
, u_char connID
, int function
, u_char bitmap
, int xo
, int seqno
)
1201 u_char
*puserdata
= (u_char
*)&userdata
;
1204 static u_short pap_send_count
= 0;
1206 fprintf(stderr
, "DEBUG: -> %s\n", packet_name(function
));
1208 puserdata
[0] = connID
;
1209 puserdata
[1] = function
;
1210 resp
.bitmap
= bitmap
;
1211 retry
.interval
= 10;
1212 retry
.retries
= -1; /* was ATP_INFINITE_RETRIES */
1216 if (pap_send_count
== 0)
1219 OSWriteBigInt16(&puserdata
[2], 0, pap_send_count
);
1222 OSWriteBigInt16(&puserdata
[2], 0, 0);
1225 sigaddset(&sv
, SIGIO
);
1226 sigprocmask(SIG_SETMASK
, &sv
, &osv
);
1228 err
= atp_sendreq(sockfd
, dest
, 0, 0, userdata
, xo
, 0, &tid
, &resp
, &retry
, 1);
1230 sigprocmask(SIG_SETMASK
, &osv
, NULL
);
1237 * @function papCancelRequest
1238 * @abstract Cancel a pending pap request.
1240 * @param sockfd socket descriptor
1241 * @param tid transaction ID
1243 * @result A non-zero return value for errors
1245 int papCancelRequest(int sockfd
, u_short tid
)
1250 sigaddset(&sv
, SIGIO
);
1251 sigprocmask(SIG_SETMASK
, &sv
, &osv
);
1253 if (atp_abort(sockfd
, NULL
, tid
) < 0)
1255 sigprocmask(SIG_SETMASK
, &osv
, NULL
);
1258 sigprocmask(SIG_SETMASK
, &osv
, NULL
);
1265 * 'sidechannel_request()' - Handle side-channel requests.
1269 sidechannel_request()
1271 cups_sc_command_t command
; /* Request command */
1272 cups_sc_status_t status
; /* Request/response status */
1273 char data
[2048]; /* Request/response data */
1274 int datalen
; /* Request/response data size */
1276 datalen
= sizeof(data
);
1278 if (cupsSideChannelRead(&command
, &status
, data
, &datalen
, 1.0))
1280 fputs(_("WARNING: Failed to read side-channel request!\n"), stderr
);
1286 case CUPS_SC_CMD_GET_BIDI
: /* Is the connection bidirectional? */
1288 cupsSideChannelWrite(command
, CUPS_SC_STATUS_OK
, data
, 1, 1.0);
1291 case CUPS_SC_CMD_GET_STATE
: /* Return device state */
1292 data
[0] = CUPS_SC_STATE_ONLINE
;
1293 cupsSideChannelWrite(command
, CUPS_SC_STATUS_OK
, data
, 1, 1.0);
1296 case CUPS_SC_CMD_DRAIN_OUTPUT
: /* Drain all pending output */
1297 case CUPS_SC_CMD_SOFT_RESET
: /* Do a soft reset */
1298 case CUPS_SC_CMD_GET_DEVICE_ID
: /* Return IEEE-1284 device ID */
1300 cupsSideChannelWrite(command
, CUPS_SC_STATUS_NOT_IMPLEMENTED
,
1310 * @function statusUpdate
1311 * @abstract Format and print a PAP status response to stderr.
1313 * @param status The status response string
1314 * @param statusLen The length of the status response string
1316 void statusUpdate(char* status
, u_char statusLen
)
1318 static char status_str
[255];
1319 static u_char last_statusLen
= 0xFF;
1321 /* Only send this if the status has changed */
1322 if (statusLen
!= last_statusLen
|| memcmp(status
, status_str
, statusLen
) != 0)
1324 if (statusLen
> sizeof(status_str
)-1)
1325 statusLen
= sizeof(status_str
)-1;
1326 last_statusLen
= statusLen
;
1327 memcpy(status_str
, status
, statusLen
);
1328 status_str
[(int)statusLen
] = '\0';
1331 * Make sure the status string is in the form of a PostScript comment.
1334 if (statusLen
> 3 && memcmp(status
, "%%[", 3) == 0)
1335 fprintf(stderr
, "INFO: %s\n", status_str
);
1337 fprintf(stderr
, "INFO: %%%%[ %s ]%%%%\n", status_str
);
1344 * @function parseUri
1345 * @abstract Parse a PAP URI into it's NBP components.
1347 * @param argv0 The PAP URI to parse
1348 * @param name NBP name
1349 * @param zone NBP zone
1350 * @param type NBP type
1352 * @result A non-zero return value for errors
1354 static int parseUri(const char* argv0
, char* name
, char* type
, char* zone
)
1356 char method
[255], /* Method in URI */
1357 hostname
[1024], /* Hostname */
1358 username
[255], /* Username info (not used) */
1359 resource
[1024], /* Resource info (device and options) */
1362 *options
, /* Pointer to options */
1363 *optionName
, /* Name of option */
1364 *value
, /* Value of option */
1365 sep
; /* Separator character */
1366 int port
; /* Port number (not used) */
1367 int statusInterval
; /* */
1370 * Extract the device name and options from the URI...
1372 method
[0] = username
[0] = hostname
[0] = resource
[0] = '\0';
1375 httpSeparateURI(HTTP_URI_CODING_NONE
, argv0
, method
, sizeof(method
),
1376 username
, sizeof(username
),
1377 hostname
, sizeof(hostname
), &port
,
1378 resource
, sizeof(resource
));
1381 * See if there are any options...
1383 if ((options
= strchr(resource
, '?')) != NULL
)
1386 * Yup, terminate the device name string and move to the first
1387 * character of the options...
1391 while (*options
!= '\0')
1397 optionName
= options
;
1399 while (*options
&& *options
!= '=' && *options
!= '+' && *options
!= '&')
1402 if ((sep
= *options
) != '\0')
1413 while (*options
&& *options
!= '+' && *options
!= '&')
1423 * Process the option...
1426 if (!strcasecmp(optionName
, "waiteof"))
1429 * Wait for the end of the print file?
1432 if (!strcasecmp(value
, "on") ||
1433 !strcasecmp(value
, "yes") ||
1434 !strcasecmp(value
, "true"))
1438 else if (!strcasecmp(value
, "off") ||
1439 !strcasecmp(value
, "no") ||
1440 !strcasecmp(value
, "false"))
1446 fprintf(stderr
, "WARNING: Boolean expected for waiteof option \"%s\"\n", value
);
1449 else if (!strcasecmp(optionName
, "status"))
1452 * Set status reporting interval...
1455 statusInterval
= atoi(value
);
1456 if (value
[0] < '0' || value
[0] > '9' || statusInterval
< 0)
1458 fprintf(stderr
, "WARNING: number expected for status option \"%s\"\n",
1463 gStatusInterval
= statusInterval
;
1469 resourcePtr
= resource
;
1471 if (*resourcePtr
== '/')
1474 /* If the resource has a slash we assume the slash seperates the AppleTalk object
1475 * name from the AppleTalk type. If the slash is not present we assume the AppleTalk
1476 * type is LaserWriter.
1479 typePtr
= strchr(resourcePtr
, '/');
1480 if (typePtr
!= NULL
)
1486 typePtr
= "LaserWriter";
1489 removePercentEscapes(hostname
, zone
, NBP_NVE_STR_SIZE
+ 1);
1490 removePercentEscapes(resourcePtr
, name
, NBP_NVE_STR_SIZE
+ 1);
1491 removePercentEscapes(typePtr
, type
, NBP_NVE_STR_SIZE
+ 1);
1498 * @function addPercentEscapes
1499 * @abstract Encode a string with percent escapes
1501 * @param src The source C string
1502 * @param dst Desination buffer
1503 * @param dstMax Size of desination buffer
1505 * @result A non-zero return value for errors
1507 static int addPercentEscapes(const char* src
, char* dst
, int dstMax
)
1510 char *dstEnd
= dst
+ dstMax
- 1; /* -1 to leave room for the NUL */
1516 if ((c
>= 'a' && c
<= 'z') || (c
>= 'A' && c
<= 'Z') ||
1517 (c
>= '0' && c
<= '9') || (c
== '.' || c
== '-' || c
== '*' || c
== '_'))
1526 if (dst
>= dstEnd
- 2)
1529 snprintf(dst
, dstEnd
- dst
, "%%%02x", c
);
1540 * @function removePercentEscapes
1541 * @abstract Returns a string with any percent escape sequences replaced with their equivalent character
1543 * @param src Source buffer
1544 * @param srclen Number of bytes in source buffer
1545 * @param dst Desination buffer
1546 * @param dstMax Size of desination buffer
1548 * @result A non-zero return value for errors
1550 static int removePercentEscapes(const char* src
, char* dst
, int dstMax
)
1553 const char *dstEnd
= dst
+ dstMax
;
1555 while (*src
&& dst
< dstEnd
)
1561 sscanf(src
, "%02x", &c
);
1576 * @function nbptuple_compare
1577 * @abstract An NBP comparator for qsort.
1579 * @result p1<p2: -1, p1=p2: 0, p1>p2: 1
1581 int nbptuple_compare(const void *p1
, const void *p2
)
1584 int len
= MIN(((at_nbptuple_t
*)p1
)->enu_entity
.object
.len
,
1585 ((at_nbptuple_t
*)p2
)->enu_entity
.object
.len
);
1587 if ((result
= memcmp(((at_nbptuple_t
*)p1
)->enu_entity
.object
.str
, ((at_nbptuple_t
*)p2
)->enu_entity
.object
.str
, len
)) == 0)
1589 if (((at_nbptuple_t
*)p1
)->enu_entity
.object
.len
< ((at_nbptuple_t
*)p2
)->enu_entity
.object
.len
)
1591 else if (((at_nbptuple_t
*)p1
)->enu_entity
.object
.len
> ((at_nbptuple_t
*)p2
)->enu_entity
.object
.len
)
1601 * @function okayToUseAppleTalk
1602 * @abstract Returns true if AppleTalk is available and enabled.
1604 * @result non-zero if AppleTalk is enabled
1606 static int okayToUseAppleTalk()
1608 int atStatus
= checkATStack();
1610 /* I think the test should be:
1611 * return atStatus == RUNNING || atStatus == LOADED;
1612 * but when I disable AppleTalk from the network control panel and
1613 * reboot, AppleTalk shows up as loaded. The test empirically becomes
1616 return atStatus
== RUNNING
;
1621 * @function packet_name
1622 * @abstract Returns packet name string.
1626 static const char *packet_name(u_char x
)
1630 case AT_PAP_TYPE_OPEN_CONN
: return "PAP_OPEN_CONN";
1631 case AT_PAP_TYPE_OPEN_CONN_REPLY
: return "PAP_OPEN_CONN_REPLY";
1632 case AT_PAP_TYPE_SEND_DATA
: return "PAP_SEND_DATA";
1633 case AT_PAP_TYPE_DATA
: return "PAP_DATA";
1634 case AT_PAP_TYPE_TICKLE
: return "PAP_TICKLE";
1635 case AT_PAP_TYPE_CLOSE_CONN
: return "PAP_CLOSE_CONN";
1636 case AT_PAP_TYPE_CLOSE_CONN_REPLY
: return "PAP_CLOSE_CONN_REPLY";
1637 case AT_PAP_TYPE_SEND_STATUS
: return "PAP_SEND_STATUS";
1638 case AT_PAP_TYPE_SEND_STS_REPLY
: return "PAP_SEND_STS_REPLY";
1639 case AT_PAP_TYPE_READ_LW
: return "PAP_READ_LW";
1646 * @function connectTimeout
1647 * @abstract Returns the connect timeout preference value.
1649 static int connectTimeout()
1651 CFPropertyListRef value
;
1652 SInt32 connect_timeout
= (7 * 24 * 60 * 60); /* Default timeout is one week... */
1654 value
= CFPreferencesCopyValue(CFSTR("timeout"), CFSTR("com.apple.print.backends"),
1655 kCFPreferencesAnyUser
, kCFPreferencesCurrentHost
);
1658 if (CFGetTypeID(value
) == CFNumberGetTypeID())
1659 CFNumberGetValue(value
, kCFNumberSInt32Type
, &connect_timeout
);
1664 return connect_timeout
;
1669 * @function signalHandler
1670 * @abstract A signal handler so we can clean up the pap session before exiting.
1672 * @param sigraised The signal raised
1674 * @result Never returns
1676 static void signalHandler(int sigraised
)
1678 fprintf(stderr
, "ERROR: There was a timeout error while sending data to the printer\n");