Sends a break on an asynchronous serial data line.
Standard C Library (libc.a)
int tcsendbreak( FileDescriptor, Duration)
If the terminal is using asynchronous serial data transmission, the tcsendbreak subroutine 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 subroutine returns without taking any action.
|FileDescriptor||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, it causes transmission of zero-valued bits for at least 250 milliseconds and not longer than 500 milliseconds. If Duration is not 0, it sends zero-valued bits for Duration milliseconds.|
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and the errno global variable is set to indicate the error.
subroutine is unsuccessful if one or both of the following are true:
|EBADF||The FileDescriptor parameter does not specify a valid open file descriptor.|
|EIO||The process group of the writing process is orphaned, and the writing process does not ignore or block the SIGTTOU signal.|
|ENOTTY||The file associated with the FileDescriptor parameter is not a terminal.|
rc = tcsendbreak(stdout,500);
rc = tcsendbreak(1,25);
This could also be performed using the default Duration by entering:
rc = tcsendbreak(1, 0);
This subroutine is part of Base Operating System (BOS) Runtime.
Pseudo-terminals and LFT do not generate a break condition. They return without taking any action.
The tcdrain (tcdrain Subroutine) subroutine, tcflow (tcflow Subroutine) subroutine, tcflush (tcflush Subroutine) subroutine.
The Input and Output Handling Programmer's Overview in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.