OSF

NAME

tcsendbreak − Sends a break on an asynchronous serial data line

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <termios.h>

int tcsendbreak(
int filedes,
int duration );

PARAMETERS

filedes Specifies an open file descriptor. 

duration
Specifies the number of milliseconds that zero-valued bits are transmitted. If the value of the duration parameter is 0 (zero), transmission of zero-valued bits is for 250 milliseconds.  If duration is not 0, transmission of zero-valued bits is for duration milliseconds. 

DESCRIPTION

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

A process group is sent a SIGTTOU signal if the tcsendbreak() 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, −1 is returned and errno is set to indicate the error. 

ERRORS

If the tcsendbreak() function fails, errno is set to one of the following values:

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

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

RELATED INFORMATION

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

Files: termios(4)