tcdrain Subroutine
Purpose
Waits for output to complete.
Library
Standard C Library (libc.a)
Syntax
#include <termios.h>int tcdrain( FileDescriptor)
int FileDescriptor;
int FileDescriptor;
Description
The tcdrain subroutine waits until all output written to the object referred to by the FileDescriptor parameter has been transmitted.
Parameter
| Item | Description |
|---|---|
| FileDescriptor | Specifies an open file descriptor. |
Return Values
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.
Error Codes
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. |
Example
To wait until all output has been transmitted, enter:
rc = tcdrain(stdout);