diff --git a/ja_JP.eucJP/man/man2/aio_error.2 b/ja_JP.eucJP/man/man2/aio_error.2 index b84c5e51e8..aa7aae56fc 100644 --- a/ja_JP.eucJP/man/man2/aio_error.2 +++ b/ja_JP.eucJP/man/man2/aio_error.2 @@ -1,93 +1,93 @@ .\" Copyright (c) 1999 Softweyr LLC. .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY Softweyr LLC 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 Softweyr LLC 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. .\" .\" %FreeBSD: src/lib/libc/sys/aio_error.2,v 1.6.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd June 2, 1999 .Dt AIO_ERROR 2 .Os .Sh 名称 .Nm aio_error .Nd 非同期入出力操作のエラーステータスを取り出す (REALTIME) .Sh ライブラリ .Lb libc .Sh 書式 .Fd #include .Ft int .Fn aio_error "const struct aiocb *iocb" .Sh 解説 .Fn aio_error 関数は、 .Fa iocb の指す構造体に対応する非同期入出力要求のエラー状態を返します。 .Sh 戻り値 非同期入出力要求が成功した上で正常に完了している場合に .Fn aio_error は 0 を返します。 要求がまだ完了していない場合は .Er EINPROGRESS が返されます。 要求が失敗した上で完了している場合、 -.Xr read 2 , +.Xr read 2 , .Xr write 2 , -.Xr fsync 2 +.Xr fsync 2 , に記述されているようなエラーステータスが返されます。 処理が失敗した場合に .Fn aio_error は .Dv -1 を返し、 .Dv errno を設定してエラー状態を示します。 .Sh エラー .Fn aio_error は次の場合に失敗します: .Bl -tag -width Er .It Bq Er EINVAL .Fa iocb が未解決の非同期 I/O 要求を参照していません。 .El .Sh 関連項目 .Xr aio_cancel 2 , .Xr aio_read 2 , .Xr aio_return 2 , .Xr aio_suspend 2 , .Xr aio_write 2 , .Xr fsync 2 , .Xr read 2 , .Xr write 2 .Sh 規格 .Fn aio_error 関数は .St -p1003.2 に準拠しています。 .Sh 歴史 .Nm 関数は .Fx 3.0 ではじめて登場しました。 .Sh 作者 このマニュアルページは .An Wes Peters Aq wes@softweyr.com が作成しました。 diff --git a/ja_JP.eucJP/man/man2/aio_read.2 b/ja_JP.eucJP/man/man2/aio_read.2 index 671aa3fc90..ba9ec8668a 100644 --- a/ja_JP.eucJP/man/man2/aio_read.2 +++ b/ja_JP.eucJP/man/man2/aio_read.2 @@ -1,207 +1,207 @@ .\" Copyright (c) 1998 Terry Lambert .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" .\" %FreeBSD: src/lib/libc/sys/aio_read.2,v 1.1.2.4 1999/08/29 14:48:55 peter Exp % .\" .Dd November 17, 1998 .Dt AIO_READ 2 .Os .Sh 名称 .Nm aio_read .Nd ファイルからの非同期読取り (REALTIME) .Sh ライブラリ .Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn aio_read "struct aiocb *iocb" .Sh 解説 .Fn aio_read 関数は、呼び出しプロセスに 記述子 .Fa iocb->aio_fildes のオフセット .Fa iocb->aio_offset で始まる .Fa iocb->aio_nbytes を、 .Fa iocb->aio_buf が指すバッファに 読取れるようにします。 呼び出しは、読取り要求が記述子に待ち行列として入れられ るとただちに戻ります。 呼び出しが戻った時点で読取りは完了していることもありますし、 完了していないこともあります。 .Pp _POSIX_PRIORITIZED_IO が定義されており、 しかも記述子がこれをサポートしている場合に 待ち行列に入れられている操作は、呼び出しプロセスの優先順位から .Fa iocb->aio_reqprio を減じたものに等しい優先順位でサブミットされます。 .Pp .Fa iocb->aio_lio_opcode は .Fn aio_read 呼び出しによって無視されます。 .Pp .Fa iocb ポインタは、進行中に待ち行列に入れられた戻りステータスまたは エラーステータスを判定するために、 .Fn aio_return と .Fn aio_error の引数として後に使用される可能性があります。 .Pp 要求が待ち行列に入れられない場合 (一般には無効な引数のために)、 呼び出しは要求を待ち行列に入れずに戻ります。 .Pp 要求が正常に待ち行列に入れられると、コンテキストとして要求の間に .Fa iocb->aio_offset の値が修正される可能性があるので、 この値は要求が待ち行列に入れられた後は参照してはなりません。 .Sh 制限 .Fa iocb が指す非同期入出力制御ブロック構造体、およびその構造体の .Fa iocb->aio_buf メンバが参照するバッファは、操作が完了するまで有効である必要があります。 このため、これらのオブジェクトについての自動 (スタック) 変数の 使用は推奨されません。 .Pp カーネルへの正しくないコンテキスト情報の引き渡しを回避するために、 非同期入出力制御バッファ .Fa iocb は .Fn aio_read 呼び出しの前にゼロにする必要があります。 .Pp 要求が待ち行列に入れられた後、要求が完了するまでは 非同期入出力制御ブロック構造体またはバッファ内容の修正は許されていません。 .Pp .Fa iocb->aio_offset 内のファイルオフセットが、 .Fa iocb->aio_fildes の最大オフセットを越えている場合は入出力は行われません。 .Sh 戻り値 .\".Rv -std aio_read .Fn aio_read 関数は、成功すると値 0 を返します。それ以外の場合は値 -1 が -返され、エラーを示すグローバル変数 +返され、エラーを示すグローバル変数 .Fa errno が設定されます。 .Sh 診断 なし。 .Sh エラー .Fn aio_read は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EAGAIN システムリソースの限界のために要求は待ち行列に入れられませんでした。 .It Bq Er ENOSYS .Fn aio_read 呼び出しがサポートされていません。 .El .Pp 以降の条件は、 .Fn aio_read 呼び出しが行なわれたときに同期的に検出されることもありますし、 その後いつでも非同期的に検出されることもあります。 これらが呼び出し時に検出された場合、 .Fn aio_read は -1 を返し、 .Va errno を適切に設定します。 そうでない場合は、 .Fn aio_return 関数を呼び出し、-1 を返し、 .Va errno に返されている実際の値を判定するために .Fn aio_error を呼び出す必要があります。 .Pp .Bl -tag -width Er .It Bq Er EBADF .Ar iocb->aio_fildes が無効です。 .It Bq Er EINVAL オフセット .Fa iocb->aio_offset が有効でないか、 .Fa iocb->aio_reqprio によって指定される優先順位が 有効な優先順位でないか、または .Fa iocb->aio_nbytes によって指定されるバイト数が有効でありません。 .It Bq Er EOVERFLOW ファイルは正規のファイルであり、 .Fa iocb->aio_nbytes はゼロより大きくて .Fa iocb->aio_offset 内の開始オフセットはファイルの末尾の前にあるものの、 .Fa iocb->aio_fildes オフセット最大にあるかまたはそれを越えています。 .El .Pp 要求が正常に待ち行列に入れられたものの、 後でキャンセルされるかエラーが発生した場合、 .Fn aio_return 関数によって返された値が .Xr read 2 呼び出しごとによるものであり、 .Fn aio_error 関数によって返される値が .Xr read 2 呼び出しから返されたエラーの 1 つであるか、または次の 1 つです。 .Bl -tag -width Er .It Bq Er EBADF .Fa iocb->aio_fildes が読取りについては無効です。 .It Bq Er ECANCELED 要求は .Fn aio_cancel の呼び出しによって明示的にキャンセルされました。 .It Bq Er EINVAL オフセット .Fa iocb->aio_offset は無効です。 .El .Sh 規格 .Fn aio_read 呼び出しは .St -p1003.2 に準拠しています。 .Sh 歴史 .Nm は .Fx 3.0 ではじめて登場しました。 .Sh 作者 このマニュアルページは .An Terry Lambert Aq terry@whistle.com が作成しました。 .Sh バグ .Fa iocb->aio_offset の値は無視されます。 .Fa iocb->_aiocb_private 内の無効な情報はカーネルを混乱させる可能性があります。 diff --git a/ja_JP.eucJP/man/man2/aio_return.2 b/ja_JP.eucJP/man/man2/aio_return.2 index 28de3f6aac..c47f060794 100644 --- a/ja_JP.eucJP/man/man2/aio_return.2 +++ b/ja_JP.eucJP/man/man2/aio_return.2 @@ -1,95 +1,95 @@ .\" Copyright (c) 1999 Softweyr LLC. .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY Softweyr LLC 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 Softweyr LLC 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. .\" .\" %FreeBSD: src/lib/libc/sys/aio_return.2,v 1.5.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd June 2, 1999 .Dt AIO_RETURN 2 .Os .Sh 名称 .Nm aio_return .Nd 非同期入出力操作の戻りステータスを取り出す (REALTIME) .Sh ライブラリ .Lb libc .Sh 書式 .Fd #include .Ft int .Fn aio_return "struct aiocb *iocb" .Sh 解説 .Fn aio_return 関数は .Fa iocb が指す構造体に対応する非同期入出力要求の最終ステータスを返します。 .Pp .Xr aio_error 2 が .Er EINPROGRESS 以外の何かを返した時の非同期入出力操作の最終ステータスを得るためには .Fn aio_return を 1 回だけしか呼び出してはいけません。 .Sh 戻り値 非同期入出力要求が完了すると -.Xr read 2 , +.Xr read 2 , .Xr write 2 , または .Xr fsync 2 で説明したようなステータスが 返されます。処理を失敗した場合に .Fn aio_return は .Dv -1 を返し、エラー状態を指すように .Dv errno を設定します。 .Sh 関連項目 .Xr aio_cancel 2 , .Xr aio_error 2 , .Xr aio_read 2 , .Xr aio_suspend 2 , .Xr aio_write 2 , .Xr fsync 2 , .Xr read 2 , .Xr write 2 . .Sh エラー .Fn aio_return は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa iocb が未解決の非同期入出力要求を参照しません。 .El .Sh 規格 .Fn aio_return は .St -p1003.2 に準拠しています。 .Sh 歴史 .Nm 関数は .Fx 3.0 ではじめて登場しました。 .Sh 作者 このマニュアルページは .An Wes Peters Aq wes@softweyr.com が作成しました。 diff --git a/ja_JP.eucJP/man/man2/chdir.2 b/ja_JP.eucJP/man/man2/chdir.2 index 1067027c41..aeb9957ec4 100644 --- a/ja_JP.eucJP/man/man2/chdir.2 +++ b/ja_JP.eucJP/man/man2/chdir.2 @@ -1,124 +1,126 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)chdir.2 8.2 (Berkeley) 12/11/93 -.\" %FreeBSD: src/lib/libc/sys/chdir.2,v 1.6.2.1 1999/08/29 14:48:57 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/chdir.2,v 1.7.2.1 2000/04/22 17:06:49 phantom Exp % .\" .Dd December 11, 1993 .Dt CHDIR 2 .Os BSD 4 .Sh 名称 .Nm chdir , .Nm fchdir .Nd 現在の作業ディレクトリを変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn chdir "const char *path" .Ft int .Fn fchdir "int fd" .Sh 解説 .Fa path 引数は、ディレクトリのパス名を指します。 .Fn chdir -関数によって、名前付きディレクトリが -現在の作業ディレクトリになります。すなわち、スラッシュ +関数によって、指定されたディレクトリが +現在の作業ディレクトリ、すなわちスラッシュ .Ql / -で開始しないパス名のパス検索の開始点です。 +で開始しないパス名のパス検索の開始点になります。 .Pp .Fn fchdir 関数によって、 .Fa fd -が参照するディレクトリが現在の作業ディレクトリになります。 -スラッシュ +が参照するディレクトリが +現在の作業ディレクトリ (スラッシュ .Ql / -で開始するパス名のパス検索の開始点です。 +で開始しないパス名のパス検索の開始点) になります。 .Pp -ディレクトリが現在のディレクトリになるためには、 -プロセスがそのディレクトリへのアクセスを -実行 (検索) している必要があります。 +ディレクトリが現在の作業ディレクトリになるためには、 +プロセスがそのディレクトリへの +実行 (検索) アクセス許可を持っている必要があります。 .Sh 戻り値 -処理が正常に完了すると値 0 が返されます。 -それ以外の場合は、値 -1 が返されてエラーを示す +処理が正常に完了すると、値 0 が返されます。 +そうでない場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー 次の 1 つまたは複数が真の場合、 .Fn chdir -は処理を失敗し、現在の作業ディレクトリは変更されません。 +の処理は失敗し、現在の作業ディレクトリは変更されません。 .Bl -tag -width Er .It Bq Er ENOTDIR -パス接頭辞の構成要素がディレクトリでありません。 +パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT -指定のディレクトリが存在しません。 +指定されたディレクトリが存在しません。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EACCES -パス名の構成要素について検索パーミッションが拒否されました。 +パス名の構成要素のいずれかで、検索が許可されていません。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Pp -以降の 1 つまたは複数が真の場合、 +次の 1 つまたは複数が真の場合、 .Fn fchdir -は処理を失敗し、現在の作業ディレクトリは変更されません。 +の処理は失敗し、現在の作業ディレクトリは変更されません。 .Bl -tag -width Er .It Bq Er EACCES -ファイル記述子が参照するディレクトリについて検索パーミッションが拒絶されました。 +ファイル記述子が参照するディレクトリで検索が許可されていません。 .It Bq Er ENOTDIR ファイル記述子がディレクトリを参照していません。 .It Bq Er EBADF 引数 .Fa fd が有効なファイル記述子ではありません。 .El .Sh 関連項目 .Xr chroot 2 .Sh 規格 .Fn chdir 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn chdir 関数は .At v7 で登場しました。 .Fn fchdir 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/chflags.2 b/ja_JP.eucJP/man/man2/chflags.2 index 99ce5e525d..67ef47db90 100644 --- a/ja_JP.eucJP/man/man2/chflags.2 +++ b/ja_JP.eucJP/man/man2/chflags.2 @@ -1,159 +1,168 @@ .\" Copyright (c) 1989, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)chflags.2 8.3 (Berkeley) 5/2/95 -.\" %FreeBSD: src/lib/libc/sys/chflags.2,v 1.7.2.2 1999/09/18 16:18:58 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/chflags.2,v 1.11.2.4 2000/12/29 14:44:51 ru Exp % .\" .Dd May 2, 1995 .Dt CHFLAGS 2 .Os .Sh 名称 .Nm chflags , .Nm fchflags .Nd ファイルフラグを設定する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn chflags "const char *path" "u_long flags" .Ft int .Fn fchflags "int fd" "u_long flags" .Sh 解説 名前が .Fa path によって指定されるファイル、または記述子 .Fa fd によって参照されるファイルのフラグが .Fa flags に変更されます。 .Pp 指定されたフラグは次の値の論理和 (or) を取ることで作成されます。 .Pp .Bl -tag -width "SF_IMMUTABLE" -compact -offset indent .It UF_NODUMP -そのファイルはダンプしません。 +そのファイルを dump の対象外とします。 .It UF_IMMUTABLE そのファイルは変更禁止です。 .It UF_APPEND -そのファイルの末尾に追加だけが可能です。 +そのファイルは末尾への追加だけが可能です。 .It UF_NOUNLINK そのファイルは名前を変更したり削除できません。 .It UF_OPAQUE ユニオンファイルシステムのスタックを通じて見るとき、 このディレクトリは不透明です。 +.It SF_ARCHIVED +そのファイルはアーカイブ可能です。 .It SF_IMMUTABLE そのファイルは変更禁止です。 .It SF_APPEND -そのファイルの末尾に追加だけが可能です。 +そのファイルは末尾への追加だけが可能です。 .It SF_NOUNLINK そのファイルは名前を変更したり削除できません。 .El .Pp .Dq UF_IMMUTABLE , .Dq UF_APPEND , .Dq UF_NOUNLINK フラグは、ファイルの所有者またはスーパユーザのどちらかによって 設定または設定解除できます。 .Dq SF_IMMUTABLE , .Dq SF_APPEND , .Dq SF_NOUNLINK フラグは、スーパユーザだけが設定または設定解除できます。 -スーパユーザのみのフラグをスーパユーザでないものが設定しようとしても +スーパユーザのみが設定できるフラグを +スーパユーザでないものが設定しようとしても 警告なしで無視されます。これらのフラグはいつでも設定できますが、 通常は、システムがシングルユーザモードにあるときにだけ 設定解除するのが普通です (詳細については .Xr init 8 を参照してください)。 .Pp .Sh 戻り値 処理が正常に完了すると、値 0 が返されます。 そうでない場合は値 -1 が返され、エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn chflags -は以下の場合に処理を失敗します。 +の処理は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定されたファイルが存在しません。 .It Bq Er EACCES -検索パーミッションが前置パス名の構成要素について拒絶されました。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EPERM 実効ユーザ ID がファイルの所有者と一致せず、かつ、実効ユーザ ID が スーパユーザでありません。 .It Bq Er EROFS 指定されたファイルは読取り専用ファイルシステム上にあります。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .It Bq Er EOPNOTSUPP -下側のファイルシステムがファイルフラグをサポートしません。 +ファイルシステムがファイルフラグをサポートしません。 .El .Pp .Fn fchflags -は以下の場合に処理を失敗します。 +の処理は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBADF 記述子が有効ではありません。 .Pp .It Bq Er EINVAL .Fa fd がファイルではなくソケットを参照しています。 .It Bq Er EPERM 実効ユーザ ID がファイルの所有者と一致せず、 実効ユーザ ID がスーパユーザではありません。 .It Bq Er EROFS ファイルが読み取り専用システム上に存在しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 +.It Bq Er EOPNOTSUPP +ファイルシステムがファイルフラグをサポートしません。 .El .Sh 関連項目 .Xr chflags 1 , +.Xr fflagstostr 3 , +.Xr strtofflags 3 , .Xr init 8 , .Xr mount_union 8 .Pp .Sh 歴史 .Nm chflags 関数と .Nm fchflags 関数は .Bx 4.4 ではじめて登場しました。 .\" Amended by N.Kumagai, 2000-3-18 diff --git a/ja_JP.eucJP/man/man2/chmod.2 b/ja_JP.eucJP/man/man2/chmod.2 index 117ca23598..30fb9b778c 100644 --- a/ja_JP.eucJP/man/man2/chmod.2 +++ b/ja_JP.eucJP/man/man2/chmod.2 @@ -1,224 +1,230 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)chmod.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/chmod.2,v 1.12.2.3 1999/08/29 14:48:58 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/chmod.2,v 1.16.2.3 2000/12/29 14:44:51 ru Exp % .\" .Dd June 4, 1993 .Dt CHMOD 2 .Os BSD 4 .Sh 名称 .Nm chmod , .Nm fchmod , .Nm lchmod .Nd ファイルのモードを変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn chmod "const char *path" "mode_t mode" .Ft int .Fn fchmod "int fd" "mode_t mode" .Ft int .Fn lchmod "const char *path" "mode_t mode" .Sh 解説 .Fa path で指定されるか、またはファイル記述子 .Fa fd で参照されるファイルの ファイル許可ビットを .Fa mode に変更します。 .Fn chmod 関数は、プロセス所有者 (ユーザ) が .Fa path (または .Fa fd ) で指定されたファイルを所有するか、またはスーパユーザで あるかのどちらかであることを確認します。 .Fn chmod -関数はシンボリックリンク自体ではなく、リンク先に作用します。 +関数は、シンボリックリンクをたどり、 +リンク自体ではなくリンクのターゲットに作用します。 .Pp .Fa lchmod 関数は .Fn chmod に類似していますが、シンボリックリンクをたどりません。 .Pp モードは .Aq Pa sys/stat.h で定義された許可ビットマスクの論理和 .Pf ( Em or ) から作成されます: .Pp .Bd -literal -offset indent -compact #define S_IRWXU 0000700 /* 所有者用の RWX マスク */ #define S_IRUSR 0000400 /* 所有者用の R */ #define S_IWUSR 0000200 /* 所有者用の W */ #define S_IXUSR 0000100 /* 所有者用の X */ #define S_IRWXG 0000070 /* グループ用の RWX マスク */ #define S_IRGRP 0000040 /* グループ用の R */ #define S_IWGRP 0000020 /* グループ用の W */ #define S_IXGRP 0000010 /* グループ用の X */ #define S_IRWXO 0000007 /* その他用の RWX マスク */ #define S_IROTH 0000004 /* その他用の R */ #define S_IWOTH 0000002 /* その他用の W */ #define S_IXOTH 0000001 /* その他用の X */ #define S_ISUID 0004000 /* 実行時にユーザ ID を設定 */ #define S_ISGID 0002000 /* 実行時にグループ ID を設定 */ #define S_ISVTX 0001000 /* スティッキービット */ #ifndef _POSIX_SOURCE #define S_ISTXT 0001000 #endif .Ed .Pp -.Tn FreeBSD +.Fx VM システムは、実行可能モジュールについてスティッキービット .Pf ( Dv ISVTX ) を完全に無視します。 UFS をベースとしたファイルシステム (FFS, MFS, LFS) では、 スティッキービットはディレクトリにだけ設定できます。 .Pp .Dv ISVTX (`スティッキービット') が設定されているディレクトリでは、 -特権のないユーザはそのディレクトリの他のユーザのファイルを削除することも -名前を変更することもできません。 -スティッキービットは、ユーザが所有するか、 -または該当する許可のあるディレクトリについて -どのユーザでも設定できます。 -スティッキービットのプロパティの詳細については、 +特権のないユーザは、そのディレクトリ内にある他ユーザのファイルの削除、 +名前の変更ができません。 +どのユーザでも、そのユーザが所有するか適切な許可のあるディレクトリについて +スティッキービットを設定できます。 +スティッキービットの性質の詳細については、 .Xr sticky 8 を参照してください。 .Pp -あるディレクトリに ISUID (UID 設定) が設定されており、 -しかもファイルシステムをマウントする際に MNT_SUIDDIR オプションが -指定された場合、 +あるディレクトリに ISUID (set-user-id ビット) が設定されており、 +かつファイルシステムをマウントする際に MNT_SUIDDIR オプションが +指定されていた場合、 このディレクトリ内に作成される新しいファイルとサブディレクトリの所有者は、 -そのディレクトリの所有者と同じに設定されます。 -この機能が有効な場合、新しいディレクトリは親からそのビットを継承します。 -実行ビットはファイルから除去されます。 -ルートは所有者を継承する機能を利用できません。 -この動作は、ファイルへの書込みがユーザに許可される条件を変更しません。 +ディレクトリの所有者に設定されます。 +この機能が有効であるとき、新しいディレクトリは親から +ISUID ビットを継承します。実行ビットはファイルから取り除かれ、 +ファイルは root の所有とはなりません。 +この機能は、ファイルへの書込みがユーザに許可される条件を変更しません。 ファイルが作成された後の最終的な所有者の決定に影響するのみです。 -グループ継承には影響ありません。 +グループは継承されません。 .Pp -この機能は、ftp、SAMBA または netatalk 経由で PC ユーザへの +この機能は、ftp、SAMBA または netatalk 経由の PC ユーザへの ファイルサービスで使用されるよう設計されています。 これはシェルユーザにセキュリティホールを提供するので、 シェルマシン上で使用してはなりません。 特に、ホームディレクトリでは使用してはなりません。 -このオプションは、利用するためにカーネル内で SUIDDIR オプションを必要とします。 +このオプションが機能するためには、 +カーネル内に SUIDDIR オプションが必要です。 UFS ファイルシステムだけがこのオプションをサポートします。 suiddir マウントオプションの詳細については、 .Xr mount 8 を参照してください。 .Pp スーパユーザ以外のユーザによる、 -ファイルの書込みまたはファイルの所有者の変更によって setuser-id +ファイルの書込みまたはファイルの所有者の変更によって set-user-id ビットと set-group-id ビットはオフに切り替えられます。 -互換性は犠牲になりますが、これによって -set-user-id (set-group-id) ファイルを、それらが変更された場合に -set-user-id (set-group-id) が残ったままになってしまわないように -する事によって、システムはいくらか安全になります。 +互換性は犠牲になりますが、 +set-user-id (set-group-id) ビットを残したまま +ファイルが変更されるのを防ぐことで、 +システムはいくらか安全になります。 .Sh 戻り値 正常に完了すると値 0 が返されます。そうでない場合は、値 -1 が返され、 エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn chmod は次の場合に処理に失敗しファイルモードは変更されません。 .Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定されたファイルが存在しません。 .It Bq Er EACCES -前置パス名の構成要素について検索許可が拒絶されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EPERM 実効ユーザ ID がファイルの所有者と一致せず、 実効ユーザ ID がスーパユーザではありません。 .It Bq Er EROFS 指定されたファイルは読取り専用ファイルシステム上にあります。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .It Bq Er EFTYPE 実行可能モジュール上でスティッキービットを設定しようとしました。 .El .Pp .Fn fchmod は次の場合に処理を失敗します。 .Bl -tag -width Er .It Bq Er EBADF 記述子が有効ではありません。 .It Bq Er EINVAL .Fa fd がファイルではなくソケットを参照しています。 .It Bq Er EROFS ファイルが読取り専用のファイルシステム上に置かれています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr chmod 1 , .Xr chown 2 , .Xr open 2 , .Xr stat 2 , .Xr sticky 8 .Sh 規格 .Fn chmod 関数は -EFTYPE の戻りと S_ISTXT の使用法を除いて +.Er EFTYPE +が返されることと +.Dv S_ISTXT +の使用法を除けば .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn chmod 関数は .At v7 で登場しました。 .Fn fchmod 関数は .Bx 4.2 で登場しました。 .Fn lchmod 関数は .Fx 3.0 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/chown.2 b/ja_JP.eucJP/man/man2/chown.2 index 39db370e3d..90ff894cf7 100644 --- a/ja_JP.eucJP/man/man2/chown.2 +++ b/ja_JP.eucJP/man/man2/chown.2 @@ -1,165 +1,166 @@ .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)chown.2 8.4 (Berkeley) 4/19/94 -.\" %FreeBSD: src/lib/libc/sys/chown.2,v 1.11.2.1 1999/08/29 14:48:59 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/chown.2,v 1.12.2.2 2000/12/29 14:44:52 ru Exp % .\" .Dd April 19, 1994 .Dt CHOWN 2 .Os BSD 4 .Sh 名称 .Nm chown , .Nm fchown , .Nm lchown .Nd ファイルの所有者とグループを変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn chown "const char *path" "uid_t owner" "gid_t group" .Ft int .Fn fchown "int fd" "uid_t owner" "gid_t group" .Ft int .Fn lchown "const char *path" "uid_t owner" "gid_t group" .Sh 解説 .Fa path -で指定されたか、または +で指定された、または .Fa fd -で参照されたファイルの所有者 ID およびグループ ID は、 -引数 +で参照されたファイルの所有者 ID およびグループ ID を、 +引数に指定された .Fa owner -と +および .Fa group -で指定されたように変更されます。ファイルの所有者は、自分がメンバである -グループに +に変更します。ファイルの所有者は、 .Fa group -を変更できますが、 +に自分が所属している任意のグループを指定できます。しかし、 .Fa owner -変更機能はスーパユーザに限定されます。 +を変更することができるのはスーパユーザのみです。 .Pp .Fn chown -は、スーパユーザによって実行されているのでない場合、 -ファイル上の set-user-id ビットと set-group-id ビットをクリアして、 -set-user-id プログラムと set-group-id プログラムを -偶然にまたはいたずらで作成するのを防止します。 +は、スーパユーザによって実行される場合をのぞいて、 +ファイル上の set-user-id ビットと set-group-id ビットをクリアします。 +これは、set-user-id あるいは set-group-id されたプログラムが +偶然、またはいたずらで作成されるのを防止するためです。 .Fn chown -は、シンボリックリンクを追跡し、 +は、シンボリックリンクをたどり、 リンク自体ではなくリンクのターゲットに作用します。 .Pp .Fn fchown が特に便利なのは、ファイルロッキングプリミティブとともに使用するときです .Pf ( Xr flock 2 を参照)。 .Pp .Fn lchown は、 .Fn chown -に類似していますが、シンボリックリンクを追跡しません。 +に類似していますが、シンボリックリンクをたどりません。 .Pp -所有者またはグループ ID の 1 つを、 --1 と指定することで変化しないままにしておけます。 +所有者 ID またはグループ ID として -1 を指定した場合、 +その ID は変更されません。 .Sh 戻り値 操作が正常に完了すると 0 が返されます。 エラーが発生すると -1 が返され、固有のエラーコードが グローバル変数 .Va errno に設定されます。 .Sh エラー .Fn chown と .Fn lchown は、次の場合に処理を失敗して、ファイルは変更されません。 .Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定されたファイルが存在しません。 .It Bq Er EACCES -前置パス名の構成要素について検索許可が拒否されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EPERM 実効ユーザ ID がスーパユーザでありません。 .It Bq Er EROFS 指定されたファイルは読取り専用ファイルシステム上にあります。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Pp .Fn Fchown は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBADF .Fa fd が有効な記述子ではありません。 .It Bq Er EINVAL .Fa fd がファイルではなくソケットを参照しています。 .It Bq Er EPERM 実効ユーザ ID がスーパユーザではありません。 .It Bq Er EROFS 指定のファイルは読取り専用ファイルシステムに常駐しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr chgrp 1 , .Xr chmod 2 , .Xr flock 2 , .Xr chown 8 .Sh 規格 .Fn chown 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn chown 関数は .At v7 で登場しました。 .Fn fchown 関数は .Bx 4.2 で登場しました。 .Pp .Fn chown 関数は .Bx 4.4 -でシンボリックリンクを追跡するように変更されました。 +でシンボリックリンクをたどるように変更されました。 .Fn lchown 関数は、機能の欠落を補充するために .Fx 3.0 で追加されました。 diff --git a/ja_JP.eucJP/man/man2/chroot.2 b/ja_JP.eucJP/man/man2/chroot.2 index ac51dfeef2..7634e75eff 100644 --- a/ja_JP.eucJP/man/man2/chroot.2 +++ b/ja_JP.eucJP/man/man2/chroot.2 @@ -1,96 +1,124 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)chroot.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/chroot.2,v 1.7.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd June 4, 1993 .Dt CHROOT 2 .Os BSD 4.2 .Sh 名称 .Nm chroot .Nd ルートディレクトリを変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn chroot "const char *dirname" .Sh 解説 .Fa dirname -は、ASCII のナル文字で終了するディレクトリのパス名のアドレスです。 +は、ASCII のヌル文字で終了するディレクトリのパス名のアドレスです。 .Fn chroot は、 .Fa dirname -がルートディレクトリになるようにします。すなわち、 +をルートディレクトリ、すなわち、 .Ql / で開始するパス名のパス検索の -開始点です。 +開始点にします。 .Pp ディレクトリがルートディレクトリになるためには、 プロセスにそのディレクトリへの実行 (検索) 許可がなければなりません。 .Pp .Fn chroot はプロセスの現在のディレクトリに影響しないことに注意する必要があります。 .Pp -この呼び出しはスーパユーザに限定されています。 -.Sh 戻り値 +この関数を呼び出せるのはスーパユーザのみです。 +.Pp +ディレクトリを参照するオープンファイル記述子が存在する場合、 +.Fn chroot +呼び出しは sysctl 変数 +.Ql kern.chroot_allow_open_directories +の設定に従い、次のように失敗します: +.Pp +.Ql kern.chroot_allow_open_directories +が 0 に設定されている場合、ディレクトリがオープンされていれば +.Fn chroot +は常に +.Er EPERM +で失敗します。 +.Pp +.Ql kern.chroot_allow_open_directories +が 1 にセットされている場合 (デフォルト)、 +ディレクトリがオープンされていて、そのプロセスが +.Fn chroot +呼び出しの影響を受ける場合、 +.Er EPERM +で失敗します。 +.Pp +.Ql kern.chroot_allow_open_directories +が他の値の場合、オープンディレクトリのチェックはされません。 +.Pp 正常に完了すると、値 0 が返されます。そうでない場合は、値 -1 が返され、 エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn chroot は、次の場合、処理に失敗し、ルートディレクトリは変更されません。 -.Bl -tag -width [ENOTDIR] +.Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er EPERM -実効ユーザ ID がスーパユーザではありません。 +実効ユーザ ID がスーパユーザではありません。またはディレクトリが +1 つ以上のファイル記述子によってオープンされています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定のディレクトリが存在しません。 .It Bq Er EACCES -パス名のいずれかの構成要素で検索許可が拒絶されます。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr chdir 2 .Sh 歴史 .Fn chroot 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/clock_gettime.2 b/ja_JP.eucJP/man/man2/clock_gettime.2 index 0b818a5adf..3451c93a83 100644 --- a/ja_JP.eucJP/man/man2/clock_gettime.2 +++ b/ja_JP.eucJP/man/man2/clock_gettime.2 @@ -1,126 +1,128 @@ .\" $OpenBSD: clock_gettime.2,v 1.4 1997/05/08 20:21:16 kstailey Exp $ -.\" %FreeBSD: src/lib/libc/sys/clock_gettime.2,v 1.2.2.1 1999/08/29 14:48:59 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/clock_gettime.2,v 1.3.2.3 2000/12/08 13:49:31 ru Exp % .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .Dd May 8, 1997 .Dt CLOCK_GETTIME 2 .Os BSD 4 .Sh 名称 .Nm clock_gettime , .Nm clock_settime , .Nm clock_getres -.Nd 日付と時刻を取得/設定/キャリブレートする +.Nd 日付と時刻の取得/設定/精度の取得をする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn clock_gettime "clockid_t clock_id" "struct timespec *tp" .Ft int .Fn clock_settime "clockid_t clock_id" "const struct timespec *tp" .Ft int .Fn clock_getres "clockid_t clock_id" "struct timespec *tp" .Sh 解説 .Fn clock_gettime と .Fn clock_settime -によって呼び出し側プロセスは、 +は .Fa clock_id -によって -指定されるクロックが使用する値を取り出したり、設定することができます。 +で指定するクロックの値を取得、設定します。 .Pp .Fa clock_id -は、次の 3 つの値のうちの 1 つにできます。 -CLOCK_REALTIME は、普通の時計のように時間を進めます。 -CLOCK_VIRTUAL は、プロセスを呼び出す代わりに CPU がユーザモードで -実行されるときにだけ進む時間用です。 -CLOCK_PROF は、CPU がユーザモードまたはカーネルモードで実行される -ときに進む時間用です。 +には、次の 3 つの値のうちの 1 つを指定します。 +CLOCK_REALTIME は普通の時計のように進む時間、 +CLOCK_VIRTUAL は呼び出しプロセスのために CPU がユーザモードで +実行されているときにだけ進む時間、 +CLOCK_PROF は、CPU がユーザモードまたはカーネルモードで実行されている +ときに進む時間です。 .Pp .Fa tp によって指される構造体は .Ao Pa sys/time.h Ac -内に次のように示されます。 +内で次のように定義されています。 .Pp .Bd -literal struct timespec { time_t tv_sec; /* 秒 */ long tv_nsec; /* ナノ秒 */ }; .Ed .Pp -スーパーユーザだけが時刻を設定できます。 -システム安全性レベルが 1 より大きい場合 +時刻を設定できるのはスーパーユーザだけです。 +システムの安全性レベル (securelevel) が 1 より大きい場合 .Pf ( Xr init 8 -を参照) -に、時間を進めることができます。この制限は、 +を参照)、 +時間は進めることだけができます。この制限は、 悪意のあるスーパーユーザがファイルに -任意のタイムスタンプを設定するのを防止するために課せられています。 -システムが安全モードの時でも、 +任意のタイムスタンプを設定するのを防止するためのものです。 +しかし、システムが安全なモードの時でも、 .Xr adjtime 2 -システムコールを使用して後方に調整できます。 +システムコールを使用すれば +システム時間を遅らせることができてしまいます。 .Pp クロックの精度 (細かさ) は、 .Fn clock_getres 呼び出しによって返されます。この値は、 -(非NULLポインタ) +(非 NULL ポインタ) .Fa *tp -内に配置されます。 -.Sh 戻り -戻り値 0 は呼び出しが正常に完了したことを示します。戻り値 -1 は -エラーが起こったことを示し、 -この場合、エラーコードはグローバル変数 +内に格納されます。 +.Sh 戻り値 +戻り値 0 は呼び出しが正常に完了したことを示します。 +戻り値 -1 はエラーが起こったことを示し、 +エラーコードはグローバル変数 .Va errno に保存されます。 .Sh エラー 次のエラーコードが .Va errno -に設定できます。 -.Bl -tag -width [EFAULT] +に設定されます。 +.Bl -tag -width Er .It Bq Er EINVAL .Fa clock_id が有効な値ではありませんでした。 .It Bq Er EFAULT .Fa *tp -引数アドレスが無効なメモリを参照しました。 +引数アドレスが無効なメモリを参照しています。 .It Bq Er EPERM スーパユーザ以外のユーザが時刻を設定しようとしました。 .El .Sh 関連項目 .Xr date 1 , .Xr adjtime 2 , .Xr ctime 3 , .Xr timed 8 .Sh 規格 .Fn clock_gettime 等の関数は .St -p1003.1b-93 に準拠しています。 diff --git a/ja_JP.eucJP/man/man2/close.2 b/ja_JP.eucJP/man/man2/close.2 index 13d1eb1f64..fba1f29b2a 100644 --- a/ja_JP.eucJP/man/man2/close.2 +++ b/ja_JP.eucJP/man/man2/close.2 @@ -1,153 +1,157 @@ .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)close.2 8.2 (Berkeley) 4/19/94 -.\" %FreeBSD: src/lib/libc/sys/close.2,v 1.8.2.2 1999/08/29 14:48:59 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/close.2,v 1.10.2.2 2000/08/23 00:45:18 jhb Exp % .\" .Dd April 19, 1994 .Dt CLOSE 2 .Os BSD 4 .Sh 名称 .Nm close .Nd 記述子を削除する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn close "int d" .Sh 解説 .Fn close -呼び出しはプロセスごとのオブジェクト参照テーブルから記述子を削除します。 -これが下層にあるオブジェクトの最後の参照である場合、 -そのオブジェクトはアクティブでなくなります。たとえば、 -ファイルを最後に閉じる時点で、そのファイルに対応する現在の +はプロセスのオブジェクト参照テーブルから記述子を削除します。 +これがそのオブジェクトへの最後の参照だった場合、 +オブジェクトはアクティブでなくなります。たとえば、 +ファイルに対する最後のクローズで、そのファイルに結び付けられた現在の .Em seek ポインタは失われます。 .Xr socket 2 -を最後に閉じる時点で、対応する命名情報と待ち行列に -入れられたデータは破棄されます。問合せ型ロックを保持している -ファイルを最後に閉じる時点で、ロックは開放されます (さらには +に対する最後のクローズで、そのソケットに結び付けられた +命名情報と待ち行列内のデータは破棄されます。 +問合せ型ロックを保持している +ファイルに対する最後のクローズで、ロックは開放されます +(詳細は .Xr flock 2 を参照)。しかし、System V と .St -p1003.1-88 では、あるプロセスがファイルに対して保持しているすべての .Xr fcntl 2 -問合せ型レコードロックが、そのファイルについてのファイル記述子の +問合せ型レコードロックは、そのファイルについてのファイル記述子の .Em いずれか -がそのプロセスによって閉じられるときに除去されることを -規定しています。 +がそのプロセスによって閉じられるときに開放される、と規定しています。 .Pp -プロセスが終了するとき、すべての対応するファイル記述子が解放されますが、 -アクティブな記述子にはプロセスごとに制限があるので、 +プロセスが終了するとき、プロセスに結び付けられた +ファイル記述子はすべて解放されます。しかし、 +アクティブな記述子の個数にはプロセスごとに制限があるので、 大量のファイル記述子を処理するときは、 .Fn close 関数呼び出しが便利です。 .Pp プロセスがフォークするとき .Pf ( Xr fork 2 -を参照)、新しい子プロセスのすべての記述子は、 -フォークの前に親の記述子が参照しているのと同じオブジェクトを参照します。 -次に、新しいプロセスが +参照)、新しい子プロセスの記述子はすべて、 +フォークの前に親プロセスの記述子が参照していたのと同じオブジェクトを +参照します。次に、新しいプロセスが .Xr execve 2 -を使用して実行されることになる場合、 -そのプロセスは通常これらの記述子を継承します。 -ほとんどの記述子が、 +で実行される場合、そのプロセスは通常これらの記述子を継承します。 +ほとんどの記述子は .Xr execve 2 -を試みる前に +の前に .Xr dup2 2 -で再配置されるか、または +で再配置されるか、 .Fn close -で削除され得ますが、もし execve が処理に失敗する場合にこれらの記述子の -いくつかが必要だとすると、 -execve が成功した場合にそれらが閉じるように手配する必要があります。 -この理由から、呼び出し +で削除されます。もし execve が失敗した場合にこれらの記述子が +必要になるのであれば、execve が成功した場合にのみ、 +それらをクローズするようにする必要があります。 +このために、 .Dq Li fcntl(d, F_SETFD, 1) -が準備されています。これは execve が成功した後で、 -記述子が閉じるように手配します。呼び出し +呼び出しが準備されています。これは execve が成功した後で、 +記述子を閉じるように指示します。 .Dq Li fcntl(d, F_SETFD, 0) -はデフォルトを復元します。デフォルトは、記述子を閉じないというものです。 +呼び出しはこれをデフォルトに戻します。デフォルトでは、 +記述子はクローズされません。 .Sh システムの注意事項 .Pp -ノンスレッドライブラリでは、 +非スレッドライブラリでは、 .Fn close は .Va close システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va close システムコールは、 .Fn _thread_sys_close にアセンブルされ、 .Fn close -は、読取りと書込みについて -.Va d +は、読み書きについて +.Fa d をロックしてから、 .Fn _thread_sys_close を呼び出す関数として実装されています。戻る前に、 .Fn close は -.Va d +.Fa d をアンロックします。 .Sh 戻り値 処理が正常に完了すると、値 0 が返されます。そうでない場合は、 値 -1 が返され、エラーを示すために グローバル整数変数 .Va errno が設定されます。 .Sh エラー .Fn close は次の場合に失敗します: .Bl -tag -width Er .It Bq Er EBADF .Fa d -がアクティブな記述子でありません。 +がアクティブな記述子ではありません。 .It Bq Er EINTR 割り込みが受信されました。 .El .Sh 関連項目 .Xr accept 2 , .Xr execve 2 , .Xr fcntl 2 , .Xr flock 2 , .Xr open 2 , .Xr pipe 2 , .Xr socket 2 , .Xr socketpair 2 .Sh 規格 .Fn close 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn close 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/connect.2 b/ja_JP.eucJP/man/man2/connect.2 index 37e6e4d559..39a0dd0f78 100644 --- a/ja_JP.eucJP/man/man2/connect.2 +++ b/ja_JP.eucJP/man/man2/connect.2 @@ -1,166 +1,166 @@ .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)connect.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/connect.2,v 1.11.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd June 4, 1993 .Dt CONNECT 2 .Os BSD 4.2 .Sh 名称 .Nm connect .Nd ソケット上で接続を開始する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn connect "int s" "const struct sockaddr *name" "int namelen" +.Fn connect "int s" "const struct sockaddr *name" "socklen_t namelen" .Sh 解説 パラメータ .Fa s -はソケットです。これのタイプが +はソケットです。このタイプが .Dv SOCK_DGRAM -の場合、この呼び出しは、ソケットが対応付けられる -通信相手を指定します。このアドレスはデータグラムが送信される宛先であり、 -データグラムが受信される元となる -唯一のアドレスです。ソケットのタイプが +の場合、この呼び出しはソケットが結び付けられる +通信相手を指定します。このアドレスは送信データグラムの送信先であり、 +受信データグラムの送信元となる唯一のアドレスです。ソケットのタイプが .Dv SOCK_STREAM -の場合、この呼び出しは別のソケットに接続を作成 -しようとします。他のソケットは +の場合、この呼び出しは通信相手のソケットに接続を確立 +しようとします。通信相手のソケットは .Fa name で指定されます。 .Fa name -はソケットの通信空間内のアドレスです。各通信空間は +はソケット通信空間内のアドレスです。各通信空間は .Fa name パラメータを独自の方法で解釈します。一般に、ストリームソケットが正常に .Fn connect -できるのは -1 回だけです。データグラムソケットは +できるのは 1 回だけです。データグラムソケットは .Fn connect -を複数回使用してその対応を変更できます。データグラム +を複数回使用してその結び付けを変更できます。データグラム ソケットは、NULL アドレスのような無効なアドレスに接続することによって -対応付けを解除する可能性があります。 +結び付けを解除できます。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn connect は .Va connect システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va connect システムコールは .Fn _thread_sys_connect にアセンブルされ、 .Fn connect -は、読取りと書込みについて +は、読み書きについて .Va s をロックしてから .Fn _thread_sys_connect を呼び出す関数として実装されています。 .Fn _thread_sys_connect の呼び出しがブロックする場合、コンテキストスイッチが 実行されます。戻る前に .Fn connect は .Va s をアンロックします。 .Sh 戻り値 -接続またはバインドが正常に完了すると 0 が返されます。 +接続または結び付けが正常に完了すると 0 が返されます。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn connect は次の場合に失敗します。 -.Bl -tag -width EADDRNOTAVAILABB +.Bl -tag -width Er .It Bq Er EBADF .Fa s が有効な記述子でありません。 .It Bq Er ENOTSOCK .Fa s がソケットではなくファイルの記述子です。 .It Bq Er EADDRNOTAVAIL 指定のアドレスがこのマシンでは利用できません。 .It Bq Er EAFNOSUPPORT 指定のアドレスファミリ内のアドレスがこのソケットでは使用できません。 .It Bq Er EISCONN ソケットは既に接続されています。 .It Bq Er ETIMEDOUT -接続を確立せずに、接続確立が時間切れになりました。 +接続を確立することなく、タイムアウトしました。 .It Bq Er ECONNREFUSED -接続しようとする試みが強制的に拒絶されました。 +接続が強制的に拒絶されました。 .It Bq Er ENETUNREACH -このホストからネットワークにホストから到達できません。 +このホストからそのネットワークに到達できません。 .It Bq Er EADDRINUSE アドレスが既に使用中です。 .It Bq Er EFAULT .Fa name パラメータはプロセスアドレス空間の外側の領域を指定しています。 .It Bq Er EINPROGRESS -ソケットは非ブロッキングであり、コネクションがただちに完了できません。 -書込み用にソケットを選択することによって、完了用に +非ブロッキングのソケットで、接続がすぐには確立できませんでした。 +ソケットへの書込みを .Xr select 2 -を選択できます。 +で待つことによって、接続完了を待つことができます。 .It Bq Er EALREADY -ソケットはノンブロッキングであり、 -以前のコネクションの試みがまだ完了していません。 +非ブロッキングのソケットで、以前の接続の試みがまだ完了していません。 .El .Pp -以降のエラーは、UNIX ドメイン内の接続名に固有です。 +以降のエラーは、UNIX ドメインの接続名に固有です。 これらのエラーは、UNIX IPC ドメインの将来の バージョンには適用されない可能性があります。 -.Bl -tag -width EADDRNOTAVAILABB +.Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定のソケットが存在しません。 .It Bq Er EACCES -前置パス名の構成要素について検索許可が拒否されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er EACCES 指定のソケットへの書込みアクセスが拒絶されています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .El .Sh 関連項目 .Xr accept 2 , .Xr getpeername 2 , .Xr getsockname 2 , .Xr select 2 , .Xr socket 2 .Sh 歴史 .Fn connect 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/creat.2 b/ja_JP.eucJP/man/man2/creat.2 index 8f3df2a565..34fc3d80f7 100644 --- a/ja_JP.eucJP/man/man2/creat.2 +++ b/ja_JP.eucJP/man/man2/creat.2 @@ -1,62 +1,65 @@ .\" Copyright (c) 1989, 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)creat.2 8.1 (Berkeley) 6/2/93 +.\" %FreeBSD: src/lib/libc/compat-43/creat.2,v 1.6.2.1 2000/04/22 16:46:16 phantom Exp % .\" .Dd June 2, 1993 .Dt CREAT 2 .Os BSD 4 .Sh 名称 .Nm creat .Nd 新しいファイルを作成する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn creat "const char *path" "mode_t mode" .Sh 解説 .Bf -symbolic このインタフェースは .Xr open 2 によって旧式のものとなっています。 .Ef .Pp .Fn creat は次のものと同じです。 .Bd -literal -offset indent open(path, O_CREAT | O_TRUNC | O_WRONLY, mode); .Ed .Sh 関連項目 .Xr open 2 .Sh 歴史 .Fn creat 関数は .At v6 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/dup.2 b/ja_JP.eucJP/man/man2/dup.2 index bc67bf5608..961ae00ae3 100644 --- a/ja_JP.eucJP/man/man2/dup.2 +++ b/ja_JP.eucJP/man/man2/dup.2 @@ -1,200 +1,202 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)dup.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/dup.2,v 1.8.2.1 1999/08/29 14:49:00 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/dup.2,v 1.9.2.2 2000/08/23 00:45:18 jhb Exp % .\" .Dd June 4, 1993 .Dt DUP 2 .Os BSD 4 .Sh 名称 .Nm dup , .Nm dup2 -.Nd 既存のファイル記述子を複写する +.Nd 既存のファイル記述子を複製する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn dup "int oldd" .Ft int .Fn dup2 "int oldd" "int newd" .Sh 解説 .Fn dup -は既存のオブジェクト記述子を複写し、その値を呼び出しプロセスに返します +は既存のオブジェクト記述子を複製し、その値を呼び出しプロセスに返します .Fa ( newd = .Fn dup oldd ) 。 引数 .Fa oldd -は、プロセスごとの記述子テーブル内の小さい負でない整数インデックスです。 -値はテーブルのサイズ -より小さくなければなりません。テーブルのサイズは +はプロセスの記述子テーブル内のインデックスで、負でない小さな整数です。 +その値はテーブルのサイズより小さくなければなりません。 +テーブルのサイズは .Xr getdtablesize 2 -によって返されます。呼び出しによって -返される記述子は、プロセスによって現時点では使用 -されていない最も小さい番号の付いた記述子です。 +によって返されます。 +.Fn dup +呼び出しは、そのときにプロセスによって使用されていない番号のうち、 +最も小さい番号の付いた記述子を返します。 .Pp 記述子が参照するオブジェクトは .Fa oldd と .Fa newd -の間を区別しません。 -このように +をまったく区別しません。したがって .Fa newd と .Fa oldd -が開いたファイルへの重複参照の場合、 +がオープンされたファイルへの複製された参照だった場合、すべての .Xr read 2 , .Xr write 2 および .Xr lseek 2 -の各呼び出しはすべて 1 つのポインタをファイル内に移動、 -モードを末尾に追加、ノンブロッキング入出力 -および非同期入出力オプションは参照の間で共有されます。 -ファイルへの別々のポインタが必要な場合は、追加の +呼び出しは、単一のポインタをファイル内で移動します。 +追加モード、ノンブロッキング入出力 +および非同期入出力オプションは各参照の間で共有されます。 +一つのファイルへの別々のポインタが必要な場合は、追加の .Xr open 2 - 呼び出しを出すことによって、ファイルへの異なるオブジェクト参照 -を得る必要があります。新しいファイル -上の close-on-exec フラグは設定解除されます。 +を呼び出し、ファイルへの異なるオブジェクト参照を +得る必要があります。このとき、新しいファイル記述子の +close-on-exec フラグは設定解除されています。 .Pp .Fn dup2 -では新しい記述子 +には新しい記述子 .Fa newd -の値が指定されます。この記述子が既に使用されており、しかも +の値を指定します。この記述子が既に使用されていた場合、 .Fa oldd != .Fa newd -の場合に、記述子は +であれば、まずその記述子は .Xr close 2 -呼び出しが使用されたかのように最初に割り当て解除されます。 +が呼び出されたかのように割り当て解除されます。 .Fa oldd -が有効な記述子でない場合、 +が有効な記述子でなかった場合には、 .Fa newd -は閉じられません。 +はクローズされません。 .Fa oldd == .Fa newd であり、しかも .Fa oldd が有効な記述子の場合、 .Fn dup2 -は正常に完了し何もしません。 +は正常に終了し、何もしません。 .Sh システムの注意事項 .Pp -ノンスレッドライブラリ +非スレッドライブラリ .Fn dup は .Va dup システムコールとして実装されています。 .Pp スレッドライブラリの場合、 .Va dup システムコールが .Fn _thread_sys_dup にアセンブルされ、 .Fn dup -は読取りと書込み用に -.Va oldd +は読み書きについて +.Fa oldd をロックしてから、 .Fn _thread_sys_dup を呼び出す関数として実装されています。 戻る前に .Fn dup は -.Va oldd +.Fa oldd をアンロックします。 .Pp -ノンスレッドライブラリ +非スレッドライブラリ .Fn dup2 は、 .Va dup2 システムコールとして実現されます。 .Pp スレッドライブラリでは、 .Va dup2 システムコールは .Fn _thread_sys_dup2 にアセンブルされ、 .Fn dup2 -は、読取りと書込み用に -.Va oldd +は、読み書きについて +.Fa oldd と -.Va newd +.Fa newd の両方をロックしてから、 .Fn _thread_sys_dup2 を呼び出す関数として実現されます。戻る前に、 .Fn dup2 は -.Va oldd +.Fa oldd と -.Va newd +.Fa newd をアンロックします。 .Sh 戻り値 いずれかの呼び出しでエラーが起きた場合は値 -1 が返されます。 外部変数 .Va errno はエラーの原因を示します。 .Sh エラー .Fn dup と .Fn dup2 は次の場合に処理に失敗します。 .Bl -tag -width Er .It Bq Er EBADF .Fa oldd または .Fa newd -が有効なアクティブな記述子ではありません。 +が有効なアクティブ記述子ではありません。 .It Bq Er EMFILE アクティブな記述子が多すぎます。 .El .Sh 関連項目 .Xr accept 2 , .Xr close 2 , .Xr fcntl 2 , .Xr getdtablesize 2 , .Xr open 2 , .Xr pipe 2 , .Xr socket 2 , .Xr socketpair 2 .Sh 規格 .Fn dup 関数と .Fn dup2 関数は、 .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn dup 関数と .Fn dup2 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/execve.2 b/ja_JP.eucJP/man/man2/execve.2 index 3dcf666c9e..7edbeff530 100644 --- a/ja_JP.eucJP/man/man2/execve.2 +++ b/ja_JP.eucJP/man/man2/execve.2 @@ -1,287 +1,287 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)execve.2 8.5 (Berkeley) 6/1/94 -.\" %FreeBSD: src/lib/libc/sys/execve.2,v 1.11.2.4 1999/08/29 14:49:00 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/execve.2,v 1.16.2.4 2000/12/08 13:49:31 ru Exp % .\" .Dd June 1, 1994 .Dt EXECVE 2 .Os BSD 4 .Sh 名称 .Nm execve .Nd ファイルを実行する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn execve "const char *path" "char *const argv[]" "char *const envp[]" .Sh 解説 .Fn execve は呼び出しプロセスを新しいプロセスに変換します。新しいプロセスは -.Fa path -によって指される新しいプロセスファイル .Em new process file -と呼ばれる通常のファイルで構成されます。 +と呼ばれる通常のファイルに基いて構成されます。このファイルの名前は +.Fa path +によって指定されます。 このファイルは実行可能オブジェクトファイル、またはインタプリタ用の データのファイルです。実行可能オブジェクトファイルは、識別ヘッダに データのページが続いたもので構成されます。このデータは 初期プログラム (テキスト) と初期値ありデータのページを表します。 -追加のページはヘッダで指定され、0 データで初期化されます。 +追加のページはヘッダの指定によって 0 データで初期化される場合があります。 .Xr a.out 5 を参照してください。 .Pp インタプリタファイルは次の形式の行で開始します。 .Pp .Bd -filled -offset indent -compact .Sy \&#! .Em interpreter .Bq Em arg .Ed .Pp インタプリタファイルが .Sy execve されるとき、システムは実際には指定の -.Em インタプリタ +.Em interpreter を .Sy execve します。オプションの .Em arg が指定されている場合、それは -.Em インタプリタ +.Em interpreter の 1番目の引数に なり、元々の .Sy execve -で指定されたファイルは 2 番目の引数になります。それ以外では +で指定されたファイルの名前は 2 番目の引数になります。それ以外では .Sy execve で指定されたファイルの名前が 1番目の引数になります。 元々の引数はシフトされて後続の引数に -なります。0 番目の引数は -.Sy execve -されたファイルの名前で通常は変更されません。 +なります。0 番目の引数は指定された +.Em interpreter +に設定されます。 .Pp 引数 .Fa argv -は、NUL で終了する文字列を指す、NULL で終了する -文字ポインタの配列を指すポインタです。 -これらの文字列は、新しいプロセスで利用できるように引数リストを構成します。 +は、ヌルで終了する文字ポインタの配列を指すポインタです。 +各文字ポインタはヌル文字で終了する文字列を指します。 +これらの文字列は、新しいプロセスから参照できる引数リストを構成します。 少なくとも 1 つの引数が配列内に存在している必要があります。 慣習では、最初の要素が実行されたプログラムの名前になるはずです (たとえば、 .Fa path の最後の構成要素)。 .Pp 引数 .Fa envp -も、NUL で終了する文字列を指す、NULL で終了する -文字ポインタの配列を指すポインタです。 +も、ヌルで終了する文字ポインタの配列を指すポインタです。 +各文字ポインタはヌル文字で終了する文字列を指します。 この配列を指すポインタは、通常、グローバル変数 .Va environ -に保存されます。これらの文字列は、コマンドへの直接的 -引数ではない情報を新しいプロセスに渡します +に保存されます。これらの文字列は、引数としてコマンドへ直接 +渡されない情報を新しいプロセスに渡します .Pf ( Xr environ 7 を参照)。 .Pp -呼び出しプロセスイメージ内で開いているファイル記述子は、 -新しいプロセスイメージの中で開いたままです。 +呼び出しプロセスイメージ内でオープンされているファイル記述子は、 +新しいプロセスイメージの中でもオープンされたままです。 しかし、close-on-exec フラグが設定されているものは例外です。 .Pf ( Xr close 2 と .Xr fcntl 2 を参照)。 -開いたままの記述子は +オープンされたままの記述子は .Fn execve の影響を受けません。 .Pp -呼び出しプロセスで無視するよう設定されたシグナルは、 -新しいプロセス内で無視されるよう設定されます。 -呼び出しプロセスイメージ内で捕捉されるよう設定されたシグナルは、 +呼び出しプロセスで無視するように設定されたシグナルは、 +新しいプロセス内でも無視されるように設定されます。 +呼び出しプロセスイメージ内で捕捉されるように設定されたシグナルは、 新しいプロセスイメージ内でデフォルトのアクションに 設定されます。ブロックされたシグナルは、 シグナルアクションの変化とは無関係にブロックされたままになります。 -シグナルスタックは未定義であるようリセットされます (詳細については +シグナルスタックは未定義にリセットされます (詳細については .Xr sigaction 2 を参照してください)。 .Pp -新しいプロセスイメージファイルの set-user-ID モードビット +新しいプロセスイメージファイルに set-user-ID モードビット が設定されている場合 .Pf ( Xr chmod 2 を参照)、新しいプロセスイメージの実効ユーザ ID は、 新しいプロセスイメージファイルの所有者 ID に設定されます。 -新しいプロセスイメージファイルの set-group-ID モードビットが +新しいプロセスイメージファイルに set-group-ID モードビットが 設定されている場合、新しいプロセスイメージの実効グループ ID は新しい プロセスイメージファイルのグループ ID に設定されます (実効グループ ID はグループリストの最初の要素です)。 新しいプロセスの実ユーザ ID、実グループ ID、およびその他の グループ ID は、呼び出しプロセスイメージと同じになります。 set-user-ID および set-group-ID 処理の後、実効ユーザ ID は saved set-user-ID として記録され、実効グループ ID は saved set-group-ID として記録されます。 これらの値は、後で実効 ID を変更するのに使用できます .Pf ( Xr setuid 2 を参照)。 -.ne 1i .Pp 該当するファイルシステムで .Ar nosuid オプションが有効な場合、または新しいプロセスファイルがインタプリタ -ファイルの場合、set-ID ビットは尊重されません。 +ファイルの場合、set-ID ビットは意味を持ちません。 実効 ID が変更された場合、システムコールのトレースは 無効になります。 .Pp また、新しいプロセスは呼び出しプロセスから次の属性を継承します。 .Pp -.Bl -column parent_process_ID -offset indent -compact -.It process ID Ta Xr getpid 2 \ を参照 -.It parent process ID Ta Xr getppid 2 \ を参照 -.It process group ID Ta Xr getpgrp 2 \ を参照 -.It access groups Ta Xr getgroups 2 \ を参照 -.It working directory Ta Xr chdir 2 \ を参照 -.It root directory Ta Xr chroot 2 \ を参照 -.It control terminal Ta Xr termios 4 \ を参照 -.It resource usages Ta Xr getrusage 2 \ を参照 -.It interval timers Ta Xr getitimer 2 \ を参照 -.It resource limits Ta Xr getrlimit 2 \ を参照 -.It file mode mask Ta Xr umask 2 \ を参照 -.It signal mask Ta Xr sigvec 2 , +.Bl -column ファイルモードマスク -offset indent -compact +.It プロセス ID Ta Xr getpid 2 \ を参照 +.It 親プロセス ID Ta Xr getppid 2 \ を参照 +.It プロセスグループ ID Ta Xr getpgrp 2 \ を参照 +.It アクセスグループ Ta Xr getgroups 2 \ を参照 +.It 作業ディレクトリ Ta Xr chdir 2 \ を参照 +.It ルートディレクトリ Ta Xr chroot 2 \ を参照 +.It 制御端末 Ta Xr termios 4 \ を参照 +.It リソースの使用状況 Ta Xr getrusage 2 \ を参照 +.It インターバルタイマ Ta Xr getitimer 2 \ を参照 +.It リソースの使用制限 Ta Xr getrlimit 2 \ を参照 +.It ファイルモードマスク Ta Xr umask 2 \ を参照 +.It シグナルマスク Ta Xr sigvec 2 , .Xr sigsetmask 2 \ を参照 .El .Pp .Fn execve 呼び出しの結果として実行されるとき、プログラムは次のように呼び出されます。 .Bd -literal -offset indent main(argc, argv, envp) int argc; char **argv, **envp; .Ed .Pp ここで、 .Fa argc は .Fa argv の要素数 (``arg count'') であり、 .Fa argv は、引数自身を指す文字ポインタの配列を指します。 .Sh システムの注意事項 .Pp -非スレッドライブラリ +非スレッドライブラリでは、 .Fn execve は .Va execve システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va execve システムコールは .Fn _thread_sys_execve にアセンブルされ、 .Fn execve は、ユーザスレッドライブラリ再初期化を行なってから、 .Fn _thread_sys_execve を呼び出す関数として実装されています。 .Sh 戻り値 .Fn execve は現在のプロセスイメージを新しいプロセスイメージで上書きするので、 処理が成功した呼び出しには戻るプロセスがありません。 .Fn execve が呼び出しプロセスに返ってくる場合は -エラーが起きています。戻り値は -1 が返され、 +エラーが起きています。戻り値は -1 で、 エラーを示すためにグローバル変数 .Va errno が設定されます .Sh エラー 次の場合、 -.Fn Execve +.Fn execve は処理に失敗し、呼び出しプロセスに戻ります。 -.Bl -tag -width [ENAMETOOLONG] +.Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 新しいプロセスファイルが存在しません。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EACCES -前置パス名の構成要素について検索許可が拒否されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています .It Bq Er EACCES 新しいプロセスファイルが通常のファイルではありません。 .It Bq Er EACCES -新しいプロセスファイルのモードで実行許可が拒否されています。 +新しいプロセスファイルは、実行が許可されていません。 .It Bq Er ENOEXEC 新しいプロセスファイルに適切なアクセス許可がありますが、 ヘッダのマジック番号が無効です。 .It Bq Er ETXTBSY -新しいプロセスファイルは純粋な手続き (共有テキスト) ファイルですが、 -現時点で書込みまたは読取り用に開かれています。 -.ne 1i +新しいプロセスファイルは純粋な手続き (共有テキスト) ファイルで、 +現時点で他のプロセスによって書込みまたは読取り用にオープンされています。 .It Bq Er ENOMEM 新しいプロセスは、許された .Pq Xr getrlimit 2 で課された最大値 以上の仮想メモリを必要とします。 .It Bq Er E2BIG 新しいプロセスの引数リストのバイト数がシステムの課した上限を 越えています。この上限は、 .Xr sysctl 3 の MIB 変数 .Dv KERN_ARGMAX により指定されます。 .It Bq Er EFAULT 新しいプロセスファイルは、ヘッダ内のサイズ値で 示されるほど長くはありません。 .It Bq Er EFAULT .Fa path , .Fa argv , または .Fa envp が正しくないアドレスを指しています。 .It Bq Er EIO ファイルシステムから読取る間に入出力エラーが発生しました。 .El .Sh 警告 -プログラムがスーパユーザでないものに対して +スーパユーザでないものに対して .Em setuid -されていて、実 +されたプログラムが、実 .Em uid -が``root''の時に実行された場合、プログラムはスーパユーザの力の -いくらかも同時に持ちます。 +が ``root'' の時に実行された場合、プログラムは部分的に +スーパユーザの権限を持ちます。 .Sh 関連項目 .Xr ktrace 1 , .Xr _exit 2 , .Xr fork 2 , .Xr execl 3 , .Xr exit 3 , .Xr sysctl 3 , .Xr environ 7 , .Xr mount 8 .Sh 歴史 .Fn execve 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/fcntl.2 b/ja_JP.eucJP/man/man2/fcntl.2 index 9e4c00dba0..7ef77bd5db 100644 --- a/ja_JP.eucJP/man/man2/fcntl.2 +++ b/ja_JP.eucJP/man/man2/fcntl.2 @@ -1,528 +1,538 @@ .\" Copyright (c) 1983, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)fcntl.2 8.2 (Berkeley) 1/12/94 +.\" %FreeBSD: src/lib/libc/sys/fcntl.2,v 1.16.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd January 12, 1994 .Dt FCNTL 2 .Os BSD 4.2 .Sh 名称 .Nm fcntl .Nd ファイル制御 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn fcntl "int fd" "int cmd" "..." .Sh 解説 .Fn fcntl は、記述子の制御機能を提供します。引数 .Fa fd は、後述する .Fa cmd によって操作される記述子です。 .Fa cmd の値によっては、 .Nm は 3 つめの引数 .Fa "int arg" を取ることができます。 .Bl -tag -width F_GETOWNX .It Dv F_DUPFD -次のように新しい記述子を返します。 +次のような新しい記述子を返します。 .Pp .Bl -bullet -compact -offset 4n .It .Fa arg 以上で最小番号をもつ利用可能な記述子 .It -オリジナルの記述子と同じオブジェクト参照する +オリジナルの記述子と同じオブジェクトを参照 .It オブジェクトがファイルだった場合、 -新しい記述子は同じファイルオフセットを共有します。 +同じファイルオフセットを共有 .It 同じアクセスモード (読取り、書込み、または読取りと書込み) .It 同じファイルステータスフラグ (すなわち、 両方のファイル記述子が同じファイルステータス -フラグを共有します) +フラグを共有) .It -新しいファイル記述子に対応する close-on-exec フラグは、 +close-on-exec フラグは、 .Xr execve 2 システムコールの後でも -開いたままでいるように設定されます。 +記述子をオープンしたままでいるように設定 .El .It Dv F_GETFD ファイル記述子 .Fa fd -に対応する close-on-exec フラグを取得します。 +に結び付けられた close-on-exec フラグを取得します。 返された値の下位ビットが 0 の場合、ファイルは .Fn exec -を実行しても開いたままになります。そうでない場合、ファイルは +を実行してもオープンされたままになります。 +そうでない場合、ファイルは .Fn exec -の実行で閉じられます +の実行でクローズされます。 .Fa ( arg は無視されます)。 .It Dv F_SETFD .Fa fd -に対応する close-on-exec フラグを +に結び付けられた close-on-exec フラグを .Fa arg (前記のように 0 または 1) の下位ビットで指定される値に設定します。 .It Dv F_GETFL 後述するように記述子のステータスフラグを取得します .Fa ( arg は無視されます)。 .It Dv F_SETFL 記述子ステータスフラグを .Fa arg で指定される値に設定します。 .It Dv F_GETOWN 現時点で .Dv SIGIO シグナルと .Dv SIGURG シグナルを受信しているプロセス ID またはプロセスグループを取得 します。プロセスグループは負の値として返されます .Fa ( arg は無視されます)。 .It Dv F_SETOWN プロセスまたはプロセスグループが .Dv SIGIO シグナルおよび .Dv SIGURG シグナルを受信するように設定します。 プロセスグループは .Fa arg -で負数にして与えることによって指定されます。そうでない場合、 +を負数にして与えることによって指定されます。そうでない場合、 .Fa arg はプロセス ID として解釈されます。 .El .Pp .Dv F_GETFL および .Dv F_SETFL 用のフラグは次のとおりです。 .Bl -tag -width O_NONBLOCKX .It Dv O_NONBLOCK 非ブロッキング入出力。 .Xr read 2 呼び出しで読み取るべきデータが無い場合、または .Xr write 2 操作がブロックするであろう場合に、読取り呼び出しまたは書込み呼び出しはエラー .Er EAGAIN で -1 を返します。 .It Dv O_APPEND 各書込みがファイルの末尾に追加されるようにします。 .Xr open 2 の .Dv O_APPEND フラグに対応します。 .It Dv O_ASYNC たとえば、読み取るべきデータが用意できたときなど、 入出力が可能になったときに .Dv SIGIO シグナルがプロセスグループに送信されるようにします。 .El .Pp 問合せ型ファイルロックを行なうためにいくつかのコマンドが利用できます。 これらのコマンドはすべて次の構造体で操作します。 .ne 7v .Bd -literal struct flock { off_t l_start; /* 開始位置のオフセット */ off_t l_len; /* len = 0 はファイル末尾までという意味 */ pid_t l_pid; /* ロック所有者 */ short l_type; /* ロックタイプ: 読取り/書込みなど */ short l_whence; /* l_start のタイプ */ }; .Ed 問合せ型レコードロックに利用できるコマンドは次のとおりです。 .Bl -tag -width F_SETLKWX .It Dv F_GETLK 3 番めの引数 .Fa arg を .Fa "struct flock" (前記を参照) へのポインタと解釈して、それによって指定される ロック記述をブロックする最初のロックを取得します。取り出された情報は、 .Fn fcntl に渡された .Fa flock 構造体内の情報に上書きされます。 このロックが作成されるのを妨げるロックが見つからない場合は、 構造体はこの関数呼び出しによっても変更されません。 ただし、ロックタイプが .Dv F_UNLCK に設定されている場合は除きます。 .It Dv F_SETLK 3 番めの引数 .Fa arg を .Fa "struct flock" (前記を参照) へのポインタと解釈して、それによって指定される ロック記述に従ってファイルセグメントロックを設定またはクリアします。 .Dv F_SETLK は、共有 (または読取り) ロック .Dv (F_RDLCK) または排他的 (または書込み) ロック .Dv (F_WRLCK) -を確立、ならびにいずれかのタイプのロックを除去 +を確立、ならびにいずれかのタイプのロックを解除 .Dv (F_UNLCK) するのに使用されます。 共有ロックまたは排他的ロックが設定できない場合、 .Fn fcntl は .Er EAGAIN でただちに戻ります。 .It Dv F_SETLKW このコマンドは .Dv F_SETLK と同じですが、共有ロックまたは排他的ロックが他のロックによって ブロックされる場合に、 -要求を満たされるまでプロセスが待機する点が異なります。 +要求が満たされるまでプロセスが待機する点が異なります。 .Fn fcntl がある領域を確保するために待機している間に 捕捉されるべきシグナルを受信して、シグナルハンドラが .Dv SA_RESTART .Pf ( Xr sigaction 2 を参照) を 指定していない場合、 .Fn fcntl は中断されます。 .El .Pp 共有ロックがファイルのあるセグメントに設定されている場合、 他のプロセスはそのセグメントまたはその 一部に共有ロックを設定できます。共有ロックは、保護している どの領域にも、他のプロセスが排他的ロックを設定するのを防止します。 ファイル記述子が読取りアクセスで開かれていない場合、 共有ロックの要求は処理を失敗します。 .Pp -排他的ロックは、保護しているどの領域にも、他のプロセスが +排他的ロックは、保護している領域に他のプロセスが 共有ロックまたは排他的ロックを設定するのを防止します。 ファイルが書込みアクセスで開かれていない場合、 -排他的ロックの要求は処理を失敗します。 +排他的ロックの要求は失敗します。 .Pp .Fa l_whence の値は .Dv SEEK_SET , .Dv SEEK_CUR , または .Dv SEEK_END で、これらは相対オフセット .Fa l_start バイトが、それぞれファイルの先頭、現在位置、 またはファイルの末尾から測定されることを指示します。 .Fa l_len の値はロックされる連続領域のバイト数です。 .Fa l_len が負の場合の結果は未定義です。 .Fa l_pid フィールドは、 ブロックするロックを保持しているプロセスのプロセス ID を返すために .Dv F_GETLK でのみ使用されます。 .Dv F_GETLK 要求が正常に完了すると .Fa l_whence の値は .Dv SEEK_SET になります。 .Pp ロックは現在のファイル末尾以降で開始したり、 ファイル末尾を越えて延長することはできますが、 -ファイルの先頭より前で開始したりまたは延長することはできません。 +ファイルの先頭より前で開始したり、 +ファイルの先頭を越えて延長することはできません。 .Fa l_len が 0 に設定されている場合、ロックはそのファイルの ファイルオフセットの可能な最大の値まで延長されます。 .Fa l_whence と .Fa l_start がファイルの先頭を指しており、しかも .Fa l_len が 0 の場合はファイル全体がロックされます。 アプリケーションがファイル全体をロックしようとしているだけなら、 .Xr flock 2 システムコールの方がはるかに効率的です。 .Pp ファイル内の各バイトについて最大で 1 つのタイプのロックが設定されます。 呼び出しプロセスが .Dv F_SETLK 要求、または .Dv F_SETLKW 要求で指定した領域内に既存のロックを保持しているとき、 要求から正常に戻る前に、 指定の領域内の各バイトについて以前の ロックタイプが新しいロックタイプで置き換えられます。共有ロックと 排他的ロックのところで前述したように、 別のプロセスが指定の領域内にロックを保持しており、しかもそれらのロック のタイプが要求で指定されたタイプと競合するとき、 .Dv F_SETLK -要求は処理を失敗し、 +要求は失敗し、 .Dv F_SETLKW 要求はブロックします。 .Pp -あるプロセスが保持している、あるファイルと関連づけられたすべてのロックが、 -そのファイルの記述子のいずれかがそのプロセスによって閉じられた時に -解除されることを要求する、System V と +このインターフェースは、System V と .St -p1003.1-88 -の不毛なセマンティクスに、このインタフェースは完全に従っています。 +が要求する不毛なセマンティクスに完全に従っています。 +つまり、あるプロセスが保持している、 +あるファイルと結び付けられたすべてのロックは、 +そのファイルの記述子の +.Em いずれか +がそのプロセスによって +クローズされたときに解除されます。 これは、サブルーチンライブラリがアクセスする可能性のあるファイル全てを アプリケーションが認識している必要がある -ことを意味します。たとえば、パスワードファイルを更新するために -アプリケーションが、更新を行なう間に -パスワードファイルデータベースをロックしてから、レコードを取り出そうとして +ことを意味します。たとえば、パスワードファイルを更新する +アプリケーションが、更新を行なうために +パスワードファイルデータベースをロックし、 +レコードを取り出すために .Xr getpwnam 3 -を呼び出した -場合、ロックは失われます。 +を呼び出したとしましょう。 .Xr getpwnam 3 -がパスワードデータベースを開き、読み取り、そして閉じるからです。 -データベースを閉じると、ライブラリルーチン +はパスワードデータベースをオープンし、読み取り、 +そしてクローズするので、ロックは失われます。 +データベースをクローズすると、ライブラリルーチン がデータベースへのロックを要求したことがない場合でさえ、 -プロセスがデータベースに対応させたすべての -ロックが開放されます。 +プロセスがデータベースに結び付けたすべての +ロックが開放されてしまうのです。 このインタフェースの別のさほど重要でないセマンティクス上の問題は、 ロックが .Xr fork 2 関数を使用して作成された子プロセスによって継承されないことです。 .Xr flock 2 インタフェースは、はるかに合理的な last close セマンティクスを採用し、 -ロックが子プロセスによって継承できるようになっています。 +ロックが子プロセスによって継承されるようになっています。 ライブラリを使用するときにロックの整合性を確実にする、 -またはロックを子に渡したいアプリケーションについては +またはロックを子プロセスに渡したいアプリケーションについては .Xr flock 2 をお勧めします。 .Xr flock 2 と .Xr fcntl 2 ロックは同時に安全に使用できます。 .Pp -指定のプロセスの、あるファイルに対応するすべてのロックは -プロセスが終了するときに除去されます。 +プロセスの、あるファイルに結び付けられたすべてのロックは +そのプロセスが終了するときに解除されます。 .Pp あるロックした領域を制御しているプロセスが、 別のプロセスがロックした領域をロックしようとして -休眠状態にされる場合に、デッドロックの可能性が発生します。 +休眠状態にされる場合に、デッドロックが発生する可能性があります。 この実装では、ロックされた領域がアンロックされるまでの休眠が -デッドロックを起こす可能性がある事を検出し、 +デッドロックを引き起こす可能性を検出すると、 .Er EDEADLK エラーで失敗します。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn fcntl は .Va fcntl として実装されています。 .Pp スレッドライブラリでは、 .Va fcntl システムコールは .Fn _thread_sys_fcntl にアセンブルされ、 .Fn fcntl はスレッドの再スケジューリングを無効にし、読み書きについて -.Va fd +.Fa fd をロックしてから .Fn _thread_sys_fcntl を呼び出す関数として実装されています。戻る前に .Fn fcntl は -.Va fd +.Fa fd をアンロックし、スレッドスケジュールを有効にします。 .Sh 戻り値 処理が正常に完了した場合、返される値は .Fa cmd に応じて次のようになります。 .Bl -tag -width F_GETOWNX -offset indent .It Dv F_DUPFD 新しいファイル記述子 .It Dv F_GETFD フラグの値 (下位ビットだけが定義されます) .It Dv F_GETFL フラグの値 .It Dv F_GETOWN ファイル記述子所有者の値 -.It other +.It その他 \-1 以外の値 .El .Pp そうでない場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn fcntl -は次の場合に処理を失敗します。 +は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EAGAIN 引数 .Fa cmd は .Dv F_SETLK であり、ロックのタイプ .Fa (l_type) は共有ロック .Dv (F_RDLCK) 、または 排他的ロック .Dv (F_WRLCK) で、ロックされるはずのファイルの セグメントは既に別のプロセスによって排他的に ロックされています。または、タイプが排他的なロックで、 ロックされるファイルのセグメントの一部が 既に別のプロセスによって共有ロックまたは排他的ロックされています。 .It Bq Er EBADF .Fa fildes は有効なオープンファイル記述子ではありません。 .Pp 引数 .Fa cmd が .Dv F_SETLK または .Dv F_SETLKW で、かつロックタイプ .Fa (l_type) が共有ロック .Dv (F_RDLCK) -であり、 +のとき、 .Fa fildes は読取り用に開かれた有効なファイル記述子ではありません。 .Pp 引数 .Fa cmd が .Dv F_SETLK または .Dv F_SETLKW で、かつロックタイプ .Fa (l_type) が排他的ロック .Dv (F_WRLCK) -であり、 +のとき、 .Fa fildes は書込み用に開かれた有効なファイル記述子ではありません。 .It Bq Er EDEADLK 引数 .Fa cmd が .Dv F_SETLKW であり、デッドロック条件が検出されました。 .It Bq Er EINTR 引数 .Fa cmd が .Dv F_SETLKW であり、関数がシグナルによって割り込まれれました。 .It Bq Er EINVAL .Fa cmd が .Dv F_DUPFD で、 .Fa arg が負であるかまたは許容される最大値より大きくなっています .Pf ( Xr getdtablesize 2 を参照)。 .Pp 引数 .Fa cmd が .Dv F_GETLK , .Dv F_SETLK , または .Dv F_SETLKW で、 .Fa arg -が指すデータが有効でありません。または  +が指すデータが有効でありません。または .Fa fildes が、ロックをサポートしないファイルを参照しています。 .It Bq Er EMFILE 引数 .Fa cmd が .Dv F_DUPFD であり、プロセスについて許容される最大数までファイル記述子が 既に使用されています。 .Fa arg で指定された以上のファイル記述子は利用できません。 .It Bq Er ENOLCK 引数 .Fa cmd が .Dv F_SETLK または .Dv F_SETLKW であり、ロック要求またはアンロック要求を満たすことによって、 システムが課した限界を越える数のロックされた領域がシステム内に できてしまいます。 .It Bq Er EPERM .Fa cmd は、 .Dv F_SETOWN であり、引数として指定されたプロセス ID またはプロセスグループ は、呼び出し側と異なるセッション内にあります。 .It Bq Er ESRCH .Fa cmd は .Dv F_SETOWN であり、引数として指定されたプロセス ID が使用されていません。 .El .Pp さらに、 .Fa fd が (ソケット上で開いている記述子とは反対に) 端末デバイス上で開いている記述子を参照する場合、 .Fa cmd で .Dv F_SETOWN を指定すると .Xr tcsetpgrp 3 と同じ理由で処理を失敗する可能性があり、 .Xr tcgetpgrp 3 で述べたような 理由で .Fa cmd で .Dv F_GETOWN を指定した場合に処理に失敗する可能性があります。 .Sh 関連項目 .Xr close 2 , .Xr execve 2 , .Xr flock 2 , .Xr getdtablesize 2 , .Xr open 2 , .Xr sigvec 2 , .Xr tcgetpgrp 3 , .Xr tcsetpgrp 3 .Sh 歴史 .Fn fcntl 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/flock.2 b/ja_JP.eucJP/man/man2/flock.2 index bc9b1638df..62b49797a8 100644 --- a/ja_JP.eucJP/man/man2/flock.2 +++ b/ja_JP.eucJP/man/man2/flock.2 @@ -1,176 +1,180 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)flock.2 8.2 (Berkeley) 12/11/93 +.\" %FreeBSD: src/lib/libc/sys/flock.2,v 1.8.2.4 2000/12/29 14:44:52 ru Exp % .\" .Dd December 11, 1993 .Dt FLOCK 2 .Os BSD 4.2 .Sh 名称 .Nm flock .Nd "開いたファイル上の問合せ型ロックを適用または除去する" +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include -.Fd #define LOCK_SH 0x01 /* 共有ファイルロック */ -.Fd #define LOCK_EX 0x02 /* 排他的ファイルロック */ -.Fd #define LOCK_NB 0x04 /* ロックするときにブロックしない */ -.Fd #define LOCK_UN 0x08 /* ファイルをアンロックする */ +.Fd "#define LOCK_SH 0x01 /* 共有ファイルロック */" +.Fd "#define LOCK_EX 0x02 /* 排他的ファイルロック */" +.Fd "#define LOCK_NB 0x04 /* ロックするときにブロックしない */" +.Fd "#define LOCK_UN 0x08 /* ファイルをアンロックする */" .Ft int .Fn flock "int fd" "int operation" .Sh 解説 flock() は、ファイル記述子 .Fa fd に対応するファイル上の .Em 問合せ型 ロックを適用または除去します。 -ロックはパラメータの +ロックを適用するには、パラメータの .Fa operation に .Dv LOCK_SH または .Dv LOCK_EX のいずれかと、必要であれば .Dv LOCK_NB -を加えて指定することで適用されます。 +を加えて指定します。 既存のロックをアンロックする場合は .Dv operation を .Dv LOCK_UN にしてください。 .Pp -問合せ型ロックによって共同するプロセス間で -一貫したファイル操作を実現できますが、一貫性が保証される +問合せ型ロックは、協同するプロセス間での一貫したファイル操作を +可能にしますが、ファイルの一貫性を保証する ものではありません (すなわち、プロセスは問合せ型ロックを使用せずに -ファイルにアクセスできて、その結果、一貫性がなくなる可能性があります)。 +ファイルにアクセスできるので、その結果一貫性がなくなる可能性があります)。 .Pp ロックメカニズムは .Em 共有 ロックと .Em 排他的 ロックという 2 つのタイプのロックを提供します。 -いつでも複数の共有ロックを 1 つのファイルに適用できますが、 +いつでも複数の共有ロックを 1 つのファイルに適用できます。しかし、 同時に 1 つのファイルに複数の排他的ロック、 または共有ロックと排他的ロックの両方を適用することはできません。 .Pp 適切なロックのタイプを指定するだけで、共有ロックは排他的ロックに .Em アップグレード でき、排他的ロックを共有ロックに .Em ダウングレード できます。 その結果として前のロックは解放されて 新しいロックが適用されます (他のプロセスがロックを取得し 解放した後かもしれません)。 .Pp 既にロックされているオブジェクトについてロックを要求すると、 ロックが獲得できるまで呼び出し側はブロックされます。ただし .Dv LOCK_NB が .Fa operation に含まれる場合はブロックされません。代わりに呼び出しが失敗し、 エラー .Er EWOULDBLOCK が返されます。 .Sh 注 -ロックはファイルにかけられるものであってファイル記述子にではありません。 +ロックはファイルにかけられるものであって、 +ファイル記述子にかけられるものではありません。 すなわち、 .Xr dup 2 または .Xr fork 2 によって複製されたファイル記述子は、 -1 つのロックの複数のインスタンスとはならずに、1 つのロックへの複数の +ロックの複数のインスタンスとはならずに、1 つのロックへの複数の 参照になります。あるファイルについてのロックを保持しているプロセスが フォークし、子プロセスが明示的にその ファイルをアンロックする場合、親プロセスはそのロックを失います。 .Pp ロックを待ってブロックしているプロセスはシグナルで起こされるかもしれません。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn flock は .Va flock システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va flock システムコールは .Fn _thread_sys_flock にアセンブルされ、 .Fn flock は、読み書きについて -.Va fd +.Fa fd をロックしてから、 .Fn _thread_sys_flock を呼び出す関数として 実装されています。戻る前に .Fn flock は -.Va fd +.Fa fd をアンロックします。 .Sh 戻り値 -操作が正常に完了した場合は 0が返されます。そうでない場合は、 -エラー -1 が返され、 +操作が正常に完了した場合は 0が返されます。 +エラーの場合は -1 が返され、 エラーコードはグローバル変数 .Va errno に残されます。 .Sh エラー .Fn flock 呼び出しは次の場合に失敗します: -.Bl -tag -width EWOULDBLOCKAA +.Bl -tag -width Er .It Bq Er EWOULDBLOCK -ファイルはロックされており、 +ファイルはすでに .Dv LOCK_NB -オプションが指定されました。 +オプションが指定された状態でロックされています。 .It Bq Er EBADF 引数 .Fa fd が無効な記述子を指しています。 .It Bq Er EINVAL 引数 .Fa fd がファイル以外のオブジェクトを参照しています。 .It Bq Er EOPNOTSUPP 引数 .Fa fd がファイルのロックをサポートしないオブジェクトを参照しています。 .El .Sh 関連項目 .Xr close 2 , .Xr dup 2 , .Xr execve 2 , .Xr fork 2 , .Xr open 2 .Sh 歴史 .Fn flock 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getpriority.2 b/ja_JP.eucJP/man/man2/getpriority.2 index 0d26761128..d6faf4bb5b 100644 --- a/ja_JP.eucJP/man/man2/getpriority.2 +++ b/ja_JP.eucJP/man/man2/getpriority.2 @@ -1,137 +1,141 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getpriority.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/getpriority.2,v 1.4.2.1 2000/04/22 17:06:54 phantom Exp % .\" .Dd June 4, 1993 .Dt GETPRIORITY 2 .Os BSD 4 .Sh 名称 .Nm getpriority , .Nm setpriority -.Nd プログラムスケジュール優先順位を取得/設定する +.Nd プログラムスケジュール優先順位を取得 / 設定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn getpriority "int which" "int who" .Ft int .Fn setpriority "int which" "int who" "int prio" .Sh 解説 .Fa which および .Fa who で指示されるプロセス、プロセスグループ、 またはユーザのスケジュール優先順位は .Fn getpriority -呼び出しによって取得され、 +呼び出しで取得され、 .Fn setpriority 呼び出しで設定されます。 .Fa which は、 .Dv PRIO_PROCESS , .Dv PRIO_PGRP または .Dv PRIO_USER -の 1 つであり、 +のどれかであり、 .Fa who は .Fa which -に相対的に解釈されます +に関連して解釈されます .Dv ( PRIO_PROCESS の場合はプロセス識別子、 .Dv PRIO_PGRP の場合はプロセスグループ識別子、および .Dv PRIO_USER の場合はユーザ ID)。 .Fa who の値が 0 であるのは、 現在のプロセス、プロセスグループ、またはユーザを表します。 .Fa prio は -20 から 20 の範囲の値です。 デフォルトの優先順位は 0 です。 優先順位が低いと、スケジュール調整にはより都合がよくなります。 .Pp .Fn getpriority -呼び出しは、指定のプロセスのいずれかが享受する最高の優先順位を返してきます -(最も小さい数値です)。 +呼び出しは、指定のプロセスのいずれかが享受する最高の優先順位を +返してきます (最も小さい数値です)。 .Fn setpriority -呼び出しは、指定されたすべてのプロセスの優先順位を指定の値に設定します。 -スーパユーザだけが優先順位を低くできます。 +呼び出しは、指定されたすべてのプロセスの優先順位を指定の値に +設定します。スーパユーザだけが優先順位を低くできます。 .Sh 戻り値 .Fn getpriority -は処理を正しく完了しても値 -1 を返すことがあるので、呼び出しの前に外部変数 +は処理を正しく完了しても値 -1 を返すことがあるので、 +呼び出しの前に外部変数 .Va errno をクリアしてから、後にこれをチェックして -1 がエラーであるか、 -または正当な値であるか判定できます。エラーがない場合 +または正当な値であるか判定する必要があります。エラーがない場合 .Fn setpriority 呼び出しは 0 を返し、エラーがある場合は -1 を返します。 .Sh エラー .Fn getpriority と .Fn setpriority は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er ESRCH 指定された .Fa which と .Fa who の値を使用して、プロセスが見つかりませんでした。 .It Bq Er EINVAL .Fa which が .Dv PRIO_PROCESS , .Dv PRIO_PGRP または .Dv PRIO_USER のどれでもありませんでした。 .El .Pp .Bl -tag -width Er 上記のエラーだけでなく、 .Fn setpriority は次の場合に失敗します。 .It Bq Er EPERM プロセスは検出されたものの、その実効 ID も実ユーザ ID の どちらも、呼び出し側の実効ユーザ ID に一致しませんでした。 .It Bq Er EACCES スーパユーザでないものがプロセスの優先順位を下げようとしました。 .El .Sh 関連項目 .Xr nice 1 , .Xr fork 2 , .Xr renice 8 .Sh 歴史 .Fn getpriority 関数は .Bx 4.2 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getrlimit.2 b/ja_JP.eucJP/man/man2/getrlimit.2 index 4d1e908494..91df501ded 100644 --- a/ja_JP.eucJP/man/man2/getrlimit.2 +++ b/ja_JP.eucJP/man/man2/getrlimit.2 @@ -1,184 +1,191 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getrlimit.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/getrlimit.2,v 1.8.2.1 1999/08/29 14:49:02 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getrlimit.2,v 1.10.2.1 2000/04/22 17:06:55 phantom Exp % .\" .Dd June 4, 1993 .Dt GETRLIMIT 2 .Os BSD 4 .Sh 名称 .Nm getrlimit , .Nm setrlimit .Nd 最大システムリソース消費を制御する +.Sh ライブラリ +.Ld libc .Sh 書式 .Fd #include .Fd #include .Fd #include .Ft int .Fn getrlimit "int resource" "struct rlimit *rlp" .Ft int .Fn setrlimit "int resource" "const struct rlimit *rlp" .Sh 解説 現在のプロセス、およびそれが作成する各プロセスによるシステムリソースの -消費のリミットは、 +消費限度は、 .Fn getrlimit -によって得ることができ、 +呼び出しで取得することができ、 .Fn setrlimit 呼び出しで設定できます。 .Pp .Fa resource パラメータは次のうちの 1 つです。 .Bl -tag -width RLIMIT_FSIZEAA .It Li RLIMIT_CORE 作成できる .Xr core 5 ファイルの最大サイズ (バイト単位) .It Li RLIMIT_CPU 各プロセスが使用する CPU 時間の最大量 (秒単位) .It Li RLIMIT_DATA -プロセス用のデータセグメントの最大サイズ (バイト単位)。これは、プログラムが -そのブレークを +プロセス用のデータセグメントの最大サイズ (バイト単位)。 +これは、プログラムがそのブレークを .Xr sbrk 2 システムコールでどのくらい遠くまで延長できるかを定義します。 .It Li RLIMIT_FSIZE 作成できるファイルの最大サイズ (バイト単位) .It Li RLIMIT_MEMLOCK プロセスが .Xr mlock 2 関数を使用して、プロセスをメモリにロックできる 最大サイズ (バイト単位)。 .It Li RLIMIT_NOFILE このプロセスが開けるファイルの最大数 .It Li RLIMIT_NPROC このユーザ ID が同時に利用できるプロセスの最大数 .It Li RLIMIT_RSS 増加させて良いプロセスの常駐セットサイズの最大サイズ (バイト単位)。 これはプロセスに与えられる物理メモリの量に制限を課します。 メモリが逼迫してシステムがメモリを回収する際に、 宣言された常駐セットサイズを越えるプロセスを回収対象として選択します。 .It Li RLIMIT_STACK プロセスのスタックセグメントの最大サイズ (バイト数)。これによって、 -プログラムのスタックセグメントがどのくらい遠くまで延長できるか定義できます。 +プログラムのスタックセグメントをどのくらい延長できるか定義できます。 スタック延長はシステムによって自動的に実行されます。 +.It Li RLIMIT_SBSIZE +このユーザが使用できるソケットバッファの最大サイズ (バイト単位)。 +このサイズは、ユーザがいつでも保持できるネットワークメモリ量を +制限しますので、したがって mbuf の使用量も制限します。 .El .Pp -リソースリミットはソフトリミットおよびハードリミットとして指定されます。 -ソフトリミットを越えた場合、 -プロセスはシグナル (たとえば、CPU 時間またはファイルサイズを越えたかどうか) -を受信する可能性がありますが、 +リソースリミットはソフトリミットおよびハードリミットとして +指定されます。ソフトリミットを越えた場合、 +プロセスはシグナルを受信する可能性があります +(例えば、CPU 時間またはファイルサイズを越えた場合) が、 ハードリミットに到達する (またはリソースリミットを修正する) まで実行を継続することはできます。 .Em rlimit 構造体を使用してリソースのハードリミットとソフトリミットを指定できます。 - .Bd -literal -offset indent struct rlimit { rlim_t rlim_cur; /* 現在の (ソフト) リミット */ rlim_t rlim_max; /* rlim_cur の最大値 */ }; .Ed .Pp -スーパユーザだけがリミットの最大値を大きくできます。他のユーザは、0 から +スーパユーザだけがリミットの最大値を大きくできます。 +他のユーザは 0 から .Fa rlim_max の範囲内で .Fa rlim_cur を変更するか、または .Fa rlim_max -を下げられるだけです (撤回できません)。 +を下げられるだけです (撤回はできません)。 .Pp リミットを .Dq 無制限 にする値は .Dv RLIM_INFINITY として定義されます。 .Pp この情報はプロセスごとの情報に保存されるので、 -このシステムコールがシェルの作成する将来のすべての -プロセスに影響を及ぼすためには、 -このシステムコールをシェルが直接実行する必要があります。このため +シェルが将来作成するすべてのプロセスに +このシステムコールが影響を及ぼすためには、 +このシステムコールをシェルが直接実行する必要があります。 +このため .Ic limit は .Xr csh 1 -の組み込みコマンドです。 +の組み込みコマンドになっているのです。 .Pp システムは、通常の方法でリミットを超えようとするときに、 データまたはスタック空間を延長することを拒絶します。 データ空間リミットに到達すると .Xr brk 2 -呼び出しは処理に失敗します。スタックリミットに到達すると、プロセスは -セグメント化侵犯 +呼び出しは処理に失敗します。スタックリミットに到達すると、 +プロセスはセグメント例外 .Pq Dv SIGSEGV を受信します。 -シグナルスタックを使用するハンドラによってこのシグナルが捕捉されない -場合、このシグナルはプロセスを抹消します。 +シグナルスタックを使用するハンドラによって +このシグナルが捕捉されない場合、このシグナルはプロセスを抹消します。 .Pp -プロセスのソフトリミットより大きなファイルを作成するファイル入出力操作によって -書込みは処理に失敗し、シグナル +プロセスのソフトリミットより大きなファイルを +作成するファイルの入出力操作をすると書込みは失敗し、シグナル .Dv SIGXFSZ が生成されます。通常、これによってプロセスは終了しますが、 捕捉することもできます。 CPU 時間のソフトリミットを越えたとき、シグナル .Dv SIGXCPU が障害を起こしているプロセスに送信されます。 .Sh 戻り値 戻り値 0 は呼び出しが正常に完了し、リソースリミットを変更しているか、 -またはリソースリミットを返している -ことを示します。戻り値 -1 はエラーが起こったことを示し、 +またはリソースリミットを返していることを示します。 +戻り値 -1 はエラーが起こったことを示し、 エラーコードはグローバル変数 .Va errno に保存されます。 .Sh エラー .Fn getrlimit -と +および .Fn setrlimit は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EFAULT .Fa rlp -で指定したアドレスが無効です。 +で指定したアドレスが不正です。 .It Bq Er EPERM .Fn setrlimit -に指定されたリミットがリミットの最大値を上昇させようとましたが、 +に指定されたリミットがリミットの最大値を上昇させようとしましたが、 呼び出し側はスーパユーザではありません。 .El .Sh 関連項目 .Xr csh 1 , .Xr quota 1 , .Xr quotactl 2 , .Xr sigaltstack 2 , .Xr sigvec 2 , .Xr sysctl 3 .Sh 歴史 .Fn getrlimit 関数は .Bx 4.2 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getrusage.2 b/ja_JP.eucJP/man/man2/getrusage.2 index fb106813cf..193fd858cb 100644 --- a/ja_JP.eucJP/man/man2/getrusage.2 +++ b/ja_JP.eucJP/man/man2/getrusage.2 @@ -1,165 +1,174 @@ .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getrusage.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/getrusage.2,v 1.9.2.1 1999/08/29 14:49:02 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getrusage.2,v 1.10.2.2 2000/12/29 14:44:52 ru Exp % .\" .Dd June 4, 1993 .Dt GETRUSAGE 2 .Os BSD 4 .Sh 名称 .Nm getrusage .Nd リソース利用についての情報を得る +.Sh ライブラリ +.Li libc .Sh 書式 .Fd #include .Fd #include .Fd #include -.Fd #define RUSAGE_SELF 0 -.Fd #define RUSAGE_CHILDREN -1 +.Fd "#define RUSAGE_SELF 0" +.Fd "#define RUSAGE_CHILDREN -1" .Ft int .Fn getrusage "int who" "struct rusage *rusage" .Sh 解説 .Fn getrusage -は、現在のプロセス、またはそのすべての終了済みの子プロセスが使用した -リソースを記述する情報を返します。 +は、現在のプロセス、またはそのプロセスが生成して、終了済みである +すべての子プロセスが使用したリソースを詳しく説明する情報を返します。 .Fa who パラメータは .Dv RUSAGE_SELF または .Dv RUSAGE_CHILDREN のどちらかです。 .Fa rusage が指すバッファには次の構造体が入れられます。 .Bd -literal struct rusage { struct timeval ru_utime; /* 使用されたユーザ時間 */ struct timeval ru_stime; /* 使用されたシステム時間 */ long ru_maxrss; /* 最大常駐セットのサイズ */ long ru_ixrss; /* 共有テキストメモリ総サイズ */ long ru_idrss; /* 非共有データ総サイズ */ long ru_isrss; /* 非共有スタック総サイズ */ long ru_minflt; /* ページ再生数 */ long ru_majflt; /* ページフォルト */ long ru_nswap; /* スワップ */ long ru_inblock; /* ブロック入力操作 */ long ru_oublock; /* ブロック出力操作 */ long ru_msgsnd; /* 送信済みメッセージ */ long ru_msgrcv; /* 受信済みメッセージ */ long ru_nsignals; /* 受信済みシグナル */ long ru_nvcsw; /* 自発的なコンテキストスイッチ */ long ru_nivcsw; /* 非自発的なコンテキストスイッチ */ }; .Ed .Pp フィールドは次のように解釈されます。 .Bl -tag -width ru_minfltaa .It Fa ru_utime ユーザモードで処理を実行するのに費やした時間の合計 .It Fa ru_stime -(一つ以上の) プロセスのためにシステムが処理を実行するために消費した時間の合計 +(1 つ以上の) プロセスのためにシステムが処理を実行するのに +消費した時間の合計 .It Fa ru_maxrss -使用された常駐セットサイズの最大 (キロバイト単位) +使用された常駐セットサイズの最大値 (キロバイト単位) .It Fa ru_ixrss 他のプロセスとの間でも共有されていたテキストセグメント -によって使用されたメモリを示す合計値。 +によって使用されたメモリ量の +.Dq 合計 +値。 この値は「キロバイト * 実行のチック数」の単位で表現されます。 チックは統計用のクロックチックです。統計用クロックの周波数は .Fn sysconf _SC_CLOCK_TCK -チック/秒です。 +チック / 秒です。 .It Fa ru_idrss プロセスのデータセグメントに常駐している非共有メモリ量の合計値 (「キロバイト * 実行のチック数」の単位で表現されます)。 .It Fa ru_isrss プロセスのスタックセグメントに常駐している非共有メモリ量の合計値 (「キロバイト * 実行のチック数」の単位で表現されます)。 .It Fa ru_minflt 入出力アクティビティなしにサービスを受けたページフォルトの数。 -ここで、入出力アクティビティは、再割り当てを待っているページのリストから -ページフレームを再生することで回避されます。 +ここで、入出力アクティビティは、再割り当てを待っているページの +リストからページフレームを +.Dq 再生 +することで回避されます。 .It Fa ru_majflt 入出力アクティビティを必要としたサービスを受けたページフォルトの数 .It Fa ru_nswap -プロセスがメインメモリの外へスワップされた回数 +プロセスがメインメモリから +.Dq スワップ +された回数 .It Fa ru_inblock ファイルシステムが入力を実行する必要があった回数 .It Fa ru_oublock ファイルシステムが出力を実行する必要があった回数 .It Fa ru_msgsnd 送信された IPC メッセージの数 .It Fa ru_msgrcv 受信した IPC メッセージの数 .It Fa ru_nsignals 配信されたシグナルの数 .It Fa ru_nvcsw -タイムスライスが完了する前に、プロセスが自発的にプロセッサを放棄した -結果として発生したコンテキストスイッチの回数 (通常、リソースの取得を -待機するためです)。 +タイムスライスが完了する前に、プロセスが自発的にプロセッサを +放棄した結果として発生したコンテキストスイッチの回数 +(通常はリソースの取得待ちをするためです)。 .It Fa ru_nivcsw より高い優先順位プロセスが実行可能になったために、 -または現在のプロセスがそのタイムスライスを -超過したために、結果として発生したコンテキストスイッチの回数。 +または現在のプロセスがそのタイムスライスを超過したために、 +結果として発生したコンテキストスイッチの回数。 .El .Sh 注 .Fa ru_inblock と .Fa ru_oublock の値は実際の入出力だけについてのものです。 キャッシュメカニズムによって提供されるデータは、データを読取りまたは -書込みを行う最初のプロセスにだけカウントされます。 +書込みを行う最初のプロセスについてのみカウントされます。 .Sh 戻り値 処理が正常に完了すると .Fn getrusage は 0 を返します。そうでない場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn getrusage 関数は次の場合に処理を失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa who パラメータが有効な値ではありません。 .It Bq Er EFAULT .Fa rusage パラメータによって指定されるアドレスは、プロセスアドレス空間の 有効な部分内にありません。 .El .Sh 関連項目 .Xr gettimeofday 2 , .Xr wait 2 , .Xr clocks 7 .Sh バグ まだ終了していない子プロセスに関する情報を得る方法はありません。 .Sh 歴史 .Fn getrusage 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getsid.2 b/ja_JP.eucJP/man/man2/getsid.2 index 5ffa0e8d2b..51e64d688d 100644 --- a/ja_JP.eucJP/man/man2/getsid.2 +++ b/ja_JP.eucJP/man/man2/getsid.2 @@ -1,79 +1,83 @@ .\" Copyright (c) 1997 Peter Wemm .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/getsid.2,v 1.2.2.1 1999/08/29 14:49:02 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getsid.2,v 1.3.2.1 2000/04/22 17:06:55 phantom Exp % .\" .Dd August 19, 1997 .Dt GETSID 2 .Os BSD 4.2 .Sh 名称 .Nm getsid .Nd プロセスセッションを得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft pid_t .Fn getsid "pid_t pid" .Sh 解説 .Fn getsid は .Fa pid によって識別されるプロセスのセッション ID を 返します。 .Fa pid が 0 の場合、 .Fn getsid は現在のプロセスのセッション ID を返します。 .Sh 戻り値 処理が正常に完了すると、関数 .Fn getsid -は指定のプロセスのセッション ID を返します。 +は指定されたプロセスのセッション ID を返します。 そうでない場合は値 -1 が返され、エラーを示すために .Fa errno が設定されます。 .Sh エラー .Fn getsid は次の場合を除いて正常に完了します。 .Bl -tag -width Er .It Bq Er ESRCH .Fa pid で指定されたプロセス ID を持つプロセスがない場合 .El .Pp 実装によっては、この関数呼び出しを呼び出しプロセスと 同じセッション ID を持つプロセスに制限する可能性が あることに注意してください。 .Sh 関連項目 .Xr getpgid 2 , .Xr getpgrp 2 , .Xr setpgid 2 , .Xr setsid 2 , .Xr termios 4 .Sh 歴史 -.Fn setsid +.Fn getsid 関数は .Fx 3.0 -で登場しました。 +ではじめて登場しました。 .Fn getsid +.\" jp-man: getsid.2 の原文は setsid になっていました。 +.\" 2001/03/09 send-pr 済 (docs/25626) 関数呼び出しは .At V での使用法に由来しています。 diff --git a/ja_JP.eucJP/man/man2/getsockname.2 b/ja_JP.eucJP/man/man2/getsockname.2 index 142cfbcf3a..6f6542c2f3 100644 --- a/ja_JP.eucJP/man/man2/getsockname.2 +++ b/ja_JP.eucJP/man/man2/getsockname.2 @@ -1,110 +1,117 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getsockname.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/getsockname.2,v 1.9.2.4 2000/08/23 00:45:18 jhb Exp % .\" .Dd June 4, 1993 .Dt GETSOCKNAME 2 .Os BSD 4.2 .Sh 名称 .Nm getsockname .Nd ソケットの名前を得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn getsockname "int s" "struct sockaddr *name" "int *namelen" +.Fn getsockname "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh 解説 .Fn getsockname は指定のソケットについて現在の .Fa name を返します。 .Fa namelen パラメータは、 .Fa name -が指す空間の量を示すように初期化しておく必要があります。戻る時には -返された名前の実際のサイズ (バイト単位) が入ります。 +が指す空間の量を示すように初期化しておく必要があります。 +戻る時には返された名前の実際のサイズ (バイト単位) が入ります。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn getsockname は .Va getsockname システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va getsockname システムコールは .Fn _thread_sys_getsockname にアセンブルされ、 .Fn getsockname は、読み書きについて -.Va fd +.Fa fd をロックしてから .Fn _thread_sys_getsockname -を呼び出す -関数として実装されています。戻る前に +を呼び出す関数として実装されています。戻る前に .Fn getsockname は -.Va fd +.Fa fd をアンロックします。 .Sh 戻り値 -呼び出しが正常に完了すると 0 が返され、処理に失敗すると -1 が返されます。 +呼び出しが正常に完了すると 0 が返され、 +処理に失敗すると -1 が返されます。 .Sh エラー 呼び出しは、次の場合を除いて正常に完了します。 -.Bl -tag -width ENOTSOCKAA +.Bl -tag -width Er .It Bq Er EBADF 引数 .Fa s が有効な記述子ではありません。 +.It Bq Er ECONNRESET +接続が通信相手によってリセットされました。 .It Bq Er ENOTSOCK 引数 .Fa s はソケットではなくファイルです。 .It Bq Er ENOBUFS 操作を実行するためにシステム内で利用できるリソースが不足しています。 .It Bq Er EFAULT .Fa name -パラメータが、プロセスアドレス空間の有効な部分内でないメモリを指しています。 +パラメータが、プロセスアドレス空間の有効な部分内でないメモリを +指しています。 .El .Sh 関連項目 .Xr bind 2 , .Xr getpeername 2 , .Xr socket 2 .Sh バグ -UNIX ドメイン内のソケットにバインドされた名前にアクセスできません。 +UNIX ドメイン内のソケットにバインドされた名前にはアクセスできません。 +この場合 .Xr getsockname は、長さが 0 の名前を返します。 .Sh 歴史 .Fn getsockname 関数は .Bx 4.2 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getsockopt.2 b/ja_JP.eucJP/man/man2/getsockopt.2 index 8b2f3b3d31..24638ba19d 100644 --- a/ja_JP.eucJP/man/man2/getsockopt.2 +++ b/ja_JP.eucJP/man/man2/getsockopt.2 @@ -1,388 +1,425 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getsockopt.2 8.4 (Berkeley) 5/2/95 -.\" %FreeBSD: src/lib/libc/sys/getsockopt.2,v 1.9.2.2 1999/08/29 14:49:03 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getsockopt.2,v 1.12.2.4 2000/08/23 00:45:19 jhb Exp % .\" .Dd May 2, 1995 .Dt GETSOCKOPT 2 .Os BSD 4.3r .Sh 名称 .Nm getsockopt , .Nm setsockopt -.Nd ソケットについてのオプションの取得と設定 +.Nd ソケットのオプションの取得と設定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn getsockopt "int s" "int level" "int optname" "void *optval" "int *optlen" +.Fn getsockopt "int s" "int level" "int optname" "void *optval" "socklen_t *optlen" .Ft int -.Fn setsockopt "int s" "int level" "int optname" "const void *optval" "int optlen" +.Fn setsockopt "int s" "int level" "int optname" "const void *optval" "socklen_t optlen" .Sh 解説 .Fn getsockopt と .Fn setsockopt -は、ソケットに対応するオプションを操作します。 -.\".Em options +は、ソケットに対応する +.Em オプション +を操作します。 オプションは複数のプロトコルレベルに存在する可能性があります。 -これらは必ず最も上の +これらは必ず最上位の .Dq ソケット レベルに存在します。 .Pp -ソケットオプションを操作するときは、オプションが常駐するレベル -およびオプションの名前を指定する -必要があります。ソケットレベルでオプションを操作するには +ソケットオプションを操作する際は、オプションが常駐するレベル +およびオプションの名前を指定する必要があります。 +ソケットレベルでオプションを操作するには .Fa level -として +を .Dv SOL_SOCKET -を指定します。 -他のレベルでオプションを操作するには、オプションを制御する該当する -プロトコルのプロトコル番号を指定します。たとえば、オプションが +として指定します。 +他のレベルでオプションを操作するには、 +オプションを制御している適切なプロトコルのプロトコル番号を指定します。 +例えば、オプションが .Tn TCP プロトコルによって解釈されることを指示するには、 .Fa level を .Tn TCP のプロトコル番号に設定する必要があります。 .Xr getprotoent 3 を参照してください。 .Pp パラメータ .Fa optval と .Fa optlen は、 .Fn setsockopt がオプション値にアクセスするために使用されます。 .Fn getsockopt の場合、これらは要求されたオプションの値が返される バッファを識別します。 .Fn getsockopt の場合、 .Fa optlen -は「値−結果」パラメータであり、初期には +は「値 - 結果」パラメータであり、初期には .Fa optval の指すバッファのサイズが入っており、戻り時に修正されて 返された値の実際のサイズを示すようになります。 オプション値を指定しないか、またはオプション値が返されない場合、 .Fa optval に NULL を指定してもかまいません。 .Pp .Fa optname および指定のオプションは、解釈されずに、 解釈用の該当プロトコルモジュールに渡されます。 インクルードファイル .Ao Pa sys/socket.h Ac には後述するソケットレベルオプション用の定義が入っています。 他のプロトコルレベルのオプションは形式と名称がさまざまです。 マニュアルのセクション 4 の該当するエントリを参照してください。 .Pp ほとんどのソケットレベルのオプションは .Fa optval 用に .Fa int パラメータを使用します。 .Fn setsockopt の場合、ブール演算を有効にするためにはパラメータは 0 でない必要があり、 オプションを無効にする場合は 0 である必要があります。 .Dv SO_LINGER は、 .Ao Pa sys/socket.h Ac で定義された .Fa struct linger パラメータを使用します。これは、 目的の状態のオプションとリンガーインターバル (後述) を指定します。 .Dv SO_SNDTIMEO と .Dv SO_RCVTIMEO は、 .Ao Pa sys/time.h Ac で定義された .Fa struct timeval パラメータを使用します。 .Pp 以降のオプションがソケットレベルで認識されます。 別記した場合を除いて、各オプションが .Fn getsockopt で調べられ、 .Fn setsockopt で設定されます。 -.Bl -column SO_OOBINLINE -offset indent +.Bl -column SO_ACCEPTFILTER -offset indent .It Dv SO_DEBUG Ta "デバッグ情報の記録を有効にします" .It Dv SO_REUSEADDR Ta "ローカルアドレスの再使用を有効にします" .It Dv SO_REUSEPORT Ta "重複したアドレスとポートのバインドを有効にします" .It Dv SO_KEEPALIVE Ta "接続を保持することを有効にします" .It Dv SO_DONTROUTE Ta "発信メッセージについて経路設定バイパスを有効にします" .It Dv SO_LINGER Ta "データが存在する場合はクローズで遅延します" .It Dv SO_BROADCAST Ta "ブロードキャストメッセージを送信するパーミッションを有効にします" .It Dv SO_OOBINLINE Ta "バンド内でのバンド外データの受信を有効にします" .It Dv SO_SNDBUF Ta "出力用のバッファサイズを設定します" .It Dv SO_RCVBUF Ta "入力用のバッファサイズを設定します" .It Dv SO_SNDLOWAT Ta "出力用の最小カウントを設定します" .It Dv SO_RCVLOWAT Ta "入力用の最小カウントを設定します" .It Dv SO_SNDTIMEO Ta "出力についてのタイムアウト値を設定します" .It Dv SO_RCVTIMEO Ta "入力についてのタイムアウト値を設定します" +.It Dv SO_ACCEPTFILTER Ta "待ち受けソケットでの受け取り用フィルタを設定します" .It Dv SO_TYPE Ta "ソケットのタイプを取得します (取得のみ)" .It Dv SO_ERROR Ta "ソケットのエラーを取得してクリアします (取得のみ)" .El .Pp .Dv SO_DEBUG は下層のプロトコルモジュール内でデバッグを有効にします。 .Dv SO_REUSEADDR は、 .Xr bind 2 呼び出しで指定されたアドレスを検証するのに使用する規則で、 ローカルアドレスの再利用が可能であることを示します。 .Dv SO_REUSEPORT は、ポートをバインドする前の複数のプロセスがすべて .Dv SO_REUSEPORT を設定している場合に、 複数のプロセスによる完全に重複したバインドが可能になるようにします。 このオプションは、プログラムの複数のインスタンスそれぞれが、 バインドされたポートを宛先とする UDP/IP マルチキャストまたは ブロードキャストのデータグラムを受信できるようにします。 .Dv SO_KEEPALIVE は接続されたソケット上でメッセージの周期的な送信を有効にします。 接続された一方がこれらのメッセージに応答できない場合は 接続が破壊されていると考えられ、ソケットを使用しているプロセスは データを送信しようとするときに .Dv SIGPIPE シグナルによって通知を受けます。 .Dv SO_DONTROUTE は発信メッセージが標準の経路設定機能をバイパスする必要があることを示します。 代わりに、メッセージは、宛先アドレスのネットワーク部分に従って 該当するネットワークインタフェースに転送されます。 .Pp .Dv SO_LINGER は送信されていないメッセージがソケットの待ち行列にあり、しかも .Xr close 2 が実行される時に行なわれる処置を制御します。 ソケットがデータの信頼できる配信を確約し、しかも .Dv SO_LINGER が設定されている場合、 データを送信できるまで または情報を配信できない (リンガーインターバルと呼ばれるタイムアウト時間は、 .Dv SO_LINGER が要求されるときに .Fn setsockopt 呼び出し内で秒単位で指定されます) と判定するまで、システムはプロセスを .Xr close 2 上でブロックします。 .Dv SO_LINGER が無効の状態で .Xr close 2 が起動されると、システムは、プロセスが可能な限り迅速に処理を 継続できる方法でクローズ処理を行います。 .Pp オプション .Dv SO_BROADCAST は、ソケット上でブロードキャストデータグラムを送信するパーミッションを 要求します。ブロードキャストは、システムの初期バージョンでは特権操作でした。 バンド外のデータをサポートするプロトコルで、 .Dv SO_OOBINLINE オプションは、バンド外のデータが受信された順番で通常の データ入力待ち行列に配置されることを要求します。そして、これは .Dv MSG_OOB フラグなしに .Xr recv 2 呼び出しまたは .Xr read 2 呼び出しでアクセスできます。 常に このオプションが設定されているかのように動作する プロトコルもあります。 .Dv SO_SNDBUF と .Dv SO_RCVBUF は、それぞれ、出力および入力用に割り当てられる通常のバッファサイズを 調整するオプションです。 バッファのサイズは、高ボリューム接続のために増加することができますし、 着信データの可能なバックログを 制限するために減少させることもできます。 システムはこれらの値について 1 つの絶対最大値を設定します。この 最大値は .Xr sysctl 3 MIB 変数 .Dq Li kern.ipc.maxsockbuf によってアクセスできます。 .Pp .Dv SO_SNDLOWAT は出力操作に最小カウントを設定するオプションです。ほとんどの出力操作は、 送信用のプロトコルにデータを配信し、フロー制御のためにブロックしながら 呼び出しによって与えられたすべてのデータを処理します。 ノンブロッキング出力操作は、ブロックなしのフロー制御に従って 許容される限界までデータを処理しますが、フロー制御が 最低基準値または要求全体のいずれか小さい方を処理することを許容しない 場合はデータを処理しません。ソケットへの書込み能力を試験する .Xr select 2 操作が真で返るのは、最低基準値を処理できる場合だけです。 .Dv SO_SNDLOWAT のデフォルト値はネットワーク効率性のために -適切なサイズ、多くの場合は 1024、に設定されます。 +適切なサイズ (多くの場合は 1024) に設定されます。 .Dv SO_RCVLOWAT は入力操作の最小カウントを設定するオプションです。一般に、受信呼び出しは、 いくらかの (0 でない) データが受信されるまでブロックしてから、 -利用できる量または要求された量の少ない方とともに戻ります。 +利用できる量または要求された量のいずれか少ない方とともに戻ります。 .Dv SO_RCVLOWAT のデフォルト値は 1 です。 .Dv SO_RCVLOWAT -がもっと大きな値に設定されている場合、 -受信呼び出しのブロックは通常、最低基準値または要求された量の小さい方が -受信されるまで待機します。 +にもっと大きな値が設定されている場合、 +受信呼び出しのブロックは通常、最低基準値または +要求された量のいずれか小さい方が受信されるまで待機します。 受信呼び出しは、エラーが発生したり、シグナルが捕らえられたり、 -または受信待ち行列内の次のデータのタイプが返された -ものと異なる場合は、最低基準値より小さい値でも戻ることがあります。 - +または受信待ち行列内の次のデータのタイプが返されたものと異なる場合は、 +最低基準値より小さい値でも戻ることがあります。 .Pp .Dv SO_SNDTIMEO は出力操作についてタイムアウト値を設定するオプションです。 これは、出力操作完了の待機を制限するために使用される秒数、 マイクロ秒数を .Fa struct timeval パラメータで指定します。送信操作が -指定された時間以上ブロックされた場合、部分的なカウントで返るか、 +指定された時間以上ブロックされた場合、部分的なカウントで戻るか、 またはデータが送信されていない場合はエラー .Er EWOULDBLOCK -で返ります。現在の実装では、このタイマは追加の各データがプロトコルに +で戻ります。現在の実装では、このタイマは追加の各データがプロトコルに 配信されるたびに再起動され、これはサイズが出力用の最低基準値から 最高基準値の範囲に至る出力部分に適用されることを意味します。 .Dv SO_RCVTIMEO は入力操作についてタイムアウト値を設定するオプションです。 -これは入力操作完了の待機を -制限するために使用される秒数、マイクロ秒数を +これは入力操作完了の待機を制限するために使用される秒数、マイクロ秒数を .Fa struct timeval -パラメータで指定します。現在の実装では、このタイマーは +パラメータで指定します。現在の実装では、このタイマは 追加のデータがプロトコルによって受信されるたびに再起動されるので、 制限は実際には休止期間のタイマとなります。 追加のデータを受信することなく受信操作がこれだけの時間について -ブロックされた場合、短いカウントで返るか、 +ブロックされた場合、短いカウントで戻るか、 またはデータが受信されていない場合はエラー .Er EWOULDBLOCK -で返ります。 +で戻ります。 +.Pp +.Dv SO_ACCEPTFILTER +は、ソケット上に +.Xr accept_filter 9 +を置きます。これにより、待ち受けしているストリームソケットに +入ってくる接続が +.Xr accept 2 +に渡される前にフィルタされることになります。 +.Bd -literal +struct accept_filter_arg { + char af_name[16]; + char af_arg[256-16]; +}; +.Ed +.Pp +.Fa optval +は +.Fa struct accept_filter_arg +を指さなくてはなりません。この構造体が +.Xr accept_filter 9 +を選択、設定します。 +.Fa af_name +は、アプリケーションが待ち受けソケット上に置きたいと思っている +受け取り用フィルタの名前で埋めなくてはなりません。 +.Fa af_arg +はオプションのパラメータで、 +.Fa af_name +で指定された受け取り用フィルタに渡すことができるものです。 +これにより、ソケットに置かれる時にさらなる設定オプションを +提供します。 +NULL を +.Fa optval +中で渡すと、フィルタが削除されます。 .Pp 最後に、 .Dv SO_TYPE と .Dv SO_ERROR は .Fn getsockopt でだけ使用されるオプションです。 .Dv SO_TYPE では .Dv SOCK_STREAM のようなソケットのタイプが返ります。これは スタートアップ時にソケットを継承するようなサーバに便利です。 .Dv SO_ERROR はソケット上で延期中のエラーを返し、エラー状態をクリアします。 これは接続されたデータグラムソケット上の非同期的エラーをチェックしたり、 その他の非同期エラーをチェックするのに使用できます。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn getsockopt は .Va getsockopt システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va getsockopt システムコールは .Fn _thread_sys_getsockopt にアセンブルされ、 .Fn getsockopt は、読み書きについて -.Va s +.Fa s をロックしてから、 .Fn _thread_sys_getsockopt を呼び出す関数として実装されています。戻る前に .Fn getsockopt は -.Va s +.Fa s をアンロックします。 .Pp 非スレッドライブラリでは、 .Fn setsockopt は .Va setsockopt システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va setsockopt システムコールは .Fn _thread_sys_setsockopt にアセンブルされ、 .Fn setsockopt は、読み書きについて -.Va s +.Fa s をロックしてから、 .Fn _thread_sys_setsockopt を呼び出す関数として実装されています。戻る前に .Fn setsockopt は -.Va s +.Fa s をアンロックします。 .Sh 戻り値 呼び出しが正常に完了すると 0 が返され、処理を失敗すると -1 が返されます。 .Sh エラー 呼び出しは次の場合を除いて正常です。 -.Bl -tag -width ENOPROTOOPTAA +.Bl -tag -width Er .It Bq Er EBADF 引数 .Fa s が有効な記述子ではありません。 .It Bq Er ENOTSOCK 引数 .Fa s がソケットではなくファイルです。 .It Bq Er ENOPROTOOPT 指示されたレベルでオプションは存在しません。 .It Bq Er EFAULT .Fa optval が指すアドレスがプロセスアドレス空間の有効な部分にありません。 .Fn getsockopt では、 .Fa optlen がプロセスアドレス空間の有効な部分でない場合も、 このエラーが返される可能性があります。 .El .Sh 関連項目 .Xr ioctl 2 , .Xr socket 2 , .Xr getprotoent 3 , .Xr sysctl 3 , .Xr protocols 5 , -.Xr sysctl 8 +.Xr sysctl 8 , +.Xr accept_filter 9 .Sh バグ ソケットオプションのいくつかはシステムの低いレベルで処理される必要があります。 .Sh 歴史 .Fn getsockopt システムコールは .Bx 4.2 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/gettimeofday.2 b/ja_JP.eucJP/man/man2/gettimeofday.2 index 794f771176..49af88bd5d 100644 --- a/ja_JP.eucJP/man/man2/gettimeofday.2 +++ b/ja_JP.eucJP/man/man2/gettimeofday.2 @@ -1,127 +1,129 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)gettimeofday.2 8.2 (Berkeley) 5/26/95 -.\" %FreeBSD: src/lib/libc/sys/gettimeofday.2,v 1.7.2.2 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/gettimeofday.2,v 1.9.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd May 26, 1995 .Dt GETTIMEOFDAY 2 .Os BSD 4 .Sh 名称 .Nm gettimeofday , .Nm settimeofday -.Nd 日付および時刻を取得/設定する +.Nd 日付と時刻の取得 / 設定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn gettimeofday "struct timeval *tp" "struct timezone *tzp" .Ft int .Fn settimeofday "const struct timeval *tp" "const struct timezone *tzp" .Sh 解説 .Bf -symbolic 注記: timezone はもはや使用されません。 この情報はカーネルの外側に保持されます。 .Ef .Pp システムが保持している現在のグリニッジ時刻と現在の時間帯は .Fn gettimeofday 呼び出しから得られ、 .Fn settimeofday 呼び出しで設定されます。時刻は 1970 年 1 月 1 日の深夜 (0 時) からの秒数とマイクロ秒数で表現されます。 システムクロックの分解能はハードウェアで決まり、 時刻は継続的または .Dq チック -で更新されます。 +単位で更新されます。 .Fa tp または .Fa tzp が NULL の場合、対応する時刻情報は返されず、また設定されません。 .Pp .Fa tp と .Fa tzp の指す構造体は .Ao Pa sys/time.h Ac 内に次のように定義されています。 .Pp .Bd -literal struct timeval { long tv_sec; /* 1970年1月1日からの秒数 */ long tv_usec; /* およびマイクロ秒数 */ }; struct timezone { int tz_minuteswest; /* グリニッジから西方向への偏差 */ int tz_dsttime; /* 夏時間補正のタイプ */ }; .Ed .Pp .Fa timezone 構造体は、ローカル時間帯 (グリニッジから西向きに分単位で測定) と -フラグを含みます。フラグがゼロでない場合は、一年の適切な期間に -夏時間がローカルに適用されることを示します。 +フラグを含みます。フラグが 0 でない場合は、一年の適切な時期に +夏時間がその地域に適用されることを示します。 .Pp スーパユーザだけが時刻または時間帯を設定できます。 システムが安全モード .Pf ( Xr init 8 -を参照)で実行される場合は、時刻は進行させることだけができます。 +を参照) で実行される場合は、時刻は進めることしかできません。 この制限が課されるのは、悪意のあるスーパユーザがファイルに任意の タイムスタンプを設定するのを防止するためです。 システム時刻は、システムが安全モードにあっても .Xr adjtime 2 システムコールを使用して後方に調整できます。 -.Sh 戻り +.Sh 戻り値 戻り値 0 は呼び出しが正常に完了したことを示します。 戻り値 -1 はエラーが起こったことを示し、エラーコードはグローバル変数 .Va errno に保存されます。 .Sh エラー 次のエラーコードが .Va errno に設定されます。 -.Bl -tag -width [EFAULT] +.Bl -tag -width Er .It Bq Er EFAULT 引数アドレスが無効なメモリを参照しました。 .It Bq Er EPERM スーパユーザ以外のユーザが時刻を設定しようとしました。 .El .Sh 関連項目 .Xr date 1 , .Xr adjtime 2 , .Xr ctime 3 , .Xr clocks 7 , .Xr timed 8 .Sh 歴史 .Fn gettimeofday 関数は .Bx 4.2 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getuid.2 b/ja_JP.eucJP/man/man2/getuid.2 index 0e7f3b8930..2dd27112c4 100644 --- a/ja_JP.eucJP/man/man2/getuid.2 +++ b/ja_JP.eucJP/man/man2/getuid.2 @@ -1,85 +1,87 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)getuid.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/getuid.2,v 1.6.2.1 1999/08/29 14:49:04 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getuid.2,v 1.7.2.1 2000/04/22 17:06:56 phantom Exp % .\" .Dd June 4, 1993 .Dt GETUID 2 .Os BSD 4 .Sh 名称 .Nm getuid , .Nm geteuid .Nd ユーザ識別子を得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft uid_t .Fn getuid void .Ft uid_t .Fn geteuid void .Sh 解説 .Fn getuid 関数は、呼び出しプロセスの実ユーザ ID を返します。 .Fn geteuid 関数は、呼び出しプロセスの実効ユーザ ID を返します。 .Pp 実ユーザ ID は、プログラムを起動したユーザの ID です。 実効ユーザ ID は、 .Dq Em set-user-ID モードプロセスの実行中にプロセスに追加のパーミッションを与えるので、 .Fn getuid -を使用して呼び出しプロセスの real-user-id を把握します。 +を使用して呼び出しプロセスの実ユーザ ID を把握します。 .Sh エラー .Fn getuid 関数と .Fn geteuid 関数は必ず正常に完了するので、エラーを示すための戻り値はありません。 .Sh 関連項目 .Xr getgid 2 , .Xr issetugid 2 , .Xr setgid 2 , .Xr setreuid 2 , .Xr setuid 2 .Sh 規格 .Fn geteuid 関数と .Fn getuid 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn getuid 関数と .Fn geteuid 関数は .At v7 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/i386_get_ioperm.2 b/ja_JP.eucJP/man/man2/i386_get_ioperm.2 index 27e76f9ba0..8fc46b9eb2 100644 --- a/ja_JP.eucJP/man/man2/i386_get_ioperm.2 +++ b/ja_JP.eucJP/man/man2/i386_get_ioperm.2 @@ -1,84 +1,86 @@ .\" Copyright (c) 1998 Jonathan Lemon .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ioperm.2,v 1.2.2.1 1999/08/29 14:47:00 peter Exp % +.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ioperm.2,v 1.3.2.2 2000/05/06 13:34:09 phantom Exp % .\" .Dd July 27, 1998 .Os .Dt I386_GET_IOPERM 2 .Sh 名称 .Nm i386_get_ioperm , .Nm i386_set_ioperm .Nd i386 入出力ポート空間へのプロセスごとのアクセスを管理する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn i386_get_ioperm "unsigned int start" "unsigned int *length" "int *enable" .Ft int .Fn i386_set_ioperm "unsigned int start" "unsigned int length" "int enable" .Sh 解説 .Fn i386_get_ioperm は、プロセスの入出力ポート空間についてのパーミッションを .Fa *enable 引数内に返します。ポートの範囲は .Fa start で開始し、連続エントリの数が .Fa *length 内に返されます。 .Pp .Fn i386_set_ioperm は、 .Fa start 引数と .Fa length 引数によって記述された入出力ポートの範囲へのアクセスを .Fa enable 引数で指定された状態に設定します。 .Sh 戻り値 正常に完了すると、 .Fn i386_get_ioperm と .Fn i386_set_ioperm は値 0 を返します。そうでない場合は -1 が返され、 エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn i386_get_ioperm と .Fn i386_set_ioperm は次の場合に失敗します。 -.Bl -tag -width [EINVAL] +.Bl -tag -width Er .It Bq Er EINVAL .Fa start または .Fa length 引数に無効な範囲が指定されました。 .It Bq Er EPERM i386_set_ioperm の呼び出し側がスーパユーザではありませんでした。 .El .Sh 作者 このマニュアルページは .An Jonathan Lemon が作成しました。 diff --git a/ja_JP.eucJP/man/man2/i386_get_ldt.2 b/ja_JP.eucJP/man/man2/i386_get_ldt.2 index c810b1b502..76aa31626a 100644 --- a/ja_JP.eucJP/man/man2/i386_get_ldt.2 +++ b/ja_JP.eucJP/man/man2/i386_get_ldt.2 @@ -1,99 +1,105 @@ .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" 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. .\" .\" from: @(#)fork.2 6.5 (Berkeley) 3/10/91 -.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ldt.2,v 1.4.2.1 1999/08/29 14:47:00 peter Exp % +.\" %FreeBSD: src/lib/libc/i386/sys/i386_get_ldt.2,v 1.6.2.4 2000/12/08 13:49:27 ru Exp % .\" .Dd September 20, 1993 .Dt I386_GET_LDT 2 .Os FreeBSD .Sh 名称 .Nm i386_get_ldt , .Nm i386_set_ldt .Nd i386 プロセスごとのローカル記述子テーブルエントリを管理する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn i386_get_ldt "int start_sel" "union descriptor *descs" "int num_sels" .Ft int .Fn i386_set_ldt "int start_sel" "union descriptor *descs" "int num_sels" .Sh 解説 .Fn i386_get_ldt はプロセスの LDT の中にある i386 記述子のリストを返します。 .Fn i386_set_ldt は現在のプロセスのための i386 記述子の リストを、そのプロセスの LDT に設定します。 両方のルーチンは、開始するセレクタ番号の .Fa start_sel と、設定する記述子の入った、または記述子が返されるメモリの配列の .Fa descs および設定または返されるエントリ数の .Fa num_sels を受け取ります。 .Pp 引数 .Fa descs としては segment_descriptor または gate_descriptor のどちらかを指定でき、これらは .\".Fd .Ao Pa i386/segments.h Ac 内に定義されています。これらの構成要素は、アーキテクチャに対応して ばらばらになったビットフィールドとして定義 されているので、それらを組み立てる際には注意を払う必要があります。 +.Pp +これらの関数を使用するには、カーネルの設定ファイル中で +.Dq options USER_LDT +を指定していなければならないことに注意してください。 .Sh 戻り値 正常に完了した場合、 .Fn i386_get_ldt は現在 LDT 内にある記述子の数を返します。 .Fn i386_set_ldt は最初のセレクタセットを返します。そうでない場合は -1 が返され、 エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn i386_get_ldt と .Fn i386_set_ldt は次の場合に失敗します。 -.Bl -tag -width [EINVAL] +.Bl -tag -width Er .It Bq Er EINVAL .Fa start_sel または .Fa num_sels について不適切なパラメータが使用されました。 -.It Bq Er EACESS +.It Bq Er EACCES 呼び出し側が保護機構を欺くかまたは障害を起こす記述子を使おうとしました。 .El -.Sh 参考文献 +.Sh 関連項目 i386 Microprocessor Programmer's Reference Manual, Intel .Sh 警告 これを使用してプロセスをまったくダメにすることができます。 diff --git a/ja_JP.eucJP/man/man2/i386_vm86.2 b/ja_JP.eucJP/man/man2/i386_vm86.2 index 4e70431d3c..fcfaa891ee 100644 --- a/ja_JP.eucJP/man/man2/i386_vm86.2 +++ b/ja_JP.eucJP/man/man2/i386_vm86.2 @@ -1,99 +1,102 @@ .\" Copyright (c) 1998 Jonathan Lemon .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/i386/sys/i386_vm86.2,v 1.2.2.1 1999/08/29 14:47:03 peter Exp % +.\" %FreeBSD: src/lib/libc/i386/sys/i386_vm86.2,v 1.3.2.3 2000/12/29 14:44:46 ru Exp % .\" .Dd July 27, 1998 .Os .Dt I386_VM86 2 .Sh 名称 .Nm i386_vm86 .Nd vm86 に関連する関数を制御する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Fd #include .Ft int .Fn i386_vm86 "int function" "void *data" .Sh 解説 .Fn i386_vm86 は vm86 に関連するさまざまな関数を呼び出すのに使用します。 .Fa function は次の値の内の 1 つにできます。 .Bl -tag -offset indent -width VM86_SET_VME .It Dv VM86_INIT カーネルのプロセス用 vm86 パラメータ領域を初期化し、プロセスが vm86 呼び出しを できるようにします。 .Fa data は次の構造体を指します。 .Bd -literal struct vm86_init_args { int debug; int cpu_type; u_char int_map[32]; }; .Ed .Pp .Fa debug はデバッグコードをオンにするために使用されます。 .Fa cpu_type はエミュレート中のタイプの CPU を制御するものですが、 現時点では実装されていません。 .Fa int_map は、vm86 割り込みを vm86 モードで処理する必要があるか、またはプロセスに 反映して戻される必要があるかどうかを決定するビットマップです。 .Em N 番め のビットが設定されている場合、 割り込みはプロセスに反映されます。そうでない場合、 vm86 割り込みテーブルによってディスパッチされます。 .\" .It Dv VM86_SET_VME .\" .It Dv VM86_GET_VME .\" .It Dv VM86_INTCALL .El .Pp vm86 モードに入るには、vm86 用に正しく設定したマシンコンテキスト、そして .Em PSL_VM ビットを設定して .Xr sigreturn 2 を呼び出します。 シグナルの配信時に制御がプロセスに戻ります。 .Sh 戻り値 処理が正常に完了すると .Fn i386_vm86 は値 0 を返します。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn i386_vm86 は次の場合に失敗します。 -.Bl -tag -width [ENOMEM] +.Bl -tag -width Er .It Bq Er EINVAL カーネルに vm86 サポートがないか、または無効な関数が指定されました。 .It Bq Er ENOMEM カーネルデータ構造体を初期化するのに十分なメモリがありません。 +.El .Sh 作者 このマニュアルページは .An Jonathan Lemon が作成しました。 diff --git a/ja_JP.eucJP/man/man2/ioctl.2 b/ja_JP.eucJP/man/man2/ioctl.2 index d9c53f63ea..54d7a67d8f 100644 --- a/ja_JP.eucJP/man/man2/ioctl.2 +++ b/ja_JP.eucJP/man/man2/ioctl.2 @@ -1,140 +1,142 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)ioctl.2 8.2 (Berkeley) 12/11/93 .\" -.\" %FreeBSD: src/lib/libc/sys/ioctl.2,v 1.6.2.1 1999/08/29 14:49:05 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/ioctl.2,v 1.7.2.2 2000/05/06 13:34:14 phantom Exp % .\" .Dd December 11, 1993 .Dt IOCTL 2 .Os BSD 4 .Sh 名称 .Nm ioctl .Nd デバイスを制御する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn ioctl "int d" "unsigned long request" ... .Sh 解説 .Fn ioctl 関数は特殊ファイルの下層となっているデバイスのパラメータを操作します。 特に、キャラクタ型特殊ファイル (たとえば、端末) の多数の操作属性は .Fn ioctl で制御できます。引数 .Fa d -はオープンファイル記述子である必要があります。 +は開いているファイル記述子である必要があります。 .Pp .Nm への 3 番めの引数は従来から .Ar "char *argp" -と名前付けられています。 +と名前付けられています。しかし、 .Fx 3.0 での .Nm のほとんどの使用法では、3 番めの引数が .Ar caddr_t または .Ar int である必要があります。 .Pp ioctl の .Fa request は、引数が .Dq in -パラメータまたは +パラメータなのか .Dq out -パラメータであるかどうかと、引数 +パラメータなのかということと、引数 .Fa argp -のサイズ (バイト単位) でエンコードされます。 +のサイズ (バイト単位) をエンコードします。 ioctl の .Fa request を指定するのに使用されるマクロと定義 はファイル .Ao Pa sys/ioctl.h Ac の中にあります。 .Sh システムの注意事項 .Pp 非スレッドライブラリ .Fn ioctl は、 .Va ioctl システムコールとして実装されています。 .Pp スレッドライブラリの場合、 .Va ioctl システムコールは .Fn _thread_sys_ioctl にアセンブルされ、 .Fn ioctl は、読み書きについて .Va d をロックしてから .Fn _thread_sys_ioctl 呼び出す関数として実装されています。戻る前に .Fn ioctl は .Va d をアンロックします。 .Sh 戻り値 エラーが起きた場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn Ioctl は次の場合に失敗します。 -.Bl -tag -width [ENOTTY] +.Bl -tag -width Er .It Bq Er EBADF .Fa d が有効な記述子ではありません。 .It Bq Er ENOTTY .Fa d がキャラクタ型特殊デバイスに対応していません。 .It Bq Er ENOTTY 指定された要求は記述子 .Fa d が参照する種類のオブジェクトには適用されません。 .It Bq Er EINVAL .Fa request または .Fa argp が有効ではありません。 .El .Sh 関連項目 .Xr mt 1 , .Xr execve 2 , .Xr fcntl 2 , .Xr intro 4 , .Xr tty 4 .Sh 歴史 .Fn ioctl 関数は .At v7 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/issetugid.2 b/ja_JP.eucJP/man/man2/issetugid.2 index 9785e4c154..8520f6897c 100644 --- a/ja_JP.eucJP/man/man2/issetugid.2 +++ b/ja_JP.eucJP/man/man2/issetugid.2 @@ -1,103 +1,106 @@ .\" $OpenBSD: issetugid.2,v 1.7 1997/02/18 00:16:09 deraadt Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" -.\" %FreeBSD: src/lib/libc/sys/issetugid.2,v 1.5.2.2 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/issetugid.2,v 1.7.2.2 2000/12/12 09:55:46 ru Exp % .\" -.Dd August, 25 1996 +.Dd August 25, 1996 .Dt ISSETUGID 2 .Os .Sh 名称 .Nm issetugid .Nd 現在のプロセスの uid または gid の変化による汚染状況 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn issetugid void .Sh 解説 .Fn issetugid 関数は、プロセスの環境またはメモリアドレス空間が .Dq 汚染されている と見なされる場合 1 を返し、そうでない場合は 0 を返します。 .Pp setuid または setgid ビットのどちらかが設定されたプロセスを .Xr execve 2 -システムコールで実行した (そして結果として追加の特権が与えられた) 場合、 -あるいはプロセスの、実, 実効, 保存された、ユーザまたはグループ ID の +システムコールで実行した (そして結果として追加の特権が与えられた) +場合、あるいはプロセスの、実ユーザ ID, 実効ユーザ ID, +保存されたユーザ ID, グループ ID の いずれかが実行後に変更された場合、そのプロセスは汚染されていると 見なされます。 .Pp -このシステムコールは、ユーザから得られた情報を使用するのが安全かどうかを -ライブラリルーチン (たとえば libc や libtermcap) -が信頼性を持って判定できるようにするために存在します。 +このシステムコールは、ユーザから得られた情報を使用するのが +安全かどうかをライブラリルーチン (たとえば libc や libtermcap) が +信頼性を持って判定できるようにするために存在します。 特に .Xr getenv 3 -からの結果を、オペレーションの制御のために使用する場合には疑いを持って見る -必要があります。 +からの結果を、オペレーションの制御のために使用する場合には +疑いを持って見る必要があります。 .Pp .Dq 汚染された 状態は、 .Xr fork 2 -システムコール (または +システムコール (あるいは .Xr popen 3 -のようにフォークを呼び出す -他のライブラリコード) の結果として、子プロセスに継承されます。 +のような fork を呼び出す他のライブラリコード) の結果として、 +子プロセスに継承されます。 .Pp -別のプログラムを実行する準備をするときにすべての特権をクリアするプログラムは、 -環境もリセットすると -想定されます。したがって +別のプログラムを実行する準備をするときにすべての特権を +クリアするプログラムは、環境もリセットすると想定されます。 +したがって .Dq 汚染された 状態は引き渡されません。 setuid を開始するけれども汚染されていない プロセスを作成できる必要のある .Xr su 1 のようなプログラムにはこれは重要です。 .Sh エラー .Fn issetugid 関数は必ず正常に完了するので、エラーを示すための戻り値はありません。 .Sh 関連項目 .Xr execve 2 , .Xr fork 2 , .Xr setegid 2 , .Xr seteuid 2 , .Xr setgid 2 , .Xr setregid 2 , .Xr setreuid 2 , .Xr setuid 2 .Sh 歴史 .Fn issetugid 関数は .Ox 2.0 ではじめて登場し、 .Fx 3.0 でも実装されました。 diff --git a/ja_JP.eucJP/man/man2/kill.2 b/ja_JP.eucJP/man/man2/kill.2 index f150f3e21e..5004da9b41 100644 --- a/ja_JP.eucJP/man/man2/kill.2 +++ b/ja_JP.eucJP/man/man2/kill.2 @@ -1,148 +1,150 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)kill.2 8.3 (Berkeley) 4/19/94 -.\" %FreeBSD: src/lib/libc/sys/kill.2,v 1.7.2.3 1999/08/29 14:49:06 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/kill.2,v 1.10.2.2 2000/05/06 13:34:14 phantom Exp % .\" .Dd April 19, 1994 .Dt KILL 2 .Os BSD 4 .Sh 名称 .Nm kill .Nd プロセスにシグナルを送信する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kill "pid_t pid" "int sig" .Sh 解説 .Fn kill 関数は、 .Fa sig によって指定されたシグナルをプロセスまたはプロセスのグループである .Fa pid に送信します。 .Fa sig は、 .Xr sigaction 2 で規定されたシグナルの 1 つにすることもできますし、0 にすることもできます。 0 の場合は、エラーチェックを実行しますが、実際にシグナルは送信されません。 これを使用して .Fa pid の有効性をチェック できます。 .Pp プロセスが .Fa pid によって指定されたプロセスにシグナルを送信するパーミッションを持つためには、 受信するプロセスの実ユーザ ID または実効ユーザ ID が 送信プロセスの対応するものと一致するか、 またはユーザは該当する特権を持っている (set-user-ID で与えられた特権、 またはユーザがスーパユーザである) 必要があります。 唯一の例外はシグナル SIGCONT で、これだけは現在のプロセスの子孫に 必ず送信できます。 .Bl -tag -width Ds .\".It \&If Fa pid No \&is greater than zero : .It Fa pid No が 0 より大きい場合: .Fa sig は ID が .Fa pid に等しいプロセスに送信されます。 .\".It \&If Fa pid No \&is zero : .It Fa pid No が 0 の場合: .Fa sig はグループ ID が送信側のプロセスグループ ID と等しく、それについて プロセスがパーミッションを持っているすべてのプロセスに送信されます。これは .Xr killpg 2 の変種です。 .\".It \&If Fa pid No \&is -1 : .It Fa pid No が -1 の場合: ユーザにスーパユーザの特権がある場合、 システムプロセス .Dv ( P_SYSTEM フラグが設定されている)、ID が 1 のプロセス (通常は .Xr init 8 )、 およびシグナルを送信しているプロセスを 除くすべてのプロセスにシグナルが送信されます。 ユーザがスーパユーザでない場合、シグナルを送信しているプロセスを除く、 ユーザと同じ uid のすべてのプロセスに シグナルが送信されます。いずれかのプロセスにシグナルを送信できた場合、 エラーは返されません。 .El .Pp System V との互換性を保つために、プロセス番号が -1 以外の負数の場合、 プロセス番号の絶対値に等しいプロセスグループ ID を持つ すべてのプロセスにシグナルが 送信されます。これは .Xr killpg 2 の変種です。 .Sh 戻り値 正常に完了すると値 0 が返されます。そうでない場合は -1 が返され、 エラーを示すように .Va errno が設定されます。 .Sh エラー .Fn Kill は次の場合に処理に失敗し、シグナルは送信されません。 -.Bl -tag -width [EINVAL] +.Bl -tag -width Er .It Bq Er EINVAL .Fa sig が有効なシグナル番号ではありません。 .It Bq Er ESRCH .Fa pid で指定されたプロセスに対応するプロセスが検出できません。 .It Bq Er ESRCH プロセス ID は 0 として与えられたものの、 送信プロセスにプロセスグループがありません。 .It Bq Er EPERM 送信プロセスはスーパユーザではなく、その実効ユーザ ID が受信 プロセスの実効ユーザ ID と一致しません。 プロセスグループにシグナルを送信するとき、グループのメンバの いずれかにシグナル を送信することができない場合、このエラーが返されます。 .El .Sh 関連項目 .Xr getpgrp 2 , .Xr getpid 2 , .Xr killpg 2 , .Xr sigaction 2 , .Xr init 8 .Sh 規格 .Fn kill 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn kill 関数は .At v7 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/killpg.2 b/ja_JP.eucJP/man/man2/killpg.2 index 7c989c5ac1..3cba8e5ba7 100644 --- a/ja_JP.eucJP/man/man2/killpg.2 +++ b/ja_JP.eucJP/man/man2/killpg.2 @@ -1,95 +1,98 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)killpg.2 8.1 (Berkeley) 6/2/93 +.\" %FreeBSD: src/lib/libc/compat-43/killpg.2,v 1.6.2.1 2000/04/22 16:46:17 phantom Exp % .\" .Dd June 2, 1993 .Dt KILLPG 2 .Os BSD 4 .Sh 名称 .Nm killpg .Nd プロセスグループにシグナルを送信する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn killpg "pid_t pgrp" "int sig" .Sh 解説 .Fn killpg は、プロセスグループ .Fa pgrp にシグナル .Fa sig を送信します。シグナルのリストについては .Xr sigaction 2 を参照してください。 .Fa pgrp が 0 の場合、 .Fn killpg は、送信側プロセスのプロセスグループにシグナルを送信します。 .Pp 送信側プロセスとプロセスグループのメンバが 同じ実効ユーザ ID を持つか、 または送信側がスーパユーザである必要があります。 唯一の特殊なケースとして、継続シグナル SIGCONT は、 現在のプロセスの子孫であればどのプロセスにでも送信できます。 .Sh 戻り値 正常に完了すると 0 が返されます。そうでない場合は値 -1 が返され、 エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn killpg -は、次の場合に処理に失敗しシグナルは送信されません。 +は、次の場合に処理に失敗し、シグナルは送信されません。 .Bl -tag -width Er .It Bq Er EINVAL .Fa sig が有効なシグナル番号ではありません。 .It Bq Er ESRCH .Fa pgrp で指定したプロセスグループ内にプロセスが見つかりません。 .It Bq Er ESRCH プロセスグループとして 0 が指定されましたが、送信側プロセスに プロセスグループがありません。 .It Bq Er EPERM 送信側プロセスがスーパユーザでなく、1 つ以上のターゲットプロセスの 実効ユーザ ID が送信側プロセスの実効ユーザ ID と 異なっています。 .El .Sh 関連項目 .Xr getpgrp 2 , .Xr kill 2 , .Xr sigaction 2 .Sh 歴史 .Fn killpg 関数は .Bx 4.0 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldfind.2 b/ja_JP.eucJP/man/man2/kldfind.2 index af1d8f79c4..493088ee7b 100644 --- a/ja_JP.eucJP/man/man2/kldfind.2 +++ b/ja_JP.eucJP/man/man2/kldfind.2 @@ -1,76 +1,82 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldfind.2,v 1.3.2.4 1999/11/14 18:21:22 chris Exp % +.\" %FreeBSD: src/lib/libc/sys/kldfind.2,v 1.6.2.4 2000/12/29 14:44:52 ru Exp % .\" .Dd March 3, 1999 .Dt KLDFIND 2 .Os FreeBSD .Sh 名称 .Nm kldfind .Nd kld ファイルのファイル ID を返す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldfind "const char *file" .Sh 解説 関数 .Fn kldfind は、 -.Va file +.Fa file によって参照される kld ファイルのファイル ID を返します。 .Sh 戻り値 .Fn kldfind は、 -.Va file +.Fa file によって参照される kld ファイルのファイル ID を返します。 エラーがある場合、 .Fn kldfind は -1 を返し、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn kldfind は処理を失敗すると、 .Va errno を以下のように設定します。 .Bl -tag -width Er .It Bq Er EFAULT この操作に必要なデータがカーネル空間から読取れませんでした。 .It Bq Er ENOENT 指定されたファイルはカーネルにロードされていません。 +.El .Sh 関連項目 .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , .Xr kldunload 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 -で登場しました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldfirstmod.2 b/ja_JP.eucJP/man/man2/kldfirstmod.2 index f2c82a1a7a..66e7df6275 100644 --- a/ja_JP.eucJP/man/man2/kldfirstmod.2 +++ b/ja_JP.eucJP/man/man2/kldfirstmod.2 @@ -1,67 +1,73 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldfirstmod.2,v 1.3.2.3 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/kldfirstmod.2,v 1.5.2.4 2000/12/29 14:44:52 ru Exp % .\" .Dd March 3, 1999 .Dt KLDFIRSTMOD 2 .Os FreeBSD .Sh 名称 .Nm kldfirstmod .Nd "指定された kld ファイルから最初のモジュール ID を返す" +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldfirstmod "int fileid" .Sh 解説 .Fn kldfirstmod 関数は、 -.Va fileid +.Fa fileid によって参照された最初のモジュールに関連するモジュール ID を 返します。 .Sh 戻り値 .Fn kldfirstmod は、 -.Va fileid +.Fa fileid によって参照される最初のモジュールの ID を返し、 参照がない場合は 0 を返します。 .Sh エラー .Bl -tag -width Er .It Bq Er ENOENT -.Va fileid +.Fa fileid によって参照された kld ファイルが見つかりませんでした。 +.El .Sh 関連項目 .Xr kldfind 2 , .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , .Xr kldunload 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldload.2 b/ja_JP.eucJP/man/man2/kldload.2 index 944766de1a..3cfad0ae81 100644 --- a/ja_JP.eucJP/man/man2/kldload.2 +++ b/ja_JP.eucJP/man/man2/kldload.2 @@ -1,82 +1,87 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldload.2,v 1.3.2.3 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/kldload.2,v 1.5.2.4 2000/12/29 14:44:52 ru Exp % .\" - .Dd March 3, 1999 .Dt KLDLOAD 2 .Os FreeBSD .Sh 名称 .Nm kldload .Nd KLD ファイルをカーネルにロードする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldload "const char *file" .Sh 解説 関数 .Fn kldload は、カーネルリンカを使用してカーネル内に kld ファイルをロードします。 .Sh 戻り値 関数 .Fn kldload は、カーネル内にロードされた kld ファイルのファイル ID を返します。 エラーが発生すると .Fn kldload は -1 を返し、エラーを示すために .Va errno が設定されます。 .Sh エラー 指定されたファイルは次の場合を除いてロードされます。 .Bl -tag -width Er .It Bq Er EPERM -ファイルを読取る、またはそれをカーネルとリンクする事が -出来ません。 +ファイルを読取ることができません。 +あるいはファイルをカーネルとリンクすることができません。 .Nm kld -関数を使用するためにはルートユーザである必要があります。 +関数を使用するためには root ユーザである必要があります。 .It Bq Er EFAULT kld 情報をカーネル空間に追加するときに無効アドレスが検出されました。 .It Bq Er ENOMEM ファイルをカーネル内にロードするためのメモリがありません。 .It Bq Er ENOENT ファイルが見つかりませんでした。 .It Bq Er ENOEXEC -.Va file +.Fa file のファイル形式が認識されませんでした。 +.El .Sh 関連項目 .Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldnext 2 , .Xr kldstat 2 , .Xr kldunload 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 , .Xr kldload 8 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldnext.2 b/ja_JP.eucJP/man/man2/kldnext.2 index b2bb138a58..aab49cadd6 100644 --- a/ja_JP.eucJP/man/man2/kldnext.2 +++ b/ja_JP.eucJP/man/man2/kldnext.2 @@ -1,70 +1,77 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldnext.2,v 1.3.2.3 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/kldnext.2,v 1.5.2.3 2000/12/08 13:49:31 ru Exp % .\" .Dd March 3, 1999 .Dt KLDNEXT 2 .Os FreeBSD .Sh 名称 .Nm kldnext .Nd 次の kld ファイルのファイル ID を返す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldnext "int fileid" .Sh 解説 関数 .Fn kldnext は、次の kld ファイル (すなわち、 .Va fileid の後のファイル) のファイル ID を返します。 または .Va fileid -がロードされた最後のファイルの場合は 0 を返します。 +が最後にロードされたファイルの場合は 0 を返します。 .Sh 戻り値 .Fn kldnext は、次の kld ファイルのファイル ID または 0 を返します (解説を参照)。 エラーが発生した場合は、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn kldnext -によって設定されるエラーは ENOENT だけです。これが設定されるときは、 +によって設定されるエラーは +.Er ENOENT +だけです。これが設定されるのは、 .Va fileid -が存在しない (ロードされていない) kld ファイルを参照しているときです。 +が存在していない (ロードされていない) kld ファイルを参照しているときです。 .Sh 関連項目 .Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldstat 2 , .Xr kldunload 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldstat.2 b/ja_JP.eucJP/man/man2/kldstat.2 index f677a5025c..3a01480696 100644 --- a/ja_JP.eucJP/man/man2/kldstat.2 +++ b/ja_JP.eucJP/man/man2/kldstat.2 @@ -1,116 +1,123 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldstat.2,v 1.3.2.3 1999/09/18 16:19:00 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/kldstat.2,v 1.5.2.4 2000/12/29 14:44:52 ru Exp % .\" .Dd March 3, 1999 .Dt KLDSTAT 2 .Os FreeBSD .Sh 名称 .Nm kldstat .Nd kld ファイルの状態を得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldstat "int fileid" "struct kld_file_stat *stat" .Sh 解説 .Fn kldstat 関数は、 -.Va fileid +.Fa fileid によって参照されたファイルに関する情報を -.Va stat +.Fa stat に書込みます。 .Bd -literal struct kld_file_stat { - int version; /* sizeof(linker_file_stat) に設定する */ + int version; /* sizeof(linker_file_stat) に設定 */ char name[MAXPATHLEN]; int refs; int id; caddr_t address; /* ロードアドレス */ size_t size; /* バイト単位のサイズ */ }; .Ed .Pp .Bl -tag -width XXXaddress .It version このフィールドは、 .Fn kldstat 自体ではなく、 .Fn kldstat を呼び出すコードで前述した 構造体のサイズに設定します。 .It name -.Va fileid +.Fa fileid によって参照されるファイルの名前 .It refs -.Va fileid +.Fa fileid によって参照されるモジュールの数 .It id -.Va fileid +.Fa fileid で指定されたファイルの ID .It address kld ファイルのロードアドレス .It size ファイルのサイズ +.El .Sh 戻り値 .Fn kldstat は、必ず 0 を返すように見えます。 .Sh エラー 次の場合を除いて、 -.Va fileid +.Fa fileid が参照するファイルに関する情報は -.Va stat +.Fa stat が指す構造体に記入されます。 .Bl -tag -width Er .It Bq Er ENOENT ファイルが見つかりませんでした (おそらくロードされていないのでしょう)。 .It Bq Er EINVAL stat の -.Va version +.Fa version フィールドで指定されたバージョンが適切ではありません。 -.Va version +.Fa version フィールドに適切に記入しているのにこのエラーが起きた場合は、 ワールド、カーネル、 またはアプリケーションを再構築する必要があります。 .It Bq Er EFAULT .Fn copyout 関数で、フィールドを -.Va stat +.Fa stat にコピーする際に問題がありました。 +.El .Sh 関連項目 .Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , .Xr kldunload 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 , .Xr kldstat 8 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/kldunload.2 b/ja_JP.eucJP/man/man2/kldunload.2 index 4c242fa48e..e577d9484c 100644 --- a/ja_JP.eucJP/man/man2/kldunload.2 +++ b/ja_JP.eucJP/man/man2/kldunload.2 @@ -1,79 +1,84 @@ .\" .\" Copyright (c) 1999 Chris Costello .\" All rights reserved. .\" .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" -.\" %FreeBSD: src/lib/libc/sys/kldunload.2,v 1.3.2.4 1999/09/18 16:19:00 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/kldunload.2,v 1.6.2.4 2000/12/29 14:44:52 ru Exp % .\" - .Dd March 3, 1999 .Dt KLDUNLOAD 2 .Os FreeBSD .Sh 名称 .Nm kldunload .Nd kld ファイルをアンロードする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn kldunload "int fileid" .Sh 解説 関数 .Fn kldunload は、 .Xr kldload 2 によってリンクされていた kld ファイルをカーネルからアンロードします。 .Sh 戻り値 関数 .Fn kldunload は、 .Fn kldload によってメモリにロードされていた kld ファイルの ファイル ID を返します。エラーが発生すると .Fn kldunload は -1 を返し、エラーを示すために .Va errno が設定されます。 .Sh エラー -.Va fileid +.Fa fileid によって参照されるファイルは、次の場合を除いてアンロードされます。 .Bl -tag -width Er .It Bq Er EPERM ファイルをカーネルからアンリンク出来ません。 .It Bq Er ENOENT ファイルが見つかりませんでした。 .It Bq Er EBUSY カーネルによってリンクされたファイルをアンロードしようとしました。 +.El .Sh 関連項目 .Xr kldfind 2 , .Xr kldfirstmod 2 , .Xr kldload 2 , .Xr kldnext 2 , .Xr kldstat 2 , +.Xr modfind 2 , +.Xr modnext 2 , +.Xr modstat 2 , .Xr kld 4 , .Xr kldunload 8 .Sh 歴史 .Nm kld インタフェースは .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/ktrace.2 b/ja_JP.eucJP/man/man2/ktrace.2 index 102e6b51ef..2874731067 100644 --- a/ja_JP.eucJP/man/man2/ktrace.2 +++ b/ja_JP.eucJP/man/man2/ktrace.2 @@ -1,160 +1,166 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)ktrace.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/ktrace.2,v 1.6.2.3 1999/09/18 16:19:00 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/ktrace.2,v 1.9.2.4 2000/12/29 14:44:52 ru Exp % .\" .Dd June 4, 1993 .Dt KTRACE 2 .Os BSD 4 .Sh 名称 .Nm ktrace .Nd プロセスのトレース +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Fd #include .Fd #include .Ft int .Fn ktrace "const char *tracefile" "int ops" "int trpoints" "int pid" .Sh 解説 .Fn ktrace 関数は、1 つまたは複数のプロセスのトレースを有効または無効にします。 ユーザは自分のプロセスだけを トレースできます。スーパーユーザだけが、setuid プログラムまたは setgid プログラムをトレースできます。 .Pp -.Ar tracefile +.Fa tracefile は、トレースに使用するファイルのパス名を指定します。 ファイルは存在していなければならず、 呼び出し側プロセスによって書き込み可能な通常ファイルである必要があります。 トレースレコードはすべてファイルの末尾に追加されるので、 直前のトレースデータを切り捨てるためにはファイルの長さを 0 にする必要が あります。トレース点が無効な場合 (後述の KTROP_CLEAR を参照)、 -.Ar tracefile +.Fa tracefile は NULL にできます。 .Pp -.Nm ops +.Fa ops パラメータは要求された ktrace 操作を指定します。 定義されている操作は次のとおりです。 .Bl -column KTRFLAG_DESCENDXXX -offset indent -.It KTROP_SET trpoints で指定されたトレース点を有効にします。 -.It KTROP_CLEAR trpoints で指定されたトレース点を無効にします。 -.It KTROP_CLEARFILE すべてのトレースを停止します。 -.It KTRFLAG_DESCEND トレースの変更が、指定のプロセスとその現在の +.It "KTROP_SET " +.Fa trpoints +で指定されたトレース点を有効にします。 +.It "KTROP_CLEAR " +.Fa trpoints +で指定されたトレース点を無効にします。 +.It "KTROP_CLEARFILE すべてのトレースを停止します。" +.It "KTRFLAG_DESCEND トレースの変更が、指定のプロセスとその現在の" すべての子プロセスに適用されます。 .El .Pp -.Nm trpoints +.Fa trpoints パラメータは関心のあるトレース点を指定します。 定義されているトレース点は次のとおりです。 .Bl -column KTRFAC_SYSCALLXXX -offset indent -.It KTRFAC_SYSCALL システムコールをトレースします。 -.It KTRFAC_SYSRET システムコールからの戻り値をトレースします。 -.It KTRFAC_NAMEI パス名の探索操作をトレースします。 -.It KTRFAC_GENIO すべての入出力をトレースします +.It "KTRFAC_SYSCALL システムコールをトレースします。" +.It "KTRFAC_SYSRET システムコールからの戻り値をトレースします。" +.It "KTRFAC_NAMEI パス名の探索操作をトレースします。" +.It "KTRFAC_GENIO すべての入出力をトレースします" (このオプションが大量の出力を生成する可能性があることに注意してください)。 -.It KTRFAC_PSIG ポストされたシグナルをトレースします。 -.It KTRFAC_CSW コンテキストスイッチをトレースします。 -.It KTRFAC_INHERIT これ以降の子にトレースを継承します。 +.It "KTRFAC_PSIG ポストされたシグナルをトレースします。" +.It "KTRFAC_CSW コンテキストスイッチをトレースします。" +.It "KTRFAC_INHERIT これ以降の子にトレースを継承します。" .El .Pp 各トレースイベントは、汎用のヘッダの後に トレース点に固有の構成要素が続く形式のレコードをを出力します。 汎用のヘッダは次のとおりです。 .Bd -literal struct ktr_header { int ktr_len; /* バッファの長さ */ short ktr_type; /* トレースレコードのタイプ */ pid_t ktr_pid; /* プロセス ID */ char ktr_comm[MAXCOMLEN+1]; /* コマンド名 */ struct timeval ktr_time; /* タイムスタンプ */ caddr_t ktr_buf; }; .Ed .Pp -.Nm ktr_len +.Va ktr_len フィールドはこのヘッダに続く -.Nm ktr_type +.Va ktr_type データの長さを示します。 -.Nm ktr_pid +.Va ktr_pid フィールドと -.Nm ktr_comm +.Va ktr_comm フィールドは、レコードを生成したプロセスとコマンドを示します。 -.Nm ktr_time +.Va ktr_time フィールドは、 レコードが生成された時刻を (マイクロ秒単位で) 示します。 -.Nm ktr_buf +.Va ktr_buf は、内部カーネルポインタで あって有用ではありません。 .Pp 汎用ヘッダには -.Nm ktr_len -バイトの -.Nm ktr_type +.Va ktr_len +バイトの長さの +.Va ktr_type レコードが続きます。タイプに固有のレコードは -.Pa -インクルードファイル内に定義されます。 +.Aq Pa sys/ktrace.h +インクルードファイル内で定義されています。 .Sh 戻り値 正常に完了すると値 0 が返されます。そうでない場合は値 -1 が返され、 エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn ktrace は次の場合に失敗します。 -.Bl -tag -width ENAMETOOLONGAA +.Bl -tag -width Er .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定のトレースファイルが存在しません。 .It Bq Er EACCES 前置パス名の構成要素について検索許可が拒否されています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .It Bq Er ENOSYS カーネルが .Nm サポートとともにコンパイルされていません。 .El .Sh 関連項目 .Xr kdump 1 , .Xr ktrace 1 .Sh 歴史 .Fn ktrace 関数は .Bx 4.4 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/link.2 b/ja_JP.eucJP/man/man2/link.2 index 608bbbae7b..0246b8d669 100644 --- a/ja_JP.eucJP/man/man2/link.2 +++ b/ja_JP.eucJP/man/man2/link.2 @@ -1,155 +1,155 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)link.2 8.3 (Berkeley) 1/12/94 -.\" %FreeBSD: src/lib/libc/sys/link.2,v 1.9.2.1 1999/08/29 14:49:09 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/link.2,v 1.11.2.4 2000/12/12 09:55:46 ru Exp % .\" -.Dd January 12, 1994 +.Dd March 5, 1999 .Dt LINK 2 .Os BSD 4 .Sh 名称 .Nm link .Nd ハードファイルリンクを作成する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn link "const char *name1" "const char *name2" .Sh 解説 .Fn link 関数呼び出しは、 .Fa name1 が指す下層オブジェクトの属性を持つ、指定のディレクトリエントリ (ハードリンク) .Fa name2 を不可分に作成します。リンクが正常に完了すると 下層オブジェクトのリンクカウントが増加します。 .Fa name1 と .Fa name2 は、下層オブジェクトへのアクセスとアクセス権を等しく 共有します。 .Pp .Fa name1 を削除してもファイル .Fa name2 は削除されず、下層オブジェクトのリンクカウントが減少します。 .Pp .Fa name1 はハードリンクが成功するために存在している必要があり、 .Fa name1 と .Fa name2 の両方が同じファイルシステム上に存在している必要があります。 .Fa name1 はディレクトリであってはなりません。 .Sh 戻り値 処理が正常に完了すると値 0 が返されます。そうでない場合は -1 が返され、 エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn link は次の場合に処理に失敗し、リンクは作成されません。 -.Bl -tag -width Ar +.Bl -tag -width Er .It Bq Er ENOTDIR いずれかの前置パス名の構成要素がディレクトリではありません。 .It Bq Er ENAMETOOLONG いずれかのパス名の構成要素が 255 文字を越えているか、 またはいずれかのパス名全体の長さが 1023 文字を越えています。 .It Bq Er ENOENT いずれかの前置パス名の構成要素が存在しません。 .It Bq Er EOPNOTSUPP .Fa name1 によって指定されたファイルが入っているファイルシステムが リンクをサポートしていません。 .It Bq Er EMLINK .Fa name1 -で指定されたファイルのリンクカウントが -.Dv {LINK_MAX} +で指定されたファイルのリンクカウントが 32767 を越えます。 .It Bq Er EACCES いずれかの前置パス名の構成要素について検索許可が拒否されています。 .It Bq Er EACCES 要求されたリンクは、書込み許可を拒否するモードのディレクトリに 書込みすることを要求しています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er ENOENT .Fa name1 によって指定されたファイルが存在しません。 .It Bq Er EEXIST .Fa name2 によって指定されたリンクが存在します。 .It Bq Er EPERM .Fa name1 によって指定されたファイルはディレクトリです。 .It Bq Er EXDEV .Fa name2 によって指定されたリンクと .Fa name1 によって指定されたファイルが異なるファイルシステム上にあります。 .It Bq Er ENOSPC ディレクトリを格納しているファイルシステムに容量が残っていないため、 新しいリンクを入れるエントリを置くディレクトリを拡張できません。 -.ne 3v .It Bq Er EDQUOT ディレクトリを格納しているファイルシステムでユーザのディスクブロックに 関するクォータが枯渇したため、 新しいリンクを入れるエントリを置くディレクトリを拡張できません。 .It Bq Er EIO ディレクトリエントリを作成するためファイルシステムに 読み書きしている間に入出力エラーが発生しました。 .It Bq Er EROFS 要求されたリンクは、読取り専用ファイルシステム上のディレクトリに 書込みすることを要求しています。 .It Bq Er EFAULT 指定されたパス名の 1 つが、プロセスに割り当てられた アドレス空間の範囲外を指しています。 .El .Sh 関連項目 .Xr readlink 2 , .Xr symlink 2 , .Xr unlink 2 .Sh 規格 .Fn link 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn link 関数は .At v7 で登場しました。 .Pp 従来、スーパユーザは .Fn link システムコールによってディレクトリをリンクでき、 これはファイルシステムの一貫性を破壊するものでした。 この実装では、このような操作は もはや許されません。 diff --git a/ja_JP.eucJP/man/man2/listen.2 b/ja_JP.eucJP/man/man2/listen.2 index 721714a7c2..ec22fa8045 100644 --- a/ja_JP.eucJP/man/man2/listen.2 +++ b/ja_JP.eucJP/man/man2/listen.2 @@ -1,140 +1,142 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" From: @(#)listen.2 8.2 (Berkeley) 12/11/93 -.\" %FreeBSD: src/lib/libc/sys/listen.2,v 1.10.2.2 1999/08/29 14:49:10 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/listen.2,v 1.12.2.3 2000/08/23 00:45:19 jhb Exp % .\" .Dd November 3, 1995 .Dt LISTEN 2 .Os BSD 4.2 .Sh 名称 .Nm listen .Nd ソケット上の接続をリスンする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn listen "int s" "int backlog" .Sh 解説 .Xr socket 2 で最初にソケットが作成され、 着信接続を受け入れる意思および着信接続用の待ち行列限界が .Fn listen で指定された後、接続が .Xr accept 2 で受け入れられます。 .Fn listen 呼び出しは、タイプが .Dv SOCK_STREAM または .Dv SOCK_SEQPACKET のソケットにだけ適用されます。 .Pp .Fa backlog パラメータは、延期中の接続の待ち行列を伸ばす際の最大長を定義します。 待ち行列が一杯のときに接続要求が到着すると、クライアントは .Er ECONNREFUSED を示すエラーを受信する可能性があります。 または下層のプロトコルが再送信をサポートする場合は、 再試行によって成功する可能性に期待して要求は無視されるかもしれません。 .Pp .Xr sysctl 3 MIB 変数 .Dq Li kern.ipc.somaxconn は .Fa backlog のハードリミットを指定します。 .Li kern.ipc.somaxconn より大きい値、または 0 より小さい値が指定されている場合、 .Fa backlog の指定は無視されて .Li kern.ipc.somaxconn の値にされます。 .Sh システムの注意事項 .Pp 非スレッドライブラリ .Fn listen は .Va listen -システムコールとして実装されます。 +システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va listen システムコールは .Fn _thread_sys_listen にアセンブルされ、 .Fn listen は読み書きについて -.Va s +.Fa s をロックしてから、 .Fn _thread_sys_listen を呼び出す関数として実装されています。戻る前に .Fn listen は -.Va s +.Fa s をアンロックします。 .Sh 戻り値 戻り値 0 は処理の成功を示し、-1 はエラーを示します。 .Sh エラー .Fn listen は次の場合に処理を失敗します。 -.Bl -tag -width [EOPNOTSUPP] +.Bl -tag -width Er .It Bq Er EBADF 引数 .Fa s が有効な記述子ではありません。 .It Bq Er ENOTSOCK 引数 .Fa s がソケットではありません。 .It Bq Er EOPNOTSUPP ソケットが、 .Fn listen をサポートするタイプではありません。 .El .Sh 関連項目 .Xr accept 2 , .Xr connect 2 , .Xr socket 2 , .Xr sysctl 3 , .Xr sysctl 8 .Sh 歴史 .Fn listen 関数は .Bx 4.2 -で現れました。 +で登場しました。 実行時に最大 .Fa backlog を設定できる機能、および許容できる最大値を指定する場合に負の .Fa backlog を使用する機能は .Fx 2.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/lseek.2 b/ja_JP.eucJP/man/man2/lseek.2 index cc5b80df11..767d7bd124 100644 --- a/ja_JP.eucJP/man/man2/lseek.2 +++ b/ja_JP.eucJP/man/man2/lseek.2 @@ -1,129 +1,131 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)lseek.2 8.3 (Berkeley) 4/19/94 -.\" %FreeBSD: src/lib/libc/sys/lseek.2,v 1.8.2.1 1999/08/29 14:49:10 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/lseek.2,v 1.10.2.2 2000/05/06 13:34:14 phantom Exp % .\" .Dd April 19, 1994 .Dt LSEEK 2 .Os BSD 4 .Sh 名称 .Nm lseek -.Nd 読取り/書込みファイルオフセット位置を変更する +.Nd 読取り / 書込みファイルオフセット位置を変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft off_t .Fn lseek "int fildes" "off_t offset" "int whence" .Sh 解説 .Fn lseek 関数は、ディレクティブ .Fa whence に従ってファイル記述子 .Fa fildes のオフセットを引数 .Fa offset に移動します。引数 .Fa fildes はオープンファイル記述子でなければなりません。 .Fn lseek は、次のようにファイル記述子 .Fa fildes に対応するファイル位置ポインタを移動します。 .Bl -item -offset indent .It .Fa whence が .Dv SEEK_SET の場合、オフセットは .Fa offset バイトに設定されます。 .It .Fa whence が .Dv SEEK_CUR の場合、オフセットは現在の位置に .Fa offset バイトを加算したものに設定されます。 .It .Fa whence が .Dv SEEK_END の場合、オフセットはファイルのサイズに .Fa offset バイトを加算したものになります。 .El .Pp .Fn lseek 関数によって、ファイルオフセットをファイルの既存のファイルの終り (EOF) を越えるところに設定できます。 後にデータがこの点に書きこまれると、それ以後のギャップ内のデータに対する読取りは (データが実際にギャップ内に書き込まれるまで) データとして 0 を返します。 .Pp シークできないデバイスもあります。そのようなデバイスに対応するポインタの -値は未定義になります。 +値は未定義になります。 .Sh 戻り値 処理が正常に完了すると .Fn lseek は、ファイルの先頭から測定した結果のオフセット位置を バイト単位で返します。そうでない場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn lseek は次の場合に処理を失敗し、ファイル位置ポインタは変更されません。 -.Bl -tag -width [EINVAL] +.Bl -tag -width Er .It Bq Er EBADF .Em fildes がオープンファイル記述子ではありません。 .It Bq Er ESPIPE .Em fildes はパイプ、ソケット、または FIFO と対応づけられています。 .It Bq Er EINVAL .Fa whence が適切な値ではありません。 .El .Sh 関連項目 .Xr dup 2 , .Xr open 2 .Sh バグ このドキュメントの .Fa whence の使用法は正しくない英語ですが、歴史的な理由で維持されています。 .Sh 規格 .Fn lseek 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn lseek 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/sigpause.2 b/ja_JP.eucJP/man/man2/sigpause.2 index 7efbbf3e8b..975274f9b2 100644 --- a/ja_JP.eucJP/man/man2/sigpause.2 +++ b/ja_JP.eucJP/man/man2/sigpause.2 @@ -1,74 +1,78 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigpause.2 8.1 (Berkeley) 6/2/93 +.\" $FreeBSD: src/lib/libc/compat-43/sigpause.2,v 1.5.2.2 2000/12/08 13:49:23 ru + Exp $ .\" .Dd June 2, 1993 .Dt SIGPAUSE 2 .Os BSD 4 .Sh 名称 .Nm sigpause .Nd ブロックされたシグナルを不可分に解放、割込み待機する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn sigpause "int sigmask" .Sh 解説 -.Sy このインタフェースは、 +.Sy このインタフェースは .Xr sigsuspend 2 -.Sy に更新されました。 +.Sy によって旧式のものとなっています。 .Pp .Fn sigpause は、マスクされたシグナルのセットに .Fa sigmask を割り当ててからシグナルの到着を待機します。 戻ると、マスクされたシグナルのセットが復元されます。通常、 .Fa sigmask の 0 はブロックされるシグナルがないことを表わします。 .Fn sigpause は、常に割り込まれることで終了し、 .Va errno を -.Dv EINTR +.Er EINTR に設定して -1 を戻します。 .Sh 関連項目 .Xr kill 2 , .Xr sigaction 2 , .Xr sigblock 2 , .Xr sigprocmask 2 , .Xr sigsuspend 2 , .Xr sigvec 2 .Sh 歴史 .Fn sigpause 関数呼び出しは、 .Bx 4.2 で登場しました。 しかし、現在ではこの関数を使用することは推奨されていません。 diff --git a/ja_JP.eucJP/man/man2/sigpending.2 b/ja_JP.eucJP/man/man2/sigpending.2 index 62327e1523..5c2d2cdcca 100644 --- a/ja_JP.eucJP/man/man2/sigpending.2 +++ b/ja_JP.eucJP/man/man2/sigpending.2 @@ -1,70 +1,83 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Berkeley Software Design, Inc. .\" .\" 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. .\" .\" @(#)sigpending.2 8.3 (Berkeley) 1/12/94 +.\" %FreeBSD: src/lib/libc/sys/sigpending.2,v 1.5.2.1 2000/04/22 17:07:07 phantom Exp % +.\" man-jp:Ohsawa: 2001/03/13 %FreeBSD: src/lib/libc/sys/sigpending.2,v 1.5.2.2 2001/01/16 21:59:22 ben Exp % .\" .Dd January 12, 1994 .Dt SIGPENDING 2 .Os .Sh 名称 .Nm sigpending .Nd 保留中のシグナルの得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn sigpending "sigset_t *set" .Sh 解説 .Fn sigpending 関数は、 .Fa set で示された場所の呼び出しプロセスの配信が保留になっているシグナルの マスクを戻します。シグナルは、現在マスクをかけられているとき、 または配信前に一時的に保留になります (通常、後者を検出することはできません)。 .Sh 戻り値 戻り値 0 は呼び出しが正常に完了したことを示します。 戻り値 -1 はエラーが起こったことを示し、 .Va errno にエラーが起こったり理由が設定されます。 .Sh エラー .Fn sigpending 関数は、現在のところエラーを検出しません。 +.\" 2001/03/13:jp-man ohsawa 2001/01/16 に修正がはいりました。 +.\" .Fn sigpending +.\" will fail if: +.\" .Bl -tag -width Er +.\" .It Bq Er EFAULT +.\" The +.\" .Fa set +.\" argument specified an invalid address. +.\" .El .Sh 関連項目 .Xr sigaction 2 , .Xr sigprocmask 2 .Sh 規格 .Fn sigpending 関数呼び出しは、 .St -p1003.1-90 に準拠しています。 diff --git a/ja_JP.eucJP/man/man2/sigprocmask.2 b/ja_JP.eucJP/man/man2/sigprocmask.2 index 7cd1207299..7101171a78 100644 --- a/ja_JP.eucJP/man/man2/sigprocmask.2 +++ b/ja_JP.eucJP/man/man2/sigprocmask.2 @@ -1,120 +1,123 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigprocmask.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/sigprocmask.2,v 1.8.2.3 2000/12/29 14:44:54 ru Exp % .\" .Dd June 4, 1993 .Dt SIGPROCMASK 2 .Os .Sh 名称 .Nm sigprocmask .Nd 現在のシグナルマスクを操作する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn sigprocmask "int how" "const sigset_t *set" "sigset_t *oset" .Sh 解説 .Fn sigprocmask 関数は、現在のシグナルマスク (配信がブロックされているシグナル) -の調査や変更を行ないます。シグナルは、現在 -のシグナルマスクセットのメンバである場合にブロックされます。 +の調査や変更を行ないます。シグナルは、現在のシグナルマスクセットに +含まれる場合にブロックされます。 .Pp .Fa set がヌルではない場合、 .Fn sigprocmask の操作は、パラメータ .Ar how の値によって決まります。シグナルマスクは、指定した .Fa set と現在のマスクによって変更されます。 関数は、 .Aq Pa signal.h -の以下の値を使用して +で定義される以下の値を使用して .Ar how で指定します。 .Bl -tag -width SIG_UNBLOCK .It Dv SIG_BLOCK 新しいマスクは、現在のマスクと指定した .Fa set の和集合になります。 .Pp .It Dv SIG_UNBLOCK 新しいマスクは、現在のマスクと指定した .Fa set の補集合の交わりになります。 .It Dv SIG_SETMASK 現在のマスクは、指定した .Fa set に置き換えられます。 .El .Pp .Fa oset がヌルでない場合、前のシグナルマスクの値に設定されます。 .Fa set がヌルである場合、 .Ar how の値が無効になり、マスクは未設定のまま残るので、 シグナルマスクを修正せずに検査できるようになります。 .Pp システムでは、 .Dv SIGKILL や .Dv SIGSTOP のブロックが許可されていません。 .Pp .Sh 戻り値 値 0 は呼び出しが正常に完了したことを示します。 戻り値 -1 はエラーが起こったことを示し、エラーの理由を示すために .Va errno が設定されます。 .Sh エラー 以下が発生すると、 .Fn sigprocmask 呼び出しはエラーになり、シグナルマスクは変更されません。 .Pp -.Bl -tag -width Bq Er EINVAL +.Bl -tag -width Er .It Bq Er EINVAL .Fa how が、ここでリストに挙げた以外の値になっています。 +.El .Pp .Sh 関連項目 .Xr kill 2 , .Xr sigaction 2 , .Xr sigsuspend 2 , .Xr fpsetmask 3 , .Xr sigsetops 3 .Sh 規格 .Fn sigprocmask 関数呼び出しは、 .St -p1003.1-90 -に準拠します。 -.Pp +に準拠しています。 diff --git a/ja_JP.eucJP/man/man2/sigreturn.2 b/ja_JP.eucJP/man/man2/sigreturn.2 index b1349411c3..de2db3dd5d 100644 --- a/ja_JP.eucJP/man/man2/sigreturn.2 +++ b/ja_JP.eucJP/man/man2/sigreturn.2 @@ -1,115 +1,115 @@ .\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigreturn.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/sigreturn.2,v 1.3.2.1 1999/09/18 16:19:01 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/sigreturn.2,v 1.6.2.2 2000/05/06 13:34:15 phantom Exp % .\" .Dd June 4, 1993 .Dt SIGRETURN 2 .Os BSD 4.3 .Sh 名称 .Nm sigreturn .Nd シグナルから戻る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Pp .Bd -literal struct sigcontext { int sc_onstack; /* 復元するスタックステータス */ int sc_mask; /* 復元するシグナルマスク */ - int sc_esp; /* 機械の状態 */ + int sc_esp; /* マシンステート */ int sc_ebp; int sc_isp; int sc_eip; int sc_efl; int sc_es; int sc_ds; int sc_cs; int sc_ss; int sc_edi; int sc_esi; int sc_ebx; int sc_edx; int sc_ecx; int sc_eax; # define sc_sp sc_esp # define sc_fp sc_ebp # define sc_pc sc_eip # define sc_ps sc_efl }; .Ed .Ft int .Fn sigreturn "struct sigcontext *scp" .Sh 解説 .Fn sigreturn によって、マスクの細かい設定解除、スタックのスイッチ、 -シグナルコンテキストからの復帰を -行なえます。プロセスのシグナルマスクとスタックステータスは、 -コンテキストから復元されます。システム呼び出しは戻りません。 +シグナルコンテキストからの復帰を行なえます。 +プロセスのシグナルマスクとスタックステータスは、 +コンテキストから復元されます。システムコールは戻りません。 ユーザのスタックポインタ、フレームポインタ、引数ポインタ、 プロセッサステータスロングワードは、コンテキストから復元されます。 -実行は、指定された -pc -で再開されます。 -このシステム呼び出しは、前に実行していたプログラムにシグナル -から戻る場合に、トランポリンコードと +実行は、指定された pc で再開されます。 +このシステムコールは、前に実行していたプログラムに +シグナルから戻る場合に、トランポリンコードと .Xr longjmp 3 で使用します。 .Sh 注釈 -このシステム呼び出しは4.2 +このシステムコールは 4.2 .Tn BSD では使用できないので、下位互換性が必要な場合は使用しないでください。 .Sh 戻り値 -処理が正常に完了すると、このシステム呼び出しは戻りません。 +処理が正常に完了すると、このシステムコールは戻りません。 そうでない場合は -1 が返され、エラーを示すために .Va errno が設定されます .Sh エラー 以下のうち 1 つが発生すると、 .Fn sigreturn は処理を失敗し、プロセスコンテキストは変更されずに残ります。 -.Bl -tag -width [EINVAL] +.Bl -tag -width Er .It Bq Er EFAULT .Fa Scp が、プロセスアドレス空間の有効な部分ではない メモリを指しています。 .It Bq Er EINVAL プロセスステータスロングワードが正しくないか、 プロセスの権限レベルを不適切に上げています。 .El .Sh 関連項目 .Xr sigvec 2 , .Xr setjmp 3 .Sh 歴史 .Fn sigreturn 関数呼び出しは、 .Bx 4.3 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/sigsetmask.2 b/ja_JP.eucJP/man/man2/sigsetmask.2 index 40cb4c2d35..88502a675b 100644 --- a/ja_JP.eucJP/man/man2/sigsetmask.2 +++ b/ja_JP.eucJP/man/man2/sigsetmask.2 @@ -1,85 +1,88 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigsetmask.2 8.1 (Berkeley) 6/2/93 +.\" %FreeBSD: src/lib/libc/compat-43/sigsetmask.2,v 1.7.2.1 2000/04/22 16:46:19 phantom Exp % .\" .Dd June 2, 1993 .Dt SIGSETMASK 2 .Os BSD 4.2 .Sh 名称 .Nm sigsetmask .Nd 現在のシグナルマスクを設定する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn sigsetmask "int mask" .Fn sigmask signum .Sh 解説 .Bf -symbolic このインタフェースは .Ef .Xr sigprocmask 2 .Bf -symbolic によって旧式のものとなっています。 .Ef .Pp .Fn sigsetmask は、現在のシグナルマスクを設定します。 .Fa mask で対応するビットが 1 である場合、シグナルの配信はブロックされ ます。マクロ .Fn sigmask は、指定した .Fa signum のマスクを作成するために提供されています。 .Pp システムでは、 .Dv SIGKILL や .Dv SIGSTOP のブロックが許可されていません。 .Sh 戻り値 マスクされたシグナルの前のセットが戻されます。 .Sh 関連項目 .Xr kill 2 , .Xr sigaction 2 , .Xr sigblock 2 , .Xr sigprocmask 2 , .Xr sigsuspend 2 , .Xr sigvec 2 , .Xr sigsetops 3 .Sh 歴史 .Fn sigsetmask 関数呼び出しは .Bx 4.2 で登場しました。 しかし、現在では この関数を使用することは推奨されていません。 diff --git a/ja_JP.eucJP/man/man2/sigstack.2 b/ja_JP.eucJP/man/man2/sigstack.2 index 4091bf74e2..643c592ad9 100644 --- a/ja_JP.eucJP/man/man2/sigstack.2 +++ b/ja_JP.eucJP/man/man2/sigstack.2 @@ -1,51 +1,54 @@ .\" Copyright (c) 1983, 1992, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigstack.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/sigstack.2,v 1.4.2.1 2000/04/22 17:07:08 phantom Exp % .\" .Dd June 4, 1993 .Dt SIGSTACK 2 .Os BSD 4.2 .Sh 名称 .Nm sigstack .Nd シグナルスタックコンテキストの設定や取得 +.Sh ライブラリ +.Lb libc .Sh 解説 .Fn sigstack 関数は、 .Xr sigaltstack 2 で説明したインタフェースで置き換えられました。 .Sh 関連項目 .Xr sigaltstack 2 .Sh 歴史 .Fn sigstack 関数呼び出しは、 .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/sigsuspend.2 b/ja_JP.eucJP/man/man2/sigsuspend.2 index b3167d241b..e01da79963 100644 --- a/ja_JP.eucJP/man/man2/sigsuspend.2 +++ b/ja_JP.eucJP/man/man2/sigsuspend.2 @@ -1,78 +1,81 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigsuspend.2 8.2 (Berkeley) 5/16/95 +.\" %FreeBSD: src/lib/libc/sys/sigsuspend.2,v 1.9.2.2 2000/12/08 13:49:32 ru Exp % .\" .Dd May 16, 1995 .Dt SIGSUSPEND 2 .Os .Sh 名称 .Nm sigsuspend -.Nd ブロックされているシグナルの解放と割込み待ちとを不可分に実行 +.Nd ブロックされているシグナルの解放と割込み待ちを不可分に実行 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn sigsuspend "const sigset_t *sigmask" .Sh 解説 .Fn sigsuspend は、 .Fa sigmask -が指す集合に、ブロックされて -いるシグナルマスクを一時的に変更してから、シグナルの到着を待ちます。 +が指す集合に、ブロックされているシグナルマスクを一時的に変更してから、 +シグナルの到着を待ちます。 復帰時に、マスクされたシグナルの前の集合が復元されます。 通常の場合、シグナルマスク集合は空で、呼び出しが続く間、 すべてのシグナルがブロックされないことを表わします。 .Pp 通常の用法では、 .Xr sigprocmask 2 でシグナルをブロックして重要なセクションを始め、 シグナルの発生で修正された変数を調べて 実行すべき仕事がないことを判断し、 .Xr sigprocmask が返した以前のマスクで .Fn sigsuspend を使用することでプロセスが停止して仕事を待ちます。 .Sh 戻り値 .Fn sigsuspend 関数は、常に、割り込まれることで終了し、 .Va errno を -.Dv EINTR +.Er EINTR に設定し、-1 を返します。 .Sh 関連項目 .Xr sigaction 2 , .Xr sigprocmask 2 , .Xr sigsetops 3 .Sh 規格 .Fn sigsupend 関数呼び出しは、 .St -p1003.1-90 -に準拠します。 +に準拠しています。 diff --git a/ja_JP.eucJP/man/man2/sigvec.2 b/ja_JP.eucJP/man/man2/sigvec.2 index 993f25184b..1632cdb0a5 100644 --- a/ja_JP.eucJP/man/man2/sigvec.2 +++ b/ja_JP.eucJP/man/man2/sigvec.2 @@ -1,330 +1,332 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)sigvec.2 8.2 (Berkeley) 4/19/94 +.\" %FreeBSD: src/lib/libc/compat-43/sigvec.2,v 1.9.2.4 2000/12/29 14:44:44 ru Exp % .\" .\" 2001/01/01 horikawa@jp.FreeBSD.org .\" sigvec.2 を更新する場合は、共通部分の多い sigaction.2 も同時に更新 .\" してください。 .\" .Dd April 19, 1994 .Dt SIGVEC 2 .Os BSD 4 .Sh 名称 .Nm sigvec .Nd ソフトウェアシグナル機能 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Bd -literal struct sigvec { void (*sv_handler)(); int sv_mask; int sv_flags; }; .Ed .Ft int .Fn sigvec "int sig" "struct sigvec *vec" "struct sigvec *ovec" .Sh 解説 .Bf -symbolic このインタフェースは、 sigaction(2) に置き換えられました。 .Ef .Pp システムではシグナルの集合を定義しており、 これらはプロセスに配信されることがあります。 シグナルの配信は、ハードウェア割込みの発生に似ています。 シグナルのさらなる発生はブロックされ、 現在のプロセスコンテキストは保存されて、新しいプロセスコンテキストが 作成されます。プロセスは、シグナルの配信先 .Em handler を指定することもあれば、シグナルを .Em ブロックすること および .Em 無視すること を指定することもあります。 シグナルが発生した場合に、システムがデフォルトのアクションを取る ことを指定することも可能です。 通常の場合、シグナルハンドラは、プロセスの現行スタックで動作します。 これは、ハンドラ毎に変更して、シグナルが特殊な .Em シグナルスタック でハンドルされるようにできます。 .Pp すべてのシグナルの .Em 優先順位 は同じです。 シグナルルーチンは、呼出しの原因となったシグナルが .Em ブロックされた 状態で動作しますが、 その他のシグナルが発生する可能性はあります。グローバルな .Em シグナルマスク には、プロセスへの配信が現在ブロック されているシグナルの集合が定義されています。 プロセスのシグナルマスクは、親のシグナルマスクに初期化されます (通常は 0)。 シグナルマスクは、 .Xr sigblock 2 か .Xr sigsetmask 2 を呼び出すか、シグナルがプロセスに配信された場合に変更され得ます。 .Pp シグナル条件がプロセスで発生すると、そのシグナルが、 プロセスで保留になっているシグナルの集合に追加されます。 そのシグナルがプロセスで現在 .Em ブロック されていない場合は、プロセスに配信されます。 シグナルが配信されると、プロセスの現在の状態が保存され、 新しいシグナルマスクが以下で説明するように 算出されて、シグナルハンドラが呼び出されます。 ハンドラの呼び出しは、シグナル処理ルーチンが正常に戻った場合に プロセスがシグナル配信前のコンテキストで実行を再開するように編成されます。 プロセスが別のコンテキストでの再開を望む場合は、 プロセスが前のコンテキストそのものを回復するように編成する必要があります。 .Pp シグナルがプロセスに配信されると、新しいシグナルマスクが、 プロセスのシグナルハンドラが続く間 (または .Xr sigblock 2 か .Xr sigsetmask 2 が呼び出されるまで) 設置されます。 このマスクは、現在のシグナルマスクに、配信されるシグナルを追加し、 呼び出されるハンドラに関連したシグナルマスクとの論理和を 取って形成されます。 .Pp .Fn sigvec は、特定のシグナルにハンドラを割り当てます。 .Fa vec を 0 以外にした場合は、指定したシグナルを配信する場合に使用する ハンドラルーチンとマスクが指定されます。 .Dv SV_ONSTACK ビットが .Fa sv_flags で設定されている場合、システムは、 .Xr sigaltstack 2 で指定された .Em シグナルスタック のプロセスにシグナルを配信します。 .Fa ovec を 0 以外にした場合は、 シグナルの前の処理情報がユーザに返されます。 .Pp 以下はすべてのシグナルのリストです。 名称は、インクルードファイル .Aq Pa signal.h と同じです。 .Bl -column SIGVTALARMXX "create core imagexxx" -.It Sy " 名称 " " デフォルトアクション " " 説明" +.It Sy "名称 デフォルトアクション 説明" .It Dv SIGHUP No " プロセスの終了" " 端末ラインのハングアップ" .It Dv SIGINT No " プロセスの終了" " プログラムの割込み" .It Dv SIGQUIT No " コアイメージの作成" " プログラムの終了" .It Dv SIGILL No " コアイメージの作成" " 不正な命令" .It Dv SIGTRAP No " コアイメージの作成" " トラップの追跡" -.It Dv SIGABRT No " コアイメージの作成" Xr abort 3 +.It Dv SIGABRT No " コアイメージの作成" Ta Xr abort 3 の呼び出し (以前の .Dv SIGIOT ) .It Dv SIGEMT No " コアイメージの作成" " 実行した命令のエミュレート" .It Dv SIGFPE No " コアイメージの作成" " 浮動小数例外" .It Dv SIGKILL No " プロセスの終了" " プログラムの終了" .It Dv SIGBUS No " コアイメージの作成" " バスエラー" .It Dv SIGSEGV No " コアイメージの作成" " セグメンテーション違反" .It Dv SIGSYS No " コアイメージの作成" " 存在しないシステムコールの呼び出し" .It Dv SIGPIPE No " プロセスの終了" " 読取り側のないパイプでの書込み" .It Dv SIGALRM No " プロセスの終了" " リアルタイムタイマの満了" .It Dv SIGTERM No " プロセスの終了" " ソフトウェア終了シグナル" .It Dv SIGURG No " シグナルの放棄" " 緊急事態がソケットに存在" .It Dv SIGSTOP No " プロセスの停止" " 停止 (補足も無視もできません) .It Dv SIGTSTP No " プロセスの停止" " キーボードから生成された停止シグナル" .It Dv SIGCONT No " シグナルの放棄" " 停止後の継続" .It Dv SIGCHLD No " シグナルの放棄" " 子ステータスの変化" .It Dv SIGTTIN No " プロセスの停止" " 制御端末からバックグラウンド読取りしようとした" .It Dv SIGTTOU No " プロセスの停止" " 制御端末にバックグラウンド書込みしようとした" .It Dv SIGIO No " シグナルの放棄" " 記述子に" .Tn I/O 可能 ( .Xr fcntl 2 参照) .It Dv SIGXCPU No " プロセスの終了" " cpu 制限時間の超過 ( .Xr setrlimit 2 参照) .It Dv SIGXFSZ No " プロセスの終了" " ファイルサイズ制限の超過 (" .Xr setrlimit 2 参照) .It Dv SIGVTALRM No " プロセスの終了" " 仮想時間アラーム (" .Xr setitimer 2 参照) .It Dv SIGPROF No " プロセスの終了" " プロファイリングタイマアラーム (" .Xr setitimer 2 参照) .It Dv SIGWINCH No " シグナルの放棄" " ウィンドウサイズの変化" .It Dv SIGINFO No " シグナルの放棄" " キーボードからのステータス要求" .It Dv SIGUSR1 No " プロセスの終了" " ユーザ定義シグナル 1" .It Dv SIGUSR2 No " プロセスの終了" " ユーザ定義シグナル 2" .El .Pp シグナルハンドラが設置されると、 .Fn sigvec を再度呼び出すか .Xr execve 2 を実行するまでシグナルハンドラは設置されたまま残ります。 シグナルに固有なデフォルトアクションへは、 .Fa sv_handler を .Dv SIG_DFL に設定することでリセットできます。 デフォルトは、プロセスの終了 (コアダンプが取られることもあります)、アクションなし、プロセスの停止、 プロセスの継続です。 それぞれのシグナルのデフォルトアクションについては、 上のシグナルリストを参照してください。 .Fa sv_handler が .Dv SIG_IGN である場合、シグナルの現在と保留中のインスタンスは無視されて放棄されます。 .Pp 以下のリストのシステムコール中にシグナルが補足されると、 通常の場合、呼び出しは再開されます。 .Dv SV_INTERRUPT ビットを .Fa sv_flags で設定することで、システムコールは、 -.Dv EINTR +.Er EINTR エラー値を伴い、途中で終了するように強制可能です。 影響を受けるシステムコールは、 通信チャネルか遅いデバイス (端末などで、通常ファイルではない) に対する .Xr read 2 , .Xr write 2 , .Xr sendto 2 , .Xr recvfrom 2 , .Xr sendmsg 2 , .Xr recvmsg 2 と .Xr wait 2 , .Xr ioctl 2 の途中です。 しかし、すでに実行されているシステムコールは再開されず、 部分的な結果 (短い読取りカウントなど) を返します。 .Pp .Xr fork 2 か .Xr vfork 2 の後では、すべてのシグナル、シグナルマスク、シグナルスタック、 再開 / 割込みフラグが子に継承されます。 .Pp .Xr execve 2 は、補足されたすべてのシグナルのデフォルトアクションを元に戻し、 ユーザスタックで補足されるすべてのシグナルをリセットします。 無視されたシグナルは無視されたまま残ります。 シグナルマスクは同じ状態のままです。 システムコールに割り込むシグナルは、割込みを続けます。 .Sh 注 .Fa vec に指定したマスクでは、 .Dv SIGKILL と .Dv SIGSTOP をブロックできません。これは、システムが暗黙的に課す制限事項です。 .Pp .Bx 4.2 では .Dv SV_INTERRUPT フラグを使用できないので、下位 互換性が必要な場合は使用しないでください。 .Pp .Sh 戻り値 0 は、呼び出しに問題がなかったことを表わします。 -1 は、エラーが発生し、 .Va errno がエラーの理由を示すように設定されていることを表わします。 .Pp .Sh エラー 以下のうち 1 つが発生すると、 .Fn sigvec -はエラーとなり、新 -しいシグナルハンドラは設置されません。 -.Bl -tag -width [EINVAL] +はエラーとなり、新しいシグナルハンドラは設置されません。 +.Bl -tag -width Er .It Bq Er EFAULT .Fa vec か .Fa ovec は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EINVAL .Fa Sig が、正しいシグナル番号になっていません。 .It Bq Er EINVAL .Dv SIGKILL か .Dv SIGSTOP のハンドラを無視するか提供しようとしました。 .El .Sh 関連項目 .Xr kill 1 , .Xr kill 2 , .Xr ptrace 2 , .Xr sigaction 2 , .Xr sigaltstack 2 , .Xr sigblock 2 , .Xr sigpause 2 , .Xr sigprocmask 2 , .Xr sigsetmask 2 , .Xr sigsuspend 2 , .Xr setjmp 3 , .Xr siginterrupt 3 , .Xr signal 3 , .Xr sigsetops 3 , .Xr tty 4 .Sh 使用例 .Tn VAX\-11 では、以下のようにハンドラルーチンを宣言できます。 .Bd -literal -offset indent void handler(sig, code, scp) int sig, code; struct sigcontext *scp; .Ed .Pp .Fa sig は、ハードウェアフォルトとトラップのマップ対象のシグナル番号であり、 下のように定義されます。 .Fa code は、下で定義する定数、 または互換性モードフォルトの場合は、ハードウェアが提供するコードで あるパラメータです (互換性モードフォルトは、pslに .Dv PSL_CM が設定されていることから、他の .Dv SIGILL トラップと区別されます)。 .Fa scp は、 .Fa sigcontext 構造体 ( .Aq Pa signal.h で定義) へのポインタで、シグナル前にコンテキストを復元するために使用されます。 .Sh バグ このマニュアルページは不明確です。 diff --git a/ja_JP.eucJP/man/man2/socketpair.2 b/ja_JP.eucJP/man/man2/socketpair.2 index eabcfaf017..5e26e5b649 100644 --- a/ja_JP.eucJP/man/man2/socketpair.2 +++ b/ja_JP.eucJP/man/man2/socketpair.2 @@ -1,90 +1,94 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)socketpair.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/socketpair.2,v 1.6.2.4 2000/12/29 14:44:54 ru Exp % .\" .Dd June 4, 1993 .Dt SOCKETPAIR 2 .Os BSD 4.2 .Sh 名称 .Nm socketpair .Nd 接続されたソケットのペアの作成 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn socketpair "int d" "int type" "int protocol" "int *sv" .Sh 解説 .Fn socketpair 関数は、任意に指定された .Fa protocol を使用し、指定された .Fa type の接続されたソケットのペアを、指定されたドメイン .Fa d に作成されます。このとき、ペアは指定できません。 新しいソケットの参照に使用された記述子は、 .Fa sv Ns [0] と .Fa sv Ns [1] に戻されます。 2 つのソケットは区別できません。 .Sh 戻り値 処理が正常に完了すると、0 が返されます。 エラーが発生すると -1 が返されます。 .Sh エラー 以下のような場合、処理を失敗します。 -.Bl -tag -width EPROTONOSUPPORTA +.Bl -tag -width Er .It Bq Er EMFILE プロセスで使用されている記述子が多すぎます。 .It Bq Er EAFNOSUPPORT 指定されたアドレスファミリが、この機械でサポートされていません。 .It Bq Er EPROTONOSUPPORT 指定したプロトコルが、この機械でサポートされていません。 -.It Bq Er EOPNOSUPPORT +.It Bq Er EOPNOTSUPP 指定したプロトコルでの、ソケットペアの作成がサポートされていません。 .It Bq Er EFAULT アドレス .Fa sv が、プロセスアドレス空間の有効な部分を指定していません。 +.El .Sh 関連項目 .Xr pipe 2 , .Xr read 2 , .Xr write 2 .Sh バグ この呼び出しは、現在のところ .Tn UNIX ドメインのみで実装されています。 .Sh 歴史 .Fn socketpair 関数呼び出しは .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/stat.2 b/ja_JP.eucJP/man/man2/stat.2 index 1d0908cbb1..2368c5512c 100644 --- a/ja_JP.eucJP/man/man2/stat.2 +++ b/ja_JP.eucJP/man/man2/stat.2 @@ -1,274 +1,270 @@ .\" Copyright (c) 1980, 1991, 1993, 1994 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)stat.2 8.4 (Berkeley) 5/1/95 -.\" %FreeBSD: src/lib/libc/sys/stat.2,v 1.14.2.1 1999/08/29 14:49:27 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/stat.2,v 1.16.2.3 2000/12/08 13:49:32 ru Exp % .\" .Dd May 1, 1995 .Dt STAT 2 .Os BSD 4 .Sh 名称 .Nm stat , .Nm lstat , .Nm fstat .Nd ファイルステータスの取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn stat "const char *path" "struct stat *sb" .Ft int .Fn lstat "const char *path" "struct stat *sb" .Ft int .Fn fstat "int fd" "struct stat *sb" .Sh 解説 .Fn stat 関数は、 .Fa path が指すファイルの情報を取得します。 指定したファイルの読取り権、書込み権、実行権は必要ありません。 -しかし、そのファイルへ至るパス名で列挙されたすべてのディレクトリは。 +しかし、そのファイルへ至るパス名で列挙されたすべてのディレクトリは、 検索可能であることが必要です。 .Pp .Fn lstat は .Fn stat に似ていますが、指定したファイルがシンボリックリンクである場合は異なります。 .Fn lstat はリンクの情報を戻しますが、 .Fn stat はリンクが参照するファイルの情報を返します。 -その他のファイルシステムオブジェクトと異なり、 -シンボリックリンクには、所有者、グループ、アクセスモード、時刻など -がありません。これらの属性は、そのリンクを含むディレクトリから -得られます。シンボリックリンクそのものを参照して -.Fn lstat -を呼び出すと、ファイルタイプ (S_IFLINK)、サイズ、ブロック、リンク数 -(常に 1) のみを返します。 .Pp .Fn fstat は、ファイル記述子 .Fa fd で区別されるオープンファイルについて、上と同じ情報を取得します。 .Pp 引数 .Fa sb は、構造体 .Fn stat へのポインタです。これは、 .Aq Pa sys/stat.h (下記参照) で定義され、ファイルに関する情報を保持します。 .Bd -literal struct stat { dev_t st_dev; /* inode のデバイス */ ino_t st_ino; /* inode 番号 */ mode_t st_mode; /* inode 保護モード */ nlink_t st_nlink; /* ハードリンク数 */ uid_t st_uid; /* ファイル所有者のユーザ ID */ gid_t st_gid; /* ファイルグループのグループ ID */ dev_t st_rdev; /* デバイスタイプ */ #ifndef _POSIX_SOURCE struct timespec st_atimespec; /* 最後のアクセス時刻 */ struct timespec st_mtimespec; /* 最後のデータ修正時刻 */ struct timespec st_ctimespec; /* 最後のファイルステータス修正時刻 */ #else time_t st_atime; /* 最後のアクセス時刻 */ - long st_atimensec; /* 最後のアクセス時刻の nsec */ + long st_atimensec; /* 最後のアクセス時刻のナノ秒 */ time_t st_mtime; /* 最後のデータ修正時刻 */ - long st_mtimensec; /* 最後のデータ修正時刻の nsec */ + long st_mtimensec; /* 最後のデータ修正時刻のナノ秒 */ time_t st_ctime; /* 最後のファイルステータス修正時刻 */ - long st_ctimensec; /* 最後のファイルステータス修正時刻の nsec */ + long st_ctimensec; /* 最後のファイルステータス修正時刻のナノ秒 */ #endif off_t st_size; /* バイト単位のファイルの大きさ */ int64_t st_blocks; /* ファイルに割り当てられたブロック数 */ - u_int32_t st_blksize; /* I/O に最適なブロックサイズ */ + u_int32_t st_blksize; /* 入出力に最適なブロックサイズ */ u_int32_t st_flags; /* ファイルに対するユーザ定義フラグ */ u_int32_t st_gen; /* ファイル生成番号 */ }; .Ed .Pp .Fa struct stat の時刻に関するフィールドは、以下のとおりです。 .Bl -tag -width XXXst_mtime .It st_atime ファイルのデータが最後にアクセスされた時刻。 .Xr mknod 2 , .Xr utimes 2 , .Xr read 2 システムコールで変更されます。 .It st_mtime ファイルのデータが最後に修正された時刻。 .Xr mknod 2 , .Xr utimes 2 , .Xr write 2 システムコールで変更されます。 .It st_ctime ファイルステータスが最後に変更された時刻 (inode データの修正)。 .Xr chmod 2 , .Xr chown 2 , .Xr link 2 , .Xr mknod 2 , .Xr rename 2 , .Xr unlink 2 , .Xr utimes 2 , .Xr write 2 システムコールで変更されます。 .El .Pp .Dv _POSIX_SOURCE が定義されていない場合、時刻に関するフィールドは以下のように定義されます。 .Bd -literal #ifndef _POSIX_SOURCE #define st_atime st_atimespec.tv_sec #define st_mtime st_mtimespec.tv_sec #define st_ctime st_ctimespec.tv_sec #endif .Ed .Pp .Fa struct stat のサイズに関するフィールドは、以下のとおりです。 .Bl -tag -width XXXst_blksize .It st_blksize -ファイルの最適な I/O ブロックサイズ。 +ファイルの最適な入出力ブロックサイズ。 .It st_blocks ファイルに 512 バイト単位で割り当てられたブロックの実際の数。 短いシンボリックリンクが i ノードに保持されている場合、この数値が 0 になることがあります。 .El .Pp ステータス情報ワード .Fa st_mode には、以下のようなビットがあります。 .Bd -literal #define S_IFMT 0170000 /* ファイルのタイプ */ #define S_IFIFO 0010000 /* 名前付きパイプ (fifo) */ #define S_IFCHR 0020000 /* キャラクタ型特殊ファイル */ #define S_IFDIR 0040000 /* ディレクトリ */ #define S_IFBLK 0060000 /* ブロック方特殊ファイル */ #define S_IFREG 0100000 /* 通常 */ #define S_IFLNK 0120000 /* シンボリックリンク */ #define S_IFSOCK 0140000 /* ソケット */ #define S_IFWHT 0160000 /* ホワイトアウト */ #define S_ISUID 0004000 /* 実行時にユーザ ID を設定 */ #define S_ISGID 0002000 /* 実行時にグループ ID を設定 */ #define S_ISVTX 0001000 /* 使用後にもスワップされたテキストを保存 */ #define S_IRUSR 0000400 /* 読み込み権限の所有者 */ #define S_IWUSR 0000200 /* 書き込み権限の所有者 */ #define S_IXUSR 0000100 /* 実行/検索権限の所有者 */ .Ed アクセスモードのリストについては、 .Aq Pa sys/stat.h , .Xr access 2 , .Xr chmod 2 を参照してください。 .Sh 戻り値 問題なく終了すると 0 が戻されます。 問題が発生すると -1 が戻され、 .Va errno にそのエラーを示す値が設定されます。 .Sh 互換性 以前のバージョンのシステムでは、 .Li st_dev , .Li st_uid , .Li st_gid , .Li st_rdev , .Li st_size , .Li st_blksize , .Li st_blocks フィールドに別のタイプを使用していました。 .Sh エラー .Fn stat と .Fn lstat は、以下のような場合にエラーとなります。 -.Bl -tag -width ENAMETOOLONGAA +.Bl -tag -width Er .It Bq Er ENOTDIR -パスの構成要素中にディレクトリ以外のものが含まれています。 +パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定されたファイルが存在しません。 .It Bq Er EACCES -パスプレフィックスの構成要素で検索権が拒否されました。 +指定されたパスには、 +検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EFAULT .Fa sb か .Em name は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO -ファイルシステムでの読み書き中に I/O エラーが発生しました。 +ファイルシステムでの読み書き中に入出力エラーが発生しました。 .El .Pp .Fn fstat は、以下のような場合にエラーとなります。 -.Bl -tag -width [EFAULT] +.Bl -tag -width Er .It Bq Er EBADF .Fa fd が、有効な記述子ではありません。 .It Bq Er EFAULT .Fa sb は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr access 2 , .Xr chmod 2 , .Xr chown 2 , .Xr utimes 2 , .Xr symlink 7 .Pp .Sh バグ .Fn fstat をソケット (およびパイプ) に適用すると、ブロックサイズフィールド、 および固有デバイスと i ノード番号以外に 0 の入ったバッファが戻されます。 .Sh 規格 .Fn stat -関数呼出しと +関数呼び出しと .Fn fstat -関数呼出しは、 +関数呼び出しは、 .St -p1003.1-90 -に準拠します。 +に準拠しています。 .Sh 歴史 .Fn stat -関数呼出しと +関数呼び出しと .Fn fstat -関数呼出しは、 +関数呼び出しは、 .At v7 で登場しました。 .Fn lstat -関数呼出しは +関数呼び出しは .Bx 4.2 で登場しました。 .\" Amended by N.Kumagai 2000-3-18 diff --git a/ja_JP.eucJP/man/man2/statfs.2 b/ja_JP.eucJP/man/man2/statfs.2 index c1dfc16123..a494eb8c74 100644 --- a/ja_JP.eucJP/man/man2/statfs.2 +++ b/ja_JP.eucJP/man/man2/statfs.2 @@ -1,184 +1,188 @@ .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)statfs.2 8.5 (Berkeley) 5/24/95 +.\" %FreeBSD: src/lib/libc/sys/statfs.2,v 1.9.2.4 2000/12/29 14:44:54 ru Exp % .\" .Dd May 24, 1995 .Dt STATFS 2 .Os .Sh 名称 .Nm statfs .Nd ファイルシステムの統計を入手 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn statfs "const char *path" "struct statfs *buf" .Ft int .Fn fstatfs "int fd" "struct statfs *buf" .Sh 解説 .Fn statfs は、マウントされているファイルシステムの情報を戻します。 .Fa path は、マウントされているファイルシステム内の任意のファイルのパス名です。 .Fa buf は、以下のように定義 されている .Fn statfs の構造体のポインタです。 .Bd -literal typedef struct fsid { int32_t val[2]; } fsid_t; /* ファイルシステム ID 型 */ /* * ファイルシステム統計 */ -#define MFSNAMELEN 16 /* Null を含むファイルシステム名の長さ */ +#define MFSNAMELEN 16 /* ヌルを含むファイルシステム名の長さ */ #define MNAMELEN 90 /* 戻り値の用のバッファの長さ */ struct statfs { long f_spare2; /* プレイスホルダー */ long f_bsize; /* ファイルシステムのブロックサイズ */ long f_iosize; /* 最適なトランスファーブロックサイズ */ long f_blocks; /* ファイルシステム上の合計ブロックサイズ */ long f_bfree; /* ファイルシステム上の利用可能なブロック */ long f_bavail; /* スーパユーザ以外が利用可能なブロック */ long f_files; /* ファイルシステム上の合計ノード数 */ long f_ffree; /* ファイルシステム上の利用可能なノード数 */ fsid_t f_fsid; /* ファイルシステム ID 番号 */ uid_t f_owner; /* ファイルシステムをマウントしたユーザ */ int f_type; /* ファイルシステムのタイプ (下記参照) */ int f_flags; /* マウントフラッグのコピー */ -long f_spare[2]; /* 将来の拡張のためのスペース */ +long f_syncwrites; /* マウントしてからの同期書き込み数 */ +long f_asyncwrites; /* マウントしてからの非同期書き込み数 */ char f_fstypename[MFSNAMELEN];/* ファイルシステムタイプ名 */ char f_mntonname[MNAMELEN]; /* マウントポイント */ char f_mntfromname[MNAMELEN]; /* マウントされたファイルシステム */ }; .Ed 戻される可能性があるフラグは以下のとおりです。 .Bl -tag -width MNT_ASYNCHRONOUS .It Dv MNT_RDONLY ファイルシステムが読取り専用でマウント されています。スーパユーザでも書込めません。 .It Dv MNT_NOEXEC そのファイルシステムからファイルを実行できません。 .It Dv MNT_NOSUID ファイルの setuid ビットと setgid ビットが、 ファイルの実行時に受け入れられません。 .It Dv MNT_NODEV ファイルシステムの特殊ファイルを開けません。 .It Dv MNT_SYNCHRONOUS -ファイルシステムへのすべての I/O が、 +ファイルシステムへのすべての入出力が、 同期を取って実行されます。 .It Dv MNT_ASYNCHRONOUS -ファイルシステム I/O が、同期を取って実行されません。 +ファイルシステムの入出力が、同期を取って実行されません。 .It Dv MNT_LOCAL ファイルシステムがローカルに常駐しています。 .It Dv MNT_QUOTA -ファイルシステムで数量規制が有効になっています。 +ファイルシステムでクォータが有効になっています。 .It Dv MNT_ROOTFS ルートファイルシステムを確認します。 .It Dv MNT_EXRDONLY ファイルシステムが、読取り専用でエクスポートされます。 .It Dv MNT_EXPORTED ファイルシステムが、読み書きの両方でエクスポートされます。 .It Dv MNT_DEFEXPORTED ファイルシステムが、読み書きの両方で 任意のインターネットホストにエクスポートされます。 .It Dv MNT_EXPORTANON ファイルシステムが、すべてのリモートアクセスを 匿名ユーザにマップします。 .It Dv MNT_EXKERB ファイルシステムが、Kerberos uid マッピングでエクスポートされます。 .El .Pp 特定のファイルシステムで定義されていないフィールドは、 -1 に設定されます。 .Fn fstatfs は、記述子 .Fa fd で参照されるオープンファイルに対して同じ情報を戻します。 .Sh 戻り値 処理が正常に完了すると、値 0 が返されます。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 .Va errno が設定されます .Sh エラー .Fn statfs は、以下のうちの 1 つ以上が真である場合にエラーとなります。 -.Bl -tag -width ENAMETOOLONGA +.Bl -tag -width Er .It Bq Er ENOTDIR .Fa path のパスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG .Fa path の構成要素が 255 文字を越えているか、または .Fa path 全体が 1023 文字を越えています。 .It Bq Er ENOENT .Fa path の参照するファイルが存在しません。 .It Bq Er EACCES .Fa path には、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP .Fa path を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EFAULT .Fa buf か .Fa path が、不正なアドレスを指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Pp .Fn fstatfs は、以下のうち 1 つ以上が真である場合にエラーとなります。 -.Bl -tag -width ENAMETOOLONGA +.Bl -tag -width Er .It Bq Er EBADF .Fa fd が有効オープンファイル記述子ではありません。 .It Bq Er EFAULT .Fa buf が不正なアドレスを指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に .Tn I/O -エラーが発生しました。 +(入出力) エラーが発生しました。 .El .Sh 歴史 .Fn statfs 関数は、 .Bx 4.4 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/swapon.2 b/ja_JP.eucJP/man/man2/swapon.2 index 15e3441ed1..531d3ffe4e 100644 --- a/ja_JP.eucJP/man/man2/swapon.2 +++ b/ja_JP.eucJP/man/man2/swapon.2 @@ -1,107 +1,111 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)swapon.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/swapon.2,v 1.6.2.3 2000/12/29 14:44:54 ru Exp % .\" .Dd June 4, 1993 .Dt SWAPON 2 .Os BSD 4 .Sh 名称 .Nm swapon -.Nd インターリーブ ページング/スワッピング用にスワップデバイスを追加する +.Nd インターリーブページング / スワップ用にスワップデバイスを追加 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn swapon "const char *special" .Sh 解説 .Fn swapon は、システムがページングとスワッピングの割当てにブロックデバイス .Fa special を使用できるようにします。 潜在的に使用できるデバイスの名前はシステムに知られていて、 システム設定時に定義されます。 .Fa special のスワップ領域のサイズは、 デバイスがスワッピングに初めて使用できるよう になるときに算出されます。 .Sh 戻り値 エラーが発生した場合は -1 が返され、エラーを示すために .Va errno が設定されます。 .Sh エラー .Fn swapon は、以下のような場合に処理を失敗します。 -.Bl -tag -width ENAMETOOLONG +.Bl -tag -width Er .It Bq Er ENOTDIR -前置パス名の構成要素がディレクトリではありません。 +パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定したデバイスが存在しません。 .It Bq Er EACCES -前置パス名の構成要素について検索許可が拒否されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EPERM スーパユーザ以外のユーザによって呼び出されました。 .It Bq Er ENOTBLK .Fa special はブロックデバイスではありません。 .It Bq Er EBUSY .Fa special で指定したデバイスは、すでにスワッピングに使用できるようになっています。 .It Bq Er EINVAL .Fa special で設定したデバイスが、システムにスワップデバイスとして設定されていません。 .It Bq Er ENXIO .Fa special のメジャーデバイス番号が範囲外になっています (これは関連するハードウェアに対応するデバイスドライバが 存在しないことを表します)。 .It Bq Er EIO スワップデバイスをオープンする間に入出力エラーが発生しました。 .It Bq Er EFAULT .Fa special は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 +.El .Sh 関連項目 .Xr config 8 , .Xr swapon 8 .Sh バグ パックを取り外せるようにするためにディスクのスワッピングを停止する方法は ありません。 .Pp この呼び出しは、システムの将来のバージョンでアップグレードされます。 .Sh 歴史 .Fn swapon 関数呼び出しは、 .Bx 4.0 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/symlink.2 b/ja_JP.eucJP/man/man2/symlink.2 index 4479dc48af..f51236d324 100644 --- a/ja_JP.eucJP/man/man2/symlink.2 +++ b/ja_JP.eucJP/man/man2/symlink.2 @@ -1,133 +1,135 @@ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" @(#)symlink.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/symlink.2,v 1.8.2.2 2000/05/06 13:34:15 phantom Exp % .\" .Dd June 4, 1993 .Dt SYMLINK 2 .Os BSD 4.2 .Sh 名称 .Nm symlink .Nd ファイルへのシンボリックリンクの作成 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn symlink "const char *name1" "const char *name2" .Sh 解説 シンボリックリンク .Fa name2 が .Fa name1 に作成されます .Pf ( Fa name2 は作成されるファイルの名前で、 .Fa name1 はシンボリックリンクの作成に使用される文字列です)。 どちらの名前も任意のパス名です。 ファイルが同じファイルシステムに存在する必要はありません。 .Sh 戻り値 処理が正常に完了すると、値 0 が返されます。エラーが発生すると エラーコードが .Va errno に保存され、-1 が返されます。 .Sh エラー 以下のような場合、シンボリックリンクはエラーとなります。 -.Bl -tag -width ENAMETOO +.Bl -tag -width Er .It Bq Er ENOTDIR .Fa name2 -前置パス名の構成要素がディレクトリではありません。 +パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT 指定されたファイルが存在しません。 .It Bq Er EACCES .Fa name2 -前置パス名の構成要素について検索許可が拒否されています。 +指定されたパスには、検索が許可されていないディレクトリが含まれています。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EEXIST .Fa name2 がすでに存在します。 .It Bq Er EIO .Fa name2 のディレクトリエントリの作成中、または .Fa name2 -の inode の割当て中、あるいは +の i ノード の割り当て中、あるいは .Fa name2 のリンクコンテンツの書き出し中に 入出力エラーが発生しました。 .It Bq Er EROFS ファイル .Fa name2 は読取り専用ファイルシステム上にあります。 .It Bq Er ENOSPC 新しいシンボリックリンクを作成するディレクトリを含むファイルシステム上に 空間が残っていないため、新しいシンボリックリンクを作成できません。 .It Bq Er ENOSPC シンボリックリンクを含むファイルシステム上にシンボリックリンクを 作る空間が残っていないため、 新しいシンボリックリンクを作成できません。 .It Bq Er ENOSPC -シンボリックリンクを作成するファイルシステム上の inode が枯渇しました。 +シンボリックリンクを作成するファイルシステム上の i ノードが枯渇しました。 .It Bq Er EDQUOT 新しいシンボリックリンクのエントリを配置するディレクトリ ディレクトリを含むファイルシステム上のユーザのディスクブロックが 枯渇したため、作成できません。 .It Bq Er EDQUOT シンボリックリンクを作るファイルシステム上のユーザの ディスクブロックのクォータが枯渇したため、 新しいシンボリックリンクを作成できません。 .It Bq Er EDQUOT -シンボリックリンクを作成するファイルシステム上のユーザの inode の +シンボリックリンクを作成するファイルシステム上のユーザの i ノードの クォータが枯渇しました。 .It Bq Er EIO -ディレクトリエントリの作成中、または inode の割当て中に +ディレクトリエントリの作成中、または i ノードの割り当て中に 入出力エラーが発生しました。 .It Bq Er EFAULT .Fa name1 か .Fa name2 が、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .El .Sh 関連項目 .Xr ln 1 , .Xr link 2 , .Xr lstat 2 , .Xr readlink 2 , .Xr unlink 2 , .Xr symlink 7 .Sh 歴史 .Fn symlink 関数呼び出しは、 .Bx 4.2 で登場しました。 -