tcsendbreak(3) [osf1 man page]
tcsendbreak(3) Library Functions Manual tcsendbreak(3) NAME
tcsendbreak - Sends a break on an asynchronous serial data line LIBRARY
Standard C Library (libc.so, libc.a) SYNOPSIS
#include <termios.h> int tcsendbreak( int filedes, int duration); STANDARDS
Interfaces documented on this reference page conform to industry standards 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 milliseconds 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. RELATED INFORMATION
Functions: tcdrain(3), tcflow(3), tcflush(3) Files: termios(4) Standards: standards(5) delim off tcsendbreak(3)
Check Out this Related Man Page
tcsendbreak(3C) Standard C Library Functions tcsendbreak(3C) NAME
tcsendbreak - send a ``break'' for a specific duration SYNOPSIS
#include <termios.h> int tcsendbreak(int fildes, int duration); DESCRIPTION
The fildes argument is an open file descriptor associated with a terminal. If the terminal is using asynchronous serial data transmission, tcsendbreak() will cause transmission of a continuous stream of zero-valued bits for a specific duration. If duration is 0, it will cause transmission of zero-valued bits for at least 0.25 seconds, and not more than 0.5 seconds. If duration is not 0, it behaves in a way similar to tcdrain(3C). If the terminal is not using asynchronous serial data transmission, it sends data to generate a break condition or returns without taking any action. Attempts to use tcsendbreak() from a process which is a member of a background process group on a fildes associated with its controlling terminal will cause 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. RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error. ERRORS
The tcsendbreak() function will fail if: EBADF The fildes argument is not a valid file descriptor. ENOTTY The file associated with fildes is not a terminal. The tcsendbreak() function may fail if: EIO The process group of the writing process is orphaned, and the writing process is not ignoring or blocking SIGTTOU. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-------------------------------+ |Interface Stability |Standard | +-----------------------------+-------------------------------+ |MT-Level |MT-Safe, and Async-Signal-Safe | +-----------------------------+-------------------------------+ SEE ALSO
tcdrain(3C), attributes(5), standards(5), termio(7I) SunOS 5.10 14 Aug 2002 tcsendbreak(3C)