tcsendbreak(3) Library Functions Manual tcsendbreak(3)
NAME
tcsendbreak - Sends a break on an asynchronous serial data line
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <termios.h>
int tcsendbreak(
int filedes,
int duration);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
tcsendbreak(): 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. Specifies the number of milliseconds that zero-valued bits are transmitted. If the value of the dura-
tion 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.
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
The tcsendbreak() function sets errno to the specified values for the following conditions:
The filedes parameter does not specify a valid open file descriptor. The file associated with the filedes parameter is not a terminal.
RELATED INFORMATION
Functions: tcdrain(3), tcflow(3), tcflush(3)
Files: termios(4)
Standards: standards(5) delim off
tcsendbreak(3)
