📄 tcsendbreak.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>tcsendbreak</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_009_489"> </a>NAME</h4><blockquote>tcsendbreak - send a "break" for a specific duration</blockquote><h4><a name = "tag_000_009_490"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="termios.h.html">termios.h</a>>int tcsendbreak(int <i>fildes</i>, int <i>duration</i>);</code></pre></blockquote><h4><a name = "tag_000_009_491"> </a>DESCRIPTION</h4><blockquote>The<i>fildes</i>argument is an open file descriptor associated with a terminal.<p>If the terminal is using asynchronous serial data transmission,<i>tcsendbreak()</i>will cause transmission of a continuous stream of zero-valued bits for aspecific duration. If<i>duration</i>is 0, it will cause transmission of zero-valued bits for at least 0.25seconds, and not more than 0.5 seconds. If<i>duration</i>is not 0, it will send zero-valued bits for animplementation-dependent period of time.<p>If the terminal is not using asynchronous serial datatransmission, it is implementation-dependent whether<i>tcsendbreak()</i>sends data to generate a break conditionor returns without taking any action.<p>Attempts to use<i>tcsendbreak()</i>from a process which is a member of a background processgroup on a<i>fildes</i>associated with its controlling terminal, will cause the process groupto 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 issent.</blockquote><h4><a name = "tag_000_009_492"> </a>RETURN VALUE</h4><blockquote>Upon successful completion, 0 is returned. Otherwise, -1 is returned and<i>errno</i>is set to indicate the error.</blockquote><h4><a name = "tag_000_009_493"> </a>ERRORS</h4><blockquote>The<i>tcsendbreak()</i>function will fail if:<dl compact><dt>[EBADF]<dd>The<i>fildes</i>argument is not a valid file descriptor.<dt>[ENOTTY]<dd>The file associated with<i>fildes</i>is not a terminal.</dl><p>The<i>tcsendbreak()</i>function may fail if:<dl compact><dt>[EIO]<dd>The process group of the writing process is orphaned,and the writing process is not ignoring or blocking SIGTTOU.</dl></blockquote><h4><a name = "tag_000_009_494"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_009_495"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_009_496"> </a>FUTURE DIRECTIONS</h4><blockquote>In the ISO POSIX-1 standard, the possibility of an [EIO] error occurring is described in<b>XBD</b> specification, <a href="../xbd/termios.html#tag_008_001_004"><b>Terminal Access Control</b> </a>, but it is not mentioned in the<i>tcsendbreak()</i>interface definition.It has become clear that this omission was unintended,so it is likely that the [EIO] error will be reclassified asa "will fail" in a future issue of the POSIX standard.</blockquote><h4><a name = "tag_000_009_497"> </a>SEE ALSO</h4><blockquote><i><a href="termios.h.html"><termios.h></a></i>,<i><a href="unistd.h.html"><unistd.h></a></i>,the <b>XBD</b> specification, <a href="../xbd/termios.html"><b>General Terminal Interface</b> </a>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the POSIX.1-1988 standard.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -