*** UNIX MANUAL PAGE BROWSER ***

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 stan- dards as follows: tcdrain(): XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. PARAMETERS Specifies an open file descriptor. DESCRIPTION The tcdrain() function waits until all output written to the object re- ferred 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. [Digital] 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. Other- wise, 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 fol- lowing conditions: The filedes parameter does not specify a valid file descriptor. A sig- nal 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)