diff options
| author | Alejandro Colomar <alx@kernel.org> | 2024-06-13 18:21:57 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-06-13 23:54:57 +0200 |
| commit | 0a8eedec25ce053282b291c46f94d1393e465731 (patch) | |
| tree | 145c49c387dd37942bdff656474997712dcc91f4 /man/man2const/TIOCCONS.2const | |
| parent | 35df1600cbde161525927b767b6d145a53f41f48 (diff) | |
| parent | 987a29b4baf41755b740cf4166f4621fa4f1d9ee (diff) | |
| download | man-pages-0a8eedec25ce053282b291c46f94d1393e465731.tar.gz | |
ioctl_tty.2, man2const/: Make sashimi
Diffstat (limited to 'man/man2const/TIOCCONS.2const')
| -rw-r--r-- | man/man2const/TIOCCONS.2const | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/man/man2const/TIOCCONS.2const b/man/man2const/TIOCCONS.2const new file mode 100644 index 0000000000..49de5c6aa5 --- /dev/null +++ b/man/man2const/TIOCCONS.2const @@ -0,0 +1,64 @@ +.\" Copyright 2002, Walter Harms <walter.harms@informatik.uni-oldenburg.de> +.\" Copyright 2002, Andries Brouwer <aeb@cwi.nl> +.\" Copyright 2024, Alejandro Colomar <alx@kernel.org> +.\" +.\" SPDX-License-Identifier: GPL-1.0-or-later +.\" +.TH TIOCCONS 2const (date) "Linux man-pages (unreleased)" +.SH NAME +TIOCCONS +\- +redirecting console output +.SH LIBRARY +Standard C library +.RI ( libc ", " \-lc ) +.SH SYNOPSIS +.nf +.BR "#include <asm/termbits.h>" " /* Definition of " TIOCCONS " */" +.B #include <sys/ioctl.h> +.P +.BI "int ioctl(int " fd ", TIOCCONS);" +.fi +.SH DESCRIPTION +Redirect output that would have gone to +.I /dev/console +or +.I /dev/tty0 +to the given terminal. +If that was a pseudoterminal master, send it to the slave. +.P +Only a process with the +.B CAP_SYS_ADMIN +capability may do this. +.P +If output was redirected already, then +.B EBUSY +is returned, +but redirection can be stopped by using this ioctl with +.I fd +pointing at +.I /dev/console +or +.IR /dev/tty0 . +.SH RETURN VALUE +On success, +0 is returned. +On error, +\-1 is returned, and +.I errno +is set to indicate the error. +.SH ERRORS +.TP +.B EBUSY +Output was redirected already. +.TP +.B EPERM +Insufficient permission. +.SH HISTORY +Before Linux 2.6.10, +anybody can do this as long as the output was not redirected yet; +.B CAP_SYS_ADMIN +was not necessary. +.SH SEE ALSO +.BR ioctl (2), +.BR ioctl_tty (2) |