Annotation of coherent/d/usr/bin/pax/shipping/ttyio.c, revision 1.1.1.1

1.1       root        1: /* $Source: /newbits/usr/bin/pax/shipping/ttyio.c,v $
                      2:  *
                      3:  * $Revision: 1.1 $
                      4:  *
                      5:  * ttyio.c - Terminal/Console I/O functions for all archive interfaces
                      6:  *
                      7:  * DESCRIPTION
                      8:  *
                      9:  *     These routines provide a consistent, general purpose interface to
                     10:  *     the user via the users terminal, if it is available to the
                     11:  *     process.
                     12:  *
                     13:  * AUTHOR
                     14:  *
                     15:  *     Mark H. Colburn, NAPS International ([email protected])
                     16:  *
                     17:  * Sponsored by The USENIX Association for public distribution. 
                     18:  *
                     19:  * Copyright (c) 1989 Mark H. Colburn.
                     20:  * All rights reserved.
                     21:  *
                     22:  * Redistribution and use in source and binary forms are permitted
                     23:  * provided that the above copyright notice is duplicated in all such 
                     24:  * forms and that any documentation, advertising materials, and other 
                     25:  * materials related to such distribution and use acknowledge that the 
                     26:  * software was developed * by Mark H. Colburn and sponsored by The 
                     27:  * USENIX Association. 
                     28:  *
                     29:  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     30:  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     31:  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     32:  *
                     33:  * $Log:       /newbits/usr/bin/pax/shipping/ttyio.c,v $
                     34:  * Revision 1.1        91/02/05  11:59:39      bin
                     35:  * Initial revision
                     36:  * 
                     37:  * Revision 1.2  89/02/12  10:06:11  mark
                     38:  * 1.2 release fixes
                     39:  * 
                     40:  * Revision 1.1  88/12/23  18:02:39  mark
                     41:  * Initial revision
                     42:  * 
                     43:  */
                     44: 
                     45: #ifndef lint
                     46: static char *ident = "$Id: ttyio.c,v 1.2 89/02/12 10:06:11 mark Exp $";
                     47: static char *copyright = "Copyright (c) 1989 Mark H. Colburn.\nAll rights reserved.\n";
                     48: #endif /* ! lint */
                     49: 
                     50: 
                     51: /* Headers */
                     52: 
                     53: #include "pax.h"
                     54: 
                     55: 
                     56: /* open_tty - open the terminal for interactive queries
                     57:  *
                     58:  * DESCRIPTION
                     59:  *
                     60:  *     Assumes that background processes ignore interrupts and that the
                     61:  *     open() or the isatty() will fail for processes which are not
                     62:  *     attached to terminals. Returns a file descriptor or -1 if
                     63:  *     unsuccessful. 
                     64:  *
                     65:  * RETURNS
                     66:  *
                     67:  *     Returns a file descriptor which can be used to read and write
                     68:  *     directly to the user's terminal, or -1 on failure.  
                     69:  *
                     70:  * ERRORS
                     71:  *
                     72:  *     If SIGINT cannot be ignored, or the open fails, or the newly opened
                     73:  *     terminal device is not a tty, then open_tty will return a -1 to the
                     74:  *     caller.
                     75:  */
                     76: 
                     77: #if __STDC__
                     78: 
                     79: int open_tty(void)
                     80: 
                     81: #else
                     82: 
                     83: int open_tty()
                     84: 
                     85: #endif
                     86: {
                     87:     int             fd;                /* file descriptor for terminal */
                     88:     SIG_T         (*intr)();   /* used to restore interupts if signal fails */
                     89: 
                     90:     if ((intr = signal(SIGINT, SIG_IGN)) == SIG_IGN) 
                     91:        return (-1);
                     92: 
                     93:     signal(SIGINT, intr);
                     94: 
                     95:     if ((fd = open(TTY, 2)) < 0) 
                     96:        return (-1);
                     97: 
                     98:     if (isatty(fd)) 
                     99:        return (fd);
                    100: 
                    101:     close(fd);
                    102:     return (-1);
                    103: }
                    104: 
                    105: 
                    106: /* nextask - ask a question and get a response
                    107:  *
                    108:  * DESCRIPTION
                    109:  *
                    110:  *     Give the user a prompt and wait for their response.  The prompt,
                    111:  *     located in "msg" is printed, then the user is allowed to type
                    112:  *     a response to the message.  The first "limit" characters of the
                    113:  *     user response is stored in "answer".
                    114:  *
                    115:  *     Nextask ignores spaces and tabs. 
                    116:  *
                    117:  * PARAMETERS
                    118:  *
                    119:  *     char *msg       - Message to display for user 
                    120:  *     char *answer    - Pointer to user's response to question 
                    121:  *     int limit       - Limit of length for user's response
                    122:  *
                    123:  * RETURNS
                    124:  *
                    125:  *     Returns the number of characters in the user response to the 
                    126:  *     calling function.  If an EOF was encountered, a -1 is returned to
                    127:  *     the calling function.  If an error occured which causes the read
                    128:  *     to return with a value of -1, then the function will return a
                    129:  *     non-zero return status to the calling process, and abort
                    130:  *     execution.
                    131:  */
                    132: 
                    133: #if __STDC__
                    134: 
                    135: int nextask(char *msg, char *answer, int limit)
                    136: 
                    137: #else
                    138: 
                    139: int nextask(msg, answer, limit)
                    140: char           *msg;           /* message to display for user */
                    141: char           *answer;                /* pointer to user's response to question */
                    142: int             limit;         /* limit of length for user's response */
                    143: 
                    144: #endif
                    145: {
                    146:     int             idx;       /* index into answer for character input */
                    147:     int             got;       /* number of characters read */
                    148:     char            c;         /* character read */
                    149: 
                    150:     if (ttyf < 0) {
                    151:        fatal("/dev/tty Unavailable");
                    152:     }
                    153:     write(ttyf, msg, (uint) strlen(msg));
                    154:     idx = 0;
                    155:     while ((got = read(ttyf, &c, 1)) == 1) {
                    156:        if (c == '\n') {
                    157:            break;
                    158:        } else if (c == ' ' || c == '\t') {
                    159:            continue;
                    160:        } else if (idx < limit - 1) {
                    161:            answer[idx++] = c;
                    162:        }
                    163:     }
                    164:     if (got == 0) {            /* got an EOF */
                    165:         return(-1);
                    166:     }
                    167:     if (got < 0) {
                    168:        fatal(strerror());
                    169:     }
                    170:     answer[idx] = '\0';
                    171:     return(0);
                    172: }
                    173: 
                    174: 
                    175: /* lineget - get a line from a given stream
                    176:  *
                    177:  * DESCRIPTION
                    178:  * 
                    179:  *     Get a line of input for the stream named by "stream".  The data on
                    180:  *     the stream is put into the buffer "buf".
                    181:  *
                    182:  * PARAMETERS
                    183:  *
                    184:  *     FILE *stream            - Stream to get input from 
                    185:  *     char *buf               - Buffer to put input into
                    186:  *
                    187:  * RETURNS
                    188:  *
                    189:  *     Returns 0 if successful, -1 at EOF. 
                    190:  */
                    191: 
                    192: #if __STDC__
                    193: 
                    194: int lineget(FILE *stream, char *buf)
                    195: 
                    196: #else
                    197: 
                    198: int lineget(stream, buf)
                    199: FILE           *stream;                /* stream to get input from */
                    200: char           *buf;           /* buffer to put input into */
                    201: 
                    202: #endif
                    203: {
                    204:     int             c;
                    205: 
                    206:     for (;;) {
                    207:        if ((c = getc(stream)) == EOF) {
                    208:            return (-1);
                    209:        }
                    210:        if (c == '\n') {
                    211:            break;
                    212:        }
                    213:        *buf++ = c;
                    214:     }
                    215:     *buf = '\0';
                    216:     return (0);
                    217: }
                    218: 
                    219: 
                    220: /* next - Advance to the next archive volume. 
                    221:  *
                    222:  * DESCRIPTION
                    223:  *
                    224:  *     Prompts the user to replace the backup medium with a new volume
                    225:  *     when the old one is full.  There are some cases, such as when
                    226:  *     archiving to a file on a hard disk, that the message can be a
                    227:  *     little surprising.  Assumes that background processes ignore
                    228:  *     interrupts and that the open() or the isatty() will fail for
                    229:  *     processes which are not attached to terminals. Returns a file
                    230:  *     descriptor or -1 if unsuccessful. 
                    231:  *
                    232:  * PARAMETERS
                    233:  *
                    234:  *     int mode        - mode of archive (READ, WRITE, PASS) 
                    235:  */
                    236: 
                    237: #if __STDC__
                    238: 
                    239: void next(int mode)
                    240: 
                    241: #else
                    242: 
                    243: void next(mode)
                    244: int             mode;          /* mode of archive (READ, WRITE, PASS) */
                    245: 
                    246: #endif
                    247: {
                    248:     char            msg[200];  /* buffer for message display */ 
                    249:     char            answer[20];        /* buffer for user's answer */
                    250:     int             ret;
                    251: 
                    252:     close_archive();
                    253:     sprintf(msg, "%s: Ready for volume %u\n%s: Type \"device\/name\" when ready to proceed (or \"quit\" to abort): \07",
                    254:                   myname, arvolume + 1, myname);
                    255:     for (;;) {
                    256:        ret = nextask(msg, answer, sizeof(answer));
                    257:        if (ret == -1 || strcmp(answer, "quit") == 0) {
                    258:            fatal("Aborted");
                    259:        }
                    260:        ar_file = answer;       /* next bug was fixed */
                    261: 
                    262:        if (ret != -1 && open_archive(mode) == 0) {
                    263:            break;
                    264:        }
                    265:     }
                    266:     warnarch("Continuing", (OFFSET) 0);
                    267: }

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.