tcsendbreak(3)tcsendbreak(3)NAMEtcsendbreak - Send a break on an asynchronous serial data line
SYNOPSIS
#include <termios.h>
int tcsendbreak(
int filedes,
int duration );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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 millisec‐
onds 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.
SEE ALSO
Functions: tcdrain(3), tcflow(3), tcflush(3)
Files: termios(4)
Standards: standards(5)tcsendbreak(3)
