Manpages

NOMBRE

termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed − obtiene y pone atributos de la terminal, controla la línea de la terminal, obtiene y pone la velocidad de la línea

SINOPSIS

#include <termios.h>
#include <unistd.h>

int tcgetattr(int fd, struct termios *termios_p);

int tcsetattr(int fd, int optional_actions, struct termios *termios_p);

int tcsendbreak(int fd, int duration);

int tcdrain(int fd);

int tcflush(int fd, int queue_selector);

int tcflow(int fd, int action);

int cfmakeraw(struct termios *termios_p);

speed_t cfgetispeed(struct termios *termios_p);

speed_t cfgetospeed(struct termios *termios_p);

int cfsetispeed(struct termios *termios_p, speed_t speed);

int cfsetospeed(struct termios *termios_p, speed_t speed);

DESCRIPCIÓN

Las funciones termios describen una interfaz general para las terminales que sirve para controlar los puertos de comunicaciones asícronas.

Muchas de las funciones que se describen aquí poseen un argumento termios_p que es un puntero a una estructura termios. Esta estructura contiene, al menos, los siguientes miembros:

tcflag_t c_iflag; /* modos de entrada */
tcflag_t c_oflag; /* modos de salida */
tcflag_t c_cflag; /* modos de control */
tcflag_t c_lflag; /* modos locales */
cc_t c_cc[NCCS]; /* caracts. de control */

Constantes de opciones de c_iflag:

IMAXBEL

(No en POSIX) Hacer sonar un pitido cuando la cola de entrada esté llena. Linux no implementa este bit y actúa como si siempre estuviera activo.

Constantes de opciones de c_oflag definidas en POSIX.1:

Las restantes constantes de opciones c_oflag se definen en POSIX 1003.1-2001, a menos que se indique lo contrario.

Constantes de opciones de c_cflag:

CBAUDEX

(No en POSIX) Máscara extra de velocidad de transferencia (1 bit), incluida en CBAUD.

(POSIX dice que la velocidad de transferencia se almacena en la estructura termios sin especificar precisamente dónde y proporciona cfgetispeed() y cfsetispeed() para acceder a ella. Algunos sistemas usan los bits seleccionados por CBAUD en c_cflag, otros usan campos separados, por ejemplo sg_ispeed y sg_ospeed.)

CRTSCTS

(No en POSIX) Habilita el contro de flujo (hardware) RTS/CTS.

Constantes de opciones de c_lflag:

ECHOCTL

(No en POSIX) Si ECHO también está activo, las señales de control ASCII distintas de TAB, NL, START y STOP se muestran como ^X, donde X es el carácter cuyo código ASCII es 0x40 más el de la señal de control. Por ejemplo, el carácter 0x08 (BS) se muestra como ^H.

ECHOPRT

(No en POSIX) Si ICANON y IECHO están también activos, los caracteres se muestran mientras están siendo borrados.

DEFECHO

(No en POSIX) Hacer eco de caracteres sólo cuando esté leyendo un proceso.

El vector c_cc define los caracteres de control especiales. Los índices simbólicos (valores iniciales) y su significado son:

VWERASE

(No en POSIX; 027, ETB, Ctrl-W) Borrado de palabras. Se reconoce cuando ICANON e IEXTEN está activas, en cuyo caso no se pasa como dato de entrada.

VREPRINT

(No en POSIX; 022, DC2, Ctrl-R) Reimprime los caracteres no leídos. Se reconoce cuando ICANON e IEXTEN están activas, en cuyo caso no se pasa como dato de entrada.

VDISCARD

(No en POSIX; sin soporte en Linux; 017, SI, Ctrl-O) Conmutar: comenzar/detener el descarte de salida pendiente. Se reconoce cuando IEXTEN está activa, en cuyo caso no se pasa como dato de entrada.

VSTATUS

(No en POSIX; sin soporte en Linux; solicitud de estado: 024, DC4, Ctrl-T).

Estos valores de subíndices simbólicos son todos diferentes, excepto VTIME y VMIN que puede tener el mismo valor que VEOL y VEOF, respectivamente. (En el modo no canónico, el significado de los caracteres especiales se reemplaza por el significado de plazo de tiempo. MIN representa el número mínimo de caracteres que se deben recibir para satisfacer la lectura. TIME es un temporizador dado en décimas de segundo. Cuando se han asignado valores a ambos, una lectura esperará hasta que se haya recibido al menos un carácter y entonces terminará tan pronto se hayan recibido MIN caracteres o haya pasado un tiempo TIME desde que se recibió el último carácter. Si se asigna un valor sólo a MIN, la lectura no terminará antes de que se hayan recibido MIN caracteres. Si se asigna un valor sólo a TIME, la lectura terminará tan pronto se haya recibido al menos un carácter o cumpla el tiempo del temporizador. Si no se les asigna ningún valor, la lectura terminará inmediatamente, devolviendo sólo los caracteres ya disponibles actualmente.)

tcgetattr() obtiene los parámetros asociados con el objeto referido por fd y los guarda en la estructura termios referenciada por termios_p. Esta función puede llamarse desde un proceso en segundo plano; sin embargo, los atributos de la terminal pueden ser modificados posteriormente por un proceso en primer plano.

tcsetattr() establece los parámetros asociados con la terminal (a menos que se requiera un soporte del hardware subyacente que no esté disponible) desde la estructura termios referenciada por termios_p. optional_actions especifica cuándo tendrán efecto los cambios:
TCSANOW

el cambio ocurre inmediatamente.

TCSADRAIN

el cambio ocurre después de que se haya transmitido toda la salida escrita a fd. Esta función debería emplearse cuando se cambien parámetros que afecten a la salida.

TCSAFLUSH

el cambio ocurre después de que se haya transmitido toda la salida escrita al objeto referenciado por fd, y toda la entrada que se haya recibido pero no leído será descartada antes de que se haga el cambio.

tcsendbreak() transmite un flujo continuo de bits a cero durante un tiempo determinado, si la terminal emplea transmisión de datos en serie asíncrona. Si duration es cero, transmite bits ceros durante al menos ¼ de segundo y no más de ½ segundo. Si duration no es cero, transmite bits cero durante duration*N segundos, donde N es como poco 0,25 s y no más de 0,5 s.

Si la terminal no está utilizando la transmisión asíncrona de datos en serie, tcsendbreak() regresa sin realizar ninguna acción.

tcdrain() espera hasta que se haya transmitido toda la salida escrita al objeto referido por fd.

tcflush() descarta datos escritos al objeto referido por fd pero no transmitidos, o datos recibidos pero no leídos, dependiendo del valor de queue_selector:
TCIFLUSH

descarta datos recibidos pero no leídos.

TCOFLUSH

descarta datos escritos pero no transmitidos.

TCIOFLUSH

descarta tanto los datos recibidos pero no leídos, como los escritos pero no transmitidos.

tcflow() suspende la transmisión o recepción de datos en el objeto referido por fd, dependiendo del valor de action:

El comportamiento predeterminado al abrir un fichero de terminal es que ni su entrada ni su salida están suspendidas.

Las funciones de tasa de transferencia se proporcionan para obtener y asignar los valores de las tasas de transferencia de entrada y de salida en la estructura termios. Los nuevos valores no entran en vigor hasta que se llame con éxito a tcsetattr().

Poner la velocidad a B0 significa decirle al módem que "cuelgue". La velocidad de bits real correspondiente a B38400 puede alterarse con setserial(8).

Las velocidades de entrada y salida se guardan en la estructura termios.

cfmakeraw establece los atributos de la terminal como sigue:
termios_p->c_iflag &= ~(IGNBRK|BRKINT|PARMRK|ISTRIP
|INLCR|IGNCR|ICRNL|IXON);
termios_p->c_oflag &= ~OPOST;
termios_p->c_lflag &= ~(ECHO|ECHONL|ICANON|ISIG|IEXTEN);
termios_p->c_cflag &= ~(CSIZE|PARENB);
termios_p->c_cflag |= CS8;

cfgetospeed() devuelve la velocidad de salida guardada en la estructura termios apuntada por termios_p.

cfsetospeed() establece la velocidad de salida, guardada en la estructura termios apuntada por termios_p, a speed, que debe ser una de estas constantes:

La velocidad de cero baudios, B0, se emplea para terminar la conexión. Si se especifica B0, las lineas de control del módem no se activarán más. Normalmente, esto desconectará la línea. CBAUDEX es una máscara para las velocidades más grandes que aquéllas definidas en POSIX.1 (57600 y más). Así, B57600 & CBAUDEX es distinto de cero.

cfgetispeed() devuelve la velocidad de entrada guardada en la estructura termios.

cfsetispeed() establece la velocidad de entrada guardada en la estructura termios a speed. Si la velocidad de entrada se pone a cero, la velocidad de entrada será igual a la de salida.

VALOR DEVUELTO

cfgetispeed() devuelve la velocidad de entrada guardada en la estructura termios.

cfgetospeed() devuelve la velocidad de salida guardada en la estructura termios.

Todas las demás funciones devuelven:

Dese cuenta que tcsetattr() termina con éxito si cualquiera de los cambios solicitados pudo llevarse a cabo satisfactoriamente. Por lo tanto, cuando se hacen múltiples cambios puede ser necesario seguir esta llamada con una llamada adicional a tcgetattr() para comprobar que todos los cambios se han realizado con éxito.

NOTAS

Unix V7 y varios sistemas posteriores poseen una lista de tasas de transferencia en las que, después de los catorce valores B0, ..., B9600, aparecen dos constantes, EXTA y EXTB ("External A" y "External B"). Muchos sistemas extienden la lista con tasas de transferencia mucho más altas.

VÉASE TAMBIÉN

stty(1), setserial(8)