1tcsendbreak(3C)          Standard C Library Functions          tcsendbreak(3C)
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       The fildes argument is an open file descriptor associated with a termi‐
16       nal.
17
18
19       If the terminal is using asynchronous serial data transmission, tcsend‐
20       break()  will  cause transmission of a continuous stream of zero-valued
21       bits for a specific duration.  If duration is 0, it will  cause  trans‐
22       mission  of  zero-valued  bits  for at least 0.25 seconds, and not more
23       than 0.5 seconds.  If duration is not 0, it behaves in a way similar to
24       tcdrain(3C).
25
26
27       If  the terminal is not using asynchronous serial data transmission, it
28       sends data to generate a break condition or returns without taking  any
29       action.
30
31
32       Attempts  to  use  tcsendbreak()  from a process which is a member of a
33       background process group on a fildes associated  with  its  controlling
34       terminal  will  cause the process group to be sent a SIGTTOU signal. If
35       the calling process  is  blocking  or  ignoring  SIGTTOU  signals,  the
36       process is allowed to perform the operation, and no signal is sent.
37

RETURN VALUES

39       Upon  successful  completion,  0 is returned. Otherwise, −1 is returned
40       and errno is set to indicate the error.
41

ERRORS

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

ATTRIBUTES

59       See attributes(5) for descriptions of the following attributes:
60
61
62
63
64       ┌─────────────────────────────┬───────────────────────────────┐
65       │      ATTRIBUTE TYPE         │       ATTRIBUTE VALUE         │
66       ├─────────────────────────────┼───────────────────────────────┤
67       │Interface Stability          │Standard                       │
68       ├─────────────────────────────┼───────────────────────────────┤
69       │MT-Level                     │MT-Safe, and Async-Signal-Safe │
70       └─────────────────────────────┴───────────────────────────────┘
71

SEE ALSO

73       tcdrain(3C), attributes(5), standards(5), termio(7I)
74
75
76
77SunOS 5.11                        14 Aug 2002                  tcsendbreak(3C)
Impressum