Provided by: manpages-es_1.55-3_all bug

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:

       IGNBRK no hacer caso de la condición BREAK en la entrada.

       BRKINT Si  IGNBRK  está activa, los BREAK se ignoran. Si no está activa
              pero BRKINT si lo está, entonces cada BREAK hace que  se  vacíen
              las  colas  de  entrada  y  de  salida  y,  si la terminal es la
              terminal controladora del grupo de  procesos  en  primer  plano,
              hará  que  se  envíe  SIGINT  a este grupo de procesos en primer
              plano. Cuando ni IGNBRK ni BRKINT están activos, cada  BREAK  se
              interpreta  como  un  carácter  NUL,  excepto cuando está 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 está activo, prefijar con \377 \0 un carácter con
              un error de paridad o  marco.  Si  ni  IGNPAR  ni  PARMRK  están
              activos, interpretar un carácter con un error de paridad o marco
              como \0.

       INPCK  Permitir la comprobación de paridad en la entrada.

       ISTRIP Quitar, o poner a cero, el 8º 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  línea  en  la  entrada  (a
              menos que IGNCR esté activado).

       IUCLC  (No  en  POSIX)  Convertir  letras  mayúsculas  a las minúsculas
              correspondientes en la entrada.

       IXON   Activar el control de flujo XON/XOFF en la salida.

       IXANY  (No en POSIX.1; XSI) Permitir que cualquier carácter 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
              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:

       OPOST  Activar   el   procesamiento   de   salida   definido   por   la
              implementación.

       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  minúsculas  en  las
              correspondientes mayúsculas 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 carácter de relleno es el ASCII DEL (0177). Si
              no está activado, el carácter de relleno es el ASCII NUL.

       NLDLY  Máscara de retardo del salto de línea. Los  valores  son  NL0  y
              NL1.

       CRDLY  Máscara  de  retardo  del retorno de carro. Los valores son CR0,
              CR1, CR2 y CR3.

       TABDLY Máscara 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  Máscara  de  retardo  del  retroceso. Los valores son BS0 o BS1.
              (Nunca se ha implementado.)

       VTDLY  Máscara de retardo del tabulador vertical. Los valores son VT0 o
              VT1.

       FFDLY  Máscara  de  retardo  del salto de página. Los valores son FF0 o
              FF1.

       Constantes de opciones de c_cflag:

       CBAUD  (No en POSIX) Máscara de velocidad de transferencia (4+1  bits).

       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.)

       CSIZE  máscara de tamaño de carácter. 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  generación de paridad en la salida y comprobación de
              paridad para la entrada.

       PARODD La paridad para la entrada y la salida es impar.

       HUPCL  Las líneas de  control  del  módem  inferiores  tras  el  último
              proceso cierran el dispositivo (cuelgan).

       CLOCAL No hace caso de las líneas de control del módem.

       CIBAUD (No  en  POSIX)  Máscara  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 señal correspondiente.

       ICANON Activar  el  modo  canónico.  Esto   habilita   los   caracteres
              especiales EOF, EOL, EOL2, ERASE, KILL, LNEXT, REPRINT, STATUS y
              WERASE y buffers para cada línea.

       XCASE  (No en POSIX; sin soporte  en  Linux)  Si  ICANON  también  está
              activo, la terminal es sólo de letras mayúsculas.  La entrada se
              convierte a minúsculas, salvo para caracteres precedidos por  \.
              En la salida, las letras mayúsculas salen precedidas por \ y las
              minúsculas convertidas en mayúsculas.

       ECHO   Muestra caracteres de entrada.

       ECHOE  Si ICANON está  también  activo,  el  carácter  ERASE  borra  el
              carácter  anterior  de  la  entrada  y  WERASE  borra la palabra
              anterior.

       ECHOK  Si ICANON también está activo, el carácter KILL borra  la  línea
              en curso.

       ECHONL Si ICANON está también activo, muestra el carácter NL incluso si
              no está activado ECHO.

       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.

       ECHOKE (No  en  POSIX)  Si  ICANON también está activo, KILL se muestra
              borrando cada carácter de la línea, como se especifica en  ECHOE
              y ECHOPRT.

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

       FLUSHO (No en POSIX; sin soporte en Linux) La salida se  está  volcando
              al  dispositivo  de  salida. Esta opción se cambia al teclear el
              carácter DISCARD.

       NOFLSH Inhabilita el volcado de las colas de entrada y salida cuando se
              estén generando las señales SIGINT, SIGQUIT y SIGSUSP.

       TOSTOP Envía  la  señal  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
              carácter (bash maneja el teclear por adelantado así.)

       IEXTEN Habilita   el   procesamiento   de   entrada   definido  por  la
              implementación.  Se debe activar esta opción, además de  ICANON,
              para  que  se interpreten los caracteres especiales EOL2, LNEXT,
              REPRINT y WERASE y para que tenga efecto la opción IUCLC.

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

       VINTR  (003,  ETX,  Ctrl-C  o  también  0177,  DEL, rubout) Carácter de
              interrupción. Envía una señal SIGINT. Se  reconoce  cuando  ISIG
              está activa en cuyo caso no se pasa como dato de entrada.

       VQUIT  (034,  FS,  Ctrl-\)  Carácter  de salida/parada. Envía una señal
              SIGQUIT. Se reconoce cuando ISIG está activa en cuyo caso no  se
              pasa como dato de entrada.

       VERASE (0177,  DEL, rubout, o 010, BS, Ctrl-H, o también #) Carácter de
              borrado. Borra el carácter anterior todavía no borrado, pero  no
              borra  más  allá  de  EOF  o del principio de línea. Se reconoce
              cuando ICANON está activa en cuyo caso no se pasa como  dato  de
              entrada.

       VKILL  (025,   NAK,   Ctrl-U,  o  Ctrl-X,  o  también  @)  Carácter  de
              eliminación. Borra la entrada desde el último EOF o principio de
              línea.  Se reconoce cuando ICANON está activa en cuyo caso no se
              pasa como dato de entrada.

       VEOF   (004, EOT, Ctrl-D) Carácter de fin de fichero. Más  exactamente:
              este  carácter hace que lo que haya pendiente en el buffer de la
              terminal se envíe al programa de usuario que está esperando  sin
              esperar  a  un  fin  de  línea.  Si es el primer carácter de una
              línea, la función read() en el programa de usuario  devuelve  0,
              que significa ‘‘fin de fichero’’. Se reconoce cuando ICANON está
              activa en cuyo caso no se pasa como dato de entrada.

       VMIN   Número mínimo de caracteres para una lectura no canónica.

       VEOL   (0, NUL) Carácter adicional de fin de línea. Se reconoce  cuando
              ICANON está activa.

       VTIME  Plazo, en décimas de segundo, para una lectura no canónica.

       VEOL2  (No  en  POSIX;  0,  NUL)  Otro carácter más de fin de línea. Se
              reconoce cuando ICANON está activa.

       VSWTCH (No en  POSIX;  sin  soporte  en  Linux;  0,  NUL)  Carácter  de
              conmutación/cambio. (Sólo lo usa shl.)

       VSTART (021,  DC1,  Ctrl-Q)  Carácter  de  comienzo.  Reinica la salida
              detenida por un carácter de parada. Se reconoce cuando IXON está
              activa en cuyo caso no se pasa como dato de entrada.

       VSTOP  (023,  DC3,  Ctrl-S) Carácter de parada. Detiene la salida hasta
              que se teclee un carácter de comienzo. Se reconoce  cuando  IXON
              está activa en cuyo caso no se pasa como dato de entrada.

       VSUSP  (032,  SUB,  Ctrl-Z)  Carácter  de  suspensión.  Envía una señal
              SIGTSTP. Se reconoce cuando ISIG está activa en cuyo caso no  se
              pasa como dato de entrada.

       VDSUSP (No en POSIX; sin soporte en Linux; 031, EM, Ctrl-Y) Carácter de
              suspensión demorada: envía una señal SIGTSTP cuando el  programa
              de  usuario  lee  el  carácter. Se reconoce cuando IEXTEN e ISIG
              están 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  carácter  de  entrada,  quitándole  cualquier
              posible  significado  especial.  Se  reconoce cuando IEXTEN está
              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  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:

       TCOOFF suspende la salida.

       TCOON  reanuda la salida suspendida.

       TCIOFF transmite un carácter STOP,  que  hace  que  el  dispositivo  de
              terminal deje de transmitir datos al sistema.

       TCION  transmite  un  carácter  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 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:
            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  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:

       0      en caso de éxito,

       -1     en  caso  de  fallo,  y asignan un valor a errno para indicar el
              error.

       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)