TCSENDBREAK(3)                       SysV                       TCSENDBREAK(3)



NAME
     tcsendbreak - Send a break on an asynchronous serial data line

SYNOPSIS
     #include <termios.h>

     int tcsendbreak (filedes, duration)
     int filedes, duration;

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.

     The filedes argument specifies an open file descriptor.

     The duration argument specifies the number of milliseconds that zero-
     valued bits are transmitted. If the value of the duration argument is 0
     (zero), transmission of zero-valued bits is for 0.25 seconds.  If
     duration is not 0, transmission of zero-valued bits is for duration
     miliseconds.

     Attempts to use the tcsendbreak function from a process that is a member
     of a background process group on a filedes associated with its
     controlling terminal causes the process group to be sent a SIGTTOU
     signal.  If the calling process is blocking or ignoring SIGTTOU signals,
     the process is allowed to perform the operation and no signal is sent.

DIAGNOSTICS
     Upon successful completion, a value of 0 (zero) is returned. Otherwise,
     -1 is returned.

ERRORS
     If tcsendbreak fails, errno is set to one of the following values:

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

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

SEE ALSO
     tcdrain(3), tcflow(3), tcflush(3) termios(7)