Annotation of sys/sys/tty.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: tty.h,v 1.22 2006/08/17 06:27:05 miod Exp $ */
! 2: /* $NetBSD: tty.h,v 1.30.4.1 1996/06/02 09:08:13 mrg Exp $ */
! 3:
! 4: /*-
! 5: * Copyright (c) 1982, 1986, 1993
! 6: * The Regents of the University of California. All rights reserved.
! 7: * (c) UNIX System Laboratories, Inc.
! 8: * All or some portions of this file are derived from material licensed
! 9: * to the University of California by American Telephone and Telegraph
! 10: * Co. or Unix System Laboratories, Inc. and are reproduced herein with
! 11: * the permission of UNIX System Laboratories, Inc.
! 12: *
! 13: * Redistribution and use in source and binary forms, with or without
! 14: * modification, are permitted provided that the following conditions
! 15: * are met:
! 16: * 1. Redistributions of source code must retain the above copyright
! 17: * notice, this list of conditions and the following disclaimer.
! 18: * 2. Redistributions in binary form must reproduce the above copyright
! 19: * notice, this list of conditions and the following disclaimer in the
! 20: * documentation and/or other materials provided with the distribution.
! 21: * 3. Neither the name of the University nor the names of its contributors
! 22: * may be used to endorse or promote products derived from this software
! 23: * without specific prior written permission.
! 24: *
! 25: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
! 26: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 27: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 28: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 29: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 30: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 31: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 32: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 33: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 34: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 35: * SUCH DAMAGE.
! 36: *
! 37: * @(#)tty.h 8.6 (Berkeley) 1/21/94
! 38: */
! 39:
! 40: #include <sys/termios.h>
! 41: #include <sys/queue.h>
! 42: #include <sys/selinfo.h> /* For struct selinfo. */
! 43: #include <sys/timeout.h>
! 44:
! 45: #define KERN_TTY_TKNIN 1 /* quad: input chars */
! 46: #define KERN_TTY_TKNOUT 2 /* quad: output chars */
! 47: #define KERN_TTY_TKRAWCC 3 /* quad: input chars, raw mode */
! 48: #define KERN_TTY_TKCANCC 4 /* quad: input char, cooked mode */
! 49: #define KERN_TTY_INFO 5 /* struct: tty stats */
! 50: #define KERN_TTY_MAXPTYS 6 /* int: max ptys */
! 51: #define KERN_TTY_NPTYS 7 /* int: number of allocated ptys */
! 52: #define KERN_TTY_MAXID 8
! 53:
! 54: #define CTL_KERN_TTY_NAMES { \
! 55: { 0, 0 }, \
! 56: { "tk_nin", CTLTYPE_QUAD }, \
! 57: { "tk_nout", CTLTYPE_QUAD }, \
! 58: { "tk_rawcc", CTLTYPE_QUAD }, \
! 59: { "tk_cancc", CTLTYPE_QUAD }, \
! 60: { "ttyinfo", CTLTYPE_STRUCT }, \
! 61: { "maxptys", CTLTYPE_INT }, \
! 62: { "nptys", CTLTYPE_INT }, \
! 63: }
! 64:
! 65: /* ptmget, for /dev/ptm pty getting ioctl PTMGET */
! 66:
! 67: struct ptmget {
! 68: int cfd;
! 69: int sfd;
! 70: char cn[16];
! 71: char sn[16];
! 72: };
! 73: #define PTMGET _IOR('t', 1, struct ptmget) /* get ptys */
! 74: #define PATH_PTMDEV "/dev/ptm"
! 75: #define TTY_GID 4 /* XXX evil hardcoding of tty gid */
! 76:
! 77: /*
! 78: * Clists are actually ring buffers. The c_cc, c_cf, c_cl fields have
! 79: * exactly the same behaviour as in true clists.
! 80: * if c_cq is NULL, the ring buffer has no TTY_QUOTE functionality
! 81: * (but, saves memory and cpu time)
! 82: *
! 83: * *DON'T* play with c_cs, c_ce, c_cq, or c_cl outside tty_subr.c!!!
! 84: */
! 85: struct clist {
! 86: int c_cc; /* count of characters in queue */
! 87: int c_cn; /* total ring buffer length */
! 88: u_char *c_cf; /* points to first character */
! 89: u_char *c_cl; /* points to next open character */
! 90: u_char *c_cs; /* start of ring buffer */
! 91: u_char *c_ce; /* c_ce + c_len */
! 92: u_char *c_cq; /* N bits/bytes long, see tty_subr.c */
! 93: };
! 94:
! 95: /*
! 96: * Per-tty structure.
! 97: *
! 98: * Should be split in two, into device and tty drivers.
! 99: * Glue could be masks of what to echo and circular buffer
! 100: * (low, high, timeout).
! 101: */
! 102: struct tty {
! 103: TAILQ_ENTRY(tty) tty_link; /* Link in global tty list. */
! 104: struct clist t_rawq; /* Device raw input queue. */
! 105: long t_rawcc; /* Raw input queue statistics. */
! 106: struct clist t_canq; /* Device canonical queue. */
! 107: long t_cancc; /* Canonical queue statistics. */
! 108: struct clist t_outq; /* Device output queue. */
! 109: long t_outcc; /* Output queue statistics. */
! 110: u_char t_line; /* Interface to device drivers. */
! 111: dev_t t_dev; /* Device. */
! 112: int t_state; /* Device and driver (TS*) state. */
! 113: int t_flags; /* Tty flags. */
! 114: struct pgrp *t_pgrp; /* Foreground process group. */
! 115: struct session *t_session; /* Enclosing session. */
! 116: struct selinfo t_rsel; /* Tty read/oob select. */
! 117: struct selinfo t_wsel; /* Tty write select. */
! 118: struct termios t_termios; /* Termios state. */
! 119: struct winsize t_winsize; /* Window size. */
! 120: /* Start output. */
! 121: void (*t_oproc)(struct tty *);
! 122: /* Set hardware state. */
! 123: int (*t_param)(struct tty *, struct termios *);
! 124: /* Set hardware flow control. */
! 125: int (*t_hwiflow)(struct tty *tp, int flag);
! 126: void *t_sc; /* XXX: net/if_sl.c:sl_softc. */
! 127: short t_column; /* Tty output column. */
! 128: short t_rocount, t_rocol; /* Tty. */
! 129: short t_hiwat; /* High water mark. */
! 130: short t_lowat; /* Low water mark. */
! 131: short t_gen; /* Generation number. */
! 132: struct timeout t_rstrt_to; /* restart timeout */
! 133: struct timeval t_tv; /* timestamp */
! 134: };
! 135:
! 136: /*
! 137: * Small version of struct tty exported via sysctl KERN_TTY_INFO
! 138: */
! 139: struct itty {
! 140: dev_t t_dev;
! 141: int t_rawq_c_cc;
! 142: int t_canq_c_cc;
! 143: int t_outq_c_cc;
! 144: short t_hiwat;
! 145: short t_lowat;
! 146: short t_column;
! 147: int t_state;
! 148: struct session *t_session;
! 149: pid_t t_pgrp_pg_id;
! 150: u_char t_line;
! 151: };
! 152:
! 153: #define t_cc t_termios.c_cc
! 154: #define t_cflag t_termios.c_cflag
! 155: #define t_iflag t_termios.c_iflag
! 156: #define t_ispeed t_termios.c_ispeed
! 157: #define t_lflag t_termios.c_lflag
! 158: #define t_min t_termios.c_min
! 159: #define t_oflag t_termios.c_oflag
! 160: #define t_ospeed t_termios.c_ospeed
! 161: #define t_time t_termios.c_time
! 162:
! 163: #define TTIPRI 25 /* Sleep priority for tty reads. */
! 164: #define TTOPRI 26 /* Sleep priority for tty writes. */
! 165:
! 166: #define TTMASK 15
! 167: #define OBUFSIZ 512
! 168: #define TTYHOG 1024
! 169:
! 170: #ifdef _KERNEL
! 171: #define TTMAXHIWAT roundup(2048, CBSIZE)
! 172: #define TTMINHIWAT roundup(100, CBSIZE)
! 173: #define TTMAXLOWAT 256
! 174: #define TTMINLOWAT 32
! 175: #endif
! 176:
! 177: /* These flags are kept in t_state. */
! 178: #define TS_ASLEEP 0x00001 /* Process waiting for tty. */
! 179: #define TS_ASYNC 0x00002 /* Tty in async I/O mode. */
! 180: #define TS_BUSY 0x00004 /* Draining output. */
! 181: #define TS_CARR_ON 0x00008 /* Carrier is present. */
! 182: #define TS_FLUSH 0x00010 /* Outq has been flushed during DMA. */
! 183: #define TS_ISOPEN 0x00020 /* Open has completed. */
! 184: #define TS_TBLOCK 0x00040 /* Further input blocked. */
! 185: #define TS_TIMEOUT 0x00080 /* Wait for output char processing. */
! 186: #define TS_TTSTOP 0x00100 /* Output paused. */
! 187: #define TS_WOPEN 0x00200 /* Open in progress. */
! 188: #define TS_XCLUDE 0x00400 /* Tty requires exclusivity. */
! 189:
! 190: /* State for intra-line fancy editing work. */
! 191: #define TS_BKSL 0x00800 /* State for lowercase \ work. */
! 192: #define TS_CNTTB 0x01000 /* Counting tab width, ignore FLUSHO. */
! 193: #define TS_ERASE 0x02000 /* Within a \.../ for PRTRUB. */
! 194: #define TS_LNCH 0x04000 /* Next character is literal. */
! 195: #define TS_TYPEN 0x08000 /* Retyping suspended input (PENDIN). */
! 196: #define TS_LOCAL (TS_BKSL | TS_CNTTB | TS_ERASE | TS_LNCH | TS_TYPEN)
! 197:
! 198: #define TS_TSTAMPDCDSET 0x10000 /* update timestamp on DCD set */
! 199: #define TS_TSTAMPDCDCLR 0x20000 /* update timestamp on DCD clr */
! 200: #define TS_TSTAMPCTSSET 0x40000 /* update timestamp on CTS set */
! 201: #define TS_TSTAMPCTSCLR 0x80000 /* update timestamp on CTS clr */
! 202:
! 203: /* Character type information. */
! 204: #define ORDINARY 0
! 205: #define CONTROL 1
! 206: #define BACKSPACE 2
! 207: #define NEWLINE 3
! 208: #define TAB 4
! 209: #define VTAB 5
! 210: #define RETURN 6
! 211:
! 212: struct speedtab {
! 213: int sp_speed; /* Speed. */
! 214: int sp_code; /* Code. */
! 215: };
! 216:
! 217: /* Modem control commands (driver). */
! 218: #define DMSET 0
! 219: #define DMBIS 1
! 220: #define DMBIC 2
! 221: #define DMGET 3
! 222:
! 223: /* Flags on a character passed to ttyinput. */
! 224: #define TTY_CHARMASK 0x000000ff /* Character mask */
! 225: #define TTY_QUOTE 0x00000100 /* Character quoted */
! 226: #define TTY_ERRORMASK 0xff000000 /* Error mask */
! 227: #define TTY_FE 0x01000000 /* Framing error or BREAK condition */
! 228: #define TTY_PE 0x02000000 /* Parity error */
! 229:
! 230: /* Is tp controlling terminal for p? */
! 231: #define isctty(p, tp) \
! 232: ((p)->p_session == (tp)->t_session && (p)->p_flag & P_CONTROLT)
! 233:
! 234: /* Is p in background of tp? */
! 235: #define isbackground(p, tp) \
! 236: (isctty((p), (tp)) && (p)->p_pgrp != (tp)->t_pgrp)
! 237:
! 238: /*
! 239: * ttylist_head is defined here so that user-land has access to it.
! 240: */
! 241: TAILQ_HEAD(ttylist_head, tty); /* the ttylist is a TAILQ */
! 242:
! 243: #ifdef _KERNEL
! 244:
! 245: extern int tty_count; /* number of ttys in global ttylist */
! 246: extern struct ttychars ttydefaults;
! 247:
! 248: /* Symbolic sleep message strings. */
! 249: extern char ttyin[], ttyout[], ttopen[], ttclos[], ttybg[], ttybuf[];
! 250:
! 251: int sysctl_tty(int *, u_int, void *, size_t *, void *, size_t);
! 252: int sysctl_pty(int *, u_int, void *, size_t *, void *, size_t);
! 253:
! 254: int b_to_q(u_char *cp, int cc, struct clist *q);
! 255: void catq(struct clist *from, struct clist *to);
! 256: void clist_init(void);
! 257: int getc(struct clist *q);
! 258: void ndflush(struct clist *q, int cc);
! 259: int ndqb(struct clist *q, int flag);
! 260: u_char *nextc(struct clist *q, u_char *cp, int *c);
! 261: int putc(int c, struct clist *q);
! 262: int q_to_b(struct clist *q, u_char *cp, int cc);
! 263: int unputc(struct clist *q);
! 264:
! 265: int nullmodem(struct tty *tp, int flag);
! 266: int tputchar(int c, struct tty *tp);
! 267: int ttioctl(struct tty *tp, u_long com, caddr_t data, int flag,
! 268: struct proc *p);
! 269: int ttread(struct tty *tp, struct uio *uio, int flag);
! 270: void ttrstrt(void *tp);
! 271: int ttpoll(dev_t device, int events, struct proc *p);
! 272: int ttkqfilter(dev_t dev, struct knote *kn);
! 273: void ttsetwater(struct tty *tp);
! 274: int ttspeedtab(int speed, const struct speedtab *table);
! 275: int ttstart(struct tty *tp);
! 276: void ttwakeup(struct tty *tp);
! 277: int ttwrite(struct tty *tp, struct uio *uio, int flag);
! 278: void ttychars(struct tty *tp);
! 279: int ttycheckoutq(struct tty *tp, int wait);
! 280: int ttyclose(struct tty *tp);
! 281: void ttyflush(struct tty *tp, int rw);
! 282: void ttyinfo(struct tty *tp);
! 283: int ttyinput(int c, struct tty *tp);
! 284: int ttylclose(struct tty *tp, int flag);
! 285: int ttymodem(struct tty *tp, int flag);
! 286: int ttyopen(dev_t device, struct tty *tp);
! 287: int ttyoutput(int c, struct tty *tp);
! 288: void ttypend(struct tty *tp);
! 289: void ttyretype(struct tty *tp);
! 290: void ttyrub(int c, struct tty *tp);
! 291: int ttysleep(struct tty *tp,
! 292: void *chan, int pri, char *wmesg, int timeout);
! 293: int ttywait(struct tty *tp);
! 294: int ttywflush(struct tty *tp);
! 295: void ttytstamp(struct tty *tp, int octs, int ncts, int odcd, int ndcd);
! 296:
! 297: void tty_init(void);
! 298: struct tty *ttymalloc(void);
! 299: void ttyfree(struct tty *);
! 300: u_char *firstc(struct clist *clp, int *c);
! 301:
! 302: int cttyopen(dev_t, int, int, struct proc *);
! 303: int cttyread(dev_t, struct uio *, int);
! 304: int cttywrite(dev_t, struct uio *, int);
! 305: int cttyioctl(dev_t, u_long, caddr_t, int, struct proc *);
! 306: int cttypoll(dev_t, int, struct proc *);
! 307:
! 308: int clalloc(struct clist *, int, int);
! 309: void clfree(struct clist *);
! 310:
! 311: #if defined(COMPAT_43) || defined(COMPAT_SUNOS) || defined(COMPAT_SVR4) || \
! 312: defined(COMPAT_FREEBSD) || defined(COMPAT_OSF1)
! 313: # define COMPAT_OLDTTY
! 314: int ttcompat(struct tty *, u_long, caddr_t, int, struct proc *);
! 315: #endif
! 316:
! 317: #endif
CVSweb