Obtener y establecer los atributos de un terminal¶

TCGETS struct termios *argp

Equivalente a tcgetattr(fd, argp).
Obtiene la configuración actual de un puerto serie.

TCSETS const struct termios *argp

Equivalente a tcsetattr(fd, TCSANOW, argp).
Establece la configuración actual de un puerto serie.

TCSETSW const struct termios *argp

Equivalente a tcsetattr(fd, TCSADRAIN, argp).
Permite vaciar el buffer de salida y establecer la configuración actual de un puerto serie.

TCSETSF const struct termios *argp

Equivalente a tcsetattr(fd, TCSAFLUSH, argp).
Permite vaciar el buffer de salida, descartar la entrada pendiente y establecer la configuración actual de un puerto serie.

Las siguientes cuatro ioctls son exactamente iguales a TCGETS, TCSETS, TCSETSW y TCSETSF, excepto en que toman un argumento struct termio * en lugar de un argumento struct termios *.

TCGETA struct termio *argp

TCSETA const struct termio *argp

TCSETAW const struct termio *argp

TCSETAF const struct termio *argp

Bloqueo de una estructura termios¶

La estructura termios de un tty se puede bloquear. El propio bloqueo es una estructura termios con bits o campos distintos de cero indicando un valor bloqueado.

TIOCGLCKTRMIOS struct termios *argp

Obtiene el estado de bloqueo de la estructura termios del terminal.

TIOCSLCKTRMIOS const struct termios *argp

Sets the locking status of the termios structure of the terminal. Only a process with the CAP_SYS_ADMIN capability can do this.

Obtener y establecer el tamaño de la ventana¶

Los tamaños de las ventanas se guardan en el núcleo pero éste no los usa (excepto en el caso de las consolas virtuales, donde el núcleo actualizará el tamaño de la ventana cuando el tamaño de la consola virtual cambie, por ejemplo, al cargar una nueva fuente).

The following constants and structure are defined in <sys/ioctl.h>.

TIOCGWINSZ struct winsize *argp

Obtiene el tamaño de la ventana.

TIOCSWINSZ const struct winsize *argp

Establece el tamaño de la ventana.

La estructura usada por estas ioctls se define como

struct winsize {


    unsigned short ws_row;


    unsigned short ws_col;


    unsigned short ws_xpixel;   /* sin usar */


    unsigned short ws_ypixel;   /* sin usar */
};

Cuando el tamaño de la ventana cambia, se envía una señal SIGWINCH al grupo de procesos en primer plano.

Envío de una pausa (break)¶

TCSBRK int arg

Equivalente a tcsendbreak(fd, arg).
Si la termina usa una transmisión asíncrona serie de datos y si el argumento arg es cero, entonces envía una pausa (un flujo de bits a cero) con una duración de entre 0'25 y 0'5 segundos. Si el terminal no usa una transmisión asíncrona serie de datos, entonces o se envía una pausa o la función regresa sin hacer nada. Cuando arg no es cero, nadie sabe qué ocurrirá.

(SVr4, UnixWare, Solaris y Linux tratan tcsendbreak(fd,arg) como tcdrain(fd) cuando el argumento arg es distinto de cero. SunOS trata arg como un multiplicador y envía arg veces un flujo de bits tan largo como el que se envía para un valor de arg igual a cero. DG/UX y AIX tratan a arg (cuando no es cero) como un intervalo de tiempo medido en milisegundos. HP-UX ignora arg.)

TCSBRKP int arg

Conocida como la "versión POSIX" de TCSBRK. Trata un arg distinto de cero como un intervalo de tiempo medido en décimas de segundo y no hace nada cuando el driver no soporta pausas.

TIOCSBRK void

Activa la pausa, es decir, empieza a enviar bits a cero.

TIOCCBRK void

Desactiva la pausa, es decir, deja de enviar bits a cero.

Control de flujo software¶

TCXONC int arg

Equivalente a tcflow(fd, arg).
Vea tcflow(3) para los valores de argumento TCOOFF, TCOON, TCIOFF y TCION.

Escrutinio y vaciado de buffers¶

FIONREAD int *argp

Obtiene el número de bytes en el buffer de entrada.

TIOCINQ int *argp

Igual que FIONREAD.

TIOCOUTQ int *argp

Obtienen el número de bytes en el buffer de salida.

TCFLSH int arg

Equivalente a tcflush(fd, arg).
Vea tcflush(3) para los valores de argumento TCIFLUSH, TCOFLUSH y TCIOFLUSH.

Falsificación de la entrada¶

TIOCSTI const char *argp

Inserta el byte dado en la cola de entrada.

Redirección de la salida de consola¶

TIOCCONS void

Redirect output that would have gone to /dev/console or /dev/tty0 to the given terminal. If that was a pseudoterminal master, send it to the slave. In Linux before version 2.6.10, anybody can do this as long as the output was not redirected yet; since version 2.6.10, only a process with the CAP_SYS_ADMIN capability may do this. If output was redirected already EBUSY is returned, but redirection can be stopped by using this ioctl with fd pointing at /dev/console or /dev/tty0.

Controlling terminal¶

TIOCSCTTY int arg

Make the given terminal the controlling terminal of the calling process. The calling process must be a session leader and not have a controlling terminal already. For this case, arg should be specified as zero.

If this terminal is already the controlling terminal of a different session group, then the ioctl fails with EPERM, unless the caller has the CAP_SYS_ADMIN capability and arg equals 1, in which case the terminal is stolen, and all processes that had it as controlling terminal lose it.

TIOCNOTTY void

If the given terminal was the controlling terminal of the calling process, give up this controlling terminal. If the process was session leader, then send SIGHUP and SIGCONT to the foreground process group and all processes in the current session lose their controlling terminal.

(Número) identificador (ID) de grupo de procesos y sesión¶

TIOCGPGRP pid_t *argp

Cuando tiene éxito, equivale a *argp = tcgetpgrp(fd).
Get the process group ID of the foreground process group on this terminal.

TIOCSPGRP const pid_t *argp

Equivalente a tcsetpgrp(fd, *argp).
Set the foreground process group ID of this terminal.

TIOCGSID pid_t *argp

Get the session ID of the given terminal. This fails with the error ENOTTY if the terminal is not a master pseudoterminal and not our controlling terminal. Strange.

Modo exclusivo¶

TIOCEXCL void

Put the terminal into exclusive mode. No further open(2) operations on the terminal are permitted. (They fail with EBUSY, except for a process with the CAP_SYS_ADMIN capability.)

TIOCGEXCL int *argp

(since Linux 3.8) If the terminal is currently in exclusive mode, place a nonzero value in the location pointed to by argp; otherwise, place zero in *argp.

TIOCNXCL void

Desactiva el modo exclusivo.

Disciplina de línea¶

TIOCGETD int *argp

Get the line discipline of the terminal.

TIOCSETD const int *argp

Set the line discipline of the terminal.

Pseudoterminal ioctls¶

TIOCPKT const int *argp

Enable (when *argp is nonzero) or disable packet mode. Can be applied to the master side of a pseudoterminal only (and will return ENOTTY otherwise). In packet mode, each subsequent read(2) will return a packet that either contains a single nonzero control byte, or has a single byte containing zero (' ') followed by data written on the slave side of the pseudoterminal. If the first byte is not TIOCPKT_DATA (0), it is an OR of one or more of the following bits:

TIOCPKT_FLUSHREAD   The read queue for the terminal is flushed.
TIOCPKT_FLUSHWRITE  The write queue for the terminal is flushed.
TIOCPKT_STOP        Output to the terminal is stopped.
TIOCPKT_START       Output to the terminal is restarted.
TIOCPKT_DOSTOP      The start and stop characters are ^S/^Q.
TIOCPKT_NOSTOP      The start and stop characters are not ^S/^Q.

While this mode is in use, the presence of control status information to be read from the master side may be detected by a select(2) for exceptional conditions or a poll(2) for the POLLPRI event.

Este modo lo usan rlogin(1) y rlogind(8) para implementar un login remoto con un flujo controlado localmente mediante ^S/^Q y un eco remoto.

TIOCGPKT const int *argp

(since Linux 3.8) Return the current packet mode setting in the integer pointed to by argp.

TIOCSPTLCK int *argp

Set (if *argp is nonzero) or remove (if *argp is zero) the pseudoterminal slave device. (See also unlockpt(3).)

TIOCGPTLCK int *argp

(since Linux 3.8) Place the current lock state of the pseudoterminal slave device in the location pointed to by argp.

TIOCGPTPEER int flags

(since Linux 4.13) Given a file descriptor in fd that refers to a pseudoterminal master, open (with the given open(2)-style flags) and return a new file descriptor that refers to the peer pseudoterminal slave device. This operation can be performed regardless of whether the pathname of the slave device is accessible through the calling process's mount namespace.

Security-conscious programs interacting with namespaces may wish to use this operation rather than open(2) with the pathname returned by ptsname(3), and similar library functions that have insecure APIs. (For example, confusion can occur in some cases using ptsname(3) with a pathname where a devpts filesystem has been mounted in a different mount namespace.)

Las ioctls de BSD TIOCSTOP, TIOCSTART, TIOCUCNTL, TIOCREMOTE no se han implementado en Linux.

Control del modem¶

TIOCMGET int *argp

Obtiene el estado de los bits del modem.

TIOCMSET const int *argp

Configura el estado de los bits del modem.

TIOCMBIC const int *argp

Borra los bits del modem que se indican.

TIOCMBIS const int *argp

Activa los bits del modem que se indican.

The following bits are used by the above ioctls:

TIOCM_LE        DSR (data set ready/line enable)
TIOCM_DTR       DTR (data terminal ready)
TIOCM_RTS       RTS (request to send)
TIOCM_ST        TXD secundario (transmitir)
TIOCM_SR        RXD secundario (recibir)
TIOCM_CTS       CTS (clear to send)
TIOCM_CAR       DCD (data carrier detect)
TIOCM_CD         vea TIOCM_CAR
TIOCM_RNG       RNG (ring)
TIOCM_RI         vea TIOCM_RNG
TIOCM_DSR       DSR (data set ready)

TIOCMIWAIT int arg

Wait for any of the 4 modem bits (DCD, RI, DSR, CTS) to change. The bits of interest are specified as a bit mask in arg, by ORing together any of the bit values, TIOCM_RNG, TIOCM_DSR, TIOCM_CD, and TIOCM_CTS. The caller should use TIOCGICOUNT to see which bit has changed.

TIOCGICOUNT struct serial_icounter_struct *argp

Get counts of input serial line interrupts (DCD, RI, DSR, CTS). The counts are written to the serial_icounter_struct structure pointed to by argp.

Note: both 1->0 and 0->1 transitions are counted, except for RI, where only 0->1 transitions are counted.

Marcar una línea como local¶

TIOCGSOFTCAR int *argp

("Get software carrier flag") Obtiene el estado de la bandera CLOCAL del campo c_cflag de la estructura termios.

TIOCSSOFTCAR const int *argp

("Set software carrier flag") Activa la bandera CLOCAL de la estructura termios cuando *argp es distinto de cero y la borra en caso contrario.

If the CLOCAL flag for a line is off, the hardware carrier detect (DCD) signal is significant, and an open(2) of the corresponding terminal will block until DCD is asserted, unless the O_NONBLOCK flag is given. If CLOCAL is set, the line behaves as if DCD is always asserted. The software carrier flag is usually turned on for local devices, and is off for lines with modems.

Específico de Linux¶

Para la ioctl TIOCLINUX vea ioctl_console(2).

Depuración del núcleo¶

#include <linux/tty.h>

TIOCTTYGSTRUCT struct tty_struct *argp

Get the tty_struct corresponding to fd. This command was removed in Linux 2.5.67.