OSDN Git Service

Retire LDP man-pages repository
[linuxjm/LDP_man-pages.git] / draft / man2 / ioctl.2
diff --git a/draft/man2/ioctl.2 b/draft/man2/ioctl.2
deleted file mode 100644 (file)
index f241175..0000000
+++ /dev/null
@@ -1,111 +0,0 @@
-.\" Copyright (c) 1980, 1991 Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
-.\"    may be used to endorse or promote products derived from this software
-.\"    without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\" %%%LICENSE_END
-.\"
-.\"     @(#)ioctl.2    6.4 (Berkeley) 3/10/91
-.\"
-.\" Modified 1993-07-23 by Rik Faith <faith@cs.unc.edu>
-.\" Modified 1996-10-22 by Eric S. Raymond <esr@thyrsus.com>
-.\" Modified 1999-06-25 by Rachael Munns <vashti@dream.org.uk>
-.\" Modified 2000-09-21 by Andries Brouwer <aeb@cwi.nl>
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" 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
-.\" 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()  関数はスペシャルファイルを構成するデバイスのパラメーターを 操作する。特に、キャラクター型のスペシャルファイル (例えば端末
-(terminal))  の多くの動作特性を \fBioctl\fP()  リクエストによって制御することができる。引き数 \fIfd\fP
-はオープンされたファイルディスクリプターでなければならない。
-.PP
-2 番目の引き数は、デバイス依存のリクエストコードである。 3 番目の引き数は、メモリーへの型を指定しないポインターである。 この引き数は伝統的に (C
-で \fBvoid *\fP という書き方が有効になる前から)  \fBchar *\fP\fIargp\fP
-と表記されている。したがって、この文章でもそう名付けることとする。
-.PP
-\fBioctl\fP()  の \fIrequest\fP には、 その引き数が \fI入力\fP パラメーターと \fI出力\fP パラメーターのどちらであるかの区別や、
-\fIargp\fP 引き数のバイト単位のサイズ、といった情報がエンコードされている。 \fBioctl\fP()  の \fIrequest\fP
-を指定するためのマクロ (macro) と定義は \fI<sys/ioctl.h>\fP ファイルにある。
-.SH 返り値
-たいていの場合、成功するとゼロが返される。 ただし、 \fBioctl\fP()  リクエストの中にはパラメーターの出力に返り値を使用しているものが若干あり、
-その場合は、成功したときに非負の値が返される。 エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
-.SH エラー
-.TP  0.7i
-\fBEBADF\fP
-\fIfd\fP が無効なディスクリプターである。
-.TP 
-\fBEFAULT\fP
-\fIargp\fP がアクセス不可能なメモリーを参照している。
-.TP 
-\fBEINVAL\fP
-\fIrequest\fP または \fIargp\fP が不正である。
-.TP 
-\fBENOTTY\fP
-\fIfd\fP がキャラクター型のスペシャルデバイスを参照していない。
-.TP 
-\fBENOTTY\fP
-指定されたリクエストはディスクリプター \fIfd\fP が参照する種類のオブジェクトには適用することができない。
-.SH 準拠
-どれか一つの標準に対応しているわけではない。 \fBioctl\fP()  の引き数、返り値、解釈は、処理対象のデバイスドライバごとに 異なる (この関数は
-UNIX の ストリーム I/O モデル に きちんと適合していない操作のための便利屋として使用される)。 よく知られている \fBioctl\fP()
-のリストについては \fBioctl_list\fP(2)  を参照すること。 \fBioctl\fP()  関数コールは Version 7 AT&T UNIX
-で登場した。
-.SH 注意
-このシステムコールを使うには、オープンされたファイルディスクリプターが 必要である。 \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.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。