OSF

NAME

tcflush − Flushes nontransmitted output data or nonread input data

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <termios.h>

int tcflush(
int filedes,
int queue_selector );

PARAMETERS

filedes Specifies an open file descriptor associated with a terminal. 

queue_selector
Specifies one of the following:

TCIFLUSH
Flush data received but not read.

TCOFLUSH
Flush data written but not transmitted.

TCIOFLUSH
Flush both data received but not read and data written but not transmitted.

DESCRIPTION

The tcflush() function discards any data written to the object referred to by the filedes parameter, or data received but not read by the object referred to by filedes, depending on the value of the queue_selector parameter. 

A process group is sent a SIGTTOU signal if the tcflush() 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. 

NOTES

AES Support Level: Full use

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

If the tcflush() function fails, errno may be set to one of the following values:

[EBADF] The filedes parameter does not specify a valid file descriptor. 

[EINVAL] The queue_selector parameter does not specify a proper value. 

[ENOTTY] The file associated with the filedes parameter is not a terminal. 

RELATED INFORMATION

Functions: tcdrain(3), tcflow(3), tcsendbreak(3)

Files: termios(4)