draft/man4/tty_ioctl.4

   1 .\" Copyright 2002 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
   2 .\" and Andries Brouwer <aeb@cwi.nl>.
   3 .\"
   4 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   5 .\" Distributed under GPL
   6 .\" %%%LICENSE_END
   7 .\"
   8 .\"*******************************************************************
   9 .\"
  10 .\" This file was generated with po4a. Translate the source file.
  11 .\"
  12 .\"*******************************************************************
  13 .TH TTY_IOCTL 4 2008\-10\-29 Linux "Linux Programmer's Manual"
  14 .SH 名前
  15 tty_ioctl \- 端末とシリアルラインの ioctl (入出力制御)
  16 .SH 書式
  17 \fB#include <termios.h>\fP
  18 .sp
  19 \fBint ioctl(int \fP\fIfd\fP\fB, int \fP\fIcmd\fP\fB, ...);\fP
  20 .SH 説明
  21 端末とシリアルポートについての \fBioctl\fP(2)  コールは、多くのコマンド引き数を受け付ける。 多くがいろいろな型の 3
  22 番目の引き数を必要とする。 ここでは \fIargp\fP または \fIarg\fP と呼ぶ。
  23 .LP
  24 \fIioctl\fP を使用すると移植性のないプログラムになる。 可能な場合は、 \fBtermios\fP(3)  に記述されている POSIX
  25 インタフェースを使うこと。
  26 .SS 端末属性の取得と設定
  27 .TP
  28 \fBTCGETS       struct termios *\fP\fIargp\fP
  29 \fItcgetattr(fd, argp)\fP と同じ。
  30 .br
  31 現在のシリアルポートの設定を取得する。
  32 .TP
  33 \fBTCSETS       const struct termios *\fP\fIargp\fP
  34 \fItcsetattr(fd, TCSANOW, argp)\fP と同じ。
  35 .br
  36 現在のシリアルポートの設定を変更する。
  37 .TP
  38 \fBTCSETSW      const struct termios *\fP\fIargp\fP
  39 \fItcsetattr(fd, TCSADRAIN, argp)\fP と同じ。
  40 .br
  41 排出 (drain) を行うための出力バッファの使用を許可し、 現在のシリアルポートの設定を変更する。
  42 .TP
  43 \fBTCSETSF      const struct termios *\fP\fIargp\fP
  44 \fItcsetattr(fd, TCSAFLUSH, argp)\fP と同じ。
  45 .br
  46 排出 (drain) を行うための出力バッファの使用を許可し、 処理していない入力を破棄して、 現在のシリアルポートの設定を変更する。
  47 .LP
  48 The following four ioctls are just like \fBTCGETS\fP, \fBTCSETS\fP, \fBTCSETSW\fP,
  49 \fBTCSETSF\fP, except that they take a \fIstruct termio\ *\fP instead of a
  50 \fIstruct termios\ *\fP.
  51 .IP
  52 \fBTCGETA       struct termio *\fP\fIargp\fP
  53 .IP
  54 \fBTCSETA       const struct termio *\fP\fIargp\fP
  55 .IP
  56 \fBTCSETAW      const struct termio *\fP\fIargp\fP
  57 .IP
  58 \fBTCSETAF      const struct termio *\fP\fIargp\fP
  59 .SS "termios 構造体のロック"
  60 端末の \fItermios\fP 構造体はロックすることが可能である。 このロック自体は \fItermios\fP 構造体であり、 0
  61 でないビットまたはフィールドはロックされた値を示す。
  62 .TP
  63 \fBTIOCGLCKTRMIOS       struct termios *\fP\fIargp\fP
  64 端末の \fItermios\fP 構造体のロック状態を取得する。
  65 .TP
  66 \fBTIOCSLCKTRMIOS       const struct termios *\fP\fIargp\fP
  67 端末の \fItermios\fP 構造体のロック状態を設定する。 root のみ (より正確には、 \fBCAP_SYS_ADMIN\fP
  68 ケーパビリティを持つプロセス) がこれを実行できる。
  69 .SS ウィンドウサイズの取得と設定
  70 ウィンドウサイズはカーネル内に保持されるが、 カーネルによって使用されない (仮想コンソールの場合は例外であり、新しいフォントを読み込んだ場合など、
  71 仮想端末のサイズが変更された場合、カーネルはウィンドウサイズを更新する)。
  72
  73 以下の定数と構造体は \fI<sys/ioctl.h>\fP で定義されている。
  74 .TP
  75 \fBTIOCGWINSZ   struct winsize *\fP\fIargp\fP
  76 ウィンドウサイズを取得する。
  77 .TP
  78 \fBTIOCSWINSZ   const struct winsize *\fP\fIargp\fP
  79 ウィンドウサイズを設定する。
  80 .LP
  81 これらの ioctl で使用される構造体は、以下のように定義される。
  82
  83 .in +4n
  84 .nf
  85 struct winsize {
  86     unsigned short ws_row;
  87     unsigned short ws_col;
  88     unsigned short ws_xpixel;   /* 未使用 */
  89     unsigned short ws_ypixel;   /* 未使用 */
  90 };
  91 .fi
  92 .in
  93
  94 ウィンドウサイズが変更された場合、 フォアグラウンドプロセスグループに \fBSIGWINCH\fP シグナルが送られる。
  95 .SS "break の送信"
  96 .TP
  97 \fBTCSBRK       int \fP\fIarg\fP
  98 \fItcsendbreak(fd, arg)\fP と同じ。
  99 .br
 100 端末が非同期シリアルデータ転送を使用しており、 \fIarg\fP が 0 の場合、0.25 から 0.5 秒の間に break (0
 101 のビット列のストリーム) が送信される。 端末が非同期シリアルデータ転送を使用している場合、 break が送信されるか、この関数は何もせずに返る。
 102 \fIarg\fP が 0 以外の場合、何が起こるか分からない。
 103
 104 (SVr4, UnixWare, Solaris, Linux は、 \fItcsendbreak(fd,arg)\fP の \fIarg\fP が 0
 105 以外の場合、 \fItcdrain(fd)\fP のように扱う。 SunOS は \fIarg\fP を倍数として扱い、ビットのストリームを \fIarg\fP
 106 回送信する。 \fIarg\fP が 0 の場合も同じ。 DG/UX と AIX は、(0 以外の場合)  \fIarg\fP をミリ秒単位の時間間隔として扱う。
 107 HP\-UX は \fIarg\fP を無視する。)
 108 .TP
 109 \fBTCSBRKP      int \fP\fIarg\fP
 110 いわゆる「POSIX 版」の \fBTCSBRK\fP である。 これは 0 以外の \fIarg\fP を 1/10 秒単位の時間間隔として扱う。 またドライバが
 111 break をサポートしていない場合は、何もしない。
 112 .TP
 113 \fBTIOCSBRK     void\fP
 114 break をオンにする。 つまり 0 のビット列の送信を開始する。
 115 .TP
 116 \fBTIOCCBRK     void\fP
 117 break をオフにする。 つまり 0 のビット列の送信を停止する。
 118 .SS ソフトウェアフロー制御
 119 .TP
 120 \fBTCXONC       int \fP\fIarg\fP
 121 \fItcflow(fd, arg)\fP と同じ。
 122 .br
 123 \fBtcflow\fP(3)  の引き数 \fBTCOOFF\fP, \fBTCOON\fP, \fBTCIOFF\fP, \fBTCION\fP を参照すること。
 124 .SS "バッファのカウントと書き出し (flush)"
 125 .TP
 126 \fBFIONREAD     int *\fP\fIargp\fP
 127 入力バッファにあるバイト数を取得する。
 128 .TP
 129 \fBTIOCINQ      int *\fP\fIargp\fP
 130 \fBFIONREAD\fP と同じ。
 131 .TP
 132 \fBTIOCOUTQ     int *\fP\fIargp\fP
 133 出力バッファにあるバイト数を取得する。
 134 .TP
 135 \fBTCFLSH       int \fP\fIarg\fP
 136 \fItcflush(fd, arg)\fP と同じ。
 137 .br
 138 \fBtcflush\fP(3)  の引き数 \fBTCIFLUSH\fP, \fBTCOFLUSH\fP, \fBTCIOFLUSH\fP を参照すること。
 139 .SS 入力の偽装
 140 .TP
 141 \fBTIOCSTI      const char *\fP\fIargp\fP
 142 指定されたバイトを入力キューに挿入する。
 143 .SS コンソール出力のリダイレクト
 144 .TP
 145 \fBTIOCCONS     void\fP
 146 \fI/dev/console\fP または \fI/dev/tty0\fP に送られる出力を、指定された端末リダイレクトする。 指定された端末が疑似端末
 147 (pseudoterminal) のマスタの場合、 出力はスレーブに送られる。 バージョン 2.6.10 より前の Linux
 148 では、出力がまだリダイレクトされて いなければ、誰でもリダイレクトを行うことができる。 バージョン 2.6.10 以降では、root
 149 (\fBCAP_SYS_ADMIN\fP ケーパビリティを持つプロセス) だけがリダイレクトを行うことができる。 出力がすでにリダイレクトされている場合は
 150 \fBEBUSY\fP が返されるが、 \fI/dev/console\fP か \fI/dev/tty0\fP を指している \fIfd\fP に対してこの ioctl
 151 を使用することで、リダイレクトを止めることができる。
 152 .SS 端末の制御
 153 .TP
 154 \fBTIOCSCTTY    int \fP\fIarg\fP
 155 指定された端末を呼び出し元のプロセスの制御端末にする。 呼び出し元のプロセスはセッションリーダでなければならず、
 156 かつ既に制御端末を持っていてはならない。 この端末が既に他のセッショングループの制御端末である場合、 ioctl は \fBEPERM\fP
 157 で失敗する。ただし呼び出したユーザが root で (より正確には \fBCAP_SYS_ADMIN\fP ケーパビリティを持っていて)、かつ \fIarg\fP
 158 が 1 である場合を除く。 この場合、端末は盗まれ (stolen)、 この端末を制御端末としていた全てのプロセスは端末を失う。
 159 .TP
 160 \fBTIOCNOTTY    void\fP
 161 指定された端末が呼び出し元のプロセスの制御端末である場合、 この制御端末を放棄する。 プロセスがセッションリーダの場合、
 162 フォアグラウンドプロセスグループに \fBSIGHUP\fP と \fBSIGCONT\fP を送り、カレントセッションの全てのプロセスは制御端末を失う。
 163 .SS "グループ ID とセッション ID の処理"
 164 .TP
 165 \fBTIOCGPGRP    pid_t *\fP\fIargp\fP
 166 成功した場合、 \fI*argp = tcgetpgrp(fd)\fP と同じ。
 167 .br
 168 この端末上のフォアグラウンドプロセスのプロセスグループ ID を取得する。
 169 .TP
 170 \fBTIOCSPGRP    const pid_t *\fP\fIargp\fP
 171 \fItcsetpgrp(fd, *argp)\fP と同じ。
 172 .br
 173 この端末のフォアグラウンドプロセスのグループ ID を設定する。
 174 .TP
 175 \fBTIOCGSID     pid_t *\fP\fIargp\fP
 176 指定された端末のセッション ID を取得する。 端末がマスタ疑似端末または制御端末でない場合は、 \fBENOTTY\fP で失敗する。 奇妙だ。
 177 .SS 排他モード
 178 .TP
 179 \fBTIOCEXCL     void\fP
 180 端末を排他モードにする。 端末に対して、これ以降の \fBopen\fP(2)  操作を禁止する。 (root 以外の場合、つまり
 181 \fBCAP_SYS_ADMIN\fP ケーパビリティを持たないプロセスの場合、これ以降の \fBopen\fP(2)  は \fBEBUSY\fP で失敗する。)
 182 .TP
 183 \fBTIOCNXCL     void\fP
 184 排他モードを無効にする。
 185 .SS "ライン制御 (line discipline)"
 186 .TP
 187 \fBTIOCGETD     int *\fP\fIargp\fP
 188 端末のライン制御の情報を取得する。
 189 .TP
 190 \fBTIOCSETD     const int *\fP\fIargp\fP
 191 端末のライン制御の情報を設定する。
 192 .SS "疑似端末の ioctl"
 193 .TP
 194 \fBTIOCPKT      const int *\fP\fIargp\fP
 195 パケットモードを有効 (*\fIargp\fP が 0 以外の場合) または無効にする。 疑似端末のマスタ側にのみ適用できる (それ以外の場合は
 196 \fBENOTTY\fP を返す)。 パケットモードでは、その後に実行される \fBread\fP(2)  は、値が 0 以外の 1
 197 つの制御バイトを含むパケットか、 値が 0 の 1 バイト (\(aq\e0\(aq) に疑似端末のスレーブ側で書き込まれた
 198 データが続くパケットを返す。 最初のバイトが \fBTIOCPKT_DATA\fP (0) でない場合、以下のビットの 1 つ以上を OR したものである:
 199
 200 .nf
 201 TIOCPKT_FLUSHREAD   端末の読み込みキューがフラッシュ (flush) される。
 202 TIOCPKT_FLUSHWRITE  端末の書き出しキューがフラッシュされる。
 203 TIOCPKT_STOP        端末への出力が停止される。
 204 TIOCPKT_START       端末への出力が再開される。
 205 TIOCPKT_DOSTOP      開始文字と終了文字が \fB^S\fP/\fB^Q\fP である。
 206 TIOCPKT_NOSTOP      開始文字と終了文字が \fB^S\fP/\fB^Q\fP でない。
 207 .fi
 208
 209 このモードが使われている場合、 制御状態情報の存在がマスタ側から読み込めるかは、 例外的な条件で \fBselect\fP(2)
 210 を使うことにより知ることができる。
 211
 212 このモードは \fBrlogin\fP(1)  と \fBrlogind\fP(8)  で使われ、リモートエコーのリモートログインと ローカルでの
 213 \fB^S\fP/\fB^Q\fP フロー制御のリモートログインを実装している。
 214
 215 BSD の ioctl である \fBTIOCSTOP\fP, \fBTIOCSTART\fP, \fBTIOCUCNTL\fP, \fBTIOCREMOTE\fP
 216 は、Linux では実装されていない。
 217 .SS モデム制御
 218 .TP
 219 \fBTIOCMGET     int *\fP\fIargp\fP
 220 モデムビット列の状態を取得する。
 221 .TP
 222 \fBTIOCMSET     const int *\fP\fIargp\fP
 223 モデムビット列の状態を設定する。
 224 .TP
 225 \fBTIOCMBIC     const int *\fP\fIargp\fP
 226 指定されたモデムビット列をクリアする。
 227 .TP
 228 \fBTIOCMBIS     const int *\fP\fIargp\fP
 229 指定されたモデムビット列を設定する。
 230 .LP
 231 これらの 4 つの ioctl で使われるビットは以下の通り:
 232
 233 .nf
 234 TIOCM_LE        DSR (data set ready/line enable)
 235 TIOCM_DTR       DTR (data terminal ready)
 236 TIOCM_RTS       RTS (request to send)
 237 TIOCM_ST        Secondary TXD (transmit)
 238 TIOCM_SR        Secondary RXD (receive)
 239 TIOCM_CTS       CTS (clear to send)
 240 TIOCM_CAR       DCD (data carrier detect)
 241 TIOCM_CD         TIOCM_CAR を参照。
 242 TIOCM_RNG       RNG (ring)
 243 TIOCM_RI         TIOCM_RNG を参照。
 244 TIOCM_DSR       DSR (data set ready)
 245 .fi
 246 .SS 回線をローカルとしてマークする
 247 .TP
 248 \fBTIOCGSOFTCAR int *\fP\fIargp\fP
 249 ("ソフトウェアキャリアフラグの取得")  \fItermios\fP 構造体の c_cflag フィールドの \fBCLOCAL\fP フラグの状態を取得する。
 250 .TP
 251 \fBTIOCSSOFTCAR const int *\fP\fIargp\fP
 252 ("ソフトウェアキャリアフラグの設定")  *\fIargp\fP が 0 以外の場合、 \fItermios\fP 構造体の \fBCLOCAL\fP
 253 フラグを設定する。 0 の場合はクリアする。
 254 .LP
 255 ラインの \fBCLOCAL\fP フラグがオフの場合、 ハードウェアキャリア検出 (hardware carrier detect, DCD)
 256 シグナルが重要であり、 \fBO_NONBLOCK\fP フラグが指定されない限り、対応する端末の \fBopen\fP(2)  は DCD
 257 が示されるまでブロックされる。 \fBCLOCAL\fP が設定されている場合、 ラインは常に DCD が示されているかのように動作する。
 258 ソフトウェアキャリアフラグは、ローカルデバイスでは通常はオンになっており、 モデムのラインではオフになっている。
 259 .SS "Linux 固有の ioctl"
 260 \fBTIOCLINUX\fP ioctl については、 \fBconsole_ioctl\fP(4)  を参照すること。
 261 .SS カーネルデバッギング
 262 \fB#include <linux/tty.h>\fP
 263 .TP
 264 \fBTIOCTTYGSTRUCT       struct tty_struct *\fP\fIargp\fP
 265 .\"
 266 .\" .SS "Serial info"
 267 .\" .BR "#include <linux/serial.h>"
 268 .\" .sp
 269 .\" .TP
 270 .\" .BI "TIOCGSERIAL    struct serial_struct *" argp
 271 .\" Get serial info.
 272 .\" .TP
 273 .\" .BI "TIOCSSERIAL    const struct serial_struct *" argp
 274 .\" Set serial info.
 275 \fIfd\fP に対応する \fItty_struct\fP を取得する。
 276 .SH 返り値
 277 \fBioctl\fP(2)  システムコールは、成功した場合は 0 を返す。 エラーの場合は \-1 を返し、 \fIerrno\fP を適切に設定する。
 278 .SH エラー
 279 .TP
 280 \fBEINVAL\fP
 281 不正なコマンド引き数である。
 282 .TP
 283 \fBENOIOCTLCMD\fP
 284 不明なコマンドである。
 285 .TP
 286 \fBENOTTY\fP
 287 \fIfd\fP が不適切である。
 288 .TP
 289 \fBEPERM\fP
 290 権限が不足している。
 291 .SH 例
 292 シリアルポートの DTR の状態をチェックする。
 293
 294 .nf
 295 #include <termios.h>
 296 #include <fcntl.h>
 297 #include <sys/ioctl.h>
 298
 299 int
 300 main(void)
 301 {
 302     int fd, serial;
 303
 304     fd = open("/dev/ttyS0", O_RDONLY);
 305     ioctl(fd, TIOCMGET, &serial);
 306     if (serial & TIOCM_DTR)
 307         puts("TIOCM_DTR が設定されていない。");
 308     else
 309         puts("TIOCM_DTR が設定されている。");
 310     close(fd);
 311 }
 312 .fi
 313 .SH 関連項目
 314 .\"
 315 .\" FIONBIO                     const int *
 316 .\" FIONCLEX                    void
 317 .\" FIOCLEX                     void
 318 .\" FIOASYNC                    const int *
 319 .\" from serial.c:
 320 .\" TIOCSERCONFIG               void
 321 .\" TIOCSERGWILD                int *
 322 .\" TIOCSERSWILD                const int *
 323 .\" TIOCSERGSTRUCT              struct async_struct *
 324 .\" TIOCSERGETLSR               int *
 325 .\" TIOCSERGETMULTI             struct serial_multiport_struct *
 326 .\" TIOCSERSETMULTI             const struct serial_multiport_struct *
 327 .\" TIOCGSERIAL, TIOCSSERIAL (see above)
 328 \fBioctl\fP(2), \fBtermios\fP(3), \fBconsole_ioctl\fP(4), \fBpty\fP(7)
 329 .SH この文書について
 330 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 331 である。プロジェクトの説明とバグ報告に関する情報は
 332 http://www.kernel.org/doc/man\-pages/ に書かれている。