.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH IOCTL 2 2000\-09\-21 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1997-1999 HANATAKA Shinya
+.\" all rights reserved.
+.\" Translated Sat Aug 14 10:10:27 JST 1999
+.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\" Modified 2002-09-24 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2005-02-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2011-08-10, TACHIBANA Akira <tati@kc5.so-net.ne.jp>
+.\" Updated 2011-09-15, TACHIBANA Akira <tati@kc5.so-net.ne.jp>
+.\"
+.TH IOCTL 2 2014\-12\-31 Linux "Linux Programmer's Manual"
.SH 名前
ioctl \- デバイスを制御する
.SH 書式
\fB#include <sys/ioctl.h>\fP
.sp
-\fBint ioctl(int \fP\fId\fP\fB, int \fP\fIrequest\fP\fB, ...);\fP
+.\" POSIX says 'request' is int, but glibc has the above
+.\" See https://bugzilla.kernel.org/show_bug.cgi?id=42705
+\fBint ioctl(int \fP\fIfd\fP\fB, unsigned long \fP\fIrequest\fP\fB, ...);\fP
.SH 説明
-\fBioctl\fP() é\96¢æ\95°ã\81¯ã\82¹ã\83\9aã\82·ã\83£ã\83«ã\83»ã\83\95ã\82¡ã\82¤ã\83«ã\82\92æ§\8bæ\88\90ã\81\99ã\82\8bã\83\87ã\83\90ã\82¤ã\82¹ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\82\92 æ\93\8dä½\9cã\81\99ã\82\8bã\80\82ç\89¹ã\81«ã\80\81ã\82ã\83£ã\83©ã\82¯ã\82¿å\9e\8bã\81®ã\82¹ã\83\9aã\82·ã\83£ã\83«ã\83»ファイル (例えば端末
-(terminal)) の多くの動作特性を \fBioctl\fP() リクエストによって制御することができる。引き数 \fId\fP
-ã\81¯ã\82ªã\83¼ã\83\97ã\83³ã\81\95ã\82\8cã\81\9fã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿でなければならない。
+\fBioctl\fP() é\96¢æ\95°ã\81¯ã\82¹ã\83\9aã\82·ã\83£ã\83«ã\83\95ã\82¡ã\82¤ã\83«ã\82\92æ§\8bæ\88\90ã\81\99ã\82\8bã\83\87ã\83\90ã\82¤ã\82¹ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\82\92 æ\93\8dä½\9cã\81\99ã\82\8bã\80\82ç\89¹ã\81«ã\80\81ã\82ã\83£ã\83©ã\82¯ã\82¿ã\83¼å\9e\8bã\81®ã\82¹ã\83\9aã\82·ã\83£ã\83«ファイル (例えば端末
+(terminal)) の多くの動作特性を \fBioctl\fP() リクエストによって制御することができる。引き数 \fIfd\fP
+ã\81¯ã\82ªã\83¼ã\83\97ã\83³ã\81\95ã\82\8cã\81\9fã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼でなければならない。
.PP
-2 ç\95ªç\9b®ã\81®å¼\95ã\81\8dæ\95°ã\81¯ã\80\81ã\83\87ã\83\90ã\82¤ã\82¹ä¾\9då\98ã\81®ã\83ªã\82¯ã\82¨ã\82¹ã\83\88ã\83»ã\82³ã\83¼ã\83\89ã\81§ã\81\82ã\82\8bã\80\82 3 ç\95ªç\9b®ã\81®å¼\95ã\81\8dæ\95°ã\81¯ã\80\81ã\83¡ã\83¢ã\83ªã\81¸ã\81®å\9e\8bã\82\92æ\8c\87å®\9aã\81\97ã\81ªã\81\84ã\83\9dã\82¤ã\83³ã\82¿である。 この引き数は伝統的に (C
+2 ç\95ªç\9b®ã\81®å¼\95ã\81\8dæ\95°ã\81¯ã\80\81ã\83\87ã\83\90ã\82¤ã\82¹ä¾\9då\98ã\81®ã\83ªã\82¯ã\82¨ã\82¹ã\83\88ã\82³ã\83¼ã\83\89ã\81§ã\81\82ã\82\8bã\80\82 3 ç\95ªç\9b®ã\81®å¼\95ã\81\8dæ\95°ã\81¯ã\80\81ã\83¡ã\83¢ã\83ªã\83¼ã\81¸ã\81®å\9e\8bã\82\92æ\8c\87å®\9aã\81\97ã\81ªã\81\84ã\83\9dã\82¤ã\83³ã\82¿ã\83¼である。 この引き数は伝統的に (C
で \fBvoid *\fP という書き方が有効になる前から) \fBchar *\fP\fIargp\fP
と表記されている。したがって、この文章でもそう名付けることとする。
.PP
-\fBioctl\fP() ã\81® \fIrequest\fP ã\81«ã\81¯ã\80\81 ã\81\9dã\81®å¼\95ã\81\8dæ\95°ã\81\8c \fIå\85¥å\8a\9b\fP ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\81¨ \fIå\87ºå\8a\9b\fP ã\83\91ã\83©ã\83¡ã\83¼ã\82¿のどちらであるかの区別や、
+\fBioctl\fP() ã\81® \fIrequest\fP ã\81«ã\81¯ã\80\81 ã\81\9dã\81®å¼\95ã\81\8dæ\95°ã\81\8c \fIå\85¥å\8a\9b\fP ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81¨ \fIå\87ºå\8a\9b\fP ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼のどちらであるかの区別や、
\fIargp\fP 引き数のバイト単位のサイズ、といった情報がエンコードされている。 \fBioctl\fP() の \fIrequest\fP
を指定するためのマクロ (macro) と定義は \fI<sys/ioctl.h>\fP ファイルにある。
.SH 返り値
-たいていの場合、成功するとゼロが返される。 ただし、 \fBioctl\fP() リクエストの中にはパラメータの出力に返り値を使用しているものが若干あり、
+ã\81\9fã\81\84ã\81¦ã\81\84ã\81®å ´å\90\88ã\80\81æ\88\90å\8a\9fã\81\99ã\82\8bã\81¨ã\82¼ã\83ã\81\8cè¿\94ã\81\95ã\82\8cã\82\8bã\80\82 ã\81\9fã\81 ã\81\97ã\80\81 \fBioctl\fP() ã\83ªã\82¯ã\82¨ã\82¹ã\83\88ã\81®ä¸ã\81«ã\81¯ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81®å\87ºå\8a\9bã\81«è¿\94ã\82\8aå\80¤ã\82\92使ç\94¨ã\81\97ã\81¦ã\81\84ã\82\8bã\82\82ã\81®ã\81\8cè\8b¥å¹²ã\81\82ã\82\8aã\80\81
その場合は、成功したときに非負の値が返される。 エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
.TP 0.7i
\fBEBADF\fP
-\fId\fP が有効なディスクリプタではない。
+\fIfd\fP が無効なディスクリプターである。
.TP
\fBEFAULT\fP
-\fIargp\fP がアクセス不可能なメモリを参照している。
+\fIargp\fP ã\81\8cã\82¢ã\82¯ã\82»ã\82¹ä¸\8då\8f¯è\83½ã\81ªã\83¡ã\83¢ã\83ªã\83¼ã\82\92å\8f\82ç\85§ã\81\97ã\81¦ã\81\84ã\82\8bã\80\82
.TP
\fBEINVAL\fP
\fIrequest\fP または \fIargp\fP が不正である。
.TP
\fBENOTTY\fP
-\fId\fP がキャラクタ型のスペシャル・デバイスを参照していない。
+\fIfd\fP がキャラクター型のスペシャルデバイスを参照していない。
.TP
\fBENOTTY\fP
-指定されたリクエストはディスクリプタ \fId\fP が参照する種類のオブジェクトには適用することができない。
+指定されたリクエストはディスクリプター \fIfd\fP が参照する種類のオブジェクトには適用することができない。
.SH 準拠
-ã\81©ã\82\8cã\81\8bä¸\80ã\81¤ã\81®æ¨\99æº\96ã\81«å¯¾å¿\9cã\81\97ã\81¦ã\81\84ã\82\8bã\82\8fã\81\91ã\81§ã\81¯ã\81ªã\81\84ã\80\82 \fBioctl\fP() ã\81®å¼\95ã\81\8dæ\95°ã\80\81è¿\94ã\82\8aå\80¤ã\80\81解é\87\88ã\81¯ã\80\81å\87¦ç\90\86対象ã\81®ã\83\87ã\83\90ã\82¤ã\82¹ã\83»ã\83\89ã\83©ã\82¤ã\83\90ã\81\94ã\81¨ã\81« ç\95°ã\81ªã\82\8b (ã\81\93ã\81®é\96¢æ\95°ã\81¯
+どれか一つの標準に対応しているわけではない。 \fBioctl\fP() の引き数、返り値、解釈は、処理対象のデバイスドライバごとに 異なる (この関数は
UNIX の ストリーム I/O モデル に きちんと適合していない操作のための便利屋として使用される)。 よく知られている \fBioctl\fP()
のリストについては \fBioctl_list\fP(2) を参照すること。 \fBioctl\fP() 関数コールは Version 7 AT&T UNIX
で登場した。
.SH 注意
-ã\81\93ã\81®ã\82·ã\82¹ã\83\86ã\83 ã\82³ã\83¼ã\83«ã\82\92使ã\81\86ã\81«ã\81¯ã\80\81ã\82ªã\83¼ã\83\97ã\83³ã\81\95ã\82\8cã\81\9fã\83\95ã\82¡ã\82¤ã\83«ã\83»ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿が 必要である。 \fBopen\fP(2)
+ã\81\93ã\81®ã\82·ã\82¹ã\83\86ã\83 ã\82³ã\83¼ã\83«ã\82\92使ã\81\86ã\81«ã\81¯ã\80\81ã\82ªã\83¼ã\83\97ã\83³ã\81\95ã\82\8cã\81\9fã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼が 必要である。 \fBopen\fP(2)
コールはしばしば望んでいない副作用を伴うことがあるが、Linux では \fBopen\fP(2) に \fBO_NONBLOCK\fP
フラグをつけることでこの副作用を避けることができる。
.SH 関連項目
.\" .BR mt (4),
\fBexecve\fP(2), \fBfcntl\fP(2), \fBioctl_list\fP(2), \fBopen\fP(2), \fBsd\fP(4), \fBtty\fP(4)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
