Sends a break on an asynchronous serial data line.
Standard C Library (libc.a)
int tcsendbreak(FileDescriptor, Duration) int FileDescriptor; int 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 25 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.
The tcsendbreak 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 subroutine, tcflow subroutine, tcflush subroutine.
The Input and Output Handling Programmer's Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.