NAME |LIBRARY |SYNOPSIS |DESCRIPTION |RETURN VALUE |SEE ALSO |COLOPHON | |
TCSBRK(2const)TCSBRK(2const)TCSBRK, TCSBRKP, TIOCSBRK, TIOCCBRK - sending a break
Standard C library (libc,-lc)
#include <asm/termbits.h>/* Definition ofT*BRK*constants */#include <sys/ioctl.h>int ioctl(intfd, TCSBRK, intarg);int ioctl(intfd, TCSBRKP, intarg);int ioctl(intfd, TIOCSBRK);int ioctl(intfd, TIOCCBRK);
TCSBRKEquivalent totcsendbreak(fd, arg). If the terminal is using asynchronous serial data transmission, andarg is zero, then send a break (a stream of zero bits) for between 0.25 and 0.5 seconds. If the terminal is not using asynchronous serial data transmission, then either a break is sent, or the function returns without doing anything. Whenarg is nonzero, nobody knows what will happen. (SVr4, UnixWare, Solaris, and Linux treattcsendbreak(fd,arg) with nonzeroarg liketcdrain(fd). SunOS treatsarg as a multiplier, and sends a stream of bitsarg times as long as done for zeroarg. DG/UX and AIX treatarg (when nonzero) as a time interval measured in milliseconds. HP-UX ignoresarg.)TCSBRKP So-called "POSIX version" ofTCSBRK. It treats nonzeroarg as a time interval measured in deciseconds, and does nothing when the driver does not support breaks.TIOCSBRK Turn break on, that is, start sending zero bits.TIOCCBRK Turn break off, that is, stop sending zero bits.
On success, 0 is returned. On error, -1 is returned, anderrno is set to indicate the error.
ioctl(2),ioctl_tty(2)
This page is part of theman-pages (Linux kernel and C library user-space interface documentation) project. Information about the project can be found at ⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report for this manual page, see ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩. This page was obtained from the tarball man-pages-6.15.tar.gz fetched from ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on 2025-08-11. If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up- to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orgLinux man-pages 6.15 2025-05-17TCSBRK(2const)Pages that refer to this page:ioctl_tty(2)
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |