*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> tcsetattr (3)              



NAME    [Toc]    [Back]

       tcsetattr  - Set the parameters associated with the terminal

SYNOPSIS    [Toc]    [Back]

       #include <termios.h>

       int tcsetattr(
               int filedes,
               int optional_actions,
               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:

       tcsetattr():  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.
   Specifies  the  options defining how the parameters
       will be set.  Points to a termios structure containing the
       terminal parameters.

DESCRIPTION    [Toc]    [Back]

       The  tcsetattr()  function  sets the parameters associated
       with the terminal referred to by the open file  descriptor
       filedes from the termios structure referenced by termios_p
       as follows: If optional_actions  is  TCSANOW,  the  change
       will occur immediately.  If optional_actions is TCSADRAIN,
       the change will occur after all output written to  filedes
       has  been  transmitted.  This function should be used when
       changing    parameters    that    affect    output.     If
       optional_actions is TCSAFLUSH, the change will occur after
       all output written to filedes has  been  transmitted,  and
       all  input  so far received but not read will be discarded
       before the change is made.

       If the output baud rate stored in  the  termios  structure
       pointed  to  by  the  termios_p parameter is the zero baud
       rate, B0, the  modem  control  lines  will  no  longer  be
       asserted. Normally, this will disconnect the line.

       If  the  input  baud  rate stored in the termios structure
       pointed to by the termios_p parameter  is  0  (zero),  the
       input  baud rate given to the hardware will be the same as
       the output baud rate stored in the termios structure.

       Attempts to use the tcsetattr() function  from  a  process
       which  is  a  member  of  a  background process group on a
       filedes associated with its  controlling  terminal  causes
       the  process  group  to  be  sent a SIGTTOU signal. If the
       calling process is blocking or ignoring  SIGTTOU  signals,
       the  process  is  allowed  to perform the operation and no
       signal is sent.

RETURN VALUES    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

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

       The  filedes  parameter is not a valid file descriptor.  A
       signal  interrupted  tcsetattr().   The   optional_actions
       parameter is not a proper value, or an attempt was made to
       change an attribute represented in the  termios  structure
       to  an  unsupported  value.   The file associated with the
       filedes parameter is not a terminal.

SEE ALSO    [Toc]    [Back]

       Functions: cfgetispeed(3) tcgetattr(3)

       Standards: standards(5)

[ Back ]
 Similar pages
Name OS Title
tcgetattr Tru64 Get the parameters associated with the terminal
termios Linux get and set terminal attributes, line control, get and set baud rate, get and set terminal foregroun...
ct HP-UX spawn getty to a remote terminal (call terminal)
glFogfv Tru64 specify fog parameters
glFogi Tru64 specify fog parameters
glFog Tru64 specify fog parameters
glfog IRIX specify fog parameters
glFogiv Tru64 specify fog parameters
glFogf Tru64 specify fog parameters
clGetParams IRIX get and set the value of the specified parameters.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service