diff --git a/ja_JP.eucJP/man/man2/_exit.2 b/ja_JP.eucJP/man/man2/_exit.2 index 452533ed1c..cb531cbe86 100644 --- a/ja_JP.eucJP/man/man2/_exit.2 +++ b/ja_JP.eucJP/man/man2/_exit.2 @@ -1,119 +1,119 @@ .\" Copyright (c) 1980, 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. .\" .\" @(#)_exit.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/_exit.2,v 1.8.2.2 1999/09/18 16:18:58 phantom Exp% +.\" %FreeBSD: src/lib/libc/sys/_exit.2,v 1.10.2.1 2000/04/22 17:06:47 phantom Exp % .\" .Dd June 4, 1993 .Dt EXIT 2 .Os BSD 4 .Sh 名称 .Nm _exit .Nd 呼び出し元プロセスを終了する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn _exit "int status" .Sh 解説 .Fn _exit -関数はプロセスを終了させ、以降のような結末をもたらします。: +関数はプロセスを終了させ、以降のような結果をもたらします。: .Bl -bullet .It 呼び出し元プロセス内のすべての記述子が閉じられます。 これには遅延が伴うことがあります。 たとえば、出力がすべて出されてしまうのを待機することです。 この状態のプロセスは既に死にかけているので、新たに kill はできません。 .It 呼び出し元プロセスの親プロセスに、未解決の .Xr wait 2 呼び出しがある場合または .Dv SIGCHLD -信号を捕捉した場合、呼び出し元プロセスの終了が親プロセスに通知され、 +シグナルを捕捉した場合、呼び出し元プロセスの終了が親プロセスに通知され、 .Xr wait 2 で定義されたように .Em status が設定されます。 .It 呼び出し元プロセスに子プロセスが存在するなら、それらすべての子プロセスの 親プロセス ID は 1 に設定されます。 初期化プロセス .Pf ( Xr intro 2 の .Sx 定義 セクションを参照) が、これらの各プロセスを継承します。 .It -プロセスの終了によっていずれかのプロセスグループが親のない子になる場合、 +プロセスの終了によっていずれかのプロセスグループが親のない子になる場合 (通常はグループのメンバ全員に対する親が終了したため。 .Xr intro 2 の .Dq 孤児になったプロセスグループ (Orphaned Process Group) を参照)、そして親のないグループのメンバのいずれかが停止されている場合、 その新たな親のないプロセスグループのすべてのメンバに .Dv SIGHUP -信号と +シグナルと .Dv SIGCONT -信号が送信されます。 +シグナルが送信されます。 .It プロセスが制御プロセスの場合 .Pf ( Xr intro 2 を参照)、 .Dv SIGHUP -信号が制御端末のフォアグラウンドプロセスグループに送信され、 -制御端末への現在のすべての呼び出しが無効にされます。 +シグナルが制御端末のフォアグラウンドプロセスグループに送信され、 +制御端末への現在のすべてのアクセスが無効にされます。 .El .Pp ほとんどの C プログラムはライブラリルーチン .Xr exit 3 -を呼び出してから +を呼び出します。これはバッファをフラッシュし、ストリームを閉じ、 +一時ファイルをアンリンクするなどした後に .Fn _exit を呼び出します。 -.Xr exit 3 -はバッファをフラッシュし、ストリームを閉じ、 -一時的ファイルをアンリンクしたりします。 .Sh 戻り値 .Fn _exit は戻りません。 .Sh 関連項目 .Xr fork 2 , .Xr sigaction 2 , .Xr wait 2 , .Xr exit 3 .Sh 規格 .Fn _exit 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn _exit 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/accept.2 b/ja_JP.eucJP/man/man2/accept.2 index 65542e6f5b..bcbf0d553a 100644 --- a/ja_JP.eucJP/man/man2/accept.2 +++ b/ja_JP.eucJP/man/man2/accept.2 @@ -1,190 +1,190 @@ .\" Copyright (c) 1983, 1990, 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. .\" .\" @(#)accept.2 8.2 (Berkeley) 12/11/93 -.\" %FreeBSD: src/lib/libc/sys/accept.2,v 1.6.2.2 1999/08/29 14:48:53 peter Exp% +.\" %FreeBSD: src/lib/libc/sys/accept.2,v 1.10.2.4 2000/08/23 00:24:37 jhb Exp % .\" .Dd December 11, 1993 .Dt ACCEPT 2 .Os BSD 4.2 .Sh 名称 .Nm accept .Nd ソケット上の接続を受け入れる +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn accept "int s" "struct sockaddr *addr" "int *addrlen" +.Fn accept "int s" "struct sockaddr *addr" "socklen_t *addrlen" .Sh 解説 引数 .Fa s は .Xr socket 2 で作成され、 .Xr bind 2 でアドレスにバインドされ、 .Xr listen 2 も済ませて接続を待ち受けているソケットです。 .Fn accept -論法は、待ち行列上の最初の接続要求を取り出し、 +呼び出しは、待ち行列上の最初の接続要求を取り出し、 .Fa s と同じプロパティの新しいソケットを作成し、 ソケットのための新しいファイル記述子を割り当てます。 接続要求が待ち行列上に存在せず、 -しかもソケットがノンブロッキングとマークされていない場合、 +しかもソケットが非ブロッキングとマークされていない場合、 .Fn accept は接続要求があるまで呼び出し側をブロックします。 -ソケットがノンブロッキングとマークされており、 +ソケットが非ブロッキングとマークされており、 しかも待ち行列に接続要求が存在しない場合、 .Fn accept は後述のようにエラーを返します。 -接続が成立したソケットは、それ以上の接続を受け入れるためには -使用されない可能性があります。 +接続が成立したソケットは、それ以上の接続を受け入れるために +使用できません。 オリジナルのソケット .Fa s は開いたままです。 .Pp 引数 .Fa addr -は結果パラメータで、通信レイヤに既知の接続エンティテイのアドレスで埋められます。 +は結果パラメータで、 +通信レイヤに既知の接続エンティティのアドレスで埋められます。 .Fa addr パラメータの正確な形式は通信が行なわれるドメインで決まります。 .Fa addrlen -は、「値−結果」パラメータです。 +は、「値 - 結果」パラメータです。 これは最初は .Fa addr が指す空間のサイズを含んでいなければなりません。 戻り時には、返されるアドレスの実際の長さ (バイト単位) を含むことになります。 この呼び出しは、コネクションをベースとしたソケットタイプ、 現在では .Dv SOCK_STREAM とともに使用されます。 .Pp 読取りでソケットを .Xr select 2 することによって、 .Fn accept するソケットを選ぶことができます。 .Pp .Tn ISO または .Tn DATAKIT のような明瞭な確認が必要な特定のプロトコルでは、 .Fn accept は単に次の接続要求を待ち行列から除くだけで、 確認は行わないと考えられます。確認は、新しいファイル記述子についての 通常の読取りまたは書込みによって行うことができ、 拒絶は新しいソケットを閉じる事によって実現できます。 .Pp .Fa msg_iovlen を 0 に、 .Fa msg_controllen を 0 でない値に設定して .Xr recvmsg 2 -を発行することによって、 -または +を発行することによって、または .Xr getsockopt 2 を発行することによって、確認なしにユーザ接続要求データを得ることができます。 同じように、制御情報だけを指定して .Xr sendmsg 2 を発行することによって、または .Xr setsockopt 2 -を発行する -ことによって、ユーザ接続拒絶情報を提供できます。 +を発行することによって、ユーザ接続拒絶情報を提供できます。 .Sh システムの注意事項 .Pp -ノンスレッドライブラリで +非スレッドライブラリで .Fn accept -は、 +は .Va accept システムコールとして実装されます。 .Pp スレッドライブラリでは、 .Va accept -システムコール -は +システムコールは .Fn _thread_sys_accept にアセンブルされ、 .Fn accept は、読取りと書込み用に -.Va s +.Fa s をロックしてから、 .Fn _thread_sys_accept -を呼び出す関数として実現されます。 +を呼び出す関数として実装されます。 .Fn _thread_sys_accept への呼び出しがブロックする場合はコンテキストスイッチが 実行されます。戻る前に .Fn accept は -.Va s +.Fa s をアンロックします。 .Pp .Sh 戻り値 -呼び出しはエラーがあった場合 \-1 を返します。 +システムコールはエラーがあった場合 \-1 を返します。 処理が正常に完了した場合、受け付けたソケットの -記述子である負でない整数を返します。 +記述子である非負整数を返します。 .Sh エラー .Fn accept は次の場合に失敗します: -.Bl -tag -width EWOULDBLOCK +.Bl -tag -width Er .It Bq Er EBADF -記述子が無効です。 +記述子が有効ではありません。 .It Bq Er EINTR .Fn accept 操作が割り込まれました。 .It Bq Er EMFILE プロセスの記述子テーブルが満杯です。 .It Bq Er ENFILE システムファイルテーブルが満杯です。 .It Bq Er ENOTSOCK 記述子がファイルを参照しておりソケットではありません。 .It Bq Er EINVAL .Xr listen 2 がソケット記述子に対して呼び出されていません。 .It Bq Er EFAULT .Fa addr -パラメータがユーザアドレス空間の書込み可能部分内にありません。 +パラメータがユーザアドレス空間の書込み可能な部分にありません。 .It Bq Er EWOULDBLOCK -ソケットがノンブロッキングとマークされており、 +ソケットが非ブロッキングとマークされ、さらに 受け付けるべき接続要求が存在しません。 .El .Sh 関連項目 .Xr bind 2 , .Xr connect 2 , .Xr getpeername 2 , .Xr listen 2 , .Xr select 2 , .Xr socket 2 .Sh 歴史 .Fn accept 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/access.2 b/ja_JP.eucJP/man/man2/access.2 index 3b82406c15..228395e4e4 100644 --- a/ja_JP.eucJP/man/man2/access.2 +++ b/ja_JP.eucJP/man/man2/access.2 @@ -1,132 +1,134 @@ .\" 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. .\" .\" @(#)access.2 8.2 (Berkeley) 4/1/94 -.\" %FreeBSD: src/lib/libc/sys/access.2,v 1.6.2.1 1999/08/29 14:48:53 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/access.2,v 1.7.2.1 2000/04/22 17:06:48 phantom Exp % .\" .Dd April 1, 1994 .Dt ACCESS 2 .Os BSD 4 .Sh 名称 .Nm access .Nd ファイルまたはパス名のアクセス許可をチェックする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn access "const char *path" "int mode" .Sh 解説 .Fn access 関数は、 .Fa mode によって示されたアクセス許可について .Fa path で指定されるファイルのアクセス可能性をチェックします。 .Fa mode の値は、チェックされるアクセス許可 (読取り許可については .Dv R_OK 、書込み許可については .Dv W_OK -、実行/検索許可については +、実行 / 検索許可については .Dv X_OK ) のビット単位の OR、または存在試験 .Dv F_OK です。 パス名 .Fa path のすべての構成要素がアクセス許可についてチェックされます .Pf ( Dv F_OK も含まれます)。 .Pp 実ユーザ ID は実効ユーザ ID の代わりに使用され、 実グループアクセスリスト (実グループ ID を含む) がパーミッションを検証するために実効 ID の代わりに使用されます。 .Pp プロセスに適切な特権があり、 .Dv X_OK について成功を示していても、実際にはファイルの実行許可ビットが 設定されていないことがあります。同じことが、 .Dv R_OK および .Dv W_OK にも該当します。 .Sh 戻り値 .Fa path -が見つからない場合、または希望のアクセスモードが認証されない場合、 +が見つからない場合、または希望のアクセスモードが認められない場合、 値 -1 が返されます。そうでない場合は、値 0 が返されます。 .Sh エラー ファイルへのアクセスは次の場合に拒絶されます。 .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 EROFS 読取り専用ファイルシステム上のファイルについて書込みアクセスが 要求されました。 .It Bq Er ETXTBSY 現時点で実行中の純粋な手続き (共有テキスト) ファイルについて書込みアクセスが要求されています。 .It Bq Er EACCES ファイルモードの許可ビットが要求されたアクセスを許容しないか、 -またはパスの先頭構成要素について検索許可が拒絶されています。 -ファイルの所有者は``所有者(owner)''読取り、書込み、 -および実行のモードビットについてパーミッションがチェックされます。 -所有者以外のファイルのグループのメンバは``グループ(group)''モードビットに -ついてパーミッションがチェックされており、 -他のすべてのものは``その他(other)''モードビットについて -パーミッションをチェックされています。 +またはパスの構成要素について検索許可が拒絶されています。 +ファイルの所有者は ``所有者 (owner)'' の読取り、書込み、 +および実行のモードビットに従ってチェックされた許可を持ちます。 +所有者以外のファイルのグループのメンバは ``グループ (group)'' モードビットに +従ってチェックされた許可を持ち、 +他のすべてのものは ``その他 (other)'' モードビットに +従ってチェックされた許可を持ちます。 .It Bq Er EFAULT .Fa path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr chmod 2 , .Xr stat 2 .Sh 規格 .Fn access 関数は .St -p1003.1-90 に準拠しています。 .Sh 警告 .Fn access は、セキュリティホールになる可能性があり、決して使用しないようにしてください。 .Sh 歴史 .Fn access 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/acct.2 b/ja_JP.eucJP/man/man2/acct.2 index 31411ea956..6e824b5feb 100644 --- a/ja_JP.eucJP/man/man2/acct.2 +++ b/ja_JP.eucJP/man/man2/acct.2 @@ -1,111 +1,113 @@ .\" 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. .\" .\" @(#)acct.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/acct.2,v 1.6.2.1 2000/04/22 17:06:48 phantom Exp % .\" .Dd June 4, 1993 .Dt ACCT 2 .Os BSD 4 .Sh 名称 .Nm acct .Nd プロセスアカウンティングを有効または無効にする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn acct "const char *file" .Sh 解説 .Fn acct 呼び出しは、システムアカウンティングレコードの収集を有効または無効にします。 引数 .Fa file -が nil ポインタである場合、アカウンティングは無効にされます。 +がヌルポインタである場合、アカウンティングは無効にされます。 .Fa file が .Em 既存 -のパス名 (null で終了) の場合、レコード収集が有効になり、 -通常の状況では終了する開始された各プロセスについてアカウンティングレコードが +のパス名 (ヌル文字で終わる) の場合、レコード収集が有効になり、 +開始されて通常の状態で終了した各プロセスについてのアカウンティングレコードが .Fa file に追加されます。 -終了の異常状況は再起動またはその他の致命的なシステムの問題です。 +異常な終了状態とは、再起動またはその他の致命的なシステムの問題です。 決して終了しないプロセス用のレコードは .Fn acct によっては作成できません。 .Pp .Fn acct が使用するレコード構造体の詳細については、 .Pa /usr/include/sys/acct.h および .Xr acct 5 を参照してください。 .Pp この呼び出しはスーパユーザにだけ許可されてます。 .Sh 注 -アカウンティングファイルが常駐しているファイルシステムが空間不足になると、 -アカウンティングは自動的に無効になります。 -スペースが再び利用できるようになると有効になります。 +アカウンティングファイルが存在しているファイルシステムの空き容量が +少なくなると、アカウンティングは自動的に無効になります。 +空き容量が増えて再び利用できるようになると有効になります。 .Sh 戻り値 エラーの場合は -1 が返されます。ファイルは存在している必要があり、 呼び出しはスーパユーザだけができます。 .Sh エラー .Fn acct は次の場合に処理を失敗します。 .Bl -tag -width Er .It Bq Er EPERM -呼び出し側がスーパユーザではありません。 +スーパユーザ以外のユーザによって呼び出されました。 .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 EROFS 指定されたファイルは読取り専用ファイルシステム上にあります。 .It Bq Er EFAULT .Fa file は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr acct 5 , .Xr sa 8 .Sh 歴史 .Fn acct 関数は .At v7 で登場しました。 - diff --git a/ja_JP.eucJP/man/man2/adjtime.2 b/ja_JP.eucJP/man/man2/adjtime.2 index cca0ee9f5e..27ed90d1da 100644 --- a/ja_JP.eucJP/man/man2/adjtime.2 +++ b/ja_JP.eucJP/man/man2/adjtime.2 @@ -1,105 +1,109 @@ .\" 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. .\" .\" @(#)adjtime.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/adjtime.2,v 1.6.2.1 2000/04/22 17:06:48 phantom Exp % .\" .Dd June 4, 1993 .Dt ADJTIME 2 .Os BSD 4.3 .Sh 名称 .Nm adjtime .Nd "システムクロックとの同期化ができるように時刻を訂正する" +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn adjtime "const struct timeval *delta" "struct timeval *olddelta" .Sh 解説 .Fn adjtime は、 .Xr gettimeofday 2 -によって返されたシステム時刻を微調整します。 +が返すようなシステム時刻を微調整します。 時間値 .Fa delta で指定された時間だけシステム時刻を進ませる、または遅らせます。 .Fa delta が負の場合、 訂正が完了するまでクロックをよりゆっくりと増加させることによって クロックを低速化します。 .Fa delta が正の場合は通常より大きな増分を使用します。 訂正を実行するために使用されるずれは、 -一般には 1 パーセントぐらいの値です。このように、時刻は常に単調増加関数です。 +一般には 1 パーセントの割合です。これにより、時刻は常に単調増加関数となります。 +以前の .Fn adjtime -の以前の呼び出しの時刻訂正が、 +呼び出しによる時刻訂正が、再び .Fn adjtime -が再び呼び出された時までに終了しない可能性があります。 +が呼び出された時に完了していない可能性があります。 .Fa olddelta -が nil でない場合、指し示されている構造体は、戻り時に -以前の呼び出しで依然として -訂正する必要のある数マイクロ秒を含んでいるでしょう。 +が nil でない場合、指し示されている構造体は、 +以前の呼び出しからの、依然として +訂正する必要のあるマイクロ秒単位の数が戻り時に格納されているでしょう。 .Pp この呼び出しは、ローカルエリアネットワーク内のコンピュータのクロックを -同期化するタイムサーバが使用することがあります。 +同期するタイムサーバが使用することがあります。 このようなタイムサーバはマシンのクロックを低速化、または 高速化して、それらを平均ネットワーク時刻にします。 .Pp .Fn adjtime の呼び出しはスーパユーザに限定されています。 .Sh 戻り値 戻り値 0 は呼び出しが成功したことを示します。 戻り値 -1 はエラーが発生したことを示します。 この場合、エラーコードはグローバル変数 .Va errno に保存されます。 .Sh エラー .Fn adjtime は次の場合に処理を失敗します。 .Bl -tag -width Er .It Bq Er EFAULT 引数は、プロセスに割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EPERM プロセスの実効ユーザ ID がスーパユーザのものではありません。 .El .Sh 関連項目 .Xr date 1 , .Xr gettimeofday 2 , .Xr timed 8 , .Xr timedc 8 .Rs .%T "TSP: The Time Synchronization Protocol for UNIX 4.3BSD" .%A R. Gusella .%A S. Zatti .Re .Sh 歴史 .Fn adjtime 関数は .Bx 4.3 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/aio_cancel.2 b/ja_JP.eucJP/man/man2/aio_cancel.2 index ee4de35425..7f9b8c6274 100644 --- a/ja_JP.eucJP/man/man2/aio_cancel.2 +++ b/ja_JP.eucJP/man/man2/aio_cancel.2 @@ -1,75 +1,108 @@ .\" 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_cancel.2,v 1.4.2.2 1999/08/29 14:48:54 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/aio_cancel.2,v 1.5.2.4 2000/12/08 13:49:31 ru Exp % .\" -.Dd June 2, 1999 +.Dd January 19, 2000 .Dt AIO_CANCEL 2 .Os .Sh 名称 .Nm aio_cancel .Nd 未解決の非同期入出力操作をキャンセルする (REALTIME) +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int -.Fn aio_cancel "int something" "struct aiocb * iocb" +.Fn aio_cancel "int fildes" "struct aiocb * iocb" .Sh 解説 .Fn aio_cancel -関数は、指定の未解決の非同期入出力要求をキャンセルすると想定されます。 +関数は +.Fa fildes +で指定されるファイル記述子の未解決の非同期入出力をキャンセルします。 +.Fa iocb +が指定された場合、指定された非同期入出力要求だけをキャンセルします。 +.Pp +通常の非同期通知がキャンセルされた要求に対して発生します。要求は +.Er ECANCELED +のエラー結果となって完了します。 +.Sh 制限 +.Fn aio_cancel +関数は raw ディスクデバイスに対する非同期入出力をキャンセルしません。 .Fn aio_cancel -は今回は実現されず、必ず処理失敗して -.Dv ENOSYS -を返しています。 +は、raw ディスクデバイスに関連づけられたファイル記述子に対しては常に +.Dv AIO_NOTCANCELED +を返します。 .Sh 戻り値 .Fn aio_cancel -は、処理失敗しなければならない場合、 -.Dv ENOSYS -を返して、これがサポートされていないことを示します。 +は -1 を返してエラーまたは次のうちの一つを示します。 +.Bl -tag -width Dv +.It Bq Dv AIO_CANCELED +指定された条件のすべての未解決要求はキャンセルされました。 +.It Bq Dv AIO_NOTCANCELED +いくつかの要求はキャンセルされず、 +その要求の状態は +.Xr aio_error 2 +でチェックすべきです。 +.It Bq Dv AIO_ALLDONE +条件に合致するすべての要求は完了しています。 +.El .Sh 関連項目 .Xr aio_error 2 , .Xr aio_read 2 , .Xr aio_return 2 , .Xr aio_suspend 2 , .Xr aio_write 2 . .Sh エラー .Fn aio_cancel -関数は次の理由で現時点では必ず処理失敗します。 +から返されるエラーは、次のことを示します: .Bl -tag -width Er -.It Bq Er ENOSYS -この操作は今回は実現されていません。 +.It Bq Er EBADF +.Fa fildes +が有効なファイル記述子ではありません。 .El -.Sh 規格 -.Nm -は、 +.Sh STANDARDS +.Fn aio_cancel +は .St -p1003.2 -標準に準拠していません。 +に準拠しています。 .Sh 歴史 -.Nm +.Fn aio_cancel 関数は .Fx 3.0 +ではじめて登場しました。機能する +.Fn aio_cancel +の実装は +.Fx 4.0 ではじめて登場しました。 .Sh 作者 -このマニュアルは +このマニュアルは始めに .An Wes Peters Aq wes@softweyr.com が作成しました。 +.Fn aio_cancel +が +.Fx 4.0 +に実装された時に +.An Christopher M Sedore Aq cmsedore@maxwell.syr.edu +が更新しました。 diff --git a/ja_JP.eucJP/man/man2/aio_error.2 b/ja_JP.eucJP/man/man2/aio_error.2 index 173621c331..b84c5e51e8 100644 --- a/ja_JP.eucJP/man/man2/aio_error.2 +++ b/ja_JP.eucJP/man/man2/aio_error.2 @@ -1,91 +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.4.2.2 1999/08/29 14:48:54 peter Exp % +.\" %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 "struct aiocb *iocb" +.Fn aio_error "const struct aiocb *iocb" .Sh 解説 .Fn aio_error 関数は、 -.Ar iocb +.Fa iocb の指す構造体に対応する非同期入出力要求のエラー状態を返します。 .Sh 戻り値 非同期入出力要求が成功した上で正常に完了している場合に .Fn aio_error は 0 を返します。 要求がまだ完了していない場合は -.Dv EINPROGRESS +.Er EINPROGRESS が返されます。 要求が失敗した上で完了している場合、 .Xr read 2 , .Xr write 2 , .Xr fsync 2 に記述されているようなエラーステータスが返されます。 処理が失敗した場合に .Fn aio_error は .Dv -1 を返し、 .Dv errno を設定してエラー状態を示します。 .Sh エラー .Fn aio_error は次の場合に失敗します: .Bl -tag -width Er .It Bq Er EINVAL -.Ar iocb +.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 e4948bd2dc..671aa3fc90 100644 --- a/ja_JP.eucJP/man/man2/aio_read.2 +++ b/ja_JP.eucJP/man/man2/aio_read.2 @@ -1,204 +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 関数は、呼び出しプロセスに 記述子 -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes のオフセット -.Ar iocb->aio_offset +.Fa iocb->aio_offset で始まる -.Ar iocb->aio_nbytes +.Fa iocb->aio_nbytes を、 -.Ar iocb->aio_buf +.Fa iocb->aio_buf が指すバッファに -読み取れるようにします。 +読取れるようにします。 呼び出しは、読取り要求が記述子に待ち行列として入れられ るとただちに戻ります。 呼び出しが戻った時点で読取りは完了していることもありますし、 完了していないこともあります。 .Pp _POSIX_PRIORITIZED_IO が定義されており、 しかも記述子がこれをサポートしている場合に 待ち行列に入れられている操作は、呼び出しプロセスの優先順位から -.Ar iocb->aio_reqprio -を除算したものに等しい優先順位でサブミットされます。 +.Fa iocb->aio_reqprio +を減じたものに等しい優先順位でサブミットされます。 .Pp -.Ar iocb->aio_lio_opcode +.Fa iocb->aio_lio_opcode は .Fn aio_read 呼び出しによって無視されます。 .Pp -.Ar iocb +.Fa iocb ポインタは、進行中に待ち行列に入れられた戻りステータスまたは エラーステータスを判定するために、 .Fn aio_return と .Fn aio_error の引数として後に使用される可能性があります。 .Pp 要求が待ち行列に入れられない場合 (一般には無効な引数のために)、 呼び出しは要求を待ち行列に入れずに戻ります。 .Pp 要求が正常に待ち行列に入れられると、コンテキストとして要求の間に -.Ar iocb->aio_offset +.Fa iocb->aio_offset の値が修正される可能性があるので、 この値は要求が待ち行列に入れられた後は参照してはなりません。 .Sh 制限 -.Ar iocb +.Fa iocb が指す非同期入出力制御ブロック構造体、およびその構造体の -.Ar iocb->aio_buf +.Fa iocb->aio_buf メンバが参照するバッファは、操作が完了するまで有効である必要があります。 このため、これらのオブジェクトについての自動 (スタック) 変数の 使用は推奨されません。 .Pp -カーネルへの無効なコンテキスト情報の引き渡しを回避するために、 +カーネルへの正しくないコンテキスト情報の引き渡しを回避するために、 非同期入出力制御バッファ -.Ar iocb +.Fa iocb は .Fn aio_read 呼び出しの前にゼロにする必要があります。 .Pp 要求が待ち行列に入れられた後、要求が完了するまでは 非同期入出力制御ブロック構造体またはバッファ内容の修正は許されていません。 .Pp -.Ar iocb->aio_offset +.Fa iocb->aio_offset 内のファイルオフセットが、 -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes の最大オフセットを越えている場合は入出力は行われません。 .Sh 戻り値 .\".Rv -std aio_read .Fn aio_read 関数は、成功すると値 0 を返します。それ以外の場合は値 -1 が 返され、エラーを示すグローバル変数 .Fa errno が設定されます。 -.Sh 規格 -.Fn aio_read -呼び出しは -.St -p1003.2 -標準に準拠しています。 .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 を返し、 -.Ar errno +.Va errno を適切に設定します。 そうでない場合は、 .Fn aio_return 関数を呼び出し、-1 を返し、 -.Ar errno +.Va errno に返されている実際の値を判定するために .Fn aio_error を呼び出す必要があります。 .Pp .Bl -tag -width Er .It Bq Er EBADF .Ar iocb->aio_fildes が無効です。 .It Bq Er EINVAL オフセット -.Ar iocb->aio_offset +.Fa iocb->aio_offset が有効でないか、 -.Ar iocb->aio_reqprio +.Fa iocb->aio_reqprio によって指定される優先順位が 有効な優先順位でないか、または -.Ar iocb->aio_nbytes +.Fa iocb->aio_nbytes によって指定されるバイト数が有効でありません。 .It Bq Er EOVERFLOW ファイルは正規のファイルであり、 -.Ar iocb->aio_nbytes +.Fa iocb->aio_nbytes はゼロより大きくて -.Ar iocb->aio_offset +.Fa iocb->aio_offset 内の開始オフセットはファイルの末尾の前にあるものの、 -.Ar iocb->aio_fildes +.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 -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes が読取りについては無効です。 .It Bq Er ECANCELED 要求は .Fn aio_cancel -への呼び出しによって明示的にキャンセルされました。 +の呼び出しによって明示的にキャンセルされました。 .It Bq Er EINVAL オフセット -.Ar iocb->aio_offset +.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 バグ -.Ar iocb->aio_offset +.Fa iocb->aio_offset の値は無視されます。 -.Ar iocb->_aiocb_private +.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 070ae841af..28de3f6aac 100644 --- a/ja_JP.eucJP/man/man2/aio_return.2 +++ b/ja_JP.eucJP/man/man2/aio_return.2 @@ -1,93 +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.4.2.2 1999/08/29 14:48:55 peter Exp % +.\" %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 関数は -.Ar iocb +.Fa iocb が指す構造体に対応する非同期入出力要求の最終ステータスを返します。 .Pp .Xr aio_error 2 が -.Dv EINPROGRESS +.Er EINPROGRESS 以外の何かを返した時の非同期入出力操作の最終ステータスを得るためには .Fn aio_return を 1 回だけしか呼び出してはいけません。 .Sh 戻り値 非同期入出力要求が完了すると .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 -.Ar iocb +.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/aio_suspend.2 b/ja_JP.eucJP/man/man2/aio_suspend.2 index b7f41653fb..5037435eb1 100644 --- a/ja_JP.eucJP/man/man2/aio_suspend.2 +++ b/ja_JP.eucJP/man/man2/aio_suspend.2 @@ -1,88 +1,101 @@ .\" 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_suspend.2,v 1.4.2.2 1999/08/29 14:48:56 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/aio_suspend.2,v 1.8.2.2 2000/08/23 00:45:18 jhb Exp % .\" .Dd June 2, 1999 .Dt AIO_SUSPEND 2 .Os .Sh 名称 .Nm aio_suspend .Nd 非同期入出力操作完了、またはタイムアウト経過まで延期する (REALTIME) +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn aio_suspend "const struct aiocb * const iocbs[]" "int niocb" "const struct timespec * timeout" .Sh 解説 -指定の非同期入出力要求が完了するか、 -.Ar timeout +指定の非同期入出力要求のうち少なくとも 1 つが完了するか、 +.Fa timeout が経過するまで .Fn aio_suspend 関数は呼び出しプロセスを延期します。 -.Ar iocbs +.Pp +.Fa iocbs は、非同期入出力要求への .Ar niocb ポインタの配列です。 NULL が入っている配列メンバはそのまま無視されます。 +.Pp +.Fa timeout +がヌルポインタでない場合、それは延期する時間の最大インターバルを指定します。 +.Fa timeout +がヌルポインタの場合、無期限に延期します。ポーリングするためには +.Fa timeout +は値 0 の timespec 構造体を指しているべきです。 .Sh 戻り値 -指定されたすべての非同期入出力要求が完了すると +指定された 1 つ以上の非同期入出力要求が完了すると .Fn aio_suspend は 0 を返します。 -.Ar timeout -が時間切れになると -.Dv EAGAIN -が返されます。他の戻り値は後述するようにエラー状態を示します。 +そうでない場合は -1 を返し、後述するように +.Va errno +がエラー状態を示すためにセットされます。 .Sh 関連項目 .Xr aio_cancel 2 , .Xr aio_error 2 , .Xr aio_read 2 , .Xr aio_suspend 2 , -.Xr aio_write 2 . +.Xr aio_write 2 .Sh エラー .Fn aio_suspend 関数は次の場合に失敗します。 .Bl -tag -width Er +.It Bq Er EAGAIN +入出力要求がどれも完了しないうちに +.Fa timeout +が時間切れになりました。 .It Bq Er EINVAL -.Ar iocbs +.Fa iocbs には .Dv AIO_LISTIO_MAX を越える非同期入出力要求が入っているか、または少なくとも 1 つの要求が 有効ではありません。 .It Bq Er EINTR 延期はシグナルによって割り込みされました。 .El .Sh 規格 .Fn aio_suspend は .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_write.2 b/ja_JP.eucJP/man/man2/aio_write.2 index ea1f65bbcb..b642160f2a 100644 --- a/ja_JP.eucJP/man/man2/aio_write.2 +++ b/ja_JP.eucJP/man/man2/aio_write.2 @@ -1,196 +1,198 @@ .\" 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_write.2,v 1.3.2.2 1999/08/29 14:48:57 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/aio_write.2,v 1.4.2.3 2000/12/29 14:44:51 ru Exp % .\" .Dd June 2, 1999 .Dt AIO_WRITE 2 .Os .Sh 名称 .Nm aio_write .Nd ファイルへの非同期書込み (REALTIME) +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn aio_write "struct aiocb *iocb" .Sh 解説 .Fn aio_write 関数によって、呼び出し元プロセスは -.Ar iocb->aio_buf +.Fa iocb->aio_buf が指すバッファから記述子 -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes に -.Ar iocb->aio_nbytes +.Fa iocb->aio_nbytes を書き込めます。書込み要求が記述子への待ち行列に入れられてしまうと ただちに呼び出しは戻ります。 呼び出しが戻った時点で書込みは完了している可能性も完了していない 可能性もあります。無効な引数のためなどにより 要求を待ち行列に入れられない場合は、 -呼び出しは要求を待ち行列入れずに戻ります。 +呼び出しは要求を待ち行列に入れずに戻ります。 .Pp -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes 用に .Dv O_APPEND が設定されている場合、 .Fn aio_write 操作は呼び出しが行なわれたのと同じ順序で ファイルの末尾に追加されます。 .Dv O_APPEND がファイル記述子用に設定されていない場合、書込み操作はファイルの先頭に -.Ar iocb->aio_offset +.Fa iocb->aio_offset を加えた絶対位置で行われます。 .Pp .Dv _POSIX_PRIORITIZED_IO が定義されており、かつ記述子がそれをサポートしている場合、 待ち行列に入れられた操作は呼び出しプロセスの優先順位から -.Ar iocb->aio_reqprio +.Fa iocb->aio_reqprio を減算したのに等しい優先順位にされます。 .Pp -.Ar iocb +.Fa iocb ポインタは待ち行列に入れられた操作の戻り値、またはエラー状態を 判定するために、 .Fn aio_return および .Fn aio_error への引数として使用できます。 .Pp 要求が正常に待ち行列に入れられると、コンテキストとして要求の間に -.Ar iocb->aio_offset +.Fa iocb->aio_offset の値が修正できるので、 この値は要求が待ち行列に入れられた後に参照されてはなりません。 .Sh 制限 -.Ar iocb +.Fa iocb が指す非同期入出力制御ブロック構造体、およびその構造体の -.Ar iocb->aio_buf +.Fa iocb->aio_buf メンバが参照するバッファは、 操作が完了するまで有効なままでいる必要があります。 このため、これらのオブジェクトについて自動 (スタック) 変数 の使用は推奨されません。 .Pp 正しくないコンテキスト情報がカーネルに引き渡されるのを回避するために、 非同期入出力制御バッファ -.Ar iocb +.Fa iocb は、 .Fn aio_read -呼び出しの前にゼロにする必要があります。 +呼び出しの前に 0 にする必要があります。 .Pp 要求が待ち行列に入れられた後、要求が完了するまでは -非同期入出力制御ブロック構造体、またはバッファ内容 -を修正することは許されません。 +非同期入出力制御ブロック構造体、 +またはバッファの内容を修正することは許されません。 .Pp -.Ar iocb->aio_offset +.Fa iocb->aio_offset 内のファイルオフセットが -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes 用のオフセット最大を越える場合は入出力は行われません。 .Sh 戻り値 .\".Rv -std aio_write .Fn aio_write 関数は成功すると値 0 を返します。それ以外の場合は値 -1 が 返され、エラーを示すグローバル変数 -.Fa errno +.Ar errno が設定されます。 .Sh エラー .Fn aio_write 関数は次の場合に処理を失敗します: .Bl -tag -width Er .It Bq Er EAGAIN システムリソースの制限のために要求は待ち行列に入れられませんでした。 .It Bq Er ENOSYS .Fn aio_write 呼び出しはサポートされていません。 .El .Pp 次の状態は .Fn aio_write -呼び出しが行なわれたときに同期的に検出でき、その後いつでも非同期的に検出できます。 +呼び出しが行なわれたときに同期的に検出でき、 +その後いつでも非同期的に検出できます。 これらが呼び出し時に検出された場合に .Fn aio_write は -1 を返し -.Ar errno +.Va errno を適切に設定します。 そうでない場合は .Fn aio_return 関数が戻り値 -1 で呼び出される必要があり、 -.Ar errno +.Va errno で返されている実際の値を判定するために -.Fn aio_error +.Fn aio_erro が呼び出される必要があります。 .Pp .Bl -tag -width Er .It Bq Er EBADF -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes が無効であるか、書込みには開かれていません。 .It Bq Er EINVAL オフセット -.Ar iocb->aio_offset +.Fa iocb->aio_offset が有効でない、 -.Ar iocb->aio_reqprio +.Fa iocb->aio_reqprio によって指定される優先順位が 有効な優先順位でない、または -.Ar iocb->aio_nbytes +.Fa iocb->aio_nbytes によって指定されるバイト数が有効ではありません。 .El .Pp 要求が正常に待ち行列に入れられたものの、 後でキャンセルされるかエラーが発生した場合、 .Fn aio_return -関数 -によって返された値は +関数によって返された値は .Xr write 2 呼び出しごとのものであり、 .Fn aio_error 関数によって返された値は .Xr write 2 呼び出しから返されたエラーの 1 つであるか、または次の 1 つです。 .Bl -tag -width Er .It Bq Er EBADF -.Ar iocb->aio_fildes +.Fa iocb->aio_fildes は書込みについては無効です。 .It Bq Er ECANCELED 要求は .Fn aio_cancel -への呼び出しによって明示的にキャンセルされました。 +の呼び出しによって明示的にキャンセルされました。 .It Bq Er EINVAL オフセット -.Ar iocb->aio_offset +.Fa iocb->aio_offset は無効です。 .El .Sh 規格 .Fn aio_write は .St -p1003.2 標準に準拠しています。 .Sh 歴史 .Nm 関数は .Fx 3.0 ではじめて登場しました。 .Sh 作者 このマニュアルページは .An Wes Peters Aq wes@softweyr.com が作成しました。 .Sh バグ 非同期入出力操作はこのバージョンではキャンセルできません。 -.Ar iocb->_aiocb_private +.Fa iocb->_aiocb_private 内の誤った情報はカーネルを混乱させる可能性があります。 diff --git a/ja_JP.eucJP/man/man2/bind.2 b/ja_JP.eucJP/man/man2/bind.2 index e30702765c..b10710cc0c 100644 --- a/ja_JP.eucJP/man/man2/bind.2 +++ b/ja_JP.eucJP/man/man2/bind.2 @@ -1,145 +1,149 @@ .\" 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. .\" .\" @(#)bind.2 8.1 (Berkeley) 6/4/93 -.\" %Id: bind.2,v 1.7 1999/06/10 22:48:27 markm Exp % +.\" %FreeBSD: src/lib/libc/sys/bind.2,v 1.11.2.3 2000/08/23 00:45:18 jhb Exp % .\" .Dd June 4, 1993 .Dt BIND 2 .Os BSD 4.2 .Sh 名称 .Nm bind .Nd ローカルプロトコルアドレスをソケットに割り当てる +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn bind "int s" "const struct sockaddr *addr" "int addrlen" +.Fn bind "int s" "const struct sockaddr *addr" "socklen_t addrlen" .Sh 解説 .Fn bind は、ローカルプロトコルアドレスをソケットに割り当てます。ソケットは、 .Xr socket 2 で作成される時にアドレスファミリ空間に存在しますが、 プロトコルアドレスは割り当てられていません。 .Fn bind -は +はソケットに .Fa addr -がソケットに割り当てられていることを必要とします。 +を割り当てることを要求します。 .Sh 注 UNIX ドメイン内でのアドレスのバインドによってファイルシステム内に ソケットが作成されます。 これは、必要なくなったときに呼び出し側が .Pf ( Xr unlink 2 を使用して) 削除する必要があります。 .Pp アドレスのバインドで使用される規則は通信ドメイン間で異なります。 詳細については、 セクション 4 のマニュアルエントリを参照してください。 .Sh システムの注意事項 .Pp -ノンスレッドライブラリでは、 +非スレッドライブラリでは、 .Fn bind は .Va bind システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va bind システムコールは .Fn _thread_sys_bind にアセンブルされ、 .Fn bind は読取りと書込み用に -.Va s +.Fa s をロックしてから、 .Fn _thread_sys_bind を呼び出す 関数として実装されています。戻る前に、 .Fn bind は -.Va s +.Fa s をアンロックします。 .Sh 戻り値 バインドは成功すると値 0 を返します。戻り値 -1 はエラーを示し、 このエラーはグローバル .Va errno で指定されています。 .Sh エラー .Fn bind 呼び出しは次の場合に失敗します。 -.Bl -tag -width EADDRNOTAVA +.Bl -tag -width Er +.It Bq Er EAGAIN +要求を満たすためのカーネルリソースが一時的に利用できません。 .It Bq Er EBADF .Fa s が有効な記述子ではありません。 .It Bq Er ENOTSOCK .Fa s がソケットではありません。 .It Bq Er EADDRNOTAVAIL 指定のアドレスがローカルマシンから利用できません。 .It Bq Er EADDRINUSE 指定のアドレスは既に使用中です。 .It Bq Er EACCES 要求されたアドレスは保護されており、現在のユーザが持っているパーミッションは それにアクセスするのには不適切です。 .It Bq Er EFAULT .Fa addr パラメータが有効なユーザアドレス空間ではありません。 .El .Pp 次のエラーは UNIX ドメイン内のバインドアドレスに固有のものです。 .Bl -tag -width EADDRNOTAVA .It Bq Er ENOTDIR パスの構成要素中にディレクトリ以外のものが含まれています。 .It Bq Er ENAMETOOLONG パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。 .It Bq Er ENOENT パス名の接頭辞構成要素が存在しません。 .It Bq Er ELOOP パス名を変換するときに検出されたシンボリックリンクが多すぎます。 .It Bq Er EIO -ディレクトリエントリを作成している間、または iノードを割り振りしている間に +ディレクトリエントリを作成している間、または i ノードを割り振りしている間に 入出力エラーが発生しました。 .It Bq Er EROFS -名前が読取り専用ファイルシステムに常駐します。 +指定されたファイルは読取り専用ファイルシステム上にあります。 .It Bq Er EISDIR 空のパス名が指定されました。 .El .Sh 関連項目 .Xr connect 2 , .Xr getsockname 2 , .Xr listen 2 , .Xr socket 2 .Sh 歴史 .Fn bind 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/brk.2 b/ja_JP.eucJP/man/man2/brk.2 index f2f44c0cb9..9d80057542 100644 --- a/ja_JP.eucJP/man/man2/brk.2 +++ b/ja_JP.eucJP/man/man2/brk.2 @@ -1,127 +1,130 @@ .\" 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. .\" .\" @(#)brk.2 8.4 (Berkeley) 5/1/95 +.\" %FreeBSD: src/lib/libc/sys/brk.2,v 1.13.2.3 2000/12/29 14:44:51 ru Exp % .\" .Dd May 1, 1995 .Dt BRK 2 .Os BSD 4 .Sh 名称 .Nm brk , .Nm sbrk .Nd データセグメントのサイズを変更する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn brk "const char *addr" .Ft char * .Fn sbrk "int incr" .Sh 解説 .Bf -symbolic brk 関数と sbrk 関数は、仮想メモリ管理の到来の前の初期の日々から残された 歴史的に興味あるものです。 .Ef .Fn brk 関数は、プロセスのデータセグメント (初期化されていないデータ) のブレーク または最下位アドレスを .Fa addr (bss の真上) に設定します。データアドレス指定は、 .Fa addr とスタックセグメントへの最も低いスタックポインタの間に制約されます。 メモリはページサイズ単位で .Fa brk によって割当てされます。 .Fa addr は、システムページサイズ上に均等に分割されない場合には 次のページ境界まで増加させます。 .Pp プログラムブレークの現在の値は、 .Dq Li sbrk(0) によって信頼性をもって返されます .Pf ( Xr end 3 も参照)。 .Xr getrlimit 2 システムコールは、 .Em data セグメントの許容できる最大のサイズを決定するのに利用できます。 .Xr getrlimit 2 の呼び出しから返された .Em rlim_max 値を越えるブレークを設定することはできません。たとえば、 .Dq etext + rlp\(->rlim_max です .Pf ( Em etext の定義については .Xr end 3 を参照してください)。 .Sh 戻り値 .Fn brk は、正常に完了すると 0 を返します。それ以外の場合は値 -1 を返し、 割当てが処理失敗した理由を示す .Va errno が設定されます。 .Fn sbrk 関数は、正常に完了すると新しい記憶域のベースを指すポインタを 返します。それ以外の場合は値 -1 を返し、割当てが処理失敗した理由を示す .Va errno が設定されます。 .Sh エラー .Fn brk または .Fn sbrk は、以降のうちの 1 つが真の場合に処理に失敗し、新しくメモリを 割当てられません。 -.Bl -tag -width [ENOMEM] +.Bl -tag -width Er .It Bq Er ENOMEM .Xr setrlimit 2 が設定した限界を越えました。 .It Bq Er ENOMEM データセグメントの可能な最大サイズ (システム内部にコンパイルされます) を越えました。 .It Bq Er ENOMEM 展開をサポートするスワップ領域内に不充分な空間が存在しました。 .El .Sh 関連項目 .Xr execve 2 , .Xr getrlimit 2 , .Xr end 3 , .Xr malloc 3 .Sh バグ ブレークの設定は、スワップ空間の一次的な不足のために処理が失敗する 可能性があります。これは .Xr getrlimit 2 を使用せずには、データセグメントの最大サイズを越えることで起こされた 障害と区別することはできません。 .Sh 歴史 .Fn brk 関数は .At v7 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/fork.2 b/ja_JP.eucJP/man/man2/fork.2 index 39d8f790d3..762f4005b6 100644 --- a/ja_JP.eucJP/man/man2/fork.2 +++ b/ja_JP.eucJP/man/man2/fork.2 @@ -1,122 +1,124 @@ .\" 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. .\" .\" @(#)fork.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/fork.2,v 1.7.2.2 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/fork.2,v 1.9.2.2 2000/05/06 13:34:14 phantom Exp % .\" .Dd June 4, 1993 .Dt FORK 2 .Os BSD 4 .Sh 名称 .Nm fork .Nd 新しいプロセスを作成する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft pid_t .Fn fork void .Sh 解説 .Fn fork によって新しいプロセスの作成が行われます。新しいプロセス (子プロセス)は、 以下の項目を除いた呼び出しプロセス (親プロセス) の正確なコピーです。 .Bl -bullet -offset indent .It 子プロセスはユニークなプロセス ID を持ちます。 .It 子プロセスは異なる親プロセス ID を持ちます (すなわち、親プロセスのプロセス ID です)。 .It 子プロセスは、専用の、親の記述子のコピーを持ちます。 それらの記述子は下層の同じオブジェクトを参照します。 つまり子と親の間で、たとえばファイルオブジェクト内の ファイルポインタが共有されます。そのため 子プロセスの記述子への .Xr lseek 2 が、その後の親による .Xr read 2 または .Xr write 2 に影響を及ぼします。この記述子コピーは、 新しく作成されたプロセス用の標準入出力を確立するために、 およびパイプをセットアップするために、シェルによっても使用されます。 .It 子プロセスのリソース使用状況は 0 に設定されます。 .Xr setrlimit 2 を参照してください。 .El .Sh 戻り値 正常に完了した場合、 .Fn fork は、子プロセスに値 0 を返し、子プロセスのプロセス ID を親プロセスに返します。 そうでない場合は -1 が親プロセスに返され、子プロセスは作成されずに、 エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー 次の場合に .Fn fork は処理に失敗し、子プロセスは作成されません。 -.Bl -tag -width [EAGAIN] +.Bl -tag -width Er .It Bq Er EAGAIN -実行中のプロセスの合計数についてシステムが課する限界を超えます。限界値は +実行中のプロセスの合計数がシステムの限界を超えます。限界値は .Xr sysctl 3 の MIB 変数の .Dv KERN_MAXPROC によって指定されます (スーパユーザを除いて、 実際には限界はこれより 1 つ小さくなります)。 .It Bq Er EAGAIN ユーザがスーパユーザでなく、 1 人のユーザによって実行中のプロセスの合計数にシステムが課す 限界を越えます。限界は .Xr sysctl 3 の MIB 変数の .Dv KERN_MAXPROCPERUID によって指定されます。 .It Bq Er EAGAIN ユーザがスーパユーザでなく、リソースパラメータの .Dv RLIMIT_NPROC に対応するソフトリソース限界を越えます。 .Pf ( Xr getrlimit 2 を参照)。 .It Bq Er ENOMEM 新しいプロセス用のスワップ空間が不充分です。 .El .Sh 関連項目 .Xr execve 2 , .Xr rfork 2 , .Xr setrlimit 2 , .Xr vfork 2 , .Xr wait 2 .Sh 歴史 .Fn fork 関数は .At v6 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/fsync.2 b/ja_JP.eucJP/man/man2/fsync.2 index cab8212c8b..66bc937599 100644 --- a/ja_JP.eucJP/man/man2/fsync.2 +++ b/ja_JP.eucJP/man/man2/fsync.2 @@ -1,102 +1,105 @@ .\" 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. .\" .\" @(#)fsync.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/fsync.2,v 1.6.2.5 2000/12/29 14:44:52 ru Exp % .\" .Dd June 4, 1993 .Dt FSYNC 2 .Os BSD 4.2 .Sh 名称 .Nm fsync -.Nd "ディスク上のファイルをメモリ上の状態と同期化する" +.Nd "ファイルに変更を同期する" +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn fsync "int fd" .Sh 解説 .Fn fsync によって、 .Fa fd の修正されたすべてのデータと属性が永続的なストレージデバイスに移動されます。 これによって、対応するファイルに関するバッファのすべての メモリ上のコピーで、修正された物がディスクに書き込まれる結果になるのが 普通です。 .Pp .Fn fsync は、ファイルが既知の状態にあることを要求するプログラムによって 使用される必要があります。たとえば、簡単なトランザクション機能の構築です。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn fsync は .Va fsync システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va fsync システムコールは .Fn _thread_sys_fsync にアセンブルされ、 .Fn fsync は、読取りと書込みについて -.Va fd +.Fa fd をロックしてから .Fn _thread_sys_fsync を呼び出す関数として実装されています。戻る前に .Fn fsync は -.Va fd +.Fa fd をアンロックします。 .Sh 戻り値 正常に完了すると値 0 が返されます。値 -1 はエラーを示します。 .Sh エラー .Fn fsync は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBADF .Fa fd が有効な記述子ではありません。 .It Bq Er EINVAL .Fa fd がファイルではなくソケットを参照しています。 .It Bq Er EIO ファイルシステムに読み書きしている間に入出力エラーが発生しました。 .El .Sh 関連項目 .Xr sync 2 , -.Xr update 4 , +.Xr syncer 4 , .Xr sync 8 .Sh 歴史 .Fn fsync 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getdirentries.2 b/ja_JP.eucJP/man/man2/getdirentries.2 index d8217e116c..0ece8f5e09 100644 --- a/ja_JP.eucJP/man/man2/getdirentries.2 +++ b/ja_JP.eucJP/man/man2/getdirentries.2 @@ -1,197 +1,200 @@ .\" 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. .\" .\" @(#)getdirentries.2 8.2 (Berkeley) 5/3/95 +.\" %FreeBSD: src/lib/libc/sys/getdirentries.2,v 1.12.2.2 2000/08/23 00:45:18 jhb Exp % .\" .Dd May 3, 1995 .Dt GETDIRENTRIES 2 .Os .Sh 名称 .Nm getdirentries , .Nm getdents -.Nd "ファイルシステムに独立な書式のディレクトリエントリを取得する" +.Nd "ファイルシステムに独立なフォーマットのディレクトリエントリを取得する" +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn getdirentries "int fd" "char *buf" "int nbytes" "long *basep" .Ft int .Fn getdents "int fd" "char *buf" "int nbytes" .Sh 解説 .Fn getdirentries 関数と .Fn getdents 関数は、ファイル記述子 .Fa fd が参照するディレクトリから .Fa buf -が指すバッファ内に、ファイルシステムに独立な書式の +が指すバッファ内に、ファイルシステムに独立なフォーマットの ディレクトリエントリを読取ります。 最高で .Fa nbytes までのデータが転送されます。 .Fa nbytes 引数は、ファイルに対応するブロックサイズ以上である必要があります。 .Xr stat 2 を参照してください。このサイズより小さいバッファでは、 これらの関数をサポートしない可能性のあるファイルシステムがあります。 .Pp バッファ内のデータは .Em dirent 構造体の連続で、それぞれ次のエントリが入っています。 .Bd -literal -offset indent u_int32_t d_fileno; u_int16_t d_reclen; u_int8_t d_type; u_int8_t d_namlen; char d_name[MAXNAMELEN + 1]; /* 下記を参照 */ .Ed .Pp .Fa d_fileno エントリは、ファイルシステム内の異なるファイル毎に一意の数値です。 ハードリンクでリンクされたファイル .Pf ( Xr link 2 を参照) は同じ .Fa d_fileno を持ちます。 .Fa d_reclen エントリは、ディレクトリレコードの 長さ (バイト単位) です。 .Fa d_type エントリは、ディレクトリレコードが指すファイルのタイプです。 ファイルタイプの値は .Fa 内に定義されます。 .Fa d_name エントリにはヌルで終端されたファイル名が 入っています。 .Fa d_namlen エントリは、ヌルバイトを除いたファイル名の長さを示します。それゆえ、 .Fa d_name の実際のサイズは 1 から .Dv MAXNAMELEN \&+ 1 の間のいずれかの値になります。 .Pp エントリは余分のスペースで分離されているかもしれません。 .Fa d_reclen エントリは、 .Fa dirent 構造体の開始点から次の構造体 がある場合はその構造体へのオフセットとして使用されます。 .Pp 実際に転送されたバイト数が返されます。 .Fa fd に関連づけられた現在の位置を示すポインタは、 エントリの次のブロックに設定されます。ポインタは .Fn getdirentries または .Fn getdents によって返されるバイト数分だけ進められるとは限りません。 ディレクトリの終わりに到達した場合は、値 0 が返されます。 .Pp .Fn getdirentries 関数は、読み込まれたブロック位置を .Fa basep が指す場所に書込みます。 代わりに .Xr lseek 2 によって現在の位置ポインタを設定、取得できます。 現在の位置ポインタは、 .Xr lseek 2 が返す値、 .Fa basep が指す場所に返される値 ( .Ns Fn getdirentries のみ)、または 0 のいずれかにのみ設定するべきです。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn getdirentries は .Va getdirentries システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va getdirentries システムコールは .Fn _thread_sys_getdirentries にアセンブルされ、 .Fn getdirentries は、読み書きについて .Va fd をロックしてから .Fn _thread_sys_getdirentries を呼び出す関数として実装されています。戻る前に、 .Fn getdirentries は -.Va fd +.Fa fd をアンロックします。 .Sh 戻り値 処理が正常に完了すると、実際に転送されたバイト数が返されます。 そうでない場合は -1 が返され、エラーを示すためにグローバル変数 .Va errno -が設定されます。 +が設定されます。 .Sh エラー .Fn getdirentries は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBADF .Fa fd -が読取り用に開いた有効なファイル記述子ではありません。 +が読取り用に開かれた有効なファイル記述子ではありません。 .It Bq Er EFAULT .Fa buf または .Fa basep のどちらかが、割り当てられたアドレス空間の範囲外を指しています。 .It Bq Er EINVAL .Fa fd -によって参照されるファイルがディレクトリでない、 +によって参照されるファイルがディレクトリでないか、 .Fa nbytes -がディレクトリエントリまたはエントリのブロックを返すのには小さすぎる、 -または、現在の位置ポインタが無効です。 +がディレクトリエントリまたはエントリのブロックを返すのには小さすぎます。 +あるいは、現在の位置ポインタが無効です。 .It Bq Er EIO ファイルシステムに読み書きしている間に .Tn I/O (入出力)エラーが発生しました。 .El .Sh 関連項目 .Xr lseek 2 , .Xr open 2 .Sh 歴史 .Fn getdirentries 関数は .Bx 4.4 ではじめて登場しました。 .Fn getdents 関数は .Fx 3.0 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getdtablesize.2 b/ja_JP.eucJP/man/man2/getdtablesize.2 index dc2f69ca48..59cb06ebc3 100644 --- a/ja_JP.eucJP/man/man2/getdtablesize.2 +++ b/ja_JP.eucJP/man/man2/getdtablesize.2 @@ -1,61 +1,64 @@ .\" 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. .\" .\" @(#)getdtablesize.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/getdtablesize.2,v 1.1.1.1.10.1 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/getdtablesize.2,v 1.4.2.1 2000/04/22 17:06:53 phantom Exp % .\" .Dd June 4, 1993 .Dt GETDTABLESIZE 2 .Os BSD 4.2 .Sh 名称 .Nm getdtablesize .Nd 記述子テーブルのサイズを得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn getdtablesize void .Sh 解説 各プロセスには固定サイズの記述子テーブルがあり、 テーブルには最低 20 個のスロットがあることが保証されています。 -記述子テーブル内のエントリは、0 で開始する小さい整数で番号付けられています。 -呼び出し +記述子テーブル内のエントリは、 +0 からはじまる小さな整数で番号付けられています。 +システムコール .Fn getdtablesize はこのテーブルのサイズを返します。 .Sh 関連項目 .Xr close 2 , .Xr dup 2 , .Xr open 2 , .Xr select 2 .Sh 歴史 .Fn getdtablesize 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getfh.2 b/ja_JP.eucJP/man/man2/getfh.2 index 6e98be11c4..0930f67d07 100644 --- a/ja_JP.eucJP/man/man2/getfh.2 +++ b/ja_JP.eucJP/man/man2/getfh.2 @@ -1,90 +1,93 @@ .\" 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. .\" .\" @(#)getfh.2 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/lib/libc/sys/getfh.2,v 1.7.2.2 2000/12/08 13:49:31 ru Exp % .\" .Dd June 9, 1993 .Dt GETFH 2 .Os .Sh 名称 .Nm getfh .Nd ファイルハンドルを得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn getfh "const char *path" "fhandle_t *fhp" .Sh 解説 .Fn getfh は指定のファイルまたはディレクトリのファイルハンドルを .Fa fhp が指すファイルハンドルの格納領域に返します。 このシステムコールはスーパユーザに限定されます。 .Sh 戻り値 正常に完了すると、値 0 が返されます。そうでない場合は -1 が返され、 エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー .Fn getfh は以下の 1 つでも真の場合、処理に失敗します。 .Bl -tag -width Er -.It Bq ENOTDIR +.It Bq Er ENOTDIR .Fa path の構成要素中にディレクトリ以外のものが含まれています。 -.It Bq ENAMETOOLONG +.It Bq Er ENAMETOOLONG .Fa path の構成要素が 255 文字を越えているか、 または .Fa path が 1023 文字を越えています。 -.It Bq ENOENT +.It Bq Er ENOENT .Fa path が参照するファイルが存在しません。 -.It Bq EACCES +.It Bq Er EACCES .Fa path -の前置パス名の構成要素について検索許可が拒否されています。 -.It Bq ELOOP +に検索が許可されていないディレクトリが含まれています。 +.It Bq Er ELOOP .Fa path を変換するときに検出されたシンボリックリンクが多すぎます。 -.It Bq EFAULT +.It Bq Er EFAULT .Fa fhp が無効なアドレスを指しています。 -.It Bq EIO +.It Bq Er EIO ファイルシステムに読み書きしている間に .Tn I/O (入出力) エラーが発生しました。 .El .Sh 歴史 .Fn getfh 関数は .Bx 4.4 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getfsstat.2 b/ja_JP.eucJP/man/man2/getfsstat.2 index d05b3cb921..1169cd85ab 100644 --- a/ja_JP.eucJP/man/man2/getfsstat.2 +++ b/ja_JP.eucJP/man/man2/getfsstat.2 @@ -1,174 +1,177 @@ .\" 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. .\" .\" @(#)getfsstat.2 8.3 (Berkeley) 5/25/95 +.\" %FreeBSD: src/lib/libc/sys/getfsstat.2,v 1.7.2.2 2000/12/08 13:49:31 ru Exp % .\" .Dd May 25, 1995 .Dt GETFSSTAT 2 .Os .Sh 名称 .Nm getfsstat .Nd マウントされたすべてのファイルシステムのリストを得る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Fd #include .Ft int .Fn getfsstat "struct statfs *buf" "long bufsize" "int flags" .Sh 解説 .Fn getfsstat は、マウントされたすべてのファイルシステムに関する情報を返します。 .Fa buf は 次のように定義される .Xr statfs 構造体へのポインタです。 .Bd -literal typedef struct fsid { int32_t val[2]; } fsid_t; /* ファイルシステム ID タイプ */ /* * ファイルシステム統計 */ #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]; /* 後のための余白 */ char f_fstypename[MFSNAMELEN];/* ファイルシステムのタイプ名 */ char f_mntonname[MNAMELEN];/* マウントされたディレクトリ */ char f_mntfromname[MNAMELEN];/* マウントされたファイルシステム */ }; .Ed .Pp 返される可能性のあるフラグには次のものが含まれます。 .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 ファイルシステムへのすべての入出力が同期的に実行されます。 .It Dv MNT_ASYNCHRONOUS ファイルシステム入出力が同期的に実行されません。 .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 に設定されます。 バッファは .Fa fsstat 構造体の配列で埋められます。 マウントされた各ファイルシステムについて 1 つずつ、最高 .Fa bufsize で指定されたサイズまでです。 .Pp .Fa buf として NULL が指定されている場合、 .Fn getfsstat はマウントされているファイルシステムの数のみを返します。 .Pp 通常、 .Fa flags には .Dv MNT_WAIT を指定するべきです。 .Fa flags として .Dv MNT_NOWAIT が指定されている場合、 .Fn getfsstat は各ファイルシステムからの更新を要求せずに利用できる情報を返します。 そのため、情報のうちには古くなっているものがあるでしょうが、 .Fn getfsstat は応答できないファイルシステムからの情報を 待機してブロックすることはありません。 .Sh 戻り値 正常に完了すると .Fa fsstat 構造体の数が返されます。そうでない場合は -1 が返され、エラーを示すために グローバル変数 .Va errno が設定されます。 .Sh エラー .Fn getfsstat は以下の 1 つでも真の場合、処理に失敗します。 .Bl -tag -width Er -.It EFAULT +.It Bq Er EFAULT .Fa buf が無効なアドレスを指しています。 -.It EIO +.It Bq Er EIO ファイルシステムを読み書きしている間に .Tn I/O (入出力) エラーが発生しました。 .El .Sh 関連項目 .Xr statfs 2 , .Xr fstab 5 , .Xr mount 8 .Sh 歴史 .Fn getfsstat 関数は .Bx 4.4 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getgid.2 b/ja_JP.eucJP/man/man2/getgid.2 index 97b3358f45..fa817b6f8e 100644 --- a/ja_JP.eucJP/man/man2/getgid.2 +++ b/ja_JP.eucJP/man/man2/getgid.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. .\" .\" @(#)getgid.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/getgid.2,v 1.8.2.1 2000/04/22 17:06:53 phantom Exp % .\" .Dd June 4, 1993 .Dt GETGID 2 .Os BSD 4.2 .Sh 名称 .Nm getgid , .Nm getegid -.Nd グループプロセス識別を得る +.Nd グループプロセス ID を取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft gid_t .Fn getgid void .Ft gid_t .Fn getegid void .Sh 解説 .Fn getgid -関数は呼び出しプロセスの実グループ ID を返して、 +関数は呼び出したプロセスの実グループ ID を返します。 .Fn getegid -は呼び出しプロセスの実効グループ ID を返します。 +関数は呼び出したプロセスの実効グループ ID を返します。 .Pp 実グループ ID はログイン時に指定されます。 .Pp 実グループ ID はプログラムを起動したユーザのグループです。 実効グループ ID は .Dq Em set-group-ID モードプロセスの実行の間にプロセスに追加のパーミッションを与えるので、 .Fn getgid は呼び出しプロセスの real-user-id を知るために使用されます。 .Sh エラー .Fn getgid 関数と .Fn getegid 関数は必ず正常に完了するので、エラーを示すための戻り値はありません。 .Sh 関連項目 .Xr getuid 2 , .Xr issetugid 2 , .Xr setgid 2 , .Xr setregid 2 .Sh 規格 .Fn getgid 関数と .Fn getegid 関数は .St -p1003.1-90 に準拠しています。 diff --git a/ja_JP.eucJP/man/man2/getgroups.2 b/ja_JP.eucJP/man/man2/getgroups.2 index b18f45a9c3..448ae74fd5 100644 --- a/ja_JP.eucJP/man/man2/getgroups.2 +++ b/ja_JP.eucJP/man/man2/getgroups.2 @@ -1,96 +1,97 @@ .\" 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. .\" .\" @(#)getgroups.2 8.2 (Berkeley) 4/16/94 -.\" %FreeBSD: src/lib/libc/sys/getgroups.2,v 1.4.2.1 1999/08/29 14:49:01 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getgroups.2,v 1.6.2.1 2000/04/22 17:06:54 phantom Exp % .\" -.Dd April 16, 1994 +.Dd March 5, 1999 .Dt GETGROUPS 2 .Os BSD 4.2 .Sh 名称 .Nm getgroups -.Nd グループアクセスリストを得る +.Nd グループアクセスリストを取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int .Fn getgroups "int gidsetlen" "gid_t *gidset" .Sh 解説 .Fn getgroups は、ユーザプロセスの現在のグループアクセスリストを取得し、それを配列 .Fa gidset に保存します。 パラメータ .Fa gidsetlen は .Fa gidset 内に配置できるエントリの数を示します。 .Fn getgroups は、 .Fa gidset -に返された実際のグループの数を返します。これは -.Fn sysconf _SC_NGROUPS_MAX -によって返される値に制限されます。 +に返された実際のグループの数を返します。 +.Dv NGROUPS_MAX +より大きい値は返しません。 .Fa gidsetlen -が 0 の場合に +が 0 の場合には .Fn getgroups は、 .Fa gidset -が指す配列を修正せずに、呼び出しプロセスに対応する補助 -グループ ID の数を返します。 +が指し示す配列を修正せずに、 +呼び出したプロセスに対応する補助グループ ID の数を返します。 .Sh 戻り値 呼び出しが正常に完了すると、グループセット内のグループの数が返されます。 戻り値 -1 はエラーが起こったことを示し、 エラーコードはグローバル変数 .Va errno に保存されます。 .Sh エラー .Fn getgroups で起こり得るエラーは次のとおりです。 .Bl -tag -width Er .It Bq Er EINVAL 引数 .Fa gidsetlen がグループセット内のグループの数より小さいです。 .It Bq Er EFAULT 引数 .Fa gidset は無効なアドレスを指しています。 .El .Sh 関連項目 .Xr setgroups 2 , -.Xr initgroups 3 , -.Xr sysconf 3 +.Xr initgroups 3 .Sh 歴史 .Fn getgroups 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getitimer.2 b/ja_JP.eucJP/man/man2/getitimer.2 index b6fe2915ad..871d25ff4d 100644 --- a/ja_JP.eucJP/man/man2/getitimer.2 +++ b/ja_JP.eucJP/man/man2/getitimer.2 @@ -1,166 +1,169 @@ .\" 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. .\" .\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95 +.\" %FreeBSD: src/lib/libc/sys/getitimer.2,v 1.10.2.2 2000/12/29 14:44:52 ru Exp % .\" .Dd May 16, 1995 .Dt GETITIMER 2 .Os BSD 4.2 .Sh 名称 .Nm getitimer , .Nm setitimer -.Nd インターバルタイマの値を取得/設定する +.Nd インターバルタイマの値を取得 / 設定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include -.Fd #define ITIMER_REAL 0 -.Fd #define ITIMER_VIRTUAL 1 -.Fd #define ITIMER_PROF 2 +.Fd "#define ITIMER_REAL 0" +.Fd "#define ITIMER_VIRTUAL 1" +.Fd "#define ITIMER_PROF 2" .Ft int .Fn getitimer "int which" "struct itimerval *value" .Ft int .Fn setitimer "int which" "const struct itimerval *value" "struct itimerval *ovalue" .Sh 解説 -システムは、 +システムは、各プロセスに .Ao Pa sys/time.h Ac -で定義された 3 つのインターバルタイマを各プロセスに提供します。 +で定義された 3 つのインターバルタイマを提供しています。 .Fn getitimer -呼び出しは +システムコールは .Fa which で指定されたタイマの現在の値を .Fa value 構造体に返します。 .Fn setitimer -呼び出しはタイマを指定の +システムコールはタイマを指定の .Fa value に設定します .Fa ( ovalue が nil でない場合、タイマの 以前の値が返されます)。 .Pp タイマの値は .Fa itimerval 構造体によって定義されます。 .Bd -literal -offset indent struct itimerval { struct timeval it_interval; /* タイマインターバル */ struct timeval it_value; /* 現在の値 */ }; .Ed .Pp .Fa it_value が 0 でない場合、それは次にタイマが時間切れになるまでの時間を示します。 .Fa it_interval が 0 でない場合、それはタイマが時間切れになるときに .Fa it_value を再設定するのに 使用される値を指定します。 .Fa it_value を 0 に設定すると、タイマは .Fa it_interval の値に関係なく無効になります。 .Fa it_interval を 0 に設定すると、次の時間切れの後でタイマは無効になります .Fa ( it_value が 0 でないと想定します)。 .Pp システムクロックの精度 (通常は 10 ミリ秒です) より小さい時間の値は この精度に切り上げられます。 .Pp .Dv ITIMER_REAL タイマはリアルタイムで減少していきます。このタイマが時間切れになると .Dv SIGALRM シグナルが配信されます。 .Pp .Dv ITIMER_VIRTUAL タイマはプロセス仮想時間で減少します。 このタイマが減るのはプロセスが実行中の ときだけです。時間切れになるときに .Dv SIGVTALRM シグナルが配信されます。 .Pp .Dv ITIMER_PROF タイマは、プロセス仮想時間内およびシステムがプロセスのために 処理を行っているときの両方で減少します。 これは、インタプリタがプログラムの実行を統計的にプロファイルするときに 使用するように設計されています。 .Dv ITIMER_PROF タイマが時間切れになるたびに .Dv SIGPROF -シグナルが配信され -ます。このシグナルは進行中のシステムコールに割り込むかもしれないので、 +シグナルが配信されます。 +このシグナルは進行中のシステムコールに割り込むかもしれないので、 このタイマを使用しているプログラムは割り込まれたシステムコールを 再実行する準備をしておかなければなりません。 .Pp .Fn setitimer で .Fa it_interval と .Fa it_value に許容される最大秒数は 100000000 です。 .Sh 注 時間の値を操作する 3 つのマクロは .Ao Pa sys/time.h Ac -で定義されます。 +で定義されています。 .Fa timerclear は時間の値を 0 に設定し、 .Fa timerisset は時間値が 0 でないかどうか検査し、 .Fa timercmp は 2 つの時間の値を比較します。 .Sh 戻り値 呼び出しが正常に完了すると値 0 が返されます。 エラーが起きた場合は値 -1 が返され、 より正確なエラーコードがグローバル変数 .Va errno に設定されます。 .Sh エラー .Fn getitimer と .Fn setitimer は次の場合に失敗します。 .Bl -tag -width Er .It Bq Er EFAULT .Fa value パラメータが無効なアドレスを指定しました。 .It Bq Er EINVAL .Fa value パラメータが、大きすぎて処理できない時間を指定しました。 .El .Sh 関連項目 .Xr gettimeofday 2 , .Xr select 2 , .Xr sigvec 2 , .Xr clocks 7 .Sh 歴史 .Fn getitimer 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getlogin.2 b/ja_JP.eucJP/man/man2/getlogin.2 index 1ebf39a3fd..93ee2c2d67 100644 --- a/ja_JP.eucJP/man/man2/getlogin.2 +++ b/ja_JP.eucJP/man/man2/getlogin.2 @@ -1,159 +1,182 @@ .\" 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. .\" .\" @(#)getlogin.2 8.1 (Berkeley) 6/9/93 -.\" %FreeBSD: src/lib/libc/sys/getlogin.2,v 1.10.2.1 1999/09/18 16:18:59 phantom Exp % +.\" %FreeBSD: src/lib/libc/sys/getlogin.2,v 1.14.2.1 2000/04/22 17:06:54 phantom Exp % .\" .Dd June 9, 1993 .Dt GETLOGIN 2 .Os BSD 4.4 .Sh 名称 .Nm getlogin , +.Nm getlogin_r , .Nm setlogin -.Nd ログイン名を取得/設定する +.Nd ログイン名を取得 / 設定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn getlogin void +.Fd #include +.Ft char * +.Fn getlogin_r "char *name" "int len" .Ft int .Fn setlogin "const char *name" .Sh 解説 .Fn getlogin ルーチンは、 .Fn setlogin で設定した現在のセッションに対応する -ユーザのログイン名を返します。通常、名前は -セッションが作成された時点でログインシェルに -対応し、ログインシェルから派生する全てのプロセスに継承されます +ユーザのログイン名を返します。 +通常、名前はセッションが作成された時点でログインシェルに対応し、 +ログインシェルから派生する全てのプロセスに継承されます (これらのプロセスが別のユーザ ID を想定している場合、たとえば、 .Xr su 1 が使用されるときでも該当します)。 .Pp +.Fn getlogin_r +は +.Fn getlogin +と同様のサービスを提供しますが、 +呼び出し側は結果を保持するための長さ +.Fa len +バイトのバッファ +.Fa name +を用意しなければなりません。バッファは少なくとも +.Dv MAXLOGNAME +バイトの長さがあるべきです。 +.Pp .Fn setlogin は、現在のセッションに対応するユーザのログイン名を .Fa name に対応させます。 この呼び出しはスーパユーザに制限されており、 新しいセッションがユーザのために 作成されるときにだけ使用されるのが普通です (たとえば、ログイン時、またはリモートシェルが 起動されるときです)。 .Pp .Em 注釈: `セッション' ごとに 1 つの `ログイン名' しかありません。 .Pp プロセスが、確実に親のセッションから切り離されるような 適切なステップを取った後にのみ、 .Fn setlogin が呼び出されるようにすることは .Em 非常に 重要です。 .Fn setsid システムコール を行なうのがこれをする .Em 唯一の 方法です。 .Fn daemon ライブラリは .Fn setsid -を呼び出しますが、これは -制御端末を切り離してフォークでバックグラウンドに入る理想的な方法です。 +を呼び出しますが、これは制御端末を切り離して +フォークでバックグラウンドに入る理想的な方法です。 .Pp 特に、 .Fn ioctl ttyfd TIOCNOTTY ... または .Fn setpgrp ... では十分では .Em ありません。 .Pp -親プロセスが一旦 +親プロセスがいったん .Fn setsid -呼び出しを行なえば、セッションリーダーでない +呼び出しを行なえば、セッションリーダでない そのプロセスの子が .Fn setlogin を行なうことも受け入れられますが、親を含めてセッション内のすべての プロセスが同時にログイン名を変更されることに注意してください。 .Pp これは特権を継承する従来の UNIX の動作と同じではありません。 .Pp .Fn setlogin -システムコールはスーパユーザに制限されているので、セキュリティ侵犯を防止 -するために (他の特権のあるすべてのプログラムと同じように) +システムコールはスーパユーザに制限されているので、セキュリティ侵犯を +防止するために (他の特権のあるすべてのプログラムと同じように) プログラマが適切な注意を払うものだと仮定しています。 .Sh 戻り値 .Fn getlogin の呼び出しが成功すると、静的バッファ内のヌルで終端された文字列への -ポインタが返されます。名前が設定されていない場合は +ポインタが返されます。 +.Fn getlogin_r +の呼び出しが成功すると、呼び出し側が渡したバッファへのポインタが +返されます。 +名前が設定されていない場合は、どちらも .Dv NULL が返されます。 +.Pp .Fn setlogin の呼び出しが成功すると 値 0 が返されます。 .Fn setlogin が処理を失敗すると値 -1 が返され、エラーコードがグローバル位置 .Va errno に設定されます。 .Sh エラー これらの呼び出しによって以下のエラーが返される可能性があります。 .Bl -tag -width Er .It Bq Er EFAULT .Fa name パラメータで無効なアドレスを与えました。 .It Bq Er EINVAL .Fa name パラメータが長すぎる文字列を指しています。ログイン名は .Pf ( Ao Pa sys/param.h Ac の ) .Dv MAXLOGNAME -文字に制限されます。現時点ではヌルを含めて 17 です。 +文字までに制限されます。現時点ではヌルを含めて 17 文字です。 .It Bq Er EPERM ログイン名を設定しようとした呼び出し元が スーパユーザではありませんでした。 .El .Sh 関連項目 .Xr setsid 2 , .Xr daemon 3 .Sh バグ システムの以前のバージョンでは、 .Fn getlogin はプロセスがログイン端末に対応していない限り 処理に失敗しました。現在では、 .Pf ( Fn setlogin を使用して) プロセスに制御端末がないときでも getlogin は正常に完了します。初期のバージョンでは、 .Fn getlogin -が返す値はユーザ ID をチェックせずには信頼 -することができませんでした。 +が返す値はユーザ ID をチェックせずには +信頼することができませんでした。 移植性の高いプログラムはおそらくまだこのチェックを行なっているはずです。 .Sh 歴史 .Fn getlogin 関数は .Bx 4.4 ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man2/getpeername.2 b/ja_JP.eucJP/man/man2/getpeername.2 index c240acc6e4..56c45dea09 100644 --- a/ja_JP.eucJP/man/man2/getpeername.2 +++ b/ja_JP.eucJP/man/man2/getpeername.2 @@ -1,110 +1,115 @@ .\" 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. .\" .\" @(#)getpeername.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/getpeername.2,v 1.9.2.4 2000/08/23 00:45:18 jhb Exp % .\" .Dd June 4, 1993 .Dt GETPEERNAME 2 .Os BSD 4.2 .Sh 名称 .Nm getpeername -.Nd 接続されたピア (通信相手) の名前を得る +.Nd 接続されたピア (通信相手) の名前の取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft int -.Fn getpeername "int s" "struct sockaddr *name" "int *namelen" +.Fn getpeername "int s" "struct sockaddr *name" "socklen_t *namelen" .Sh 解説 .Fn getpeername は、ソケット .Fa s に接続されたピア (通信相手) の名前を返します。 .Fa namelen パラメータには、 .Fa name が指す空間の量を示す値を入れておく必要があります。 戻る時に、これには返された名前の 実際のサイズ (バイト単位) が入れられます。 準備されたバッファが小さすぎる場合、名前は切り捨てられます。 .Sh システムの注意事項 .Pp 非スレッドライブラリでは、 .Fn getpeername は .Va getpeername システムコールとして実装されています。 .Pp スレッドライブラリでは、 .Va getpeername システムコールは .Fn _thread_sys_getpeername にアセンブルされ、 .Fn getpeername は、読取りと書込みについて -.Va s +.Fa s をロックしてから .Fn _thread_sys_getpeername を呼び出す関数として実装されています。戻る前に .Fn getpeername は -.Va s +.Fa s をアンロックします。 .Sh 戻り値 呼び出しが正常に完了すると 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 ENOTCONN ソケットが接続されていません。 .It Bq Er ENOBUFS 操作を実行するための十分なリソースがシステムにありません。 .It Bq Er EFAULT .Fa name -パラメータはプロセスアドレス空間の外側の領域を指定しています。 +パラメータは、プロセスのアドレス空間の有効な領域の範囲外を指しています。 .El .Sh 関連項目 .Xr accept 2 , .Xr bind 2 , .Xr getsockname 2 , .Xr socket 2 .Sh 歴史 .Fn getpeername 関数は .Bx 4.2 で登場しました。 diff --git a/ja_JP.eucJP/man/man2/getpgrp.2 b/ja_JP.eucJP/man/man2/getpgrp.2 index 64af0fd82a..bac49f063b 100644 --- a/ja_JP.eucJP/man/man2/getpgrp.2 +++ b/ja_JP.eucJP/man/man2/getpgrp.2 @@ -1,119 +1,122 @@ .\" 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. .\" .\" @(#)getpgrp.2 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/sys/getpgrp.2,v 1.11.2.1 2000/04/22 17:06:54 phantom Exp % .\" .Dd June 4, 1993 .Dt GETPGRP 2 .Os BSD 4.2 .Sh 名称 .Nm getpgrp -.Nd プロセスグループを得る +.Nd プロセスグループの取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft pid_t .Fn getpgrp void .Ft pid_t .Fn getpgid "pid_t pid" .Sh 解説 現在のプロセスのプロセスグループは .Fn getpgrp によって返されます。 .Fa pid によって識別される プロセスのプロセスグループは .Fn getpgid によって返されます。 .Fa pid が 0 の場合、 .Fn getpgid は現在のプロセスのプロセスグループを返します。 .Pp プロセスグループはシグナルの配信用に使用され、 また端末によって入力の要求を調整するのにも使用されます。 -端末と同じプロセスグループを持つ (1つ以上の) プロセスは +端末と同じプロセスグループを持つ (1 つ以上の) プロセスは フォアグラウンドであり読み取りできます。一方でその他のプロセスが 読み取ろうした場合はシグナルによってブロックさせられます。 .Pp このように、この呼び出しは .Xr csh 1 のようにジョブ制御のためにプロセスグループの作成を 行なうプログラムによって使用されます。 .Fn tcgetpgrp 呼び出しと .Fn tcsetpgrp 呼び出しは制御端末のプロセスグループ を取得/設定するのに使用されます。 .Sh 関連項目 .Xr getsid 2 , .Xr setpgid 2 , .Xr termios 4 .Sh 歴史 .Fn getpgrp 関数は .Bx 4.0 で登場しました。 .Fn getpgid 関数呼び出しは System V Release 4 での使用法に由来しています。 .Sh 規格 .Fn getpgrp 関数は .St -p1003.1-90 に準拠しています。 .Sh 互換性 このバージョンの .Fn getpgrp は、 .Fa "pid_t pid" 引数を取らないという点で過去の Berkeley バージョンとは 異なっています。互換性は .St -p1003.1-90 への対応により失われてしまいました。 .Pp .St -p1003.1-90 基本概念から: .Pp .Bx 4.3 は、指定のプロセスについてプロセスグループ ID を返す .Fn getpgrp 関数を備えています。 この関数はジョブ制御をサポートするのに使用されますが、 既知のジョブ制御をする全てのシェルは、必ずこの関数に 呼び出しプロセスを指定しています。そのためより簡単な .At V .Fn getpgrp で十分であり、 .Bx 4.3 .Fn getpgrp の追加された複雑さは POSIX.1 から省略されています。 古い機能は .Fn getpgid 関数で利用できます。 diff --git a/ja_JP.eucJP/man/man2/getpid.2 b/ja_JP.eucJP/man/man2/getpid.2 index 8197393d8e..5203cac4bf 100644 --- a/ja_JP.eucJP/man/man2/getpid.2 +++ b/ja_JP.eucJP/man/man2/getpid.2 @@ -1,75 +1,77 @@ .\" 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. .\" .\" @(#)getpid.2 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libc/sys/getpid.2,v 1.7.2.1 1999/08/29 14:49:01 peter Exp % +.\" %FreeBSD: src/lib/libc/sys/getpid.2,v 1.8.2.1 2000/04/22 17:06:54 phantom Exp % .\" .Dd June 4, 1993 .Dt GETPID 2 .Os BSD 4 .Sh 名称 .Nm getpid , .Nm getppid -.Nd 親または呼び出しプロセスの識別子を得る +.Nd 親または呼び出しプロセスの識別子を取得 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft pid_t .Fn getpid void .Ft pid_t .Fn getppid void .Sh 解説 .Fn getpid は呼び出しプロセスのプロセス ID を返します。 ID はユニークであることが保証されており、 -一時的なファイルの名前を構築するのに便利です。 +一時的なファイルの名前を作成するのに便利です。 .Pp .Fn getppid は呼び出しプロセスの親のプロセス ID を返します。 .Sh エラー .Fn getpid 関数と .Fn getppid 関数は必ず正常に完了するので、エラーを示すための戻り値はありません。 .Sh 関連項目 .Xr gethostid 3 .Sh 規格 .Fn getpid 関数と .Fn getppid 関数は .St -p1003.1-90 に準拠しています。 .Sh 歴史 .Fn getpid 関数は .At v7 で登場しました。