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.3 Documentation Build 39.