1TCSENDBREAK(P)             POSIX Programmer's Manual            TCSENDBREAK(P)
2
3
4

NAME

6       tcsendbreak - send a break for a specific duration
7

SYNOPSIS

9       #include <termios.h>
10
11       int tcsendbreak(int fildes, int duration);
12
13

DESCRIPTION

15       If the terminal is using asynchronous serial data transmission, tcsend‐
16       break() shall cause transmission of a continuous stream of  zero-valued
17       bits  for  a specific duration. If duration is 0, it shall cause trans‐
18       mission of zero-valued bits for at least 0.25  seconds,  and  not  more
19       than  0.5 seconds. If duration is not 0, it shall send zero-valued bits
20       for an implementation-defined period of time.
21
22       The fildes argument is an open file descriptor associated with a termi‐
23       nal.
24
25       If  the terminal is not using asynchronous serial data transmission, it
26       is implementation-defined whether tcsendbreak() sends data to  generate
27       a break condition or returns without taking any action.
28
29       Attempts  to  use  tcsendbreak()  from a process which is a member of a
30       background process group on a fildes associated  with  its  controlling
31       terminal  shall cause the process group to be sent a SIGTTOU signal. If
32       the calling process  is  blocking  or  ignoring  SIGTTOU  signals,  the
33       process  shall  be  allowed  to perform the operation, and no signal is
34       sent.
35

RETURN VALUE

37       Upon successful completion, 0 shall be returned. Otherwise, -1 shall be
38       returned and errno set to indicate the error.
39

ERRORS

41       The tcsendbreak() function shall fail if:
42
43       EBADF  The fildes argument is not a valid file descriptor.
44
45       ENOTTY The file associated with fildes is not a terminal.
46
47
48       The tcsendbreak() function may fail if:
49
50       EIO    The  process  group  of the writing process is orphaned, and the
51              writing process is not ignoring or blocking SIGTTOU.
52
53
54       The following sections are informative.
55

EXAMPLES

57       None.
58

APPLICATION USAGE

60       None.
61

RATIONALE

63       None.
64

FUTURE DIRECTIONS

66       None.
67

SEE ALSO

69       The Base Definitions volume of IEEE Std 1003.1-2001, Chapter  11,  Gen‐
70       eral Terminal Interface, <termios.h>, <unistd.h>
71

73       Portions  of  this text are reprinted and reproduced in electronic form
74       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
75       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
76       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
77       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
78       event of any discrepancy between this version and the original IEEE and
79       The  Open Group Standard, the original IEEE and The Open Group Standard
80       is the referee document. The original Standard can be  obtained  online
81       at http://www.opengroup.org/unix/online.html .
82
83
84
85IEEE/The Open Group                  2003                       TCSENDBREAK(P)
Impressum