NAME    [Toc]    [Back]

       tcgetattr  - Get the parameters associated with the terminal

SYNOPSIS    [Toc]    [Back]

       #include <termios.h>

       int tcgetattr(
               int filedes,
               struct termios *termios_p );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       tcgetattr():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies an open file descriptor associated with a terminal.
  Points to a termios structure.

DESCRIPTION    [Toc]    [Back]

       The  tcgetattr()  function  gets the parameters associated
       with the object referenced by the  filedes  parameter  and
       stores  them  in  the  termios structure referenced by the
       termios_p parameter.

       If the device does not support split baud rates, the input
       baud  rate  stored  in  the  termios  structure  will be 0
       (zero).

       The tcgetattr() function may be called from any process.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, 0 (zero) is  returned.  Otherwise,
  -1  is  returned  and  errno is set to indicate the
       error.

ERRORS    [Toc]    [Back]

       The tcgetattr() function sets errno to the specified  values
 for the following conditions:

       The filedes parameter is not a valid file descriptor.  The
       file associated with the filedes parameter is not a terminal.

SEE ALSO    [Toc]    [Back]

       Functions: tcsetattr(3)

       Files: termios(4)

       Standards: standards(5)



                                                     tcgetattr(3)