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

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



NAME    [Toc]    [Back]

       tcdrain - Wait for output to complete

SYNOPSIS    [Toc]    [Back]

       #include <termios.h>

       int tcdrain(
               int filedes );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

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

       tcdrain():  XSH4.2

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

PARAMETERS    [Toc]    [Back]

       Specifies an open file descriptor.

DESCRIPTION    [Toc]    [Back]

       The  tcdrain()  function waits until all output written to
       the object referred to by the filedes parameter  has  been

       A  process group is sent a SIGTTOU signal if the tcdrain()
       function is called from one of its  member  processes.  If
       the  calling  process is blocking or ignoring SIGTTOU signals,
 the process is allowed to perform the operation  and
       no signal is sent.

       [Tru64  UNIX]  The  tcdrain() function, which suspends the
       calling process until the request is completed,  is  redefined
 so that only the calling thread is suspended.

RETURN VALUES    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

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

       The filedes  parameter  does  not  specify  a  valid  file
       descriptor.   A signal interrupted the tcdrain() function.
       The file associated with the filedes parameter  is  not  a

EXAMPLE    [Toc]    [Back]

       To wait until all output has been transmitted, enter:

       rc = tcdrain(stdout);

SEE ALSO    [Toc]    [Back]

       Functions: tcflow(3), tcflush(3), tcsendbreak(3)

       Standards: standards(5)

[ Back ]
 Similar pages
Name OS Title
aio_suspend HP-UX wait for an asynchronous I/O operation to complete
glFinish Tru64 block until all GL execution is complete
biodone Tru64 General: Indicates that block I/O is complete
exit HP-UX Causes dtscp to complete execution.
glfinish IRIX block until all GL execution is complete
quit HP-UX Causes dtscp to complete execution
faq OpenBSD things to check after the first complete boot
glflushrastersgix IRIX complete rasterization of previous GL commands
afterboot OpenBSD things to check after the first complete boot
glxwaitx IRIX complete X execution prior to subsequent GL calls
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service