logo
Free, Micro AI Code Reviews That Run on Git Commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, Micro AI Code Reviews That Run on Git Commit | Product Hunt git-lrc - Free, Micro AI Code Reviews That Run on Git Commit | Product Hunt

TIOCSCTTY, TIOCNOTTY - controlling the terminal

Description

TIOCSCTTY 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 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.

Errors

EPERM Insufficient permission.

Library

Standard C library (libc, -lc)

Name

TIOCSCTTY, TIOCNOTTY - controlling the terminal

Return Value

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

See Also

ioctl(2), ioctl_tty(2) Linux man-pages 6.9.1 2024-06-13 TIOCSCTTY(2const)

Synopsis

#include<asm/termbits.h> /* Definition of TIOC*TTY constants */ #include<sys/ioctl.h>intioctl(intfd,TIOCSCTTY,intarg);intioctl(intfd,TIOCNOTTY);

See Also