Provided by:
manpages-es_1.55-10_all 
NOMBRE
termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow,
cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed - obtiene
y pone atributos de la terminal, controla la linea de la terminal,
obtiene y pone la velocidad de la linea
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'ON
Las funciones termios describen una interfaz general para las
terminales que sirve para controlar los puertos de comunicaciones
asicronas.
Muchas de las funciones que se describen aqui 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:
IGNBRK no hacer caso de la condicion BREAK en la entrada.
BRKINT Si IGNBRK esta activa, los BREAK se ignoran. Si no esta activa
pero BRKINT si lo esta, entonces cada BREAK hace que se vacien
las colas de entrada y de salida y, si la terminal es la
terminal controladora del grupo de procesos en primer plano,
hara que se envie SIGINT a este grupo de procesos en primer
plano. Cuando ni IGNBRK ni BRKINT estan activos, cada BREAK se
interpreta como un caracter NUL, excepto cuando esta activo
PARMRK, en cuyo caso se interpretan como la secuencia \377 \0
\0.
IGNPAR No hacer caso de errores de marco y paridad.
PARMRK si IGNPAR no esta activo, prefijar con \377 \0 un caracter con
un error de paridad o marco. Si ni IGNPAR ni PARMRK estan
activos, interpretar un caracter con un error de paridad o marco
como \0.
INPCK Permitir la comprobacion de paridad en la entrada.
ISTRIP Quitar, o poner a cero, el 8o bit.
INLCR Traducir NL a CR en la entrada.
IGNCR No hacer caso del retorno de carro en la entrada.
ICRNL Traducir retorno de carro a salto de linea en la entrada (a
menos que IGNCR este activado).
IUCLC (No en POSIX) Convertir letras mayusculas a las minusculas
correspondientes en la entrada.
IXON Activar el control de flujo XON/XOFF en la salida.
IXANY (No en POSIX.1; XSI) Permitir que cualquier caracter reinicie la
salida.
IXOFF Activar el control de flujo XON/XOFF en la entrada.
IMAXBEL
(No en POSIX) Hacer sonar un pitido cuando la cola de entrada
este llena. Linux no implementa este bit y actua como si siempre
estuviera activo.
Constantes de opciones de c_oflag definidas en POSIX.1:
OPOST Activar el procesamiento de salida definido por la
implementacion.
Las restantes constantes de opciones c_oflag se definen en POSIX
1003.1-2001, a menos que se indique lo contrario.
OLCUC (No en POSIX) Convertir las letras minusculas en las
correspondientes mayusculas en la salida.
ONLCR (XSI) Convertir NL a CR-NL en la salida.
OCRNL Convertir CR a NL en la salida.
ONOCR No sacar CR en la columna 0.
ONLRET No sacar CR.
OFILL Enviar caracteres de relleno para un retardo, en vez de usar un
retardo de tiempo.
OFDEL (No en POSIX) El caracter de relleno es el ASCII DEL (0177). Si
no esta activado, el caracter de relleno es el ASCII NUL.
NLDLY Mascara de retardo del salto de linea. Los valores son NL0 y
NL1.
CRDLY Mascara de retardo del retorno de carro. Los valores son CR0,
CR1, CR2 y CR3.
TABDLY Mascara de retardo del tabulador horizontal. Los valores son
TAB0, TAB1, TAB2 y TAB3 (o XTABS). Un valor de TAB3, es decir,
XTABS, expande tabuladores a espacios (con paradas del tabulador
cada 8 columnas).
BSDLY Mascara de retardo del retroceso. Los valores son BS0 o BS1.
(Nunca se ha implementado.)
VTDLY Mascara de retardo del tabulador vertical. Los valores son VT0 o
VT1.
FFDLY Mascara de retardo del salto de pagina. Los valores son FF0 o
FF1.
Constantes de opciones de c_cflag:
CBAUD (No en POSIX) Mascara de velocidad de transferencia (4+1 bits).
CBAUDEX
(No en POSIX) Mascara 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 donde 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.)
CSIZE mascara de tamano de caracter. Los valores son CS5, CS6, CS7 o
CS8.
CSTOPB Establece dos bits de parada, en vez de uno.
CREAD Habilita el receptor.
PARENB Activa la generacion de paridad en la salida y comprobacion de
paridad para la entrada.
PARODD La paridad para la entrada y la salida es impar.
HUPCL Las lineas de control del modem inferiores tras el ultimo
proceso cierran el dispositivo (cuelgan).
CLOCAL No hace caso de las lineas de control del modem.
CIBAUD (No en POSIX) Mascara para las velocidades de entrada. Los
valores para los bits CIBAUD son los mismos que los valores para
los bits CBAUD, desplazados IBSHIFT bits a la izquierda.
CRTSCTS
(No en POSIX) Habilita el contro de flujo (hardware) RTS/CTS.
Constantes de opciones de c_lflag:
ISIG Cuando se reciba cualquiera de los caracteres INTR, QUIT, SUSP o
DSUSP, generar la senal correspondiente.
ICANON Activar el modo canonico. Esto habilita los caracteres
especiales EOF, EOL, EOL2, ERASE, KILL, LNEXT, REPRINT, STATUS y
WERASE y buffers para cada linea.
XCASE (No en POSIX; sin soporte en Linux) Si ICANON tambien esta
activo, la terminal es solo de letras mayusculas. La entrada se
convierte a minusculas, salvo para caracteres precedidos por \.
En la salida, las letras mayusculas salen precedidas por \ y las
minusculas convertidas en mayusculas.
ECHO Muestra caracteres de entrada.
ECHOE Si ICANON esta tambien activo, el caracter ERASE borra el
caracter anterior de la entrada y WERASE borra la palabra
anterior.
ECHOK Si ICANON tambien esta activo, el caracter KILL borra la linea
en curso.
ECHONL Si ICANON esta tambien activo, muestra el caracter NL incluso si
no esta activado ECHO.
ECHOCTL
(No en POSIX) Si ECHO tambien esta activo, las senales de
control ASCII distintas de TAB, NL, START y STOP se muestran
como ^X, donde X es el caracter cuyo codigo ASCII es 0x40 mas el
de la senal de control. Por ejemplo, el caracter 0x08 (BS) se
muestra como ^H.
ECHOPRT
(No en POSIX) Si ICANON y IECHO estan tambien activos, los
caracteres se muestran mientras estan siendo borrados.
ECHOKE (No en POSIX) Si ICANON tambien esta activo, KILL se muestra
borrando cada caracter de la linea, como se especifica en ECHOE
y ECHOPRT.
DEFECHO
(No en POSIX) Hacer eco de caracteres solo cuando este leyendo
un proceso.
FLUSHO (No en POSIX; sin soporte en Linux) La salida se esta volcando
al dispositivo de salida. Esta opcion se cambia al teclear el
caracter DISCARD.
NOFLSH Inhabilita el volcado de las colas de entrada y salida cuando se
esten generando las senales SIGINT, SIGQUIT y SIGSUSP.
TOSTOP Envia la senal SIGTTOU al grupo de proceso de un proceso en
segundo plano que trata de escribir en su terminal controladora.
PENDIN (No en POSIX; sin soporte en Linux) Todos los caracteres de la
cola de entrada se reimprimen cuando se lee el siguiente
caracter (bash maneja el teclear por adelantado asi.)
IEXTEN Habilita el procesamiento de entrada definido por la
implementacion. Se debe activar esta opcion, ademas de ICANON,
para que se interpreten los caracteres especiales EOL2, LNEXT,
REPRINT y WERASE y para que tenga efecto la opcion IUCLC.
El vector c_cc define los caracteres de control especiales. Los indices
simbolicos (valores iniciales) y su significado son:
VINTR (003, ETX, Ctrl-C o tambien 0177, DEL, rubout) Caracter de
interrupcion. Envia una senal SIGINT. Se reconoce cuando ISIG
esta activa en cuyo caso no se pasa como dato de entrada.
VQUIT (034, FS, Ctrl-\) Caracter de salida/parada. Envia una senal
SIGQUIT. Se reconoce cuando ISIG esta activa en cuyo caso no se
pasa como dato de entrada.
VERASE (0177, DEL, rubout, o 010, BS, Ctrl-H, o tambien #) Caracter de
borrado. Borra el caracter anterior todavia no borrado, pero no
borra mas alla de EOF o del principio de linea. Se reconoce
cuando ICANON esta activa en cuyo caso no se pasa como dato de
entrada.
VKILL (025, NAK, Ctrl-U, o Ctrl-X, o tambien @) Caracter de
eliminacion. Borra la entrada desde el ultimo EOF o principio de
linea. Se reconoce cuando ICANON esta activa en cuyo caso no se
pasa como dato de entrada.
VEOF (004, EOT, Ctrl-D) Caracter de fin de fichero. Mas exactamente:
este caracter hace que lo que haya pendiente en el buffer de la
terminal se envie al programa de usuario que esta esperando sin
esperar a un fin de linea. Si es el primer caracter de una
linea, la funcion read() en el programa de usuario devuelve 0,
que significa ``fin de fichero''. Se reconoce cuando ICANON esta
activa en cuyo caso no se pasa como dato de entrada.
VMIN Numero minimo de caracteres para una lectura no canonica.
VEOL (0, NUL) Caracter adicional de fin de linea. Se reconoce cuando
ICANON esta activa.
VTIME Plazo, en decimas de segundo, para una lectura no canonica.
VEOL2 (No en POSIX; 0, NUL) Otro caracter mas de fin de linea. Se
reconoce cuando ICANON esta activa.
VSWTCH (No en POSIX; sin soporte en Linux; 0, NUL) Caracter de
conmutacion/cambio. (Solo lo usa shl.)
VSTART (021, DC1, Ctrl-Q) Caracter de comienzo. Reinica la salida
detenida por un caracter de parada. Se reconoce cuando IXON esta
activa en cuyo caso no se pasa como dato de entrada.
VSTOP (023, DC3, Ctrl-S) Caracter de parada. Detiene la salida hasta
que se teclee un caracter de comienzo. Se reconoce cuando IXON
esta activa en cuyo caso no se pasa como dato de entrada.
VSUSP (032, SUB, Ctrl-Z) Caracter de suspension. Envia una senal
SIGTSTP. Se reconoce cuando ISIG esta activa en cuyo caso no se
pasa como dato de entrada.
VDSUSP (No en POSIX; sin soporte en Linux; 031, EM, Ctrl-Y) Caracter de
suspension demorada: envia una senal SIGTSTP cuando el programa
de usuario lee el caracter. Se reconoce cuando IEXTEN e ISIG
estan activas y el sistema soporta control de trabajos, en cuyo
caso no se pasa como dato de entrada.
VLNEXT (No en POSIX; 026, SYN, Ctrl-V) Siguiente literal. Obtiene tal
cual el siguiente caracter de entrada, quitandole cualquier
posible significado especial. Se reconoce cuando IEXTEN esta
activa en cuyo caso no se pasa como dato de entrada.
VWERASE
(No en POSIX; 027, ETB, Ctrl-W) Borrado de palabras. Se reconoce
cuando ICANON e IEXTEN esta activas, en cuyo caso no se pasa
como dato de entrada.
VREPRINT
(No en POSIX; 022, DC2, Ctrl-R) Reimprime los caracteres no
leidos. Se reconoce cuando ICANON e IEXTEN estan 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 esta 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 subindices simbolicos son todos diferentes, excepto
VTIME y VMIN que puede tener el mismo valor que VEOL y VEOF,
respectivamente. (En el modo no canonico, el significado de los
caracteres especiales se reemplaza por el significado de plazo de
tiempo. MIN representa el numero minimo de caracteres que se deben
recibir para satisfacer la lectura. TIME es un temporizador dado en
decimas de segundo. Cuando se han asignado valores a ambos, una lectura
esperara hasta que se haya recibido al menos un caracter y entonces
terminara tan pronto se hayan recibido MIN caracteres o haya pasado un
tiempo TIME desde que se recibio el ultimo caracter. Si se asigna un
valor solo a MIN, la lectura no terminara antes de que se hayan
recibido MIN caracteres. Si se asigna un valor solo a TIME, la lectura
terminara tan pronto se haya recibido al menos un caracter o cumpla el
tiempo del temporizador. Si no se les asigna ningun valor, la lectura
terminara inmediatamente, devolviendo solo los caracteres ya
disponibles actualmente.)
tcgetattr() obtiene los parametros asociados con el objeto referido por
fd y los guarda en la estructura termios referenciada por termios_p.
Esta funcion 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 parametros asociados con la terminal (a menos
que se requiera un soporte del hardware subyacente que no este
disponible) desde la estructura termios referenciada por termios_p.
optional_actions especifica cuando tendran efecto los cambios:
TCSANOW
el cambio ocurre inmediatamente.
TCSADRAIN
el cambio ocurre despues de que se haya transmitido toda la
salida escrita a fd. Esta funcion deberia emplearse cuando se
cambien parametros que afecten a la salida.
TCSAFLUSH
el cambio ocurre despues de que se haya transmitido toda la
salida escrita al objeto referenciado por fd, y toda la entrada
que se haya recibido pero no leido sera 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 transmision de datos en serie
asincrona. Si duration es cero, transmite bits ceros durante al menos
1/4 de segundo y no mas de 1/2 segundo. Si duration no es cero,
transmite bits cero durante duration*N segundos, donde N es como poco
0,25 s y no mas de 0,5 s.
Si la terminal no esta utilizando la transmision asincrona de datos en
serie, tcsendbreak() regresa sin realizar ninguna accion.
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 leidos, dependiendo del valor
de queue_selector:
TCIFLUSH
descarta datos recibidos pero no leidos.
TCOFLUSH
descarta datos escritos pero no transmitidos.
TCIOFLUSH
descarta tanto los datos recibidos pero no leidos, como los
escritos pero no transmitidos.
tcflow() suspende la transmision o recepcion de datos en el objeto
referido por fd, dependiendo del valor de action:
TCOOFF suspende la salida.
TCOON reanuda la salida suspendida.
TCIOFF transmite un caracter STOP, que hace que el dispositivo de
terminal deje de transmitir datos al sistema.
TCION transmite un caracter START, que hace que el dispositivo de
terminal empiece a transmitir datos del sistema.
El comportamiento predeterminado al abrir un fichero de terminal es que
ni su entrada ni su salida estan 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 exito a tcsetattr().
Poner la velocidad a B0 significa decirle al modem 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:
B0
B50
B75
B110
B134
B150
B200
B300
B600
B1200
B1800
B2400
B4800
B9600
B19200
B38400
B57600
B115200
B230400
La velocidad de cero baudios, B0, se emplea para terminar la conexion.
Si se especifica B0, las lineas de control del modem no se activaran
mas. Normalmente, esto desconectara la linea. CBAUDEX es una mascara
para las velocidades mas grandes que aquellas definidas en POSIX.1
(57600 y mas). Asi, 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 sera 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 demas funciones devuelven:
0 en caso de exito,
-1 en caso de fallo, y asignan un valor a errno para indicar el
error.
Dese cuenta que tcsetattr() termina con exito si cualquiera de los
cambios solicitados pudo llevarse a cabo satisfactoriamente. Por lo
tanto, cuando se hacen multiples cambios puede ser necesario seguir
esta llamada con una llamada adicional a tcgetattr() para comprobar que
todos los cambios se han realizado con exito.
NOTAS
Unix V7 y varios sistemas posteriores poseen una lista de tasas de
transferencia en las que, despues 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 mas altas.
V'EASE TAMBI'EN
stty(1), setserial(8)