tcflow()

suspend data transmission to or reception from a terminal 

Function

SYNOPSIS

#include <termios.h>

int tcflow(int fildes, int action);

DESCRIPTION

The tcflow() function suspends data transmission or reception on the specified file descriptor, depending upon the value of action.

PARAMETERS

fildes 

Is the file descriptor, which must refer to a terminal.

action 

Is one of the following symbolic constants: TCOOFF (suspend output), TCOON (resume output), TCIOFF (transmit a STOP character, which causes the device to cease transmitting data), TCION (transmit a START character, which causes the device to resume transmitting data).

RETURN VALUES

If successful, tcflow() returns a value of zero. Otherwise, it returns -1 and sets errno to one of the following values:

EBADF 

The fildes parameter is not a valid file descriptor.

EINVAL 

The action parameter is not a proper value.

ENOTTY 

The file associated with fildes is not a terminal.

CONFORMANCE

POSIX.1 (1996).

MULTITHREAD SAFETY LEVEL

Async-signal-safe.

PORTING ISSUES

None.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
ioctl(), tcdrain(), tcflush(), tcsendbreak()

Miscellaneous:
struct termios

PTC MKS Toolkit 10.5 Documentation Build 40.