Waits for output to complete.
Standard C Library (libc.a)
#include <termios.h>
int tcdrain( FileDescriptor)
int FileDescriptor;
The tcdrain subroutine waits until all output written to the object referred to by the FileDescriptor parameter has been transmitted.
Item | Description |
---|---|
FileDescriptor | Specifies an open file descriptor. |
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and the errno global variable is set to indicate the error.
The tcdrain subroutine is unsuccessful if one of the following is true:
Item | Description |
---|---|
EBADF | The FileDescriptor parameter does not specify a valid file descriptor. |
EINTR | A signal interrupted the tcdrain subroutine. |
EIO | The process group of the writing process is orphaned, and the writing process does not ignore or block the SIGTTOU signal. |
ENOTTY | The file associated with the FileDescriptor parameter is not a terminal. |
To wait until all output has been transmitted, enter:
rc = tcdrain(stdout);