.\" Copyright 2002 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
.\" and Andries Brouwer <aeb@cwi.nl>.
.\" Distributed under GPL.
.\"
.\" Japanese Version Copyright (c) 2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sat Oct 16 06:08:24 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH TTY_IOCTL 4 2002-12-29 "Linux" "Linux Programmer's Manual"
.SH ̾
tty ioctl \- üȥꥢ饤 ioctl ()
.SH 
.B "#include <termios.h>"
.sp
.BI "int ioctl(int " fd ", int " cmd ", ...);"
.SH 
üȥꥢݡȤˤĤƤ
.BR ioctl ()
ϡ¿Υޥɰդ롣
¿ʷ 3 ܤΰɬפȤ롣
Ǥ \fIargp\fP ޤ \fIarg\fP ȸƤ֡
.LP
.I ioctl
ѤȰܿΤʤץˤʤ롣
ǽʾϡ
.BR termios (3)
˵ҤƤ POSIX 󥿥եȤȡ
.SS ü°μ
.TP
.BI "TCGETS	struct termios *" argp
.I "tcgetattr(fd, argp)"
Ʊ
.br
ߤΥꥢݡȤ롣
.TP
.BI "TCSETS	const struct termios *" argp
.I "tcsetattr(fd, TCSANOW, argp)"
Ʊ
.br
ߤΥꥢݡȤѹ롣
.TP
.BI "TCSETSW	const struct termios *" argp
.I "tcsetattr(fd, TCSADRAIN, argp)"
Ʊ
.br
ӽ (drain) ԤνϥХåեλѤĤ
ߤΥꥢݡȤѹ롣
.TP
.BI "TCSETSF	const struct termios *" argp
.I "tcsetattr(fd, TCSAFLUSH, argp)"
Ʊ
.br
ӽ (drain) ԤνϥХåեλѤĤ
ƤʤϤ˴ơ
ߤΥꥢݡȤѹ롣
.LP
ʲ 4 Ĥ ioctl 
.BR TCGETS ,
.BR TCSETS ,
.BR TCSETSW ,
.B TCSETSF
ȻƤ롣

.I "struct termios *"

.I "struct termio *"
롣
.TP
.BI "TCGETA	struct termio *" argp
.TP
.BI "TCSETA	const struct termio *" argp
.TP
.BI "TCSETAW	const struct termio *" argp
.TP
.BI "TCSETAF	const struct termio *" argp
.SS "termios ¤ΤΥå"
ü termios ¤Τϥå뤳ȤǽǤ롣
ΥåΤ termios ¤ΤǤꡢ
0 ǤʤӥåȤޤϥեɤϥå줿ͤ򼨤
.TP
.BI "TIOCGLCKTRMIOS	struct termios *" argp
ü termios ¤ΤΥå֤롣
.TP
.BI "TIOCSLCKTRMIOS	const struct termios *" argp
ü termios ¤ΤΥå֤ꤹ롣
root Τߤ¹ԤǤ롣
.SS ɥμ
ɥϥͥݻ뤬
ͥˤäƻѤʤ
(ۥ󥽡ξ㳰ǤꡢեȤɤ߹ʤɡ
üΥѹ줿硢ͥϥɥ򹹿)
.TP
.BI "TIOCGWINSZ	struct winsize *" argp
ɥ롣
.TP
.BI "TIOCSWINSZ	const struct winsize *" argp
ɥꤹ롣
.LP
 ioctl ǻѤ빽¤ΤϡʲΤ褦롣

.in +4n
.nf
struct winsize {
    unsigned short ws_row;
    unsigned short ws_col;
    unsigned short ws_xpixel;   /* ̤ */
    unsigned short ws_ypixel;   /* ̤ */
};
.fi
.in

ɥѹ줿硢
ե饦ɥץ롼פ
.B SIGWINCH
ʥ뤬롣
.SS "break "
.TP
.BI "TCSBRK	int " arg
.I "tcsendbreak(fd, arg)"
Ʊ
.br
üƱꥢǡžѤƤꡢ
.I arg
 0 ξ硢0.25  0.5 äδ֤
break (0 ΥӥåΥȥ꡼) 롣
üƱꥢǡžѤƤ硢
break 뤫δؿϲ⤻֤롣
.I arg
 0 ʳξ硢뤫ʬʤ

(SVr4, UnixWare, Solaris, Linux ϡ
.I "tcsendbreak(fd,arg)"

.I arg
 0 ʳξ硢
.I "tcdrain(fd)"
Τ褦˰
SunOS 
.I arg
ܿȤưӥåȤΥȥ꡼
.I arg
롣
.I arg
 0 ξƱ
DG/UX  AIX ϡ(0 ʳξ)
.I arg
ߥñ̤λֳִ֤Ȥư
HP-UX 
.I arg
̵뤹롣)
.TP
.BI "TCSBRKP	int " arg
POSIX ǡפ
.B TCSBRK
Ǥ롣
 0 ʳ
.I arg
 1/10 ñ̤λֳִ֤Ȥư
ޤɥ饤Ф break 򥵥ݡȤƤʤϡ⤷ʤ
.TP
.B "TIOCSBRK	void"
break 򥪥ˤ롣
Ĥޤ 0 Υӥå򳫻Ϥ롣
.TP
.B "TIOCCBRK	void"
break 򥪥դˤ롣
Ĥޤ 0 Υӥåߤ롣
.SS եȥե
.TP
.BI "TCXONC	int " arg
.I "tcflow(fd, arg)"
Ʊ
.br
.BR tcflow (3)
ΰ
.BR TCOOFF ,
.BR TCOON ,
.BR TCIOFF ,
.B TCION
򻲾Ȥ뤳ȡ
.SS "ХåեΥȤȽ񤭽Ф (flush)"
.TP
.BI "FIONREAD	int *" argp
ϥХåեˤХȿ롣
.TP
.BI "TIOCINQ	int *" argp
.B FIONREAD
Ʊ
.TP
.BI "TIOCOUTQ	int *" argp
ϥХåեˤХȿ롣
.TP
.BI "TCFLSH	int " arg
.I "tcflush(fd, arg)"
Ʊ
.br
.BR tcflush (3)
ΰ
.BR TCIFLUSH ,
.BR TCOFLUSH ,
.B TCIOFLUSH
򻲾Ȥ뤳ȡ
.SS Ϥε
.TP
.BI "TIOCSTI	const char *" argp
ꤵ줿ХȤϥ塼롣
.SS 󥽡ϤΥ쥯
.TP
.B "TIOCCONS	void"
.I /dev/console
ޤ
.I /dev/tty0
Ϥ򡢻ꤵ줿ü (tty) ˥쥯Ȥ롣
ꤵ줿üü (pty) Υޥξ硢Ϥϥ졼֤롣
Ϥޤ쥯ȤƤʤС
ïǤ쥯ȤԤȤǤ롣
˥쥯ȤƤ
.B EBUSY
֤뤬
root ϡ
.I /dev/console
ޤ
.I /dev/tty0
ؤ
.I fd
ФƤ ioctl Ѥ뤳Ȥˤꡢ쥯Ȥߤ뤳ȤǤ롣
.SS "ü"
.TP
.BI "TIOCSCTTY	int " arg
ꤵ줿üƤӽФΥץüˤ롣
ƤӽФΥץϥå꡼ǤʤФʤ餺
ĴüäƤƤϤʤʤ
ü¾Υå󥰥롼פüǤ硢
ioctl 
.B EPERM
ǼԤ롣ƤӽФ桼 root ǡ
.I arg
 1 Ǥ
ξ硢üޤ (stolen)
üüȤƤƤΥץü򼺤
.TP
.B TIOCNOTTY	void
ꤵ줿üƤӽФΥץüǤ硢
ü롣
ץå꡼ξ硢
ե饦ɥץ롼פ
.B SIGHUP

.B SIGCONT
ꡢȥåƤΥץü򼺤
.SS "롼 ID ȥå ID ν"
.TP
.BI "TIOCGPGRP	pid_t *" argp
硢
.I "*argp = tcgetpgrp(fd)"
Ʊ
.br
üΥե饦ɥץΥץ롼 ID 롣
.TP
.BI "TIOCSPGRP	const pid_t *" argp
.I "tcsetpgrp(fd, *argp)"
Ʊ
.br
üΥե饦ɥץΥ롼 ID ꤹ롣
.TP
.BI "TIOCGSID	pid_t *" argp
ꤵ줿üΥå ID 롣
üޥüޤüǤʤϡ
.B ENOTTY
ǼԤ롣
̯
.SS ¾⡼
.TP
.B "TIOCEXCL	void"
ü¾⡼ɤˤ롣
üФơʹߤ
.BR open (2)
ػߤ롣
(root ʳξ硢ʹߤ
.BR open (2)

.B EBUSY
ǼԤ롣)
.TP
.B "TIOCNXCL	void"
¾⡼ɤ̵ˤ롣
.SS "饤 (line discipline)"
.TP
.BI "TIOCGETD	int *" argp
üΥ饤ξ롣
.TP
.BI "TIOCSETD	const int *" argp
üΥ饤ξꤹ롣
.SS "ü ioctl"
.TP
.BI "TIOCPKT	const int *" argp
ѥåȥ⡼ɤͭ
.RI (* argp
 0 ʳξ) ޤ̵ˤ롣
üΥޥ¦ˤΤŬѤǤ (ʳξ
.B ENOTTY
֤)
ѥåȥ⡼ɤǤϡθ˼¹Ԥ
.BR read (2)
ϡͤ 0 ʳ 1 ĤХȤޤѥåȤ
ͤ 0  1 Х ('\\0') ˵üΥ졼¦ǽ񤭹ޤ줿
ǡ³ѥåȤ֤
ǽΥХȤ
.B TIOCPKT_DATA
(0) Ǥʤ硢ʲΥӥåȤ 1 İʾ OR ΤǤ:

.nf
TIOCPKT_FLUSHREAD   üɤ߹ߥ塼եå (flush) 롣
TIOCPKT_FLUSHWRITE  üν񤭽Ф塼եå夵롣
TIOCPKT_STOP        üؤνϤߤ롣
TIOCPKT_START       üؤνϤƳ롣
TIOCPKT_DOSTOP      t_stopc  `^S' ǡ
                     t_startc  `^Q' Ǥ롣
TIOCPKT_NOSTOP      start ʸ stop ʸ `^S/^Q' Ǥʤ
.fi

Υ⡼ɤȤƤ硢
־¸ߤޥ¦ɤ߹뤫ϡ
㳰Ūʾ
.BR select (2)
ȤȤˤΤ뤳ȤǤ롣

Υ⡼ɤ
.BR rlogin (1)

.BR rlogind (8)
ǻȤ졢⡼ȥΥ⡼ȥ
Ǥ `^S/^Q' եΥ⡼ȥƤ롣

BSD  ioctl Ǥ
.BR TIOCSTOP ,
.BR TIOCSTART ,
.BR TIOCUCNTL ,
.B TIOCREMOTE
ϡLinux ǤϼƤʤ
.SS ǥ
.TP
.BI "TIOCMGET	int *" argp
ǥӥåξ֤롣
.TP
.BI "TIOCMSET	const int *" argp
ǥӥåξ֤ꤹ롣
.TP
.BI "TIOCMBIC	const int *" argp
ꤵ줿ǥӥå򥯥ꥢ롣
.TP
.BI "TIOCMBIS	const int *" argp
ꤵ줿ǥӥåꤹ롣
.LP
 4 Ĥ ioctl ǻȤӥåȤϰʲ̤:

.nf
TIOCM_LE        DSR (data set ready/line enable)
TIOCM_DTR       DTR (data terminal ready)
TIOCM_RTS       RTS (request to send)
TIOCM_ST        Secondary TXD (transmit)
TIOCM_SR        Secondary RXD (receive)
TIOCM_CTS       CTS (clear to send)
TIOCM_CAR       DCD (data carrier detect)
TIOCM_CD         TIOCM_CAR 򻲾ȡ
TIOCM_RNG       RNG (ring)
TIOCM_RI         TIOCM_RNG 򻲾ȡ
TIOCM_DSR       DSR (data set ready)
.fi
.SS "Ȥƥޡ"
.TP
.BI "TIOCGSOFTCAR	int *" argp
("եȥꥢե饰μ")
termios ¤Τ c_cflag եɤ
.B CLOCAL
ե饰ξ֤롣
.TP
.BI "TIOCSSOFTCAR	const int *" argp
("եȥꥢե饰")
.RI * argp
 0 ʳξ硢termios ¤Τ
.B CLOCAL
ե饰ꤹ롣
0 ξϥꥢ롣
.LP
饤
.B CLOCAL
ե饰դξ硢
ϡɥꥢ (hardware carrier detect, DCD) ʥ뤬פǤꡢ
.B O_NONBLOCK
ե饰ꤵʤ¤ꡢбü
.BR open (2)
 DCD ޤǥ֥å롣
.B CLOCAL
ꤵƤ硢
饤Ͼ DCD Ƥ뤫Τ褦ư롣
եȥꥢե饰ϡǥХǤ̾ϥˤʤäƤꡢ
ǥΥ饤ǤϥդˤʤäƤ롣
.SS "Linux ͭ ioctl"
.B TIOCLINUX
ioctl ˤĤƤϡ
.BR console_ioctl (4)
򻲾Ȥ뤳ȡ
.SS ͥǥХå
.B "#include <linux/tty.h>"
.TP
.BI "TIOCTTYGSTRUCT	struct tty_struct *" argp
.I fd
б
.I tty_struct
롣
.\" .SS "ꥢ"
.\" .BR "#include <linux/serial.h>"
.\" .sp
.\" .TP
.\" .BI "TIOCGSERIAL	struct serial_struct *" argp
.\" ꥢ롣
.\" .TP
.\" .BI "TIOCSSERIAL	const struct serial_struct *" argp
.\" ꥢꤹ롣
.SH ֤
.BR ioctl ()
ƥॳϡ 0 ֤
顼ξ \-1 ֤
.I errno
Ŭڤꤹ롣
.SH 顼
.TP
.B EINVAL
ʥޥɰǤ롣
.TP
.B ENOIOCTLCMD
ʥޥɤǤ롣
.TP
.B ENOTTY
.I fd
ŬڤǤ롣
.TP
.B EPERM
¤­Ƥ롣
.SH 
ꥢݡȤ DTR ξ֤å롣

.nf
#include <termios.h>
#include <fcntl.h>
#include <sys/ioctl.h>

int
main(void)
{
    int fd, serial;

    fd = open("/dev/ttyS0", O_RDONLY);
    ioctl(fd, TIOCMGET, &serial);
    if (serial & TIOCM_DTR)
        puts("TIOCM_DTR ꤵƤʤ");
    else
        puts("TIOCM_DTR ꤵƤ롣");
    close(fd);
}
.fi
.SH Ϣ
.BR ioctl (2),
.BR termios (3),
.BR console_ioctl (4),
.BR pty (7)
.\"
.\" FIONBIO			const int *
.\" FIONCLEX			void
.\" FIOCLEX			void
.\" FIOASYNC			const int *
.\" serial.c :
.\" TIOCSERCONFIG		void
.\" TIOCSERGWILD		int *
.\" TIOCSERSWILD		const int *
.\" TIOCSERGSTRUCT		struct async_struct *
.\" TIOCSERGETLSR		int *
.\" TIOCSERGETMULTI		struct serial_multiport_struct *
.\" TIOCSERSETMULTI		const struct serial_multiport_struct *
.\" TIOCGSERIAL, TIOCSSERIAL (嵭򻲾)