Content-type: text/html Man page of tcsendbreak

tcsendbreak

Section: C Library Functions (3)
Index Return to Main Contents
 

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 duration 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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:54 GMT, October 02, 2010