NAME

TIOCCONS - redirecting console output

LIBRARY

Standard C library (libc, -lc)

SYNOPSIS

#include <asm/termbits.h>  /* Definition of TIOCCONS */
#include <sys/ioctl.h>

int ioctl(int fd, TIOCCONS);

DESCRIPTION

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.

Only a process with the CAP_SYS_ADMIN capability may do this.

If output was redirected already, then EBUSY is returned, but redirection can be stopped by using this ioctl with fd pointing at /dev/console or /dev/tty0.

RETURN VALUE

On success, 0 is returned. On error, -1 is returned, and errno is set to indicate the error.

ERRORS

EBUSY

Output was redirected already.

EPERM

Insufficient permission.

HISTORY

Before Linux 2.6.10, anybody can do this as long as the output was not redirected yet; CAP_SYS_ADMIN was not necessary.

SEE ALSO

ioctl(2), ioctl_tty(2)