ref: 20a1d2268d69a0bbe66d0f21999649133878377c
dir: /sys/src/cmd/postscript/postio/postio.c/
/* * * postio - RS-232 serial interface for PostScript printers * * A simple program that manages input and output for PostScript printers. Much * has been added and changed from early versions of the program, but the basic * philosophy is still the same. Don't send real data until we're certain we've * connected to a PostScript printer that's in the idle state and try to hold the * connection until the job is completely done. It's more work than you might * expect is necessary, but should provide a reasonably reliable spooler interface * that can return error indications to the caller via the program's exit status. * * I've added code that will let you split the program into separate read/write * processes. Although it's not the default it should be useful if you have a file * that will be returning useful data from the printer. The two process stuff was * laid down on top of the single process code and both methods still work. The * implementation isn't as good as it could be, but didn't require many changes * to the original program (despite the fact that there are now many differences). * * By default the program still runs as a single process. The -R2 option forces * separate read and write processes after the intial connection is made. If you * want that as the default initialize splitme (below) to TRUE. In addition the * -t option that's used to force stuff not recognized as status reports to stdout * also tries to run as two processes (by setting splitme to TRUE). It will only * work if the required code (ie. resetline() in ifdef.c) has been implemented * for your Unix system. I've only tested the System V code. * * Code needed to support interactive mode has also been added, although again it's * not as efficient as it could be. It depends on the system dependent procedures * resetline() and setupstdin() (file ifdef.c) and for now is only guaranteed to * work on System V. Can be requested using the -i option. * * Quiet mode (-q option) is also new, but was needed for some printers connected * to RADIAN. If you're running in quiet mode no status requests will be sent to * the printer while files are being transmitted (ie. in send()). * * The program expects to receive printer status lines that look like, * * %%[ status: idle; source: serial 25 ]%% * %%[ status: waiting; source: serial 25 ]%% * %%[ status: initializing; source: serial 25 ]%% * %%[ status: busy; source: serial 25 ]%% * %%[ status: printing; source: serial 25 ]%% * %%[ status: PrinterError: out of paper; source: serial 25 ]%% * %%[ status: PrinterError: no paper tray; source: serial 25 ]%% * * although this list isn't complete. Sending a '\024' (control T) character forces * the return of a status report. PostScript errors detected on the printer result * in the immediate transmission of special error messages that look like, * * %%[ Error: undefined; OffendingCommand: xxx ]%% * %%[ Flushing: rest of job (to end-of-file) will be ignored ]%% * * although we only use the Error and Flushing keywords. Finally conditions, like * being out of paper, result in other messages being sent back from the printer * over the communications line. Typical PrinterError messages look like, * * %%[ PrinterError: out of paper; source: serial 25 ]%% * %%[ PrinterError: paper jam; source: serial 25 ]%% * * although we only use the PrinterError keyword rather than trying to recognize * all possible printer errors. * * The implications of using one process and only flow controlling data going to * the printer are obvious. Job transmission should be reliable, but there can be * data loss in stuff sent back from the printer. Usually that only caused problems * with jobs designed to run on the printer and return useful data back over the * communications line. If that's the kind of job you're sending call postio with * the -t option. That should force the program to split into separate read and * write processes and everything not bracketed by "%%[ " and " ]%%" strings goes * to stdout. In otherwords the data you're expecting should be separated from the * status stuff that goes to the log file (or stderr). The -R2 option does almost * the same thing (ie. separate read and write processes), but everything that * comes back from the printer goes to the log file (stderr by default) and you'll * have to separate your data from any printer messages. * * A typical command line might be, * * postio -l /dev/tty01 -b 9600 -L log file1 file2 * * where -l selects the line, -b sets the baud rate, and -L selects the printer * log file. Since there's no default line, at least not right now, you'll always * need to use the -l option, and if you don't choose a log file stderr will be * used. If you have a program that will be returning data the command line might * look like, * * postio -t -l/dev/tty01 -b9600 -Llog file >results * * Status stuff goes to file log while the data you're expecting back from the * printer gets put in file results. * */ #include <stdio.h> #include <ctype.h> #include <fcntl.h> #include <signal.h> #include <sys/types.h> #include <errno.h> #include "ifdef.h" /* conditional compilation stuff */ #include "gen.h" /* general purpose definitions */ #include "postio.h" /* some special definitions */ char **argv; /* global so everyone can use them */ int argc; char *prog_name = ""; /* really just for error messages */ int x_stat = 0; /* program exit status */ int debug = OFF; /* debug flag */ int ignore = OFF; /* what's done for FATAL errors */ char *line = NULL; /* printer is on this tty line */ short baudrate = BAUDRATE; /* and running at this baud rate */ Baud baudtable[] = BAUDTABLE; /* converts strings to termio values */ int stopbits = 1; /* number of stop bits */ int tostdout = FALSE; /* non-status stuff goes to stdout? */ int quiet = FALSE; /* no status queries in send() if TRUE */ int interactive = FALSE; /* interactive mode */ char *postbegin = POSTBEGIN; /* preceeds all the input files */ int useslowsend = FALSE; /* not recommended! */ int sendctrlC = TRUE; /* interrupt with ctrl-C when BUSY */ int window_size = -1; /* for Datakit - use -w */ char *block = NULL; /* input file buffer */ int blocksize = BLOCKSIZE; /* and its size in bytes */ int head = 0; /* block[head] is the next character */ int tail = 0; /* one past the last byte in block[] */ int splitme = FALSE; /* into READ and WRITE processes if TRUE */ int whatami = READWRITE; /* a READ or WRITE process - or both */ int canread = TRUE; /* allow reads */ int canwrite = TRUE; /* and writes if TRUE */ int otherpid = -1; /* who gets signals if greater than 1 */ int joinsig = SIGTRAP; /* reader gets this when writing is done */ int writedone = FALSE; /* and then sets this to TRUE */ char mesg[MESGSIZE]; /* exactly what came back on ttyi */ char sbuf[MESGSIZE]; /* for parsing the message */ int next = 0; /* next character goes in mesg[next] */ char *mesgptr = NULL; /* printer message starts here in mesg[] */ char *endmesg = NULL; /* as far as readline() can go in mesg[] */ Status status[] = STATUS; /* for converting status strings */ int nostatus = NOSTATUS; /* default getstatus() return value */ int currentstate = NOTCONNECTED; /* what's happening START, SEND, or DONE */ int ttyi = 0; /* input */ int ttyo = 2; /* and output file descriptors */ FILE *fp_log = stderr; /* log file for stuff from the printer */ /*****************************************************************************/ main(agc, agv) int agc; char *agv[]; { /* * * A simple program that manages input and output for PostScript printers. Can run * as a single process or as separate read/write processes. What's done depends on * the value assigned to splitme when split() is called. * */ argc = agc; /* other routines may want them */ argv = agv; prog_name = argv[0]; /* really just for error messages */ init_signals(); /* sets up interrupt handling */ options(); /* get command line options */ initialize(); /* must be done after options() */ start(); /* make sure the printer is ready */ split(); /* into read/write processes - maybe */ arguments(); /* then send each input file */ done(); /* wait until the printer is finished */ cleanup(); /* make sure the write process stops */ exit(x_stat); /* everything probably went OK */ } /* End of main */ /*****************************************************************************/ init_signals() { void interrupt(); /* handles them if we catch signals */ /* * * Makes sure we handle interrupts. The proper way to kill the program, if * necessary, is to do a kill -15. That forces a call to interrupt(), which in * turn tries to reset the printer and then exits with a non-zero status. If the * program is running as two processes, sending SIGTERM to either the parent or * child should clean things up. * */ if ( signal(SIGINT, interrupt) == SIG_IGN ) { signal(SIGINT, SIG_IGN); signal(SIGQUIT, SIG_IGN); signal(SIGHUP, SIG_IGN); } else { signal(SIGHUP, interrupt); signal(SIGQUIT, interrupt); } /* End else */ signal(SIGTERM, interrupt); } /* End of init_sig */ /*****************************************************************************/ options() { int ch; /* return value from getopt() */ char *optnames = "b:cil:qs:tw:B:L:P:R:SDI"; extern char *optarg; /* used by getopt() */ extern int optind; /* * * Reads and processes the command line options. The -R2, -t, and -i options all * force separate read and write processes by eventually setting splitme to TRUE * (check initialize()). The -S option is not recommended and should only be used * as a last resort! * */ while ( (ch = getopt(argc, argv, optnames)) != EOF ) { switch ( ch ) { case 'b': /* baud rate string */ baudrate = getbaud(optarg); break; case 'c': /* no ctrl-C's */ sendctrlC = FALSE; break; case 'i': /* interactive mode */ interactive = TRUE; break; case 'l': /* printer line */ line = optarg; break; case 'q': /* no status queries - for RADIAN? */ quiet = TRUE; break; case 's': /* use 2 stop bits - for UNISON? */ if ( (stopbits = atoi(optarg)) < 1 || stopbits > 2 ) stopbits = 1; break; case 't': /* non-status stuff goes to stdout */ tostdout = TRUE; break; case 'w': /* Datakit window size */ window_size = atoi(optarg); break; case 'B': /* set the job buffer size */ if ( (blocksize = atoi(optarg)) <= 0 ) blocksize = BLOCKSIZE; break; case 'L': /* printer log file */ if ( (fp_log = fopen(optarg, "w")) == NULL ) { fp_log = stderr; error(NON_FATAL, "can't open log file %s", optarg); } /* End if */ break; case 'P': /* initial PostScript code */ postbegin = optarg; break; case 'R': /* run as one or two processes */ if ( atoi(optarg) == 2 ) splitme = TRUE; else splitme = FALSE; break; case 'S': /* slow and kludged up version of send */ useslowsend = TRUE; break; case 'D': /* debug flag */ debug = ON; break; case 'I': /* ignore FATAL errors */ ignore = ON; break; case '?': /* don't understand the option */ error(FATAL, ""); break; default: /* don't know what to do for ch */ error(FATAL, "missing case for option %c\n", ch); break; } /* End switch */ } /* End while */ argc -= optind; /* get ready for non-option args */ argv += optind; } /* End of options */ /*****************************************************************************/ getbaud(rate) char *rate; /* string representing the baud rate */ { int i; /* for looking through baudtable[] */ /* * * Called from options() to convert a baud rate string into an appropriate termio * value. *rate is looked up in baudtable[] and if it's found, the corresponding * value is returned to the caller. * */ for ( i = 0; baudtable[i].rate != NULL; i++ ) if ( strcmp(rate, baudtable[i].rate) == 0 ) return(baudtable[i].val); error(FATAL, "don't recognize baud rate %s", rate); } /* End of getbaud */ /*****************************************************************************/ initialize() { /* * * Initialization, a few checks, and a call to setupline() (file ifdef.c) to open * and configure the communications line. Settings for interactive mode always * take precedence. The setupstdin() call with an argument of 0 saves the current * terminal settings if interactive mode has been requested - otherwise nothing's * done. Unbuffering stdout (via the setbuf() call) isn't really needed on System V * since it's flushed whenever terminal input is requested. It's more efficient if * we buffer the stdout (on System V) but safer (for other versions of Unix) if we * include the setbuf() call. * */ whatami = READWRITE; /* always run start() as one process */ canread = canwrite = TRUE; if ( tostdout == TRUE ) /* force separate read/write processes */ splitme = TRUE; if ( interactive == TRUE ) { /* interactive mode settings always win */ quiet = FALSE; tostdout = FALSE; splitme = TRUE; blocksize = 1; postbegin = NULL; useslowsend = FALSE; nostatus = INTERACTIVE; setbuf(stdout, NULL); } /* End if */ if ( useslowsend == TRUE ) { /* last resort only - not recommended */ quiet = FALSE; splitme = FALSE; if ( blocksize > 1024 ) /* don't send too much all at once */ blocksize = 1024; } /* End if */ if ( tostdout == TRUE && fp_log == stderr ) fp_log = NULL; if ( line == NULL && (interactive == TRUE || tostdout == TRUE) ) error(FATAL, "a printer line must be supplied - use the -l option"); if ( (block = malloc(blocksize)) == NULL ) error(FATAL, "no memory"); endmesg = mesg + sizeof mesg - 2; /* one byte from last position in mesg */ setupline(); /* configure the communications line */ setupstdin(0); /* save current stdin terminal settings */ } /* End of initialize */ /*****************************************************************************/ start() { /* * * Tries to put the printer in the IDLE state before anything important is sent. * Run as a single process no matter what has been assigned to splitme. Separate * read and write processes, if requested, will be created after we're done here. * */ logit("printer startup\n"); currentstate = START; clearline(); while ( 1 ) switch ( getstatus(1) ) { case IDLE: case INTERACTIVE: if ( postbegin != NULL && *postbegin != '\0' ) Write(ttyo, postbegin, strlen(postbegin)); clearline(); return; case BUSY: if ( sendctrlC == TRUE ) { Write(ttyo, "\003", 1); Rest(1); } /* End if */ break; case WAITING: case ERROR: case FLUSHING: Write(ttyo, "\004", 1); Rest(1); break; case PRINTERERROR: Rest(15); break; case DISCONNECT: error(FATAL, "Disconnected - printer may be offline"); break; case ENDOFJOB: case UNKNOWN: clearline(); break; default: Rest(1); break; } /* End switch */ } /* End of start */ /*****************************************************************************/ split() { int pid; void interrupt(); /* * * If splitme is TRUE we fork a process, make the parent handle reading, and let * the child take care of writing. resetline() (file ifdef.c) contains all the * system dependent code needed to reset the communications line for separate * read and write processes. For now it's expected to return TRUE or FALSE and * that value controls whether we try the fork. I've only tested the two process * stuff for System V. Other versions of resetline() may just be dummy procedures * that always return FALSE. If the fork() failed previous versions continued as * a single process, although the implementation wasn't quite right, but I've now * decided to quit. The main reason is a Datakit channel may be configured to * flow control data in both directions, and if we run postio over that channel * as a single process we likely will end up in deadlock. * */ if ( splitme == TRUE ) if ( resetline() == TRUE ) { pid = getpid(); signal(joinsig, interrupt); if ( (otherpid = fork()) == -1 ) error(FATAL, "can't fork"); else if ( otherpid == 0 ) { whatami = WRITE; nostatus = WRITEPROCESS; otherpid = pid; setupstdin(1); } else whatami = READ; } else if ( interactive == TRUE || tostdout == TRUE ) error(FATAL, "can't create two process - check resetline()"); else error(NON_FATAL, "running as a single process - check resetline()"); canread = (whatami & READ) ? TRUE : FALSE; canwrite = (whatami & WRITE) ? TRUE : FALSE; } /* End of split */ /*****************************************************************************/ arguments() { int fd_in; /* next input file */ /* * * Makes sure all the non-option command line arguments are processed. If there * aren't any arguments left when we get here we'll send stdin. Input files are * only read and sent to the printer if canwrite is TRUE. Checking it here means * we won't have to do it in send(). If interactive mode is TRUE we'll stay here * forever sending stdin when we run out of files - exit with a break. Actually * the loop is bogus and used at most once when we're in interactive mode because * stdin is in a pseudo raw mode and the read() in readblock() should never see * the end of file. * */ if ( canwrite == TRUE ) do /* loop is for interactive mode */ if ( argc < 1 ) send(fileno(stdin), "pipe.end"); else { while ( argc > 0 ) { if ( (fd_in = open(*argv, O_RDONLY)) == -1 ) error(FATAL, "can't open %s", *argv); send(fd_in, *argv); close(fd_in); argc--; argv++; } /* End while */ } /* End else */ while ( interactive == TRUE ); } /* End of arguments */ /*****************************************************************************/ send(fd_in, name) int fd_in; /* next input file */ char *name; /* and it's pathname */ { /* * * Sends file *name to the printer. There's nothing left here that depends on * sending and receiving status reports, although it can be reassuring to know * the printer is responding and processing our job. Only the writer gets here * in the two process implementation, and in that case split() has reset nostatus * to WRITEPROCESS and that's what getstatus() always returns. For now we accept * the IDLE state and ENDOFJOB as legitimate and ignore the INITIALIZING state. * */ if ( interactive == FALSE ) logit("sending file %s\n", name); currentstate = SEND; if ( useslowsend == TRUE ) { slowsend(fd_in); return; } /* End if */ while ( readblock(fd_in) ) switch ( getstatus(0) ) { case IDLE: case BUSY: case WAITING: case PRINTING: case ENDOFJOB: case PRINTERERROR: case UNKNOWN: case NOSTATUS: case WRITEPROCESS: case INTERACTIVE: writeblock(); break; case ERROR: fprintf(stderr, "%s", mesg); /* for csw */ error(USER_FATAL, "PostScript Error"); break; case FLUSHING: error(USER_FATAL, "Flushing Job"); break; case DISCONNECT: error(FATAL, "Disconnected - printer may be offline"); break; } /* End switch */ } /* End of send */ /*****************************************************************************/ done() { int sleeptime = 15; /* for 'out of paper' etc. */ /* * * Tries to stay connected to the printer until we're reasonably sure the job is * complete. It's the only way we can recover error messages or data generated by * the PostScript program and returned over the communication line. Actually doing * it correctly for all possible PostScript jobs is more difficult that it might * seem. For example if we've sent several jobs, each with their own EOF mark, then * waiting for ENDOFJOB won't guarantee all the jobs have completed. Even waiting * for IDLE isn't good enough. Checking for the WAITING state after all the files * have been sent and then sending an EOF may be the best approach, but even that * won't work all the time - we could miss it or might not get there. Even sending * our own special PostScript job after all the input files has it's own different * set of problems, but probably could work (perhaps by printing a fake status * message or just not timing out). Anyway it's probably not worth the trouble so * for now we'll quit if writedone is TRUE and we get ENDOFJOB or IDLE. * * If we're running separate read and write processes the reader gets here after * after split() while the writer goes to send() and only gets here after all the * input files have been transmitted. When they're both here the writer sends the * reader signal joinsig and that forces writedone to TRUE in the reader. At that * point the reader can begin looking for an indication of the end of the job. * The writer hangs around until the reader kills it (usually in cleanup()) sending * occasional status requests. * */ if ( canwrite == TRUE ) logit("waiting for end of job\n"); currentstate = DONE; writedone = (whatami == READWRITE) ? TRUE : FALSE; while ( 1 ) { switch ( getstatus(1) ) { case WRITEPROCESS: if ( writedone == FALSE ) { sendsignal(joinsig); Write(ttyo, "\004", 1); writedone = TRUE; sleeptime = 1; } /* End if */ Rest(sleeptime++); break; case WAITING: Write(ttyo, "\004", 1); Rest(1); sleeptime = 15; break; case IDLE: case ENDOFJOB: if ( writedone == TRUE ) { logit("job complete\n"); return; } /* End if */ break; case BUSY: case PRINTING: case INTERACTIVE: sleeptime = 15; break; case PRINTERERROR: Rest(sleeptime++); break; case ERROR: fprintf(stderr, "%s", mesg); /* for csw */ error(USER_FATAL, "PostScript Error"); return; case FLUSHING: error(USER_FATAL, "Flushing Job"); return; case DISCONNECT: error(FATAL, "Disconnected - printer may be offline"); return; default: Rest(1); break; } /* End switch */ if ( sleeptime > 60 ) sleeptime = 60; } /* End while */ } /* End of done */ /*****************************************************************************/ cleanup() { int w; /* * * Only needed if we're running separate read and write processes. Makes sure the * write process is killed after the read process has successfully finished with * all the jobs. sendsignal() returns a -1 if there's nobody to signal so things * work when we're running a single process. * */ while ( sendsignal(SIGKILL) != -1 && (w = wait((int *)0)) != otherpid && w != -1 ) ; } /* End of cleanup */ /*****************************************************************************/ readblock(fd_in) int fd_in; /* current input file */ { static long blocknum = 1; /* * * Fills the input buffer with the next block, provided we're all done with the * last one. Blocks from fd_in are stored in array block[]. head is the index * of the next byte in block[] that's supposed to go to the printer. tail points * one past the last byte in the current block. head is adjusted in writeblock() * after each successful write, while head and tail are reset here each time * a new block is read. Returns the number of bytes left in the current block. * Read errors cause the program to abort. The fake status message that's put out * in quiet mode is only so you can look at the log file and know something's * happening - take it out if you want. * */ if ( head >= tail ) { /* done with the last block */ if ( (tail = read(fd_in, block, blocksize)) == -1 ) error(FATAL, "error reading input file"); if ( quiet == TRUE && tail > 0 ) /* put out a fake message? */ logit("%%%%[ status: busy; block: %d ]%%%%\n", blocknum++); head = 0; } /* End if */ return(tail - head); } /* End of readblock */ /*****************************************************************************/ writeblock() { int count; /* bytes successfully written */ /* * * Called from send() when it's OK to send the next block to the printer. head * is adjusted after the write, and the number of bytes that were successfully * written is returned to the caller. * */ if ( (count = write(ttyo, &block[head], tail - head)) == -1 ) error(FATAL, "error writing to %s", line); else if ( count == 0 ) error(FATAL, "printer appears to be offline"); head += count; return(count); } /* End of writeblock */ /*****************************************************************************/ getstatus(t) int t; /* sleep time after sending '\024' */ { int gotline = FALSE; /* value returned by readline() */ int state = nostatus; /* representation of the current state */ int mesgch; /* to restore mesg[] when tostdout == TRUE */ static int laststate = NOSTATUS; /* last state recognized */ /* * * Looks for things coming back from the printer on the communications line, parses * complete lines retrieved by readline(), and returns an integer representation * of the current printer status to the caller. If nothing was available a status * request (control T) is sent to the printer and nostatus is returned to the * caller (provided quiet isn't TRUE). Interactive mode either never returns from * readline() or returns FALSE. * */ if ( canread == TRUE && (gotline = readline()) == TRUE ) { state = parsemesg(); if ( state != laststate || state == UNKNOWN || mesgptr != mesg || debug == ON ) logit("%s", mesg); if ( tostdout == TRUE && currentstate != START ) { mesgch = *mesgptr; *mesgptr = '\0'; fprintf(stdout, "%s", mesg); fflush(stdout); *mesgptr = mesgch; /* for ERROR in send() and done() */ } /* End if */ return(laststate = state); } /* End if */ if ( (quiet == FALSE || currentstate != SEND) && (tostdout == FALSE || currentstate == START) && interactive == FALSE ) { if ( Write(ttyo, "\024", 1) != 1 ) error(FATAL, "printer appears to be offline"); if ( t > 0 ) Rest(t); } /* End if */ return(nostatus); } /* End of getstatus */ /*****************************************************************************/ parsemesg() { char *e; /* end of printer message in mesg[] */ char *key, *val; /* keyword/value strings in sbuf[] */ char *p; /* for converting to lower case etc. */ int i; /* where *key was found in status[] */ /* * * Parsing the lines that readline() stores in mesg[] is messy, and what's done * here isn't completely correct nor as fast as it could be. The general format * of lines that come back from the printer (assuming no data loss) is: * * str%%[ key: val; key: val; key: val ]%%\n * * where str can be most anything not containing a newline and printer reports * (eg. status or error messages) are bracketed by "%%[ " and " ]%%" strings and * end with a newline. Usually we'll have the string or printer report but not * both. For most jobs the leading string will be empty, but could be anything * generated on a printer and returned over the communications line using the * PostScript print operator. I'll assume PostScript jobs are well behaved and * never bracket their messages with "%%[ " and " ]%%" strings that delimit status * or error messages. * * Printer reports consist of one or more key/val pairs, and what we're interested * in (status or error indications) may not be the first pair in the list. In * addition we'll sometimes want the value associated with a keyword (eg. when * key = status) and other times we'll want the keyword (eg. when key = Error or * Flushing). The last pair isn't terminated by a semicolon and a value string * often contains many space separated words and it can even include colons in * meaningful places. I've also decided to continue converting things to lower * case before doing the lookup in status[]. The isupper() test is for Berkeley * systems. * */ if ( *(mesgptr = find("%%[ ", mesg)) != '\0' && *(e = find(" ]%%", mesgptr+4)) != '\0' ) { strcpy(sbuf, mesgptr+4); /* don't change mesg[] */ sbuf[e-mesgptr-4] = '\0'; /* ignore the trailing " ]%%" */ for ( key = strtok(sbuf, " :"); key != NULL; key = strtok(NULL, " :") ) { if ( (val = strtok(NULL, ";")) != NULL && strcmp(key, "status") == 0 ) key = val; for ( ; *key == ' '; key++ ) ; /* skip any leading spaces */ for ( p = key; *p; p++ ) /* convert to lower case */ if ( *p == ':' ) { *p = '\0'; break; } else if ( isupper(*p) ) *p = tolower(*p); for ( i = 0; status[i].state != NULL; i++ ) if ( strcmp(status[i].state, key) == 0 ) return(status[i].val); } /* End for */ } else if ( strcmp(mesg, "CONVERSATION ENDED.\n") == 0 ) return(DISCONNECT); return(mesgptr == '\0' ? nostatus : UNKNOWN); } /* End of parsemesg */ /*****************************************************************************/ char *find(str1, str2) char *str1; /* look for this string */ char *str2; /* in this one */ { char *s1, *s2; /* can't change str1 or str2 too fast */ /* * * Looks for *str1 in string *str2. Returns a pointer to the start of the substring * if it's found or to the end of string str2 otherwise. * */ for ( ; *str2 != '\0'; str2++ ) { for ( s1 = str1, s2 = str2; *s1 != '\0' && *s1 == *s2; s1++, s2++ ) ; if ( *s1 == '\0' ) break; } /* End for */ return(str2); } /* End of find */ /*****************************************************************************/ clearline() { /* * * Reads characters from the input line until nothing's left. Don't do anything if * we're currently running separate read and write processes. * */ if ( whatami == READWRITE ) while ( readline() != FALSE ) ; } /* End of clearline */ /*****************************************************************************/ sendsignal(sig) int sig; /* this goes to the other process */ { /* * * Sends signal sig to the other process if we're running as separate read and * write processes. Returns the result of the kill if there's someone else to * signal or -1 if we're running alone. * */ if ( whatami != READWRITE && otherpid > 1 ) return(kill(otherpid, sig)); return(-1); } /* End of sendsignal */ /*****************************************************************************/ void interrupt(sig) int sig; /* signal that we caught */ { /* * * Caught a signal - all except joinsig cause the program to quit. joinsig is the * signal sent by the writer to the reader after all the jobs have been transmitted. * Used to tell the read process when it can start looking for the end of the job. * */ signal(sig, SIG_IGN); if ( sig != joinsig ) { x_stat |= FATAL; if ( canread == TRUE ) if ( interactive == FALSE ) error(NON_FATAL, "signal %d abort", sig); else error(NON_FATAL, "quitting"); quit(sig); } /* End if */ writedone = TRUE; signal(joinsig, interrupt); } /* End of interrupt */ /*****************************************************************************/ logit(mesg, a1, a2, a3) char *mesg; /* control string */ unsigned a1, a2, a3; /* and possible arguments */ { /* * * Simple routine that's used to write a message to the log file. * */ if ( mesg != NULL && fp_log != NULL ) { fprintf(fp_log, mesg, a1, a2, a3); fflush(fp_log); } /* End if */ } /* End of logit */ /*****************************************************************************/ error(kind, mesg, a1, a2, a3) int kind; /* FATAL or NON_FATAL error */ char *mesg; /* error message control string */ unsigned a1, a2, a3; /* control string arguments */ { FILE *fp_err; /* * * Called when we've run into some kind of program error. First *mesg is printed * using the control string arguments a?. If kind is FATAL and we're not ignoring * errors the program will be terminated. If mesg is NULL or *mesg is the NULL * string nothing will be printed. * */ fp_err = (fp_log != NULL) ? fp_log : stderr; if ( mesg != NULL && *mesg != '\0' ) { fprintf(fp_err, "%s: ", prog_name); fprintf(fp_err, mesg, a1, a2, a3); putc('\n', fp_err); } /* End if */ x_stat |= kind; if ( kind != NON_FATAL && ignore == OFF ) quit(SIGTERM); } /* End of error */ /*****************************************************************************/ quit(sig) int sig; { int w; /* * * Makes sure everything is properly cleaned up if there's a signal or FATAL error * that should cause the program to terminate. The sleep by the write process is * to help give the reset sequence a chance to reach the printer before we break * the connection - primarily for printers connected to Datakit. There's a very * slight chance the reset sequence that's sent to the printer could get us stuck * here. Simplest solution is don't bother to send it - everything works without it. * Flushing ttyo would be better, but means yet another system dependent procedure * in ifdef.c! I'll leave things be for now. * * Obscure problem on PS-810 turbos says wait a bit after sending an interrupt. * Seem to remember the printer getting into a bad state immediately after the * top was opened when the toner light was on. A sleep after sending the ctrl-C * seemed to fix things. * */ signal(sig, SIG_IGN); ignore = ON; while ( sendsignal(sig) != -1 && (w = wait((int *)0)) != otherpid && w != -1 ) ; setupstdin(2); if ( currentstate != NOTCONNECTED ) { if ( sendctrlC == TRUE ) { Write(ttyo, "\003", 1); Rest(1); /* PS-810 turbo problem?? */ } /* End if */ Write(ttyo, "\004", 1); } /* End if */ alarm(0); /* prevents sleep() loop on V9 systems */ Rest(2); exit(x_stat); } /* End of quit */ /*****************************************************************************/ Rest(t) int t; { /* * * Used to replace sleep() calls. Only needed if we're running the program as * a read and write process and don't want to have the read process sleep. Most * sleeps are in the code because of the non-blocking read used by the single * process implementation. Probably should be a macro. * */ if ( t > 0 && canwrite == TRUE ) sleep(t); } /* End of Rest */ /*****************************************************************************/ Read(fd, buf, n) int fd; char *buf; int n; { int count; /* * * Used to replace some of the read() calls. Only needed if we're running separate * read and write processes. Should only be used to replace read calls on ttyi. * Always returns 0 to the caller if the process doesn't have its READ flag set. * Probably should be a macro. * */ if ( canread == TRUE ) { if ( (count = read(fd, buf, n)) == -1 && errno == EINTR ) count = 0; } else count = 0; return(count); } /* End of Read */ /*****************************************************************************/ Write(fd, buf, n) int fd; char *buf; int n; { int count; /* * * Used to replace some of the write() calls. Again only needed if we're running * separate read and write processes. Should only be used to replace write calls * on ttyo. Always returns n to the caller if the process doesn't have its WRITE * flag set. Should also probably be a macro. * */ if ( canwrite == TRUE ) { if ( (count = write(fd, buf, n)) == -1 && errno == EINTR ) count = n; } else count = n; return(count); } /* End of Write */ /*****************************************************************************/