Index for Section 3

Alphabetical listing for T

Bottom of page

tcgetattr(3)
NAME
  tcgetattr - Get the parameters associated with the terminal

SYNOPSIS
  #include <termios.h>

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

LIBRARY
  Standard C Library (libc)

STANDARDS
  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
  filedes
      Specifies an open file descriptor associated with a terminal.

  termios_p
      Points to a termios structure.

DESCRIPTION
  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
  Upon successful completion, 0 (zero) is returned. Otherwise, -1 is returned
  and errno is set to indicate the error.

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

  [EBADF]
      The filedes parameter is not a valid file descriptor.

  [ENOTTY]
      The file associated with the filedes parameter is not a terminal.

SEE ALSO
  Functions: tcsetattr(3)

  Files: termios(4)

  Standards: standards(5)

Index for Section 3

Alphabetical listing for T

Top of page