plucky (2) TIOCSCTTY.2const.gz

NAME

       TIOCSCTTY, TIOCNOTTY - controlling the terminal

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <asm/termbits.h>  /* Definition of TIOC*TTY constants */
       #include <sys/ioctl.h>

       int ioctl(int fd, TIOCSCTTY, int arg);
       int ioctl(int fd, TIOCNOTTY);

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.

RETURN VALUE

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

ERRORS

       EPERM  Insufficient permission.

SEE ALSO

       ioctl(2), ioctl_tty(2)