Discards data from the specified queue.
Standard C Library (libc.a)
int tcflush( FileDescriptor, QueueSelector)
The tcflush subroutine discards any data written to the object referred to by the FileDescriptor parameter, or data received but not read by the object referred to by FileDescriptor, depending on the value of the QueueSelector parameter.
|FileDescriptor||Specifies an open file descriptor.|
|QueueSelector||Specifies one of the following:|
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 tcflush subroutine
is unsuccessful if one of the following is true:
|EBADF||The FileDescriptor parameter does not specify a valid file descriptor.|
|EINVAL||The QueueSelector parameter does not specify a proper value.|
|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 flush the output queue, enter:
rc = tcflush(2, TCOFLUSH);
This subroutine is part of Base Operating System (BOS) Runtime.
The tcdrain (tcdrain Subroutine) subroutine, tcflow (tcflow Subroutine) subroutine, tcsendbreak (tcsendbreak Subroutine) subroutine.
The Input and Output Handling Programmer's Overview in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.