tcsendbreak()

transmit stream of zeroes to terminal 

Function

SYNOPSIS

#include <termios.h>

int tcsendbreak(int fildes, int duration);

DESCRIPTION

If the terminal associated with the specified file descriptor is using asynchronous serial data transmission, tcsendbreak() causes transmission of a continuous stream of zero-valued bits for a specific duration. If the terminal associated with the specified file descriptor is not using asynchronous serial data transmission, tcsendbreak() returns without taking any action.

PARAMETERS

fildes 

Specifies an open file descriptor.

duration 

Specifies the duration of break transmission. If duration is zero, it causes zero-valued bits to be transmitted for a minimum of 250 milliseconds and a maximum of 500 milliseconds. If duration is not zero, tcsendbreak() sends zero-valued bits for an implementation-defined period of time.

RETURN VALUES

If successful, tcsendbreak() 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 device does not support the tcsendbreak() function.

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(), tcflow(), tcflush()

PTC MKS Toolkit 10.4 Documentation Build 39.