osf1 man page for tcdrain

tcdrain(3)						     Library Functions Manual							tcdrain(3)

NAME
       tcdrain -  Waits for output to complete

LIBRARY
       Standard C Library (libc.so, libc.a)

SYNOPSIS
       #include <termios.h>

       int tcdrain(
	       int filedes);

STANDARDS
       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
       Specifies an open file descriptor.

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

       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.

EXAMPLE
       To wait until all output has been transmitted, enter:

       rc = tcdrain(stdout);

RETURN VALUES
       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
       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 terminal.

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

       Standards: standards(5) delim off

																	tcdrain(3)