tcflush(3)tcflush(3)NAMEtcflush - Flush nontransmitted output data or nonread input data
SYNOPSIS
#include <termios.h>
int tcflush(
int filedes,
int queue_selector );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
tcflush(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Specifies an open file descriptor associated with a terminal. Speci‐
fies one of the following: Flush data received but not read. Flush
data written but not transmitted. 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.
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
The tcflush() function sets errno to the specified values for the fol‐
lowing conditions:
The filedes parameter does not specify a valid file descriptor. The
queue_selector parameter does not specify a proper value. The file
associated with the filedes parameter is not a terminal.
SEE ALSO
Functions: tcdrain(3), tcflow(3), tcsendbreak(3)
Files: termios (4)
Standards: standards(5)tcflush(3)