TIOCCONS(2const)

TIOCCONS2const

Redirecting console output

Usage

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

int ioctl(int fd, TIOCCONS);

Library

Standard C library (libc, -lc)

Overview

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.

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

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.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.