stty(2)                                                             stty(2)
                               TO BE OBSOLETED



 NAME    [Toc]    [Back]
      stty(), gtty() - control terminal device (Bell Version 6
      compatibility)

 SYNOPSIS    [Toc]    [Back]
      #include <sgtty.h>

      int stty(int fildes, const struct sgttyb *argp);

      int gtty(int fildes, struct sgttyb *argp);

    Remarks    [Toc]    [Back]
      These system calls are preserved for backward compatibility with Bell
      Version 6.  They provide as close an approximation as possible to the
      old Version 6 functions.  All new code should use the TCSETA and TCGETA
      ioctl() calls described in termio(7).

 DESCRIPTION    [Toc]    [Back]
      For certain status settings and status inquiries about terminal
      devices, the functions stty() and gtty() are equivalent to

           ioctl(fildes, TIOCSETP, argp)

      and

           ioctl(fildes, TIOCGETP, argp)

      respectively (see ioctl(2) and termio(7).

 RETURN VALUE    [Toc]    [Back]
      gtty() and stty() return the following values:

            0   Successful completion.
           -1   Failure.  errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      If gtty() or stty() fails, errno is set to one of the following
      values:

      [EBADF]        fildes is not a valid file descriptor.

      [EFAULT]       argp points to an invalid address.

 WARNINGS    [Toc]    [Back]
    Obsolescent Interfaces
      gtty() and stty() are to be obsoleted at a future date.

 SEE ALSO    [Toc]    [Back]
      stty(1), exec(2), ioctl(2), sttyV6(7), termio(7), tty(7).


 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003