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

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)