.TH tcsendbreak() "" "" "termios Macro (termios.h)"
.PC "Send a break to a terminal"
.B "#include <termios.h>"
\fBint tcsendbreak(\fIfd\^\fB, \fIduration\^\fB)\fR
\fBint \fIfd\^\fB;\fR
\fBint \fIduration\^\fB;\fR
.PP
The
.B termios
macro
.B tcsendbreak()
transmits NUL characters to the terminal device described by file descriptor
.IR fd .
.PP
.I duration
gives the length of time to transmit NUL characters.
If
.I duration
is zero,
.B tcsnedbreak()
transmits zero-valued bits for at least 0.25 seconds and no more than 0.5
seconds.
If
.I duration
is not set to zero,
.B tcsendbreak()
sends zero-valued bits for the time specified by the implementation.
Under \*(CO,
.B tcsendbreak()
is a macro defined as follows:
.DM
	#define tcsendbreak(filedes,duration) ioctl(filedes,TCSBRK,0)
.DE
.PP
.B TCSBRK
is defined in header file
.BR <termio.h> :
it transmits break characters for 0.25 seconds.
Thus, the argument
.I duration
is ignored.
.PP
If
.I fd
does not use asynchronous serial data transmission,
the implementation defines whether the
.B tcsendbreak()
function sends data to generate a break condition
(as defined by the implementation) or returns without taking any action.
Under \*(CO, it does nothing.
.PP
If all goes well,
.B tcsendbreak()
returns zero.
If something goes wrong, it returns \-1 and sets
.B errno
to an appropriate value, as follows:
.IP \fBEBADF\fR
.I fd
is not a valid file descriptor.
.IP \fBENOTTY\fR
.I fd
does not describe a terminal.
.SH "See Also"
.Xr "termios" termios
.br
\*(PX Standard, \(sc7.2.2
