diff --git a/ja_JP.eucJP/man/man3/_secure_path.3 b/ja_JP.eucJP/man/man3/_secure_path.3 index f5f1fc836d..adc174d453 100644 --- a/ja_JP.eucJP/man/man3/_secure_path.3 +++ b/ja_JP.eucJP/man/man3/_secure_path.3 @@ -1,77 +1,79 @@ .\" Copyright (c) 1997 David Nugent .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, is permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice immediately at the beginning of the file, without modification, .\" 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. This work was done expressly for inclusion into FreeBSD. Other use .\" is permitted provided this notation is included. .\" 4. Absolutely no warranty of function or purpose is made by the author .\" David Nugent. .\" 5. Modifications may be freely made to this file providing the above .\" conditions are met. .\" -.\" %Id: _secure_path.3,v 1.3 1998/06/06 05:50:42 jkoshy Exp % +.\" %FreeBSD: src/lib/libutil/_secure_path.3,v 1.7.2.1 2000/04/22 16:36:01 phantom Exp % .\" .\" $FreeBSD$ .Dd May 2, 1997 .Os FreeBSD .Dt _SECURE_PATH 3 .Sh 名称 .Nm _secure_path .Nd ファイルが安全であるように見えるかどうかを判定する +.Sh ライブラリ +.Lb libutil .Sh 書式 .Fd #include .Fd #include .Ft int .Fn _secure_path "const char *path" "uid_t uid" "gid_t gid" -.Pp .Sh 解説 この関数は、指定のパスについて基本的なセキュリティチェックを行います。 これはルート特権で実行中のプロセスが使用することを意図しています。指定の ファイルの内容を信頼するかどうかを判定するためです。この関数は、システムの -危うさを検出するために使用される方法を使うことがよくあります。ファイルは、 -次の条件を満たす場合に安全であると考えられます。 +危険性を検出するために使用される方法としてよく使われます。 +ファイルは、次の条件を満たす場合に +.Sq 安全である +と考えられます。 .Bl -enum .It ファイルが存在し、それが通常のファイルである (シンボリックリンク、 ファイル、デバイスに固有のファイル、または名前付きのパイプファイル でない)。 .It -ワールド書き込み可能でない。 +誰もが書き込み可能な属性を持っていない。 .It -uid が -1 でない場合は、指定の uid またはユーザ 0 によって +uid が -1 でない場合は、指定された uid または uid 0 のユーザによって 所有されている。 .It -グループ書き込みでない、または +グループの書き込み属性がない、または gid が -1 でない場合は指定の gid によるグループ所有権がある。 .El .Sh 戻り値 -この関数は、ファイルが存在し、安全であると考えられる場合 0 を返します。 -ファイルが存在しない場合は -2 を返します。その他、セキュリティ障害を示す -場合は -1 を返します。 +この関数は、ファイルが存在し、安全であると考えられる場合は 0 を返します。 +ファイルが存在しない場合は -2 を返します。 +セキュリティ障害を示す場合には -1 を返します。 .Xr syslog 3 -が、この関数の処理失敗をログ記入するのに -使用されます。これには、理由 -LOG_ERR -優先順位が含まれます。 +が、この関数の処理失敗を理由を含めて LOG_ERR 優先順位のログに +記入するために使用されます。 .Pp .Sh バグ 実行されるチェックは基本的なものであり、この関数の使用と参照ファイルへの アクセスの間の競争状況を除去しようとする試みは行われません。 .Pp .Sh 関連項目 -.Xr lstat 3 , +.Xr lstat 2 , .Xr syslog 3 .Pp .Sh 歴史 この関数の由来であるコードは、Berkeley Software Design,Inc. によって -FreeBSD プロジェクトに寄与されたものです。 -.\"X kuma +.Fx +プロジェクトに寄与されたものです。 +.\"X kuma oh diff --git a/ja_JP.eucJP/man/man3/abort.3 b/ja_JP.eucJP/man/man3/abort.3 index a6644208b8..f12dca54e5 100644 --- a/ja_JP.eucJP/man/man3/abort.3 +++ b/ja_JP.eucJP/man/man3/abort.3 @@ -1,70 +1,72 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)abort.3 8.1 (Berkeley) 6/4/93 -.\" +.\" %FreeBSD: src/lib/libc/stdlib/abort.3,v 1.6.2.1 2000/04/22 17:06:23 phantom Exp % .\" $FreeBSD$ +.\" .Dd June 4, 1993 .Dt ABORT 3 .Os .Sh 名称 .Nm abort .Nd プログラムを異常終了させる +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn abort void .Sh 解説 .Fn abort 関数は、プログラムを異常終了させます。ただし、シグナル .Dv SIGABRT -が -捕捉され、シグナルハンドラが戻らない場合は別です。開いているストリームは -フラッシュされ閉じられます。 +が捕捉され、シグナルハンドラが戻らない場合は別です。 .Pp +開いているストリームはフラッシュされ閉じられます。 .Sh 戻り値 .Fn abort 関数が戻ることはありません。 .Pp .Sh 関連項目 .Xr sigaction 2 , .Xr exit 3 .Pp .Sh 規格 .Fn abort 関数は .St -p1003.1-90 -に準拠しています。 -.\"X kuma +に適合しています。 +.\"X kuma oh diff --git a/ja_JP.eucJP/man/man3/abs.3 b/ja_JP.eucJP/man/man3/abs.3 index 6a8e3c3aaf..54c09b9207 100644 --- a/ja_JP.eucJP/man/man3/abs.3 +++ b/ja_JP.eucJP/man/man3/abs.3 @@ -1,75 +1,75 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)abs.3 8.1 (Berkeley) 6/4/93 -.\" %Id: abs.3,v 1.5 1997/02/22 15:03:06 peter Exp % +.\" %FreeBSD: src/lib/libc/stdlib/abs.3,v 1.7.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ABS 3 .Os .Sh 名称 .Nm abs -.Nd 整数絶対値関数 +.Nd 整数の絶対値関数 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn abs "int j" .Sh 解説 .Fn abs -関数は整数 +関数は、整数 .Ar j の絶対値を計算します。 -.Pp .Sh 戻り値 .Fn abs -関数は絶対値を返します。 -.Pp +関数は、絶対値を返します。 .Sh 関連項目 .Xr cabs 3 , +.Xr fabs 3 , .Xr floor 3 , .Xr hypot 3 , .Xr labs 3 , .Xr math 3 -.Pp .Sh 規格 .Fn abs -関数は -.St -ansiC -に準拠しています。 -.Pp +関数は、 +.St -isoC +に適合しています。 .Sh バグ -最も大きい負の値の絶対値は負のままです。 -.\"X kuma +最大の負の整数の絶対値は、負のままです。 + + diff --git a/ja_JP.eucJP/man/man3/acos.3 b/ja_JP.eucJP/man/man3/acos.3 index 0ff374012b..c1df43fc56 100644 --- a/ja_JP.eucJP/man/man3/acos.3 +++ b/ja_JP.eucJP/man/man3/acos.3 @@ -1,104 +1,99 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)acos.3 5.1 (Berkeley) 5/2/91 -.\" %Id: acos.3,v 1.5 1997/02/22 15:09:19 peter Exp % +.\" %FreeBSD: src/lib/msun/man/acos.3,v 1.6.2.2 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt ACOS 3 .Os .Sh 名称 .Nm acos , .Nm acosf .Nd 逆余弦関数 .Sh 書式 .Fd #include .Ft double .Fn acos "double x" .Ft float .Fn acosf "float x" .Sh 解説 .Fn acos -関数と +および .Fn acosf -関数は +関数は、 .Fa x の逆余弦の主値を計算します。 -[-1, +1] -の -範囲にない引数については領域エラーが起きます。切り捨て丸めによるエラーの -詳細については、 +[-1, +1] の区間外の引数によって、領域エラーが発生します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 -.Pp .Sh 戻り値 .Fn acos -関数と +および .Fn acosf 関数は、 .Bq 0 , \*(Pi -ラジアンの範囲内の余弦を返します。 +ラジアンの区間の逆余弦を返します。 .Tn VAX -と +および .Tn Tahoe では、 .Bd -unfilled -offset indent -.Pf \&| Ns Ar x Ns \&| > 1 , +.Pf \&| Ns Ar x Ns \&| > 1 .Ed .Pp -の場合、 +の場合に、 .Fn acos x -は -.Dv EDOM -にグローバル変数 +はグローバル変数 .Va errno -を設定し、予約された -オペランドエラーが生成されます。 -.Pp +を +.Er EDOM +に設定し、予約されたオペランドフォルトが生成されます。 .Sh 関連項目 .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 -.Pp .Sh 規格 .Fn acos -関数は -.St -ansiC -に準拠しています。 -.Pp +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/acosh.3 b/ja_JP.eucJP/man/man3/acosh.3 index 565925949a..49179e6d50 100644 --- a/ja_JP.eucJP/man/man3/acosh.3 +++ b/ja_JP.eucJP/man/man3/acosh.3 @@ -1,90 +1,87 @@ .\" Copyright (c) 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)acosh.3 5.2 (Berkeley) 5/6/91 -.\" %Id: acosh.3,v 1.5 1997/02/22 15:09:20 peter Exp % +.\" %FreeBSD: src/lib/msun/man/acosh.3,v 1.6 1999/08/28 00:06:18 peter Exp % .\" .\" $FreeBSD$ .Dd May 6, 1991 .Dt ACOSH 3 .Os BSD 4.3 .Sh 名称 .Nm acosh , .Nm acoshf .Nd 逆双曲余弦関数 .Sh 書式 .Fd #include .Ft double .Fn acosh "double x" .Ft float .Fn acoshf "float x" .Sh 解説 .Fn acosh -関数と +および .Fn acoshf -関数は、実数引数 +関数は、実数の引数 .Ar x -の逆双曲余弦を計算します。切り捨て丸めによるエラーの詳細については、 +の逆双曲余弦を計算します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 -.Pp .Sh 戻り値 .Fn acosh -関数と +および .Fn acoshf 関数は、 .Ar x -の逆双曲余弦を返します。 +逆双曲余弦を返します。 .Tn VAX -と +および .Tn Tahoe -では、引数が 1 より小さい場合、 +では、引数が 1 よりも小さい場合に、 .Fn acosh -は、 -.Er EDOM -にグローバル変数 +はグローバル変数 .Va errno を -設定し、予約済みのオペランドエラーを発生させます。 -.Pp +.Er EDOM +に設定し、予約されたオペランドフォルトが生成されます。 .Sh 関連項目 .Xr asinh 3 , .Xr atanh 3 , .Xr exp 3 , .Xr math 3 -.Pp .Sh 歴史 .Fn acosh -関数は +関数は、 .Bx 4.3 -で現れました。 -.Pp -.\"X kuma +で登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/addr2ascii.3 b/ja_JP.eucJP/man/man3/addr2ascii.3 index 9eef2cf35f..893d01808d 100644 --- a/ja_JP.eucJP/man/man3/addr2ascii.3 +++ b/ja_JP.eucJP/man/man3/addr2ascii.3 @@ -1,222 +1,218 @@ .\" .\" Copyright 1996 Massachusetts Institute of Technology .\" .\" Permission to use, copy, modify, and distribute this software and .\" its documentation for any purpose and without fee is hereby .\" granted, provided that both the above copyright notice and this .\" permission notice appear in all copies, that both the above .\" copyright notice and this permission notice appear in all .\" supporting documentation, and that the name of M.I.T. not be used .\" in advertising or publicity pertaining to distribution of the .\" software without specific, written prior permission. M.I.T. makes .\" no representations about the suitability of this software for any .\" purpose. It is provided "as is" without express or implied .\" warranty. .\" .\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS .\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT .\" SHALL M.I.T. 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. .\" -.\" $ANA: addr2ascii.3,v 1.1 1996/06/13 18:41:46 wollman Exp $ +.\" $ANA: addr2ascii.3,v 1.1 1996/06/13 18:41:46 wollman Exp $ +.\" %FreeBSD: src/lib/libc/net/addr2ascii.3,v 1.7.2.2 2000/05/06 13:34:10 phantom Exp % .\" .\" $FreeBSD$ .Dd June 13, 1996 .Dt ADDR2ASCII 3 .Os .Sh 名称 .Nm addr2ascii , .Nm ascii2addr -.Nd 一般的なアドレスフォーマット化ルーチン +.Nd 一般的なアドレスフォーマットルーチン +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Fd #include .Ft "char *" .Fn addr2ascii "int af" "const void *addrp" "int len" "char *buf" .Ft int .Fn ascii2addr "int af" "const char *ascii" "void *result" .Sh 解説 ルーチン .Fn addr2ascii と .Fn ascii2addr -は、バイナリ形式と、アドレスファミリに -適切な印刷可能形式の間でネットワークアドレスを変換するのに使用されます。 -両方の関数が、変換プロセスで使用されるアドレスファミリを指定する +は、バイナリ形式と、アドレスファミリに適切な印字可能な形式との間で +ネットワークアドレスを変換するのに使用されます。 +両方の関数とも、変換プロセスで使用されるアドレスファミリを指定する .Fa af -引数を -使用します (現時点では、 +引数を使用します (現時点では、 .Dv AF_INET および .Dv AF_LINK アドレスファミリだけがサポートされています)。 .Pp .Fn addr2ascii -関数は、バイナリのネットワーク形式のアドレス印刷可能な形式に +関数は、バイナリのネットワーク形式のアドレスを印字可能な形式に 変換するのに使用されます。 .Fa af -に加えて、 -3 つの他の引数があります。 +の他に、 3 つの引数を持ちます。 .Fa addrp -引数は、変換するネットワークアドレスを指すポインタです。 +引数は、変換するネットワークアドレスへのポインタです。 .Fa len -引数は、 -アドレスの長さです。 +引数は、アドレスの長さです。 .Fa buf 引数は、結果を保持するために呼び出し元が割り振る -バッファを指すオプションのポインタです。 +バッファへのオプションのポインタです。 ヌルポインタが渡されると、 .Fn addr2ascii は静的に割り振られたバッファを使用します。 .Pp .Fn ascii2addr 関数は、 .Fn addr2ascii -と逆の演算を実行します。 +と逆の操作を実行します。 .Fa af -に加えて、 -2 つのパラメータ +に加えて、2 つのパラメータ .Fa ascii と .Fa result を使用します。 .Fa ascii -パラメータは、バイナリに -変換されるストリングを指すポインタです。 +パラメータは、バイナリに変換される文字列へのポインタです。 .Fa result -パラメータは、指定のファミリ -に適切なネットワークアドレス構造を指すポインタです。 +パラメータは、指定されたファミリに適切なネットワークアドレス構造体への +ポインタです。 .Pp -指定ファイル内のバイナリアドレスを使用するのに適切な構造は次のとおりです。 +指定されたファミリにおいて使用されるバイナリアドレスとして +適切な構造体は次のとおりです。 .Pp .Bl -tag -width AF_INETxxxx -compact .It Dv AF_INET .Li struct in_addr .Pq in Aq Pa netinet/in.h -.It Av AF_LINK +.It Dv AF_LINK .Li struct sockaddr_dl .Pq in Aq Pa net/if_dl.h .\" .It Dv AF_INET6 .\" .Li struct in6_addr .\" .Pq in Aq Pa netinet6/in6.h .El .Sh 戻り値 .Fn addr2ascii 関数は、渡されたバッファのアドレス、または NULL -ポインタが -渡された場合は静的バッファのアドレスを返します。処理が失敗した場合は、 -ヌルポインタを返します。 +ポインタが渡された場合は静的バッファのアドレスを返します。 +処理が失敗した場合は、ヌルポインタを返します。 .Fn ascii2addr -関数は、バイナリアドレスの長さ (バイト単位) -を返します。処理が失敗した場合は --1 を返します。 +関数は、バイナリアドレスの長さ (バイト単位) を返します。 +処理が失敗した場合は -1 を返します。 .Pp .Sh 例 .Xr inet 3 関数 .Fn inet_ntoa と .Fn inet_aton -は次のように実現できます。 +は次のように実装することができます。 .Bd -literal -offset indent #include #include #Include #include char * inet_ntoa(struct in_addr addr) { - return addr2ascii(AF_INET, &addr, sizeof addr, 0); + return addr2ascii(AF_INET, &addr, sizeof addr, 0); } int inet_aton(const char *ascii, struct in_addr *addr) { - return (ascii2addr(AF_INET, ascii, addr) - == sizeof(*addr)); + return (ascii2addr(AF_INET, ascii, addr) + == sizeof(*addr)); } .Ed .Pp 実際には、これは実行できません。 .Fn addr2ascii と .Fn ascii2addr は、他の方法でなく、 .Xr inet 3 -関数で実現されているからです。 +関数で実装されているからです。 .Sh エラー 処理失敗が返されたとき、 .Li errno に次の値の 1 つの設定されます。 -.Bl -tag -width [EPROTONOSUPPORT] +.Bl -tag -width Er .It Bq Er ENAMETOOLONG .Fn addr2ascii ルーチンは、 .Fa af によって渡されたアドレスファミリに不適切なパラメータ .Fa len を渡されました。 .It Bq Er EPROTONOSUPPORT いずれかのルーチンに、 .Dv AF_INET または .Dv AF_LINK ではない .Fa af パラメータが渡されました。 -.It Bq er EINVAL -.Fn ascii2addr -によって渡された +.It Bq Er EINVAL .Fn ascii2addr に渡された文字列は、 アドレスファミリ .Fa af について不適切にフォーマットされていました。 .El .Sh 関連項目 .Xr inet 3 , .Xr linkaddr 3 , .Xr inet 4 .Sh 歴史 -これに近いインタフェースは、オリジナルには Craig Partridge -が提案しました。 +これに近いインタフェースは、もともと Craig Partridge によって +提案されました。 このインタフェース自体は、 .Tn INRIA +の .Tn IPv6 -インプリメントに最初に現れたものです。 +の実装に最初に現れました。 .Sh 作者 -コードとドキュメンテーションは -.An Garrett A. Wollman , -MIT Laboratory for Computer Science +コードとドキュメントは MIT Laboratory for Computer Science の +.An Garrett A. Wollman によるものです。 .Sh バグ -オリジナルの実装は IPv6 をサポートしていました。このサポートは、 -しだいに復活されるはずです。 +オリジナルの実装は IPv6 をサポートしていました。 +このサポートは、そのうち復活されるはずです。 .Tn NRL -の実装は、 +の実装には、 .Dv AF_ISO および .Dv AF_NS -のアドレスファミリのサポートを組み込んでいるはずです。 +アドレスファミリのサポートも含まれていました。 .Pp -このインタフェースの一般性については、いくらか疑問があります。真に一般的な -インタフェースは、使用されるバッファの長さを決定する手段を備えています。 -動的に割り当てでき、バイナリアドレスとして保存するのに必ず +このインタフェースの一般性については、いくらか疑問があります。 +本当に一般的なインタフェースであれば、バッファを動的に割り当てることが +できるよう、使用されるバッファの長さを決定する手段を備えているでしょうし、 +バイナリアドレスを保持するのには必ず .Dq Li struct sockaddr -を使用とするからです。不都合なことに、これは -既存のやり方と互換性がありません。この制限は、任意のアドレスファミリからの -ネットワークアドレスを印刷するルーチンには、必要な最大バッファ長と、 -バイナリアドレスとして使用するアドレスの該当する部分の内部的な -知識がなければならないことを意味します。 -.\" kuma +を要求するでしょう。 +残念ながら、これは既存のやり方と互換性がありません。 +この制限のため、任意のアドレスファミリからネットワークアドレスを +印字するルーチンは、必要な最大バッファ長や、 +バイナリアドレスとして使用するアドレスの適切な部分といった +内部的な知識を依然として持っていなければなりません。 diff --git a/ja_JP.eucJP/man/man3/alarm.3 b/ja_JP.eucJP/man/man3/alarm.3 index 32db85e8b9..ee5e16c96e 100644 --- a/ja_JP.eucJP/man/man3/alarm.3 +++ b/ja_JP.eucJP/man/man3/alarm.3 @@ -1,96 +1,102 @@ .\" Copyright (c) 1980, 1991, 1993, 1994 -.\" The Regents of the University of California. All rights reserved. +.\" 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. +.\" 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. .\" -.\" @(#)alarm.3 8.2 (Berkeley) 4/19/94 +.\" @(#)alarm.3 8.2 (Berkeley) 4/19/94 +.\" %FreeBSD: src/lib/libc/gen/alarm.3,v 1.9.2.2 2001/03/06 16:45:53 ru Exp % .\" .\" $FreeBSD$ .Dd April 19, 1994 .Dt ALARM 3 .Os BSD 4 .Sh 名称 .Nm alarm .Nd シグナルタイマアラームを設定する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft unsigned int .Fn alarm "unsigned int seconds" .Sh 解説 .Bf -symbolic このインタフェースは setitimer(2) によって旧式のものとなっています。 .Ef .Pp .Fn alarm -関数は、指定の -.Fa seconds -秒の後、シグナル +関数は、シグナル .Dv SIGALRM -を呼び出しプロセスに -配信するタイマを設定します。アラームが既に +を呼び出し元プロセスに指定の +.Fa seconds +秒後に配信するタイマを設定します。 +アラームが既に .Fn alarm -によって -設定されているものの配信されていない場合は、 +によって設定されているものの配信されていない場合、 +新たな .Fn alarm -をもう一度呼び出すと、 -前の呼び出しの設定を上書きします。要求 +呼び出しは、前の設定を上書きします。 +要求 .Fn alarm "0" は、現在のアラームを無効にし、シグナル .Dv SIGALRM は配信されません。 .Pp .Xr setitimer 2 の制約のために、 .Ar seconds の許される最大数は 100000000 です。 .Pp .Sh 戻り値 .Fn alarm の戻り値は、 .Fn alarm -の直前の呼び出しからタイマに残された時間の -量です。アラームが現時点で設定されていない場合、戻り値は +の直前の呼び出しからタイマに残された時間の量です。 +アラームが現時点で設定されていない場合、戻り値は 0 になります。 .Sh 関連項目 .Xr setitimer 2 , .Xr sigaction 2 , .Xr sigpause 2 , .Xr sigvec 2 , .Xr signal 3 , .Xr sleep 3 , .Xr ualarm 3 , .Xr usleep 3 -.Pp +.\" .Sh 規格 +.\" .Fn alarm +.\" 関数は +.\" .St -p1003.1-90 +.\" に適合しています。 .Sh 歴史 .Fn alarm 関数は .At v7 -で現れました。 -.\"X kuma +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man3/alloca.3 b/ja_JP.eucJP/man/man3/alloca.3 index 0188c74451..8e3426bf8b 100644 --- a/ja_JP.eucJP/man/man3/alloca.3 +++ b/ja_JP.eucJP/man/man3/alloca.3 @@ -1,76 +1,79 @@ .\" Copyright (c) 1980, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" 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. +.\" 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. .\" -.\" @(#)alloca.3 8.1 (Berkeley) 6/4/93 +.\" @(#)alloca.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/alloca.3,v 1.4.2.1 2000/04/22 17:06:23 phantom Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ALLOCA 3 .Os BSD 4 .Sh 名称 .Nm alloca .Nd メモリ割り当て関数 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void * .Fn alloca "size_t size" .Sh 解説 .Fn alloca 関数は、呼び出し元のスタックフレーム内に .Fa size バイトの空き領域を割り当てます。 この一時的な空間は、関数から戻るときに自動的に解放されます。 .Sh 戻り値 .Fn alloca -関数は、割り当てられた空間の先頭を指すポインタを返します。割り当て -処理に失敗した場合は、 +関数は、割り当てられた空間の先頭を指すポインタを返します。 +割り当て処理に失敗した場合は、 .Dv NULL ポインタが返されます。 .Pp .Sh 関連項目 .Xr brk 2 , .Xr calloc 3 , .Xr getpagesize 3 , .Xr malloc 3 , .Xr realloc 3 .Sh バグ .Fn alloca -関数はマシン依存です。これを使用することはお勧めできません。 +関数はマシン依存です。 +これを使用することはお勧めできません。 .\" .Sh HISTORY .\" .\" The .\" .Fn alloca .\" function appeared in .\" .Bx ?? . .\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd .\" The first man page (or link to a man page that I can find at the .\" moment is 4.3... -.\" kuma diff --git a/ja_JP.eucJP/man/man3/asin.3 b/ja_JP.eucJP/man/man3/asin.3 index 09e5ba9bdb..1201d7d601 100644 --- a/ja_JP.eucJP/man/man3/asin.3 +++ b/ja_JP.eucJP/man/man3/asin.3 @@ -1,102 +1,101 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)asin.3 5.1 (Berkeley) 5/2/91 -.\" %Id: asin.3,v 1.5 1997/02/22 15:09:22 peter Exp % +.\" %FreeBSD: src/lib/msun/man/asin.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" -.\" word: range 区間[asin.3] -.\" word: principal 主値[asin.3] -.\" word: radian ラジアン[asin.3] +.\" WORD: range 区間[asin.3] +.\" WORD: principal 主値[asin.3] +.\" WORD: radian ラジアン[asin.3] .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt ASIN 3 .Os .Sh 名称 .Nm asin , .Nm asinf .Nd 逆正弦関数 .Sh 書式 .Fd #include .Ft double .Fn asin "double x" .Ft float .Fn asinf "float x" .Sh 解説 .Fn asin -関数と +および .Fn asinf 関数は、 .Fa x -の逆正弦の主値を計算します。区間 -[-1, +1] -内にない引数については区間エラーが起きます。切り捨て丸めによるエラーの -詳細については、 +の逆正弦の主値を計算します。 +[-1, +1] の区間外の引数によって、領域エラーが発生します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 .Sh 戻り値 .Fn asin -関数と +および .Fn asinf -関数は、区間 +関数は、 .Bk -words -.Bq -\*(Pi/2, +\*(Pi/2 +.Bq -\*(Pi/2 , +\*(Pi/2 .Ek -ラジアンの逆正弦を返します。 +ラジアンの区間の逆正弦を返します。 .Tn VAX -と Tahoe では、 +および +.Tn Tahoe +では、 .Bd -unfilled -offset indent .Pf \&| Ns Ar x Ns \&| > 1 .Ed .Pp -の場合、グローバル変数 +の場合に、グローバル変数 .Va errno -が +を .Er EDOM -に設定され、予約されたオペランドエラーが生成されます。 +に設定し、予約されたオペランドフォルトが生成されます。 .Sh 関連項目 .Xr acos 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , -.Xr math 3 , +.Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 -.Pp .Sh 規格 .Fn asin -関数は -.St -ansiC -に準拠しています。 -.\" kuma +関数は、 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/asinh.3 b/ja_JP.eucJP/man/man3/asinh.3 index 8b5134baba..1798141e34 100644 --- a/ja_JP.eucJP/man/man3/asinh.3 +++ b/ja_JP.eucJP/man/man3/asinh.3 @@ -1,77 +1,77 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)asinh.3 6.4 (Berkeley) 5/6/91 -.\" %Id: asinh.3,v 1.5 1997/02/22 15:09:23 peter Exp % +.\" %FreeBSD: src/lib/msun/man/asinh.3,v 1.6 1999/08/28 00:06:18 peter Exp % .\" .\" $FreeBSD$ .Dd May 6, 1991 .Dt ASINH 3 .Os BSD 4.3 .Sh 名称 .Nm asinh , .Nm asinhf .Nd 逆双曲正弦関数 .Sh 書式 .Fd #include .Ft double .Fn asinh "double x" .Ft float .Fn asinhf "float x" .Sh 解説 .Fn asinh -関数と +および .Fn asinhf -関数は、実数引数 +関数は、実数の引数 .Ar x -の逆双曲正弦を計算します。切り捨て丸めエラーの詳細については、 +の逆双曲正弦を計算します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 -.Pp .Sh 戻り値 .Fn asinh -関数と +および .Fn asinhf -関数は +関数は、 .Ar x の逆双曲正弦を返します。 -.Pp .Sh 関連項目 .Xr acosh 3 , .Xr atanh 3 , .Xr exp 3 , .Xr math 3 .Sh 歴史 .Fn asinh -関数は +関数は、 .Bx 4.3 で登場しました。 -.\" kuma + + diff --git a/ja_JP.eucJP/man/man3/assert.3 b/ja_JP.eucJP/man/man3/assert.3 index fbb1d80ca5..8fd91b0a07 100644 --- a/ja_JP.eucJP/man/man3/assert.3 +++ b/ja_JP.eucJP/man/man3/assert.3 @@ -1,84 +1,86 @@ .\" Copyright (c) 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" 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. +.\" 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. .\" -.\" @(#)assert.3 8.1 (Berkeley) 6/9/93 -.\" %Id: assert.3,v 1.4 1998/01/02 19:22:50 alex Exp % +.\" @(#)assert.3 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/share/man/man3/assert.3,v 1.7.2.2 2000/12/29 10:17:59 ru Exp % .\" .\" $FreeBSD$ -.Dd June 9, 1993 +.Dd January 26, 1999 .Dt ASSERT 3 .Os .Sh 名称 .Nm assert .Nd 式検証マクロ .Sh 書式 .Fd #include .Fn assert expression .Sh 解説 .Fn assert マクロは、指定された .Ar expression -を試験し、偽の場合は、呼び出し元の -プロセスは終了されます。診断メッセージが +を試験し、偽の場合は、呼び出し元プロセスは終了されます。 +診断メッセージが .Em stderr に書き込まれ、関数 .Xr abort 3 が呼び出されてプログラムを効率的に終了します。 .Pp .Ar expression が真の場合、 .Fn assert マクロは何もしません。 .Pp .Fn assert マクロはコンパイル時に -.Fl NDEBUG -オプションで除去できます。 +.Dv NDEBUG +をマクロとして定義することで除去できます +(例えば .Xr cc 1 -を参照してください。 +のオプション +.Fl D Ns Dv NDEBUG +を使います)。 .Sh 診断 .Ar expression が偽の場合、次の診断メッセージが .Em stderr に書き込まれます。 .Bd -literal -offset indent -"assertion \e"%s\e" failed: file \e"%s\e", line %d0, \e - "expression", __FILE__, __LINE__); +"assertion \e"%s\e" failed: file \e"%s\e", line %d\en", \e + "expression", __FILE__, __LINE__); .Ed .Sh 関連項目 .Xr abort 3 .Pp .Sh 歴史 -.Fn assert +.Nm マクロは .At v6 で登場しました。 -.\" kuma diff --git a/ja_JP.eucJP/man/man3/atan.3 b/ja_JP.eucJP/man/man3/atan.3 index 72814ee994..1e713cf61c 100644 --- a/ja_JP.eucJP/man/man3/atan.3 +++ b/ja_JP.eucJP/man/man3/atan.3 @@ -1,86 +1,85 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)atan.3 5.1 (Berkeley) 5/2/91 -.\" %Id: atan.3,v 1.5 1997/02/22 15:09:24 peter Exp % +.\" %FreeBSD: src/lib/msun/man/atan.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt ATAN 3 .Os .Sh 名称 .Nm atan , .Nm atanf -.Nd 1 つの変数の逆正接関数 +.Nd 1 変数の逆正接関数 .Sh 書式 .Fd #include .Ft double .Fn atan "double x" .Ft float .Fn atanf "float x" .Sh 解説 .Fn atan -関数と +および .Fn atanf 関数は、 .Fa x -の逆正接の主値を計算します。切り捨て丸めのエラーの詳細については、 +の逆正接の主値を計算します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 -.Pp .Sh 戻り値 .Fn atan -関数と +および .Fn atanf -関数は、範囲 +関数は、 .Bk -words .Bq -\*(Pi/2 , +\*(Pi/2 .Ek -ラジアンの逆正接を返します。 -.Pp +ラジアンの区間の逆正接を返します。 .Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 -.Pp .Sh 規格 .Fn atan -関数は -.St -ansiC -に準拠しています。 -.\" kuma +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/atanh.3 b/ja_JP.eucJP/man/man3/atanh.3 index d2b11eaa99..3fd3328afe 100644 --- a/ja_JP.eucJP/man/man3/atanh.3 +++ b/ja_JP.eucJP/man/man3/atanh.3 @@ -1,91 +1,83 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)atanh.3 5.2 (Berkeley) 5/6/91 -.\" %Id: atanh.3,v 1.5 1997/02/22 15:09:25 peter Exp % +.\" %FreeBSD: src/lib/msun/man/atanh.3,v 1.6 1999/08/28 00:06:20 peter Exp % .\" .\" $FreeBSD$ .Dd May 6, 1991 .Dt ATANH 3 .Os BSD 4.3 .Sh 名称 .Nm atanh , .Nm atanhf .Nd 逆双曲正接関数 .Sh 書式 .Fd #include .Ft double .Fn atanh "double x" .Ft float .Fn atanhf "float x" .Sh 解説 -.Fn atanh -関数と -.Fn atanhf -関数は、実数引数 +.Fn atanh +および +.Fn atanhf +関数は、実数の引数 .Ar x -の逆双曲正接を計算します。切り捨て丸めによるエラーの詳細については、 -.Xr math 3 -を参照してください。 +の逆双曲正接を計算します。 .Sh 戻り値 .Fn atanh -関数と +および .Fn atanhf -関数は、処理が成功した場合、 +関数は、成功した場合には .Ar x -の逆双曲正接を -返します。 -.Tn VAX -と +の逆双曲正接を返します。 +.Tn VAX +および .Tn Tahoe -で、引数の絶対値が -1 より大きいかまたは -1 に等しい -場合、 +では、引数が 1 以上の値を持つ場合に、 .Fn atanh -がグローバル変数 +はグローバル変数 .Va errno を .Er EDOM -に設定し、予約済みオペランドエラーが生成されます。 -.Pp +に設定し、予約されたオペランドフォルトが生成されます。 .Sh 関連項目 .Xr acosh 3 , .Xr asinh 3 , .Xr exp 3 , .Xr math 3 -.Pp .Sh 歴史 .Fn atanh -関数は +関数は、 .Bx 4.3 -で現れました。 -.\" kuma +で登場しました。 + diff --git a/ja_JP.eucJP/man/man3/atexit.3 b/ja_JP.eucJP/man/man3/atexit.3 index fb479d4e19..7ff1cdfca0 100644 --- a/ja_JP.eucJP/man/man3/atexit.3 +++ b/ja_JP.eucJP/man/man3/atexit.3 @@ -1,80 +1,85 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. +.\" 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. .\" -.\" @(#)atexit.3 8.1 (Berkeley) 6/4/93 +.\" @(#)atexit.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/atexit.3,v 1.3.2.3 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ATEXIT 3 .Os .Sh 名称 .Nm atexit .Nd 終了時に呼び出される関数を登録する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn atexit "void (*function)(void)" .Sh 解説 .Fn atexit 関数は、 .Xr exit 3 -によってであれ、プログラムのメイン関数の -戻りによってであれ、プログラム終了で呼び出される指定の +によるものであろうが、プログラムの +.Em main +関数からの戻りによるものであろうが +プログラム終了時に、与えられた .Ar function -を登録します。このように登録された関数は、逆の順序に呼び出されます。 -引数は渡されません。少なくとも -32 個の関数が常に登録でき、十分なメモリが割り -振りできる限り、それを超える関数も登録できます。 +が呼び出されるよう登録します。 +登録された関数は、逆の順序で呼び出されます。 +引数は渡されません。 +少なくとも 32 個の関数が常に登録でき、 +十分なメモリが割り当てられる限り、それを超える関数も登録できます。 .Sh 戻り値 .\"X .Rv -std atexit .Fn atexit -関数は、処理が成功すると値 0 を返します。そうでない場合、値 -1 が -返され、グローバル変数 +関数は、処理が成功すると値 0 を返します。 +そうでない場合は -1 が返され、エラーを示すためにグローバル変数 .Fa errno -が設定されてエラーを示します。 +が設定されます。 .Sh エラー -.Bl -tag -width [ENOMEM] +.Bl -tag -width Er .It Bq Er ENOMEM -関数をリストに追加するメモリが利用できませんでした。関数の既存の -リストは無修正です。 +関数をリストに追加するメモリが利用できませんでした。 +関数の既存のリストは無修正です。 .El .Sh 関連項目 .Xr exit 3 .Sh 規格 .Fn atexit 関数は -.St -ansiC -に準拠しています。 -.\" kuma +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/atof.3 b/ja_JP.eucJP/man/man3/atof.3 index 8d2bb535c1..bd5c1862ee 100644 --- a/ja_JP.eucJP/man/man3/atof.3 +++ b/ja_JP.eucJP/man/man3/atof.3 @@ -1,76 +1,78 @@ .\" Copyright (c) 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. +.\" 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. .\" -.\" @(#)atof.3 8.1 (Berkeley) 6/4/93 +.\" @(#)atof.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/atof.3,v 1.4.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ATOF 3 .Os .Sh 名称 .Nm atof .Nd .Tn ASCII 文字列を倍精度浮動小数点数に変換する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft double .Fn atof "const char *nptr" .Sh 解説 .Fn atof 関数は、 .Ar nptr が指している文字列の最初の部分を、 .Ar double 表現に変換します。 .Pp これは次と同等です。 .Bd -literal -offset indent strtod(nptr, (char **)NULL); .Ed .Pp .Sh 関連項目 .Xr atoi 3 , .Xr atol 3 , .Xr strtod 3 , .Xr strtol 3 , .Xr strtoul 3 .Pp .Sh 規格 .Fn atof 関数は -.St -ansiC -に準拠しています。 -.\" kuma +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/atoi.3 b/ja_JP.eucJP/man/man3/atoi.3 index 496c6ad941..bbd8d052eb 100644 --- a/ja_JP.eucJP/man/man3/atoi.3 +++ b/ja_JP.eucJP/man/man3/atoi.3 @@ -1,74 +1,76 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. +.\" 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. .\" -.\" @(#)atoi.3 8.1 (Berkeley) 6/4/93 +.\" @(#)atoi.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/atoi.3,v 1.3.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ATOI 3 .Os .Sh 名称 .Nm atoi .Nd .Tn ASCII 文字列を整数に変換する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn atoi "const char *nptr" .Sh 解説 .Fn atoi 関数は、 .Em nptr の指す文字列の最初の部分を .Em integer 表現に変換します。 .Pp これは次と同等です。 .Bd -literal -offset indent (int)strtol(nptr, (char **)NULL, 10); .Ed .Sh 関連項目 .Xr atof 3 , .Xr atol 3 , .Xr strtod 3 , .Xr strtol 3 , .Xr strtoul 3 .Sh 規格 .Fn atoi 関数は -.St -ansiC -に準拠しています。 -.\" kuma +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/atol.3 b/ja_JP.eucJP/man/man3/atol.3 index 6dfec10658..c778c1a93e 100644 --- a/ja_JP.eucJP/man/man3/atol.3 +++ b/ja_JP.eucJP/man/man3/atol.3 @@ -1,75 +1,77 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. +.\" 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. .\" -.\" @(#)atol.3 8.1 (Berkeley) 6/4/93 +.\" @(#)atol.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/atol.3,v 1.3.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt ATOL 3 .Os .Sh 名称 .Nm atol .Nd .Tn ASCII 文字列を長整数に変換する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft long .Fn atol "const char *nptr" .Sh 解説 .Fn atol 関数は、 .Ar nptr が指す文字列の先頭部分を .Em long integer 表現に変換します。 .Pp これは次と同等です。 .Bd -literal -offset indent strtol(nptr, (char **)NULL, 10); .Ed .Sh 関連項目 .Xr atof 3 , .Xr atoi 3 , .Xr strtod 3 , .Xr strtol 3 , .Xr strtoul 3 .Pp .Sh 規格 .Fn atol 関数は -.St -ansiC -に準拠しています。 -.\" kuma +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/bcmp.3 b/ja_JP.eucJP/man/man3/bcmp.3 index efabf68ff6..bf6a7c8fa0 100644 --- a/ja_JP.eucJP/man/man3/bcmp.3 +++ b/ja_JP.eucJP/man/man3/bcmp.3 @@ -1,76 +1,76 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" 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. +.\" 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. .\" -.\" @(#)bcmp.3 8.1 (Berkeley) 6/4/93 +.\" @(#)bcmp.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/bcmp.3,v 1.4.2.1 2000/04/22 17:06:35 phantom Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt BCMP 3 .Os BSD 4.2 .Sh 名称 .Nm bcmp .Nd バイト文字列を比較する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn bcmp "const void *b1" "const void *b2" "size_t len" .Sh 解説 .Fn bcmp 関数は、バイト文字列 .Fa b1 をバイト文字列 .Fa b2 -に対して比較し、 -これらが同一の場合は -0 を返し、そうでない場合はゼロでない値を返します。 -両方の文字列が +に対して比較します。 +これらが同一の場合は 0 を返し、そうでない場合は 0 でない値を返します。 +両方の文字列は .Fa len -バイトの長さであると想定して比較します。長さがゼロの -文字列は必ず同一です。 +バイトの長さであると想定します。 +長さが 0 の文字列は常に同一です。 .Pp -2つの文字列が重なりあっていても構いません。 +2 つの文字列は重なり合っていても構いません。 .Pp .Sh 関連項目 -.Xr bcmp 3 , .Xr memcmp 3 , .Xr strcasecmp 3 , .Xr strcmp 3 , .Xr strcoll 3 , .Xr strxfrm 3 .Pp .Sh 歴史 .Fn bcmp -関数は最初に +関数は .Bx 4.2 -で現れました。 -.\" kuma +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man3/bcopy.3 b/ja_JP.eucJP/man/man3/bcopy.3 index 38b91c6779..31c0546a2a 100644 --- a/ja_JP.eucJP/man/man3/bcopy.3 +++ b/ja_JP.eucJP/man/man3/bcopy.3 @@ -1,71 +1,73 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" .\" 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. +.\" 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. .\" -.\" @(#)bcopy.3 8.1 (Berkeley) 6/4/93 +.\" @(#)bcopy.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/bcopy.3,v 1.3.2.1 2000/04/22 17:06:37 phantom Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt BCOPY 3 .Os BSD 4.2 .Sh 名称 .Nm bcopy .Nd バイト文字列をコピーする +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn bcopy "const void *src" "void *dst" "size_t len" .Sh 解説 .Fn bcopy 関数は、文字列 .Fa src から文字列 .Fa dst に .Fa len バイトをコピーします。 -2 つの文字列が重なりあっていても構いません。 +2 つの文字列は重なり合っていても構いません。 .Fa len -がゼロの場合、コピーされるバイトはありません。 +が 0 の場合、コピーはされません。 .Sh 関連項目 .Xr memccpy 3 , .Xr memcpy 3 , .Xr memmove 3 , .Xr strcpy 3 , .Xr strncpy 3 .Sh 歴史 .Fn bcopy 関数は .Bx 4.2 -で現れました。 -.\" kuma +で登場しました。 diff --git a/ja_JP.eucJP/man/man3/bsearch.3 b/ja_JP.eucJP/man/man3/bsearch.3 index 74b02c8db9..b261085b53 100644 --- a/ja_JP.eucJP/man/man3/bsearch.3 +++ b/ja_JP.eucJP/man/man3/bsearch.3 @@ -1,95 +1,91 @@ .\" Copyright (c) 1990, 1991, 1993, 1994 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. +.\" 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. .\" -.\" @(#)bsearch.3 8.3 (Berkeley) 4/19/94 +.\" @(#)bsearch.3 8.3 (Berkeley) 4/19/94 +.\" %FreeBSD: src/lib/libc/stdlib/bsearch.3,v 1.4.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd April 19, 1994 .Dt BSEARCH 3 .Os .Sh 名称 .Nm bsearch .Nd ソート済みの表に対するバイナリ探索 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void * .Fn bsearch "const void *key" "const void *base" "size_t nmemb" "size_t size" "int (*compar) (const void *, const void *)" .Sh 解説 .Fn bsearch -関数は、 -最初のメンバが +関数は、最初のメンバが .Fa base によって示されている .Fa nmemb 個のオブジェクトの配列の中から .Fa key -が指すオブジェクト -に一致するメンバを探します。 +が指すオブジェクトに一致するメンバを探します。 配列の各メンバのサイズは .Fa size で指定されます。 .Pp 配列の内容は、 .Fa compar -が参照する比較関数に従って昇順にソート -された状態でなければなりません。 +が参照する比較関数に従って昇順にソートされた状態でなければなりません。 .Fa compar -ルーチンには、 -2 つの引数があり、 +ルーチンは .Fa key オブジェクト -と配列メンバをこの順序で指します。 +と配列メンバを指す 2 つの引数をこの順序でとることが期待されており、 .Fa key -オブジェクトが、配列メンバより -小さい、一致する、またはより多いことが検出された場合、それぞれゼロより -小さい整数、ゼロ、ゼロを超える整数が返されます。 +オブジェクトが配列メンバより小さい、一致する、またはより大きいことが +検出された場合、それぞれ 0 より小さい整数、0、0 より大きい整数を返します。 .Sh 戻り値 .Fn bsearch -関数は、配列の一致するメンバを指すポインタを返します。または、 -一致するメンバが見つからない場合は -NULL -ポインタを返します。 +関数は、配列の一致したメンバへのポインタを返します。 +一致したメンバが見つからなかった場合は、ヌルポインタを返します。 もし 2 つのメンバが比較の対象として等しい場合、 -一致したメンバがどちらになるかは不定となります。 +どちらのメンバが一致したかは不定となります。 .Sh 関連項目 .Xr db 3 , .Xr lsearch 3 , .Xr qsort 3 .\" .Xr tsearch 3 .Sh 規格 .Fn bsearch 関数は -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/bstring.3 b/ja_JP.eucJP/man/man3/bstring.3 index 4d45b8b48a..d010223160 100644 --- a/ja_JP.eucJP/man/man3/bstring.3 +++ b/ja_JP.eucJP/man/man3/bstring.3 @@ -1,117 +1,114 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" 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. +.\" 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. .\" -.\" @(#)bstring.3 8.1 (Berkeley) 6/4/93 +.\" @(#)bstring.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/bstring.3,v 1.3.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt BSTRING 3 .Os .Sh 名称 .Nm bcmp , .Nm bcopy , .Nm bzero , .Nm memccpy , .Nm memchr , .Nm memcmp , .Nm memcpy , -.Nm memmove, +.Nm memmove , .Nm memset .Nd バイト文字列の操作 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn bcmp "const void *b1" "const void *b2" "size_t len" .Ft void .Fn bcopy "const void *src" "void *dst" "size_t len" .Ft void .Fn bzero "void *b" "size_t len" .Ft void * .Fn memchr "const void *b" "int c" "size_t len" .Ft int .Fn memcmp "const void *b1" "const void *b2" "size_t len" .Ft void * .Fn memccpy "void *dst" "const void *src" "int c" "size_t len" .Ft void * .Fn memcpy "void *dst" "const void *src" "size_t len" .Ft void * .Fn memmove "void *dst" "const void *src" "size_t len" .Ft void * .Fn memset "void *b" "int c" "size_t len" .Sh 解説 -これらの関数は、さまざまな長さのバイトストリングに作用します。これらは、 +これらの関数は、さまざまな長さのバイト文字列を操作します。 +これらは、 .Xr string 3 -にリストされたルーチンのように終了の -NULL -バイトをチェック -しません。 +にリストされたルーチンのように終了のヌルバイトをチェックしません。 .Pp -詳細については、専用のマニュアルページを参照してください。 +詳細については、それぞれのマニュアルページを参照してください。 .Sh 関連項目 .Xr bcmp 3 , .Xr bcopy 3 , .Xr bzero 3 , .Xr memccpy 3 , .Xr memchr 3 , .Xr memcmp 3 , .Xr memcpy 3 , .Xr memmove 3 , .Xr memset 3 .Sh 規格 関数 -.Fn memchr -、 -.Fn memcmp -、 -.Fn memcpy -、 +.Fn memchr , +.Fn memcmp , +.Fn memcpy , .Fn memmove -、および +および .Fn memset は -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 .Sh 歴史 -関数 .Fn bzero -と +関数と .Fn memccpy -は +関数は .Bx 4.3 -で現れました。関数 +で登場しました。 .Fn bcmp -と +関数と .Fn bcopy -は +関数は .Bx 4.2 -で現れました。 +で登場しました。 diff --git a/ja_JP.eucJP/man/man3/byteorder.3 b/ja_JP.eucJP/man/man3/byteorder.3 index 8deb1a03af..0fbc5b5ac9 100644 --- a/ja_JP.eucJP/man/man3/byteorder.3 +++ b/ja_JP.eucJP/man/man3/byteorder.3 @@ -1,82 +1,80 @@ .\" Copyright (c) 1983, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" 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. +.\" 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. .\" -.\" @(#)byteorder.3 8.1 (Berkeley) 6/4/93 +.\" @(#)byteorder.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/net/byteorder.3,v 1.3.2.1 2000/04/22 17:06:03 phantom Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt BYTEORDER 3 .Os BSD 4.2 .Sh 名称 .Nm htonl , .Nm htons , .Nm ntohl , .Nm ntohs -.Nd ホストとネットワーク間のバイト順序を変換 +.Nd ホストバイトオーダとネットワークバイトオーダを変換する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft u_long .Fn htonl "u_long hostlong" .Ft u_short .Fn htons "u_short hostshort" .Ft u_long .Fn ntohl "u_long netlong" .Ft u_short .Fn ntohs "u_short netshort" .Sh 解説 -これらのルーチンは、 -16 ビットと -32 ビットの量を、ネットワークバイト順序と -ホストバイト順序の間で変換します。 -ネットワークの順序と同じバイト順序の -マシンでは、ルーチンは -NULL -マクロとして定義されます。 +これらのルーチンは、16 ビットと 32 ビットの値を、 +ネットワークバイトオーダとホストバイトオーダの間で変換します。 +ネットワークのオーダと同じバイトオーダのマシンでは、 +ルーチンはヌルマクロとして定義されます。 .Pp これらのルーチンは、 .Xr gethostbyname 3 および .Xr getservent 3 -によって返される -インターネットアドレスおよびポートとともに使用されることが -最もよくあります。 +によって返されるインターネットアドレスおよびポートとともに +使用されることが最もよくあります。 .Sh 関連項目 .Xr gethostbyname 3 , .Xr getservent 3 .Sh 歴史 .Nm byteorder 関数は .Bx 4.2 -に現れました。 +で登場しました。 .Sh バグ .Tn VAX は、世界中の他のほとんどすべてのマシンとは逆順にバイトを処理します。 この問題は、当分解決の見込みはありません。 diff --git a/ja_JP.eucJP/man/man3/bzero.3 b/ja_JP.eucJP/man/man3/bzero.3 index e959c4654b..d9880b623d 100644 --- a/ja_JP.eucJP/man/man3/bzero.3 +++ b/ja_JP.eucJP/man/man3/bzero.3 @@ -1,70 +1,71 @@ .\" Copyright (c) 1990, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" .\" 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. +.\" 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. .\" -.\" @(#)bzero.3 8.1 (Berkeley) 6/4/93 +.\" @(#)bzero.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/bzero.3,v 1.3.2.1 2000/04/22 17:06:37 phantom Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt BZERO 3 .Os BSD 4.3 .Sh 名称 .Nm bzero -.Nd バイトストリングにゼロを書き込む +.Nd バイト文字列に 0 を書き込む +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn bzero "void *b" "size_t len" .Sh 解説 .Fn bzero 関数は、 .Fa len -個のゼロバイトをストリング +個の 0 バイトを文字列 .Fa b に書き込みます。 .Fa len -がゼロの -場合、 +が 0 の場合、 .Fn bzero は何もしません。 .Pp .Sh 関連項目 .Xr memset 3 , .Xr swab 3 .Pp .Sh 歴史 .Fn bzero 関数は .Bx 4.3 -で現れました。 - +で登場しました。 diff --git a/ja_JP.eucJP/man/man3/calendar.3 b/ja_JP.eucJP/man/man3/calendar.3 index 62f6f0bfe6..a468fc5bd8 100644 --- a/ja_JP.eucJP/man/man3/calendar.3 +++ b/ja_JP.eucJP/man/man3/calendar.3 @@ -1,230 +1,217 @@ .\" Copyright (c) 1997 Wolfgang Helbig .\" 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. .\" -.\" %Id: calendar.3,v 1.4 1998/03/19 07:33:51 charnier Exp % -.\" +.\" %FreeBSD: src/lib/libcalendar/calendar.3,v 1.6.2.2 2001/01/16 12:09:30 ru Exp % .\" $FreeBSD$ +.\" .Dd November 29, 1997 .Dt CALENDAR 3 .Os .Sh 名称 .Nm easterg , .Nm easterog , .Nm easteroj , .Nm gdate , .Nm jdate , .Nm ndaysg , .Nm ndaysj , .Nm week , .Nm weekday .Nd 西暦での日付けの演算 +.Sh ライブラリ +.Lb libcalendar .Sh 書式 .Fd #include .Ft struct date * .Fn easterg "int year" "struct date *dt" .Ft struct date * .Fn easterog "int year" "struct date *dt" .Ft struct date * .Fn easteroj "int year" "struct date *dt" .Ft struct date * .Fn gdate "int nd" "struct date *dt" .Ft struct date * .Fn jdate "int nd" "struct date *dt" .Ft int .Fn ndaysg "struct date *dt" .Ft int .Fn ndaysj "struct date *dt" .Ft int .Fn week "int nd" "int *year" .Ft int .Fn weekday "int nd" .Sh 解説 -これらの関数は、西暦ゼロ年 (すなわちB.C. 1 年) 3 月 1 日 +これらの関数は、西暦 0 年 (すなわち B.C. 1 年) 3 月 1 日 から西暦 100000 年までの 広範囲の年月のカレンダを演算します。 .Pp プログラムは .Fl lcalendar とリンクさせる必要があります。 .Pp 関数 -.Fn easterg -、 +.Fn easterg , .Fn easterog および .Fn easteroj は、 -Eastern Sunday (復活祭の日曜日) +Easter Sunday (復活祭の日曜日) の日付けを、 .Fa dt で指定した構造体に保存し、 この構造体のポインタを返します。 関数 .Fn easterg は、グレゴリオ暦 (1582 年以降に西ヨーロッパのほとんどのキリスト教会で採用された) を仮定し、 関数 .Fn easterog および .Fn easteroj は、正統派 (1582 年以前の西ヨーロッパ教会、および今日まで続く ギリシャ正教会、ロシア正教会などいわゆる東方正教会) の規則に従って、 Easter Sunday の日付けを演算します。 その結果、 .Fn easterog はグレゴリオ暦(現行太陽暦)を返し、 .Fn easteroj はユリウス暦(旧太陽暦)を返します。 .Pp 関数 .Fn gdate , .Fn jdate , .Fn ndaysg および .Fn ndaysj は、日付けの .Qq 年、月、日 という一般表記と、より演算に適した .Qq 日数 表現の相互変換を行います。 B.C. 1 年 3 月 1 日をゼロとして、 以降の経過日に順番に番号が振られます。 すなわちこの日番号は、 B.C. 1 年 3 月 1 日からその日までの経過日数を示します。 変換は、正数の日番号に対してだけ機能します。 .Pp .Fn gdate および .Fn jdate 関数は、日番号 .Fa nd に対応する日付けを .Fa dt -で指定した構造体に保存し、 -その構造体のポインタを返します。 +で指定した構造体に保存し、その構造体のポインタを返します。 .Pp .Fn ndaysg および .Fn ndaysj 関数は、 .Fa dt で指定した日付けの日番号を返します。 .Pp .Fn gdate および .Fn ndaysg -関数は、 -1582 年 10 月 4 日以降のグレゴリオ暦および、 +関数は、1582 年 10 月 4 日以降のグレゴリオ暦および、 以前のユリウス暦を仮定しますが、 一方、 .Fn jdate および .Fn ndaysj は一貫してユリウス暦だけを仮定します。 .Pp これら 2 つの暦ではうるう年の定義が違います。 ユリウス暦では 4 の倍数の年はすべてうるう年ですが、 グレゴリオ暦ではそのうちの -100 の倍数で、 -400 の 倍数ではない年を除きます。 -すなわち、 1700 、 1800 、 1900 、 2100 年はうるう年ではなく、 +100 の倍数で、400 の 倍数ではない年を除きます。 +すなわち、1700, 1800, 1900, 2100 年はうるう年ではなく、 2000 年はうるう年になります。 この新たな規則は、1582 年 10 月 4 日に、 同日以降の 10 日を削除することで開始されました。 カトリック国家のほとんどは、 16 世紀末までにこの新暦を採用しましたが、 -一方、 -20 世紀までなおユリウス暦にとどまる国々もありました。 -英国とその植民地が -新暦に切り替えたのは、 -1752 年 9 月 2 日でしたが、 -その時点ではすでに -11 日を -削除する必要がありました。 +一方、20 世紀までなおユリウス暦にとどまる国々もありました。 +英国とその植民地が新暦に切り替えたのは、1752 年 9 月 2 日でしたが、 +その時点ではすでに 11 日を削除する必要がありました。 .Pp 関数 .Fn week は、 .Fa nd -で指定された日番号の日付けが含まれる、週番号を返します。 +で指定された日番号の日付けが含まれる週番号を返します。 引数 .Fa *year -は、その週 (の半分以上) -が含まれる年に設定されます。 -週番号は、 -各年の 3 日以上が含まれる第 1 週を 1 として、 +は、その週 (の半分以上) が含まれる年に設定されます。 +週番号は、各年の 3 日以上が含まれる第 1 週を 1 として、 順番に振られます。 週は月曜日から始まります。 この関数はグレゴリオ暦だけに定義されます。 .Pp 関数 .Fn weekday は、 .Fa nd で指定された日番号の日付けの曜日 (月曜 = 0 … 日曜 = 6) を返します。 .Pp 構造体 .Fa date は .Aq Pa calendar.h 内で定義されています。次のフィールドを 含みます。 .Bd -literal -offset indent int y; /\(** year (0000 - ????) \(**/ int m; /\(** month (1 - 12) \(**/ int d; /\(** day of month (1 - 31) \(**/ .Ed .Pp -ゼロ年は歴史家の手では +0 年は歴史家の手では .Qq 1 B.C. -と書かれますが、天文学者とこのライブラリ -では +と書かれますが、天文学者とこのライブラリでは .Qq 0 と表記されます。 .Sh 関連項目 .Xr ncal 1 , .Xr strftime 3 -.Rs -.%A A. B. Author -.%D November 1997 .Sh 規格 週番号は ISO 8601: 1988 に準拠しています。 .Sh 歴史 .Nm calendar ライブラリは .Fx 3.0 -で最初に取り入れられました。 +で最初に登場しました。 .Sh 作者 このマニュアルページとライブラリは、 .An Wolfgang Helbig Aq helbig@FreeBSD.org によって書かれました。 .Sh バグ -このライブラリはきわめて慎重にコーディングされたので、残されたバグ -はありません。 +このライブラリはきわめて慎重にコーディングされたので、 +残されたバグはありません。 diff --git a/ja_JP.eucJP/man/man3/catclose.3 b/ja_JP.eucJP/man/man3/catclose.3 index 492b83ea05..298e1e917b 100644 --- a/ja_JP.eucJP/man/man3/catclose.3 +++ b/ja_JP.eucJP/man/man3/catclose.3 @@ -1,56 +1,71 @@ -.\" %Id: catclose.3,v 1.5 1998/04/30 11:06:11 ache Exp % -.\" .\" Copyright (c) 1994 Winning Strategies, Inc. .\" 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 Winning Strategies, Inc. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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/nls/catclose.3,v 1.7.2.4 2001/02/12 08:43:29 phantom Exp % .\" $FreeBSD$ .Dd May 29, 1994 .Dt CATCLOSE 3 .Os .Sh 名称 .Nm catclose -.Nd メッセージカタログを閉じる +.Nd メッセージカタログのクローズ +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn catclose "nl_catd catd" .Sh 解説 .Fn catclose 関数は、引数 .Fa catd -で指定されたメッセージカタログを閉じます。 -.Pp +によって指定されたメッセージカタログをクローズします。 +.Sh 戻り値 +.\".Rv -std catclose +.Fn catclose +関数は成功すると値 0 を返します。それ以外の場合は値 -1 が +返され、エラーを示すグローバル変数 +.Fa errno +が設定されます。 +.Sh エラー +.Bl -tag -width Er +.It Bq Er EBADF +.Fa catd +引数によって無効なメッセージカタログ記述子が渡されました。 +.El .Sh 関連項目 +.Xr gencat 1 , .Xr catgets 3 , .Xr catopen 3 -.Pp .Sh 規格 .Fn catclose -関数は +関数は、 .St -xpg4 -に準拠しています。 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/catgets.3 b/ja_JP.eucJP/man/man3/catgets.3 index 0e4bf95469..45faa304bd 100644 --- a/ja_JP.eucJP/man/man3/catgets.3 +++ b/ja_JP.eucJP/man/man3/catgets.3 @@ -1,72 +1,73 @@ -.\" %Id: catgets.3,v 1.5 1998/04/30 11:06:12 ache Exp % -.\" .\" Copyright (c) 1994 Winning Strategies, Inc. .\" 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 Winning Strategies, Inc. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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/nls/catgets.3,v 1.7.2.2 2000/09/07 16:46:33 ache Exp % .\" $FreeBSD$ .Dd May 29, 1994 .Dt CATGETS 3 .Os .Sh 名称 .Nm catgets -.Nd メッセージカタログからの文字列の取得 +.Nd メッセージカタログからの文字列の取り出し +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn catgets "nl_catd catd" "int set_id" "int msg_id" "const char *s" .Sh 解説 -.Fn catgets +.Fn catgets 関数は、記述子 .Fa catd -が参照しているメッセージカタログからセット +によって参照されたメッセージカタログの、セット .Fa set_id のメッセージ .Fa msg_id -を取り出そうとします。引数 +の取り出しを試みます。 +引数 .Fa s -は、関数が指定の -メッセージを取り出せない場合に返されるデフォルトメッセージを指定します。 -.Pp +は、この関数が指定されたメッセージを取り出せない場合に返される、 +デフォルトメッセージを指しています。 .Sh 戻り値 -指定のメッセージを取り出すことができた場合、 +指定されたメッセージが成功裏に取り出された場合には、 .Fn catgets -は、 -メッセージストリングの入った内部バッファを指すポインタを返します。 -そうでない場合は、 +はそのメッセージ文字列が入った内部バッファへのポインタを返します。 +そうでない場合には、 .Fa s を返します。 -.Pp .Sh 関連項目 +.Xr gencat 1 , .Xr catclose 3 , .Xr catopen 3 .Sh 規格 .Fn catgets -関数は +関数は、 .St -xpg4 -に -準拠しています。 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/catopen.3 b/ja_JP.eucJP/man/man3/catopen.3 index cd9c5ac344..b5df8c1ede 100644 --- a/ja_JP.eucJP/man/man3/catopen.3 +++ b/ja_JP.eucJP/man/man3/catopen.3 @@ -1,102 +1,146 @@ -.\" %Id: catopen.3,v 1.6 1998/04/30 16:11:50 ache Exp % -.\" .\" Copyright (c) 1994 Winning Strategies, Inc. .\" 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 Winning Strategies, Inc. .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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/nls/catopen.3,v 1.9.2.4 2000/12/08 13:49:28 ru Exp % .\" $FreeBSD$ .Dd May 29, 1994 .Dt CATOPEN 3 .Os .Sh 名称 .Nm catopen .Nd メッセージカタログのオープン +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft nl_catd .Fn catopen "const char *name" "int oflag" .Sh 解説 .Fn catopen 関数は、 +.Fa name +によって指定されたメッセージカタログをオープンし、メッセージカタログの +記述子を返します。 .Fa name -によって指定されるメッセージカタログを開き、 -メッセージカタログ記述子を返します。 +に 1 つの +.Sq / +が含まれている場合には、 .Fa name -に -.Sq / -が -1 つ含まれる場合、 +はメッセージカタログのフルパス名を指定します。そうでない場合には、環境変数の値 +.Ev NLSPATH +が以下の置換とともに使用されます。 +.Bl -tag -width XXX +.It \&%N .Fa name -はメッセージカタログの完全なパス名を指定します。そうでない場合は、 -環境変数 +引数の値です。 +.It \&%L +.Ev LANG +環境変数または +.Dv LC_MESSAGES +カテゴリ (下記参照) の値です。 +.It \&%l +.Ev LANG +環境変数または +.Dv LC_MESSAGES +カテゴリの言語要素です。 +.It \&%t +.Ev LANG +環境変数または +.Dv LC_MESSAGES +カテゴリの地域要素です。 +.It \&%c +.Ev LANG +環境変数または +.Dv LC_MESSAGES +カテゴリのコードセット要素です。 +.It \&%% +単一の % 文字です。 +.El +.Pp +空の文字列は未定義の値に置換されます。 +.Pp .Ev NLSPATH -の値が、 -%N -の代わりに置き換えられ -.Fa name -とともに -使用されます。 +で定義されるパス名のテンプレートは、コロン +.No ( Sq \&: ) +で区切られます。 +先頭のまたは 2 つの隣接するコロンは、%N を指定したのと同等です。 .Pp .Fa oflag 引数が .Dv NL_CAT_LOCALE -定数に設定されている場合、メッセージカタログを開くために +定数に設定されている場合には、 .Dv LC_MESSAGES -ロケールカテゴリが使用されます。 +ロケールカテゴリがメッセージカタログをオープンするために使用されます。 .Dv NL_CAT_LOCALE -を使用することは +の使用は、 .St -xpg4 -規格に準拠しています。 +規格に適合しています。 .St -xpg3 -との互換性を保つために 0 を指定することができます。 +との互換性のために 0 を指定することができます。 .Fa oflag -が 0 に設定されている場合、 +が 0 に設定されている時には、 .Ev LANG -環境変数によってメッセージカタログのロケールが決定されます。 +環境変数がメッセージカタログのロケールを決定します。 +.Pp +メッセージカタログの記述子は、プロセスがそれをクローズするまで、または 1 つの +.Xr exec 3 +関数の呼び出しの成功まで、有効に残ります。 .Sh 戻り値 -処理が正常に完了すると、 +成功して完了した時には、 .Fn catopen -は、メッセージカタログ記述子を返します。 -そうでない場合は、 -(nl_catd) -1 -が返され、エラーを示す -.Va errno -が設定されます。 +はメッセージカタログの記述子を返します。 +そうでない場合には、(nl_catd) -1 が返され、 +.Va errno +がそのエラーを示すために設定されます。 .Sh エラー .Bl -tag -width Er +.It Bq Er EINVAL +引数 +.Fa name +が有効なメッセージカタログを指していません。 +.It Bq Er ENAMETOOLONG +メッセージカタログのパス名全体が 1024 文字を超過しています。 +.It Bq Er ENOENT +その名前のメッセージカタログが存在しません。または、 +.Fa name +引数が空の文字列を指しています。 .It Bq Er ENOMEM -利用できるメモリが不十分です。 +十分なメモリが有効ではありません。 .El .Sh 関連項目 +.Xr gencat 1 , .Xr catclose 3 , .Xr catgets 3 , .Xr setlocale 3 .Sh 規格 .Fn catopen -関数は +関数は、 .St -xpg4 -に準拠しています。 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/ceil.3 b/ja_JP.eucJP/man/man3/ceil.3 index 6a767b31f9..0682d8f90c 100644 --- a/ja_JP.eucJP/man/man3/ceil.3 +++ b/ja_JP.eucJP/man/man3/ceil.3 @@ -1,69 +1,69 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)ceil.3 5.1 (Berkeley) 5/2/91 -.\" %Id: ceil.3,v 1.7 1997/03/19 01:28:42 bde Exp % +.\" %FreeBSD: src/lib/msun/man/ceil.3,v 1.8.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd March 10, 1994 .Dt CEIL 3 .Os .Sh 名称 .Nm ceil , .Nm ceilf -.Nd x 以上で最も小さい整数への切上げ +.Nd x 以上の最も小さな整数値への切上げ .Sh 書式 .Fd #include .Ft double .Fn ceil "double x" .Ft float .Fn ceilf "float x" .Sh 解説 .Fn ceil -関数と +および .Fn ceilf -関数は、 +関数は、(倍精度数として表現される) .Fa x -以上の最も小さい整数値 -(倍精度数として表現される) -を返します。 +以上の最も小さな整数値を返します。 .Sh 関連項目 .Xr abs 3 , .Xr fabs 3 , .Xr floor 3 , .Xr ieee 3 , .Xr math 3 , .Xr rint 3 .Sh 規格 .Fn ceil -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/cos.3 b/ja_JP.eucJP/man/man3/cos.3 index 55118cabe1..f520f8f616 100644 --- a/ja_JP.eucJP/man/man3/cos.3 +++ b/ja_JP.eucJP/man/man3/cos.3 @@ -1,83 +1,82 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)cos.3 5.1 (Berkeley) 5/2/91 -.\" %Id: cos.3,v 1.6 1997/03/19 01:28:44 bde Exp % +.\" %FreeBSD: src/lib/msun/man/cos.3,v 1.7.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt COS 3 .Os .Sh 名称 .Nm cos , .Nm cosf .Nd 余弦関数 .Sh 書式 .Fd #include .Ft double .Fn cos "double x" .Ft float .Fn cosf "float x" .Sh 解説 .Fn cos -関数と +および .Fn cosf -関数は、 +関数は、(ラジアンで計測された) .Fa x -( -ラジアン単位で計算 -) の余弦を計算します。 -引数があまりに大きいと、結果はわずかしか重要性がないか、または -重要性のないものになります。切り捨て名丸めエラーの詳細については、 +大きな引数は、ほとんどまたは全く意味のない結果を生じることがあります。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 .Sh 戻り値 .Fn cos -関数と +および .Fn cosf -関数は余弦値を返します。 +関数は、余弦の値を返します。 .Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh 規格 .Fn cos -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/cosh.3 b/ja_JP.eucJP/man/man3/cosh.3 index a38176288d..45d41b4ae3 100644 --- a/ja_JP.eucJP/man/man3/cosh.3 +++ b/ja_JP.eucJP/man/man3/cosh.3 @@ -1,84 +1,85 @@ .\" Copyright (c) 1989, 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)cosh.3 5.1 (Berkeley) 5/2/91 -.\" %Id: cosh.3,v 1.6 1997/03/19 01:28:44 bde Exp % +.\" %FreeBSD: src/lib/msun/man/cosh.3,v 1.7.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt COSH 3 .Os .Sh 名称 .Nm cosh , .Nm coshf .Nd 双曲余弦関数 .Sh 書式 .Fd #include .Ft double .Fn cosh "double x" .Ft float .Fn coshf "float x" .Sh 解説 .Fn cosh -関数と +および .Fn coshf 関数は、 .Fa x の双曲余弦を計算します。 .Sh 戻り値 .Fn cosh -関数と +および .Fn coshf 関数は、 .Fa x -が大きすぎない場合は、双曲余弦を返します。 -.Fa x -が大きすぎる場合は、グローバル変数 +の大きさが大きすぎる場合以外は、双曲余弦を返します。 +大きすぎる場合は、グローバル変数 .Va errno が .Er ERANGE に設定されます。 .Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh 規格 .Fn cosh -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/fabs.3 b/ja_JP.eucJP/man/man3/fabs.3 index 553eb73b1f..e1ed29b59e 100644 --- a/ja_JP.eucJP/man/man3/fabs.3 +++ b/ja_JP.eucJP/man/man3/fabs.3 @@ -1,76 +1,77 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" @(#)fabs.3 5.1 (Berkeley) 5/2/91 .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)fabs.3 5.1 (Berkeley) 5/2/91 -.\" %Id: fabs.3,v 1.5 1997/02/22 15:09:31 peter Exp % +.\" %FreeBSD: src/lib/msun/man/fabs.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ -.\" .Dd May 2, 1991 .Dt FABS 3 .Os .Sh 名称 .Nm fabs , .Nm fabsf .Nd 浮動小数絶対値関数 .Sh 書式 .Fd #include .Ft double .Fn fabs "double x" .Ft float .Fn fabsf "float x" .Sh 解説 .Fn fabs -関数と +および .Fn fabsf -関数は、浮動小数 +関数は、浮動小数点数 .Fa x -の絶対値を算出します。 +の絶対値を計算します。 .Sh 戻り値 .Fn fabs -関数と +および .Fn fabsf 関数は、 .Fa x -の絶対値を戻します。 +の絶対値を返します。 .Sh 関連項目 .Xr abs 3 , .Xr ceil 3 , .Xr floor 3 , .Xr ieee 3 , .Xr math 3 , .Xr rint 3 .Sh 規格 .Fn fabs 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/fclose.3 b/ja_JP.eucJP/man/man3/fclose.3 index bff2a9a684..bda0d7d4fb 100644 --- a/ja_JP.eucJP/man/man3/fclose.3 +++ b/ja_JP.eucJP/man/man3/fclose.3 @@ -1,89 +1,99 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)fclose.3 8.1 (Berkeley) 6/4/93 .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt FCLOSE 3 .Os .Sh 名称 .Nm fclose .Nd ストリームを閉じる +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn fclose "FILE *stream" .Sh 解説 .Fn fclose 関数は、基礎となるファイルや関数のセットから、指定された -.Fa stream +.Fa ストリーム を分離します。 -ストリームが出力に使用されていた場合は、バッファのデータが +ストリームを出力に使用している場合は、 +まず最初に、 .Xr fflush 3 -で最初に書き込まれます。 +を使用して、バッファにあるデータを書込みます。 .Sh 戻り値 -問題なく終了すると 0 が戻されます。問題がある場合は +正常終了すると 0 が返されます。 +正常終了しなかった場合は .Dv EOF -が戻され、そのエラーを示す値にグローバル変数 +が返され、 +グローバル変数 .Va errno -が設定されます。 -どちらの場合も、ストリームにはアクセスできなくなります。 +には、エラーを示す値を設定されます。 +どちらの場合でも、ストリームには +それ以上アクセスできません。 .Sh エラー .Fn fclose -関数がエラーになると、ルーチン +関数がエラーなると、 +ルーチン .Xr close 2 か .Xr fflush 3 -に指定されたエラーに +で指定されたエラーが .Va errno -が設定されることがあります。 +に設定されます。 .Sh 注 .Fn fclose は NULL 引数を処理しません。 NULL 引数はセグメンテーション違反を引き起こします。 -これは、FreeBSD で作成されたプログラムのバグをなくすためのものです。 -この動作はシステムの詳細であり、プログラムが依存すべきではありません。 +この動作は意図的なもので、 +.Fx +で作成されたプログラムのバグをなくすためです。 +この動作は実装に関わるものであり、 +プログラムが依存すべきではありません。 .Sh 関連項目 .Xr close 2 , .Xr fflush 3 , .Xr fopen 3 , .Xr setbuf 3 .Sh 規格 .Fn fclose 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/fflush.3 b/ja_JP.eucJP/man/man3/fflush.3 index 86aff2b98a..1dba9a6c63 100644 --- a/ja_JP.eucJP/man/man3/fflush.3 +++ b/ja_JP.eucJP/man/man3/fflush.3 @@ -1,108 +1,118 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)fflush.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdio/fflush.3,v 1.4.2.3 2001/03/06 16:46:01 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt FFLUSH 3 .Os .Sh 名称 .Nm fflush , .Nm fpurge .Nd ストリームのフラッシュ +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn fflush "FILE *stream" .Ft int .Fn fpurge "FILE *stream" .Sh 解説 .Fn fflush -関数は、指定された出力のバッファにあるすべてのデータの書込み、 -またはストリームの基礎となる書込み関数による +関数は、すべてのバッファされたデータを対応する +出力に強制的に書込みます。 +またはストリームの場合は、下層の書込み関数を用いて .Fa stream -の更新を強制的に実行します。ストリームのオープンステータスは変化しません。 +の更新を強制的に実行します。 +.\" underlying 下層 +ストリームは開いた状態のままで、この関数によって影響は受けません。 +.\" status ステータス? .Pp .Fa stream 引数が .Dv NULL -である場合、 +の場合、 .Fn fflush は開いている .Em すべての 出力ストリームをフラッシュします。 .Pp .Fn fpurge 関数は、指定された .Fa stream -でバッファに入っている入力か出力を消去します。 -出力ストリームの場合は、書き込まれていない出力が破棄されます。 -入力ストリームの場合は、基礎となるオブジェクトから読み込まれたが、 +のバッファに入っているどんな入出力も消去します。 +出力ストリームの場合は、書込まれていない出力を破棄します。 +入力ストリームの場合は、下層オブジェクトから読込んであり、 .Xr getc 3 -で入手されていない入力が破棄されます。これには、 +で取り出されていない入力を破棄します。 +これには、 .Xr ungetc でプッシュバックされたテキストも含まれます。 .Sh 戻り値 -問題なく終了すると 0 が戻されます。問題がある場合は +処理が正常に完了すると、値 0 が返されます。 +そうでない場合は .Dv EOF -が戻され、そのエラーを示す値にグローバル変数 +が戻され、エラーを示すためにグローバル変数 .Va errno が設定されます。 .Sh エラー -.Bl -tag -width [EBADF] +.Bl -tag -width Er .It Bq Er EBADF .Fa stream が開いているストリームではありません。 .Fn fflush -の場合は、ストリームが書込み用に開いていません。 +の場合、ストリームが書込み用に開いていません。 +.El .Pp .Fn fflush 関数がエラーになると、ルーチン .Xr write 2 -で指定されたエラーに +で指定されたエラーが .Va errno -が設定されることがあります。 +に設定されます。 .Sh 関連項目 .Xr write 2 , .Xr fclose 3 , .Xr fopen 3 , .Xr setbuf 3 .Sh 規格 .Fn fflush 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/floor.3 b/ja_JP.eucJP/man/man3/floor.3 index 282ad18274..051ab5a67c 100644 --- a/ja_JP.eucJP/man/man3/floor.3 +++ b/ja_JP.eucJP/man/man3/floor.3 @@ -1,68 +1,69 @@ -.\" copyright (c) 1985, 1991 The Regents of the University of California. +.\" Copyright (c) 1985, 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)floor.3 6.5 (Berkeley) 4/19/91 -.\" %Id: floor.3,v 1.6 1997/02/22 15:09:32 peter Exp % +.\" %FreeBSD: src/lib/msun/man/floor.3,v 1.7.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ -.\" .Dd March 10, 1994 .Dt FLOOR 3 .Os .Sh 名称 .Nm floor , .Nm floorf -.Nd x 以下の最大整数値に丸める +.Nd x 以下の最も大きな整数値への切捨て .Sh 書式 .Fd #include .Ft double .Fn floor "double x" .Ft float .Fn floorf "float x" .Sh 解説 .Fn floor -関数と +および .Fn floorf -関数は、 -.Fa x -以下の最大整数値 (倍精度数値) を戻します。 +関数は、(倍精度数として表現される) +.Fa x +以下の最も大きな整数値を返します。 .Sh 関連項目 .Xr abs 3 , .Xr ceil 3 , .Xr fabs 3 , .Xr ieee 3 , .Xr math 3 , .Xr rint 3 .Sh 規格 .Fn floor 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/ieee.3 b/ja_JP.eucJP/man/man3/ieee.3 index d04aa48021..3cc9852bca 100644 --- a/ja_JP.eucJP/man/man3/ieee.3 +++ b/ja_JP.eucJP/man/man3/ieee.3 @@ -1,192 +1,189 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" %Id: ieee.3,v 1.4 1997/02/22 15:09:35 peter Exp % +.\" %FreeBSD: src/lib/msun/man/ieee.3,v 1.5.2.2 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ -.Dd Feb 25, 1994 +.Dd February 25, 1994 .Dt IEEE 3 .Os .Sh 名称 .Nm copysign , .Nm copysignf , .Nm finite , .Nm finitef , .Nm ilogb , .Nm ilogbf , .Nm nextafter , .Nm nextafterf , .Nm remainder , .Nm remainderf , .Nm scalbn , .Nm scalbnf -.Nd IEEE論理演算 +.Nd IEEE 演算関数 .Sh 書式 .Fd #include .Ft double .Fn copysign "double x" "double y" .Ft float .Fn copysignf "float x" "float y" .Ft int .Fn finite "double x" .Ft int .Fn finitef "float x" .Ft int .Fn ilogb "double x" .Ft int .Fn ilogbf "float x" .Ft double .Fn nextafter "double x" "double y" .Ft float .Fn nextafterf "float x" "float y" .Ft double .Fn remainder "double x" "double y" .Ft float .Fn remainderf "float x" "float y" .Ft double .Fn scalbn "double x" "int n" .Ft float .Fn scalbnf "float x" "int n" .Sh 解説 -これらの関数は +これらの関数は、 .St -ieee754 -により要求または推奨されています。 +によって要求または推奨されています。 .Pp .Fn copysign -と +および .Fn copysignf -は +は、 .Fa x の符号を .Fa y の符号に置き換えて .Fa x を返します。 .Pp \-\*(If \*(Lt .Fa x \*(Lt +\*(If -のとき、 +の時には、 .Fn finite -と +および .Fn finitef -は値 1 を返します。 -その他 -( +は、値 1 を返します。そうでない時 ( .Pf \\*(Ba Ns Fa x Ns \\*(Ba -= \*(If -または += \*(If または .Fa x -が \*(Na の時 ) -はゼロを返します。 +が \*(Na の時) には、0 が返されます。 .Pp .Fn ilogb -と +および .Fn ilogbf -は +は、 .Fa x の .Fa n -乗を整数値で返します。 -.Fn ilogb \*(Pm\*(If +乗を整数型で返します。 +.Fn ilogb \*(Pm\*(If は .Dv INT_MAX -を戻し、 +を返し、 .Fn ilogb 0 は .Dv INT_MIN を返します。 .Pp -.Fn nextafter -と +.Fn nextafter +および .Fn nextafterf -は次のマシン表示可能な数を +は、次のマシン表示可能な数を .Fa x から .Fa y 方向に返します。 .Pp .Fn remainder -と +および .Fn remainderf -は剰余 -.Fa r -:= +は、剰余 +.Fa r +:= .Fa x -\- +\- .Fa n\(**y -を返します。このとき +を返します。このとき .Fa n は .Bk -words .Fa x Ns / Ns Fa y .Ek -の完全な値に最も近似の整数です。さらに、 +の正確な値に最も近い整数です。更に、 .Pf \\*(Ba Fa n \- .Sm off .Fa x No / Fa y No \\*(Ba .Sm on = 1/2 ならば、 .Fa n -は偶数です。 -この結果、剰余は完全に計算されて、 +は偶数です。その結果、剰余は正確に計算され、 .Sm off .Pf \\*(Ba Fa r No \\*(Ba .Sm on \*(Le .Sm off .Pf \\*(Ba Fa y No \\*(Ba/2 .Sm on -になります。しかし、 +となります。しかし、 .Fn remainder x 0 -と +および .Fn remainder \*(If 0 -は \*(Na を作る無効の演算です。 +は、\*(Na を生成する無効な演算です。 .Pp .Fn scalbn -と +および .Fn scalbnf -は指数操作で計算される +は、指数操作によって計算された .Fa x Ns \(**(2** Ns Fa n ) を返します。 .Sh 関連項目 .Xr math 3 .Sh 歴史 .Nm ieee -関数は +関数は、 .Bx 4.3 -から登場しました。 +で登場しました。 .Sh 規格 .St -ieee754 + + diff --git a/ja_JP.eucJP/man/man3/ieee_test.3 b/ja_JP.eucJP/man/man3/ieee_test.3 index 5a3c778fad..4b558c8e16 100644 --- a/ja_JP.eucJP/man/man3/ieee_test.3 +++ b/ja_JP.eucJP/man/man3/ieee_test.3 @@ -1,118 +1,114 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" %Id: ieee_test.3,v 1.4 1997/02/22 15:09:36 peter Exp % +.\" %FreeBSD: src/lib/msun/man/ieee_test.3,v 1.5.2.1 2000/12/29 14:45:07 ru Exp % .\" .\" $FreeBSD$ .Dd March 10, 1994 .Dt IEEE_TEST 3 .Os .Sh 名称 .Nm logb , .Nm logbf , .Nm scalb , .Nm scalbf , .Nm significand , .Nm significandf -.Nd IEEEテスト関数 +.Nd IEEE テスト関数 .Sh 書式 .Fd #include .Ft double .Fn logb "double x" .Ft float .Fn logbf "float x" .Ft double .Fn scalb "double x" "double n" .Ft float .Fn scalbf "float x" "float n" .Ft double .Fn significand "double x" .Ft float .Fn significandf "float x" .Sh 解説 -これらの関数でユーザは +これらの関数は、ユーザが .St -ieee754 -への適合性のテストができます。 -それ以外の目的での使用は推奨されません。 +への適合をテストすることを可能にします。 +それ以外の目的でのこれらの使用は推奨されません。 .Pp .Fn logb x -と +および .Fn logbf x は、 .Fa x の .Fa n -乗で符号付き整数を倍精度浮動小数点に変換して返します。 +乗を返します。ここでの +.Fa n +は、符号付き整数が倍精度浮動小数に変換されたものです。 .Fn logb \*(Pm\*(If = +\*(If; -.Fn logb 0 +.Fn logb 0 = -\*(If -ゼロ除算による例外が発生します。 +で、0 による除算の例外を伴います。 .Pp .Fn scalbn x n -と +および .Fn scalbnf x n -は -指数操作により計算される +は、指数操作により計算された .Fa x Ns \(**(2** Ns Fa n ) を返します。 .Pp -.Fn significand x -と -.Fn significandf x -は -1 \(<= +.Fn significand x +および +.Fn significandf x +は、1 \(<= .Fa sig -< 2 の範囲のとき -.Fa sig -を返します。このとき、 +< 2 の範囲で .Fa x := .Fa sig No \(** 2** Ns Fa n -です。 +となる時の、 +.Fa sig +を返します。 .Fn significand x -と +および .Fn significandf x -は +は、 .Fa x -が -0, \*(Pm\*(If -または -\*(Na -のとき定義されません。 -.Pp +が 0, \*(Pm\*(If, または \*(Na の時には定義されません。 .Sh 関連項目 .Xr ieee 3 , .Xr math 3 - .Sh 規格 .St -ieee754 + + diff --git a/ja_JP.eucJP/man/man3/popen.3 b/ja_JP.eucJP/man/man3/popen.3 index 2b9e08194a..93b4537b6d 100644 --- a/ja_JP.eucJP/man/man3/popen.3 +++ b/ja_JP.eucJP/man/man3/popen.3 @@ -1,188 +1,203 @@ .\" Copyright (c) 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. .\" .\" @(#)popen.3 8.2 (Berkeley) 5/3/95 .\" .\" $FreeBSD$ .\" .Dd May 3, 1995 .Dt POPEN 3 .Os .Sh 名称 .Nm popen , .Nm pclose -.Nd I/O 処理 +.Nd +.Tn 入出力処理 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft FILE * .Fn popen "const char *command" "const char *type" .Ft int .Fn pclose "FILE *stream" .Sh 解説 .Fn popen 関数は、双方向パイプフォークを作成し、シェルを起動してプロセスを .Dq 開き -ます。親プロセスで以前に +ます。 +親プロセスで事前に .Fn popen を呼び出して開いたストリームは、 -新しい子プロセスで閉じられます。以前の +新しい子プロセスによってクローズされます。 +以前の .Fn popen -は一方向パイプで実現されていたため、 +は単方向のパイプで実装されていたため、 .Fn popen -の多くのシステでは、 +の多くの実装は、 +読み書きの両方ではなく、 .Fa type -引数で読み取りか書込みを指定していました。 -両方は指定できませんでした。現在の +引数が読込もしくは書込のどちらかを指定すること +だけ許可していました。 +現在の .Fn popen -は双方向パイプで実現されているので、 +は双方向パイプで実装しているので、 .Fa type 引数で双方向データフローを要求できます。 .Fa type -引数はナル文字で終わる文字列のポインタで、読み取りの場合は +引数はヌル文字で終わる文字列のポインタで、 +読取りの場合は .Ql r 、書込みの場合は .Ql w -、読み取りと書込みの場合は +、読み書きの場合は .Ql r+ である必要があります。 .Pp .Fa command 引数は、シェルコマンドラインを含む、 -ナル文字で終わる文字列のポインタです。このコマンドは、 +ヌル文字で終了する文字列のポインタです。 +このコマンドは、 .Fl c フラグで .Pa /bin/sh -に渡されます。解釈がある場合はシェルで実行されます。 +に渡されます。解釈がある場合、シェルで実行されます。 .Pp .Fn popen -からの戻り値は標準 -.Tn I/O -ストリームで、保存するためには +の戻り値は通常の標準 +.Tn 入出力 +とあらゆる点で同等のものです。 +ただし、閉じるときは、 .Fn fclose ではなく .Fn pclose -で閉じる必要があります。 -このようなストリームに書き込むと、 -コマンドの標準入力に書き込まれます。 +を使わなければなりません。 +このようなストリームに書込むと、 +コマンドの標準入力に書込まれます。 コマンドの標準出力は、 -コマンドで変更しないかぎり、 +そのコマンド自体で変更しないかぎり、 .Fn popen -を呼び出したプロセスのものと同じです。 +で呼び出したプロセスのものと同じです。 +反対に、 .Fn popen -で開いたストリームから読み込むと、 -コマンドの標準出力から読み込まれます。 -コマンドの標準入力は、 +で +.Dq 開かれた +ストリームからの読込みは、 +コマンドの標準出力から読込まれます。 +コマンドの標準入力は .Fn popen -を呼び出したプロセスのものと -同じです。 +を呼び出したプロセスのものと同じです。 .Pp 出力 .Fn popen -ストリームは、デフォルトで完全にバッファに入ります。 +ストリームは、デフォルトで完全にバッファ +されることに注意してください。 .Pp .Fn pclose -関数は、関連プロセスの終了を待機し、 +関数は、結び付けられたプロセスの終了を待機し、 .Fn wait4 -が戻す、コマンドの終了ステータスを戻します。 +が戻すコマンドの終了ステータスを返します。 .Sh 戻り値 .Fn popen 関数は、 .Xr fork 2 か .Xr pipe 2 -でエラーが発生した場合、またはメモリを割り振れない場合は +でエラーが発生した場合、またはメモリを割り当てられない場合は .Dv ヌル を戻します。 .Pp .Fn pclose 関数は、 +.Fa ストリーム +が .Fn popen で .Dq 開いた -コマンドに -.Fa stream -が関連していない場合、または -.Fa stream -が +コマンドと +結び付いていなかった場合、または +.Fa ストリーム +がすでに .Fn pclose -ですでに +で .Dq 閉じている 場合、あるいは -.Xr wait4 2 +.Xr wait4 でエラーが発生した場合は \-1 を戻します。 -.Sh 誤り +.Sh エラー .Fn popen -関数は +関数は、信頼性のある .Va errno を設定しません。 .Sh 関連項目 .Xr sh 1 , .Xr fork 2 , .Xr pipe 2 , .Xr wait4 2 , .Xr fclose 3 , .Xr fflush 3 , .Xr fopen 3 , .Xr stdio 3 , .Xr system 3 .Sh バグ -読み取り用に開いたコマンドの標準入力は、 +読取り用に開いたコマンドの標準入力は、 .Fn popen を呼び出したプロセスとシークオフセットを共有するので、 -オリジナルプロセスがバッファ読み取りを実行すると、 +オリジナルプロセスがバッファ読取りを実行すると、 コマンドの入力位置が予想どおりにならないことがあります。 -書込み用に開いたコマンドの出力は、 +同様に、書込み用に開いたコマンドの出力は、 オリジナルプロセスのものと混ざることがあります。後者は、 .Fn popen の前に .Xr fflush 3 を呼び出すことで回避できます。 .Pp -シェルを実行する場合のエラーは、 -コマンドを実行する場合のシェルのエラー、 -またはコマンドの途中終了と区別できません。 +シェルを実行しないことには、それが実行できないコマンドのシェル +なのか、すぐに終了してしまうコマンドか、区別できません。 終了ステータスの 127 のみがヒントになります。 .Pp .Fn popen の引数は常に .Xr sh 1 を呼び出し、 .Xr csh 1 は呼び出しません。 .Sh 歴史 .Fn popen 関数と .Fn pclose 関数は、 .At v7 -に追加されました。双方向機能は、 -.Tn FreeBSD -2.2.6 で追加されました。 +で登場しました。 +.Pp +双方向機能は、 +.Fx 2.2.6 +で追加されました。 diff --git a/ja_JP.eucJP/man/man3/pthread.3 b/ja_JP.eucJP/man/man3/pthread.3 index 62a827d1e4..4546827f99 100644 --- a/ja_JP.eucJP/man/man3/pthread.3 +++ b/ja_JP.eucJP/man/man3/pthread.3 @@ -1,256 +1,453 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL 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. .\" -.\" %Id: pthread.3,v 1.7 1998/09/12 13:53:58 alex Exp % +.\" %FreeBSD: src/share/man/man3/pthread.3,v 1.12.2.2 2001/03/06 19:08:09 ru Exp % .\" .\" $FreeBSD$ -.\" .Dd September 10, 1998 .Dt PTHREAD 3 .Os BSD 4 .Sh 名称 .Nm pthread .Nd POSIX スレッド関数 +.Sh 書式 +.Fd #include .Sh 解説 -POSIX スレッドは、プロセスで制御の複数のフロー -(スレッド) を要求するアプリケーションをサポートする関数です。 -マルチスレッドは、 -プログラムのパフォーマンスを改善するために使用されます。 +POSIX スレッドは、プロセス内でスレッド (thread) と呼ばれる +制御の複数のフローを要求するアプリケーションをサポートする関数群です。 +マルチスレッドは、プログラムのパフォーマンスを改善するために使用されます。 +.Pp このセクションでは、 POSIX スレッド関数の概要について以下のグループに分けて説明します。 .Bl -bullet -offset indent .It スレッドルーチン .It 属性オブジェクトルーチン .It -Mutex ルーチン +mutex ルーチン .It 条件変数ルーチン .It -読み書きロックルーチン +読取り/書込みロックルーチン .It スレッド固有コンテキストルーチン .It クリーンアップルーチン .El .Sh スレッドルーチン .Bl -tag -width Er -.It int Fn pthread_create "pthread_t *thread" "const pthread_attr_t *attr" "void *(*start_routine)(void *)" "void *arg" -実行の新しいスレッドを作成します。 -.It int Fn pthread_detach "pthread_t thread" -スレッドに削除マークを付けます。 -.It int Fn pthread_equal "pthread_t t1" "pthread_t t2" -2 つのスレッド ID を比較します。 -.It void Fn pthread_exit "void *value_ptr" -呼び出しスレッドを終了します。 -.It int Fn pthread_join "pthread_t thread" "void **value_ptr" -呼び出しスレッドが、指定したスレッドの終了を待つようになりす。 -.It int Fn pthread_once "pthread_once_t *once_control" "void (*init_routine)(void)" -初期化ルーチンを 1 回呼び出します。 -.It pthread_t Fn pthread_self void -呼び出しスレッドのスレッド ID を戻します。 +.It Xo +.Ft int +.Fn pthread_create "pthread_t *thread" "const pthread_attr_t *attr" "void *(*start_routine)(void *)" "void *arg" +.Xc +新しい実行するスレッドを作成します。 +.It Xo +.Ft int +.Fn pthread_detach "pthread_t thread" +.Xc +スレッドに削除のための印を付けます。 +.It Xo +.Ft int +.Fn pthread_equal "pthread_t t1" "pthread_t t2" +.Xc +2 つのスレッドの ID を比較します。 +.It Xo +.Ft void +.Fn pthread_exit "void *value_ptr" +.Xc +呼び出しているスレッドを終了します。 +.It Xo +.Ft int +.Fn pthread_join "pthread_t thread" "void **value_ptr" +.Xc +呼び出しているスレッドが、指定したスレッドの終了を待つようにします。 +.It Xo +.Ft int +.Fn pthread_cancel "pthread_t thread" +.Xc +スレッドの実行を取り消します。 +.It Xo +.Ft int +.Fn pthread_once "pthread_once_t *once_control" "void (*init_routine)(void)" +.Xc +初期化ルーチンを一度だけ呼び出します。 +.It Xo +.Ft pthread_t +.Fn pthread_self void +.Xc +呼び出しているスレッドの ID を返します。 .El .Sh 属性オブジェクトルーチン .Bl -tag -width Er -.It int Fn pthread_attr_destroy "pthread_attr_t *attr" +.It Xo +.Ft int +.Fn pthread_attr_destroy "pthread_attr_t *attr" +.Xc スレッドの属性オブジェクトを破壊します。 -.It int Fn pthread_attr_getinheritsched "pthread_attr_t *attr" "int *inheritsched" -スレッドの属性オブジェクトから継承スケジューリング属性を入手します。 -.It int Fn pthread_attr_getschedparam "pthread_attr_t *attr" "struct sched_param *param" -スレッドの属性オブジェクトからスケジューリングパラメータ属性を入手します。 -.It int Fn pthread_attr_getschedpolicy "pthread_attr_t *attr" "int *policy" -スレッドの属性オブジェクトからスケジューリング方針属性を入手します。 -.It int Fn pthread_attr_getscope "pthread_attr_t *attr" "int *contentionscope" -スレッドの属性オブジェクトからコンテンション範囲属性を入手します。 -.It int Fn pthread_attr_getstacksize "pthread_attr_t *attr" "size_t *stacksize" -スレッドの属性オブジェクトからスタックサイズ属性を入手します。 -.It int Fn pthread_attr_getstackaddr "pthread_attr_t *attr" "void **stackaddr" -スレッドの属性オブジェクトからスタックアドレス属性を入手します。 -.It int Fn pthread_attr_getdetachstate "pthread_attr_t *attr" "int *detachstate" -スレッドの属性オブジェクトから切り離し状態属性を入手します。 -.It int Fn pthread_attr_init "pthread_attr_t *attr" -スレッドの属性オブジェクトをデフォルト値で初期化します。 -.It int Fn pthread_attr_setinheritsched "pthread_attr_t *attr" "int inheritsched" -スレッドの属性オブジェクトで継承スケジューリング属性を設定します。 -.It int Fn pthread_attr_setschedparam "pthread_attr_t *attr" "struct sched_param *param" -スレッドの属性オブジェクトでスケジューリングパラメータ属性を設定します。 -.It int Fn pthread_attr_setschedpolicy "pthread_attr_t *attr" "int policy" -スレッドの属性オブジェクトでスケジューリング方針属性を設定します。 -.It int Fn pthread_attr_setscope "pthread_attr_t *attr" "int contentionscope" -スレッドの属性オブジェクトでコンテンション範囲属性を設定します。 -.It int Fn pthread_attr_setstacksize "pthread_attr_t *attr" "size_t stacksize" -スレッドの属性オブジェクトでスタックサイズ属性を設定します。 -.It int Fn pthread_attr_setstackaddr "pthread_attr_t *attr" "void *stackaddr" -スレッドの属性オブジェクトでスタックアドレス属性を設定します。 -.It int Fn pthread_attr_setdetachstate "pthread_attr_t *attr" "int detachstate" -スレッドの属性オブジェクトで切り離し状態を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_getinheritsched "const pthread_attr_t *attr" "int *inheritsched" +.Xc +スレッドの属性オブジェクトから継承スケジューリング属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getschedparam "const pthread_attr_t *attr" "struct sched_param *param" +.Xc +スレッドの属性オブジェクトからスケジューリングパラメータ属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getschedpolicy "const pthread_attr_t *attr" "int *policy" +.Xc +スレッドの属性オブジェクトからスケジューリング方針属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getscope "const pthread_attr_t *attr" "int *contentionscope" +.Xc +スレッドの属性オブジェクトからコンテンション範囲属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getstacksize "const pthread_attr_t *attr" "size_t *stacksize" +.Xc +スレッドの属性オブジェクトからスタックサイズ属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getstackaddr "const pthread_attr_t *attr" "void **stackaddr" +.Xc +スレッドの属性オブジェクトからスタックアドレス属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_getdetachstate "const pthread_attr_t *attr" "int *detachstate" +.Xc +スレッドの属性オブジェクトからデタッチ状態属性を取得します。 +.It Xo +.Ft int +.Fn pthread_attr_init "pthread_attr_t *attr" +.Xc +スレッド属性オブジェクトをデフォルト値で初期化します。 +.It Xo +.Ft int +.Fn pthread_attr_setinheritsched "pthread_attr_t *attr" "int inheritsched" +.Xc +スレッドの属性オブジェクトに継承スケジューリング属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setschedparam "pthread_attr_t *attr" "const struct sched_param *param" +.Xc +スレッドの属性オブジェクトにスケジューリングパラメータ属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setschedpolicy "pthread_attr_t *attr" "int policy" +.Xc +スレッドの属性オブジェクトにスケジューリング方針属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setscope "pthread_attr_t *attr" "int contentionscope" +.Xc +スレッドの属性オブジェクトにコンテンション範囲属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setstacksize "pthread_attr_t *attr" "size_t stacksize" +.Xc +スレッドの属性オブジェクトにスタックサイズ属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setstackaddr "pthread_attr_t *attr" "void *stackaddr" +.Xc +スレッドの属性オブジェクトにスタックアドレス属性を設定します。 +.It Xo +.Ft int +.Fn pthread_attr_setdetachstate "pthread_attr_t *attr" "int detachstate" +.Xc +スレッドの属性オブジェクトにデタッチ状態属性を設定します。 .El -.Sh MUTEX ルーチン +.Sh mutex ルーチン .Bl -tag -width Er -.It int Fn pthread_mutexattr_destroy "pthread_mutexattr_t *attr" -MUTEX 属性オブジェクトを破壊します。 -.It int Fn pthread_mutexattr_init "pthread_mutexattr_t *attr" -MUTEX 属性オブジェクトをデフォルト値で初期化します。 -.It int Fn pthread_mutex_destroy "pthread_mutex_t *mutex" -MUTEX を破壊します。 -.It int Fn pthread_mutex_init "pthread_mutex_t *mutex" "const pthread_mutexattr_t *attr" -指定された属性で MUTEX を初期化します。 -.It int Fn pthread_mutex_lock "pthread_mutex_t *mutex" -MUTEX をロックし、MUTEX が使用できるようになるまでブロックします。 -.It int Fn pthread_mutex_trylock "pthread_mutex_t *mutex" -MUTEX をロックしようとしますが、 -現行スレッドも含めた別のスレッドで -MUTEX がロックされている場合はブロックしません。 -.It int Fn pthread_mutex_unlock "pthread_mutex_t *mutex" -MUTEX のロックを解除します。 +.It Xo +.Ft int +.Fn pthread_mutexattr_destroy "pthread_mutexattr_t *attr" +.Xc +mutex の属性オブジェクトを破壊します。 +.It Xo +.Ft int +.Fn pthread_mutexattr_init "pthread_mutexattr_t *attr" +.Xc +mutex の属性オブジェクトをデフォルト値で初期化します。 +.It Xo +.Ft int +.Fn pthread_mutex_destroy "pthread_mutex_t *mutex" +.Xc +mutex を破壊します。 +.It Xo +.Ft int +.Fn pthread_mutex_init "pthread_mutex_t *mutex" "const pthread_mutexattr_t *attr" +.Xc +mutex を指定された属性で初期化します。 +.It Xo +.Ft int +.Fn pthread_mutex_lock "pthread_mutex_t *mutex" +.Xc +mutex をロックして、mutex が利用可能になるまでブロックします。 +.It Xo +.Ft int +.Fn pthread_mutex_trylock "pthread_mutex_t *mutex" +.Xc +mutex をロックしようとしますが、mutex が現在のスレッドを含めた +別のスレッドによってロックされている場合には、ブロックしません。 +.It Xo +.Ft int +.Fn pthread_mutex_unlock "pthread_mutex_t *mutex" +.Xc +mutex のロックを解除します。 .El .Sh 条件変数ルーチン .Bl -tag -width Er -.It int Fn pthread_condattr_init "pthread_condattr_t *attr" -条件変数属性オブジェクトをデフォルト値で初期化します。 -.It int Fn pthread_condattr_destroy "pthread_condattr_t *attr" -条件変数属性オブジェクトを破壊します。 -.It int Fn pthread_cond_broadcast "pthread_cond_t *cond" -指定された条件変数で現在ブロックされている、 -すべてのスレッドのブロックを解除します。 -.It int Fn pthread_cond_destroy "pthread_cond_t *cond" +.It Xo +.Ft int +.Fn pthread_condattr_init "pthread_condattr_t *attr" +.Xc +条件変数の属性オブジェクトをデフォルト値で初期化します。 +.It Xo +.Ft int +.Fn pthread_condattr_destroy "pthread_condattr_t *attr" +.Xc +条件変数の属性オブジェクトを破壊します。 +.It Xo +.Ft int +.Fn pthread_cond_broadcast "pthread_cond_t *cond" +.Xc +指定された条件変数で現在ブロックされている +全てのスレッドのブロックを解除します。 +.It Xo +.Ft int +.Fn pthread_cond_destroy "pthread_cond_t *cond" +.Xc 条件変数を破壊します。 -.It int Fn pthread_cond_init "pthread_cond_t *cond" "const pthread_condattr_t *attr" -指定された属性で条件変数を初期化します。 -.It int Fn pthread_cond_signal "pthread_cond_t *cond" -指定された条件変数でブロックされているスレッドの、 -最低 1 つのブロックを解除します。 -.It int Fn pthread_cond_timedwait "pthread_cond_t *cond" "pthread_mutex_t *mutex" "const struct timespec *abstime" -指定された時間以内で条件を待機し、 -指定された MUTEX をロックします。 -.It int Fn pthread_cond_wait "pthread_cond_t *" "pthread_mutex_t *mutex" -条件を待機し、指定された MUTEX をロックします。 +.It Xo +.Ft int +.Fn pthread_cond_init "pthread_cond_t *cond" "const pthread_condattr_t *attr" +.Xc +条件変数を指定された属性で初期化します。 +.It Xo +.Ft int +.Fn pthread_cond_signal "pthread_cond_t *cond" +.Xc +指定された条件変数で現在ブロックされている +少なくとも 1 つのスレッドのブロックを解除します。 +.It Xo +.Ft int +.Fn pthread_cond_timedwait "pthread_cond_t *cond" "pthread_mutex_t *mutex" "const struct timespec *abstime" +.Xc +条件を指定された時間内で待機し、指定された mutex をロックします。 +.It Xo +.Ft int +.Fn pthread_cond_wait "pthread_cond_t *" "pthread_mutex_t *mutex" +.Xc +条件を待機し、指定された mutex をロックします。 .El -.Sh 読み書きロックルーチン +.Sh 読取り/書込みロックルーチン .Bl -tag -width Er -.It int Fn pthread_rwlock_destroy "pthread_rwlock_t *lock" -読み書きロックオブジェクトを破壊します。 -.It int Fn pthread_rwlock_init "pthread_rwlock_t *lock" "const pthread_rwlockat-tr_t *attr" -読み書きロックオブジェクトを初期化します。 -.It int Fn pthread_rwlock_rdlock "pthread_rwlock_t *lock" -読み書きロックを読込み用にロックし、 -ロックを取得できるまでブロックします。 -.It int Fn pthread_rwlock_tryrdlock "pthread_rwlock_t *lock" -読み書きロックを読込み用にロックしようとしますが、 -ロックを使用できない場合はブロックしません。 -.It int Fn pthread_rwlock_trywrlock "pthread_rwlock_t *lock" -読み書きロックを書込み用にロックしようとしますが、 -ロックを使用できない場合はブロックしません。 -.It int Fn pthread_rwlock_unlock "pthread_rwlock_t *lock" -読み書きロックを解除します。 -.It int Fn pthread_rwlock_wrlock "pthread_rwlock_t *lock" -読み書きロックを書込み用にロックし、 -ロックを取得できるまでブロックします。 -.It int Fn pthread_rwlockattr_destroy "pthread_rwlockattr_t *attr" -読み書きロック属性オブジェクトを破壊します。 -.It int Fn pthread_rwlockattr_getpshared "pthread_rwlockattr_t *attr" "int *pshared" -プロセスで共有している、 -読み書きロック属性オブジェクトの設定を取り出します。 -.It int Fn pthread_rwlockattr_init "pthread_rwlockattr_t *attr" -読み書きロック属性オブジェクトを初期化します。 -.It int Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int *pshared" -プロセスで共有している、 -読み書きロック属性オブジェクトの設定を設定します。 +.It Xo +.Ft int +.Fn pthread_rwlock_destroy "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックオブジェクトを破壊します。 +.It Xo +.Ft int +.Fn pthread_rwlock_init "pthread_rwlock_t *lock" "const pthread_rwlockattr_t *attr" +.Xc +読取り/書込みロックオブジェクトを初期化します。 +.It Xo +.Ft int +.Fn pthread_rwlock_rdlock "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックを読取り用にロックし、 +ロックを取得できるようになるまでブロックします。 +.It Xo +.Ft int +.Fn pthread_rwlock_tryrdlock "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックを読取り用にロックしようとしますが、 +ロックできない場合にはブロックしません。 +.It Xo +.Ft int +.Fn pthread_rwlock_trywrlock "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックを書込み用にロックしようとしますが、 +ロックできない場合にはブロックしません。 +.It Xo +.Ft int +.Fn pthread_rwlock_unlock "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックのロックを解除します。 +.It Xo +.Ft int +.Fn pthread_rwlock_wrlock "pthread_rwlock_t *lock" +.Xc +読取り/書込みロックを書込み用にロックし、 +ロックを取得できるようになるまでブロックします。 +.It Xo +.Ft int +.Fn pthread_rwlockattr_destroy "pthread_rwlockattr_t *attr" +.Xc +読取り/書込みロックの属性オブジェクトを破壊します。 +.It Xo +.Ft int +.Fn pthread_rwlockattr_getpshared "const pthread_rwlockattr_t *attr" "int *pshared" +.Xc +読取り/書込みロックの属性オブジェクトのプロセス共有設定を取得します。 +.It Xo +.Ft int +.Fn pthread_rwlockattr_init "pthread_rwlockattr_t *attr" +.Xc +読取り/書込みロックの属性オブジェクトを初期化します。 +.It Xo +.Ft int +.Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int pshared" +.Xc +読取り/書込みロックの属性オブジェクトのプロセス共有設定を設定します。 .El .Sh スレッド固有コンテキストルーチン .Bl -tag -width Er -.It int Fn pthread_key_create "pthread_key_t *key" "void (*routine)(void *)" -スレッドに固有なデータキーを作成します。 -.It int Fn pthread_key_delete "pthread_key_t key" -スレッドに固有なデータキーを削除します。 -.It void * Fn pthread_getspecific "pthread_key_t key" "void **value_ptr" -指定されたキーのスレッドに固有な値を入手します。 -.It int Fn pthread_setspecific "pthread_key_t key" "const void *value_ptr" -指定されたキーのスレッドに固有な値を設定します。 +.It Xo +.Ft int +.Fn pthread_key_create "pthread_key_t *key" "void (*routine)(void *)" +.Xc +スレッド固有のデータキーを作成します。 +.It Xo +.Ft int +.Fn pthread_key_delete "pthread_key_t key" +.Xc +スレッド固有のデータキーを削除します。 +.It Xo +.Ft "void *" +.Fn pthread_getspecific "pthread_key_t key" +.Xc +指定されたキーのスレッド固有の値を取得します。 +.It Xo +.Ft int +.Fn pthread_setspecific "pthread_key_t key" "const void *value_ptr" +.Xc +指定されたキーのスレッド固有の値を設定します。 .El .Sh クリーンアップルーチン .Bl -tag -width Er -.It void Fn pthread_cleanup_pop "int execute" -呼び出しスレッドのキャンセルクリーンアップスタックの -最上位でルーチンを削除し、オプションで起動します。 -.It void Fn pthread_cleanup_push "void (*routine)(void *)" "void *routine_arg" -指定されたキャンセルクリーンアップハンドラを呼び出し -スレッドのキャンセルスタックにプッシュします。 +.It Xo +.Ft void +.Fn pthread_cleanup_pop "int execute" +.Xc +呼び出しているスレッドの取り消しクリーンアップスタックの最初のルーチンを +削除し、オプションでそのルーチンを実行します。 +.It Xo +.Ft void +.Fn pthread_cleanup_push "void (*routine)(void *)" "void *routine_arg" +.Xc +呼び出しているスレッドの取り消しスタックに指定された取り消しクリーンアップ +ハンドラを積みます。 .El .Sh インストレーション -現在の FreeBSD POSIX スレッドシステムは、 -スレッドセーフな libc 関数とスレッド関数を含むライブラリ +現在の +.Fx +POSIX スレッドの実装は、スレッドセーフな libc 関数とスレッド関数を含む +ライブラリ .Fa libc_r -で構築されています。このライブラリは、スレッドアプリケーションの +で構築されています。このライブラリはスレッドアプリケーションの .Fa libc を置き換えます。 .Pp デフォルトでは、 .Fa libc_r -は 'make world' の一部として構築されます。 -.Fa libc_r -の構築を無効にするには、'-DNOLIBC_R' オプションを +は 'make world' の一部として構築されます。この構築を無効にするには、 .Xr make 1 -に指定する必要があります。 +に '-DNOLIBC_R' オプションを与えなければなりません。 .Pp -gcc には FreeBSD に固有なオプションが追加されており、 -スレッドプロセスのリンクが簡単になっています。 +スレッド化されたプロセスを簡単にリンクするために、gcc に +.Fx +固有のオプションが追加されています。 .Fa gcc -pthread -を実行すると、 +はスレッド化されたプロセスに .Fa libc -ではなく +に代って .Fa libc_r -にスレッドプロセスがリンクされます。 +をリンクします。 +.Sh 関連項目 +.Xr pthread_create 3 , +.Xr pthread_detach 3 , +.Xr pthread_equal 3 , +.Xr pthread_exit 3 , +.Xr pthread_join 3 , +.Xr pthread_once 3 , +.Xr pthread_self 3 , +.Xr pthread_mutex_destroy 3 , +.Xr pthread_mutex_init 3 , +.Xr pthread_mutex_lock 3 , +.Xr pthread_mutex_trylock 3 , +.Xr pthread_mutex_unlock 3 , +.Xr pthread_cond_broadcast 3 , +.Xr pthread_cond_destroy 3 , +.Xr pthread_cond_init 3 , +.Xr pthread_cond_signal 3 , +.Xr pthread_cond_timedwait 3 , +.Xr pthread_cond_wait 3 , +.Xr pthread_rwlock_destroy 3 , +.Xr pthread_rwlock_init 3 , +.Xr pthread_rwlock_rdlock 3 , +.Xr pthread_rwlock_unlock 3 , +.Xr pthread_rwlock_wrlock 3 , +.Xr pthread_rwlockattr_destroy 3 , +.Xr pthread_rwlockattr_getpshared 3 , +.Xr pthread_rwlockattr_init 3 , +.Xr pthread_rwlockattr_setpshared 3 , +.Xr pthread_key_delete 3 , +.Xr pthread_getspecific 3 , +.Xr pthread_setspecific 3 , +.Xr pthread_cleanup_pop 3 , +.Xr pthread_cleanup_push 3 .Sh 規格 -接頭語 .Fa pthread_ -が付き、接尾語 +接頭語が付き、 .Fa _np -や接頭語 +接尾語または .Fa pthread_rwlock -が付いていない +接頭語が付いていない .Fa libc_r -の関数は、IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Eition 1996-07-12 に準拠しています。 +の関数は、 +.St -p1003.1-96 +に適合しています。 .Pp -接頭語 .Fa pthread_ -と接尾語 +接頭語および .Fa _np -が付いている libc_r の関数は、 -POSIX スレッドの移植不可能なエクステンションです。 +接尾語が付いた libc_r の関数は、POSIX スレッドへの非ポータブル拡張です。 .Pp -接頭語 .Fa pthread_rwlock -が付いている libc_r の関数は、 -Single UNIX Specification, Version 2 の -The Open Group が作成したエクステンションです。 +接頭語が付いた libc_r の関数は、 +.St -susv2 +の The Open Group によって作成された拡張です。 diff --git a/ja_JP.eucJP/man/man3/pthread_cleanup_pop.3 b/ja_JP.eucJP/man/man3/pthread_cleanup_pop.3 index 84b636d3c2..50eadc1cc4 100644 --- a/ja_JP.eucJP/man/man3/pthread_cleanup_pop.3 +++ b/ja_JP.eucJP/man/man3/pthread_cleanup_pop.3 @@ -1,62 +1,66 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" %FreeBSD: src/lib/libc_r/man/pthread_cleanup_pop.3,v 1.5.2.2 2001/03/06 16:46:08 ru Exp % .\" +.\" $FreeBSD$ .Dd July 30, 1998 .Dt PTHREAD_CLEANUP_POP 3 .Os BSD 4 .Sh 名称 .Nm pthread_cleanup_pop -.Nd 最初のクリーンアップルーチンを呼び出す +.Nd 最初のクリーンアップルーチンの呼び出し +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft void .Fn pthread_cleanup_pop "int execute" .Sh 解説 .Fn pthread_cleanup_pop -関数は、現行スレッドクリーンアップルーチンスタックの -最初のクリーンアップルーチンを取り出し、 +関数は、現在のスレッドのクリーンアップルーチンスタックから先頭の +クリーンアップルーチンを取り出します。 .Fa execute -がゼロ以外である場合にこの関数を実行します。 -クリーンアップルーチンがない場合、 +が 0 でない場合には、その関数を実行します。 +クリーンアップルーチンがない場合には、 .Fn pthread_cleanup_pop -は何も実行しません。 +は何もしません。 .Sh 戻り値 .Fn pthread_cleanup_pop -は値を戻しません。 -.Sh 誤り +はいかなる値も返しません。 +.Sh エラー ありません。 .Sh 関連項目 .Xr pthread_cleanup_push 3 , .Xr pthread_exit 3 .Sh 規格 .Fn pthread_cleanup_pop -は、ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn Posix -POSIX -Std 1003.1 Second Edition 1996-07-12 に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cleanup_push.3 b/ja_JP.eucJP/man/man3/pthread_cleanup_push.3 index 25868e423b..3f3b7e74e2 100644 --- a/ja_JP.eucJP/man/man3/pthread_cleanup_push.3 +++ b/ja_JP.eucJP/man/man3/pthread_cleanup_push.3 @@ -1,63 +1,68 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" %FreeBSD: src/lib/libc_r/man/pthread_cleanup_push.3,v 1.5.2.2 2001/03/06 16:46:08 ru Exp % .\" +.\" $FreeBSD$ .Dd July 30, 1998 .Dt PTHREAD_CLEANUP_PUSH 3 .Os BSD 4 .Sh 名称 .Nm pthread_cleanup_push -.Nd クリーンアップ関数を追加し、スレッドが終了したときに実行 +.Nd スレッド終了時のクリーンアップ関数の追加 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft void .Fn pthread_cleanup_push "void (*cleanup_routine)(void *)" "void *arg" .Sh 解説 .Fn pthread_cleanup_push -関数は、クリーンアップハンドラのスタックの最上位に +関数は、現在のスレッドが終了する時に呼び出されるクリーンアップハンドラの +スタックの先頭に .Fa cleanup_routine -を追加します。このハンドラは、 -現行スレッドが終了した場合に呼び出されます。 +を追加します。 .Pp .Fn pthread_cleanup_push -を呼び出すと、 +が呼び出されると、 .Fa arg -が唯一の引数として渡されます。 +がその唯一の引数として渡されます。 .Sh 戻り値 .Fn pthread_cleanup_push -は値を戻しません。 -.Sh 誤り +はいかなる値も返しません。 +.Sh エラー ありません。 .Sh 関連項目 .Xr pthread_cleanup_pop 3 , .Xr pthread_exit 3 .Sh 規格 .Fn pthread_cleanup_push -は、ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_broadcast.3 b/ja_JP.eucJP/man/man3/pthread_cond_broadcast.3 index 165625be24..89b481f263 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_broadcast.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_broadcast.3 @@ -1,69 +1,74 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_broadcast.3,v 1.5.2.2 2001/03/06 16:46:08 ru Exp % .\" +.\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_BROADCAST 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_broadcast -.Nd 条件変数を待機しているすべてのスレッドのブロックを解除 +.Nd 条件変数を待っている全てのスレッドのブロック解除 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_broadcast "pthread_cond_t *cond" .Sh 解説 .Fn pthread_cond_broadcast 関数は、条件変数 .Fa cond -を待機しているすべてのスレッドのブロックを解除します。 +を待っている全てのスレッドのブロックを解除します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_broadcast -関数はゼロを戻します。 -問題がある場合は、そのエラーを示すエラー番号を戻します。 -.Sh 誤り +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 +.Sh エラー .Fn pthread_cond_broadcast -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa cond -で指定された値が正しくない場合 +によって指定された値が無効です。 .El .Pp .Sh 関連項目 .Xr pthread_cond_destroy 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_signal 3 , .Xr pthread_cond_timedwait 3 , .Xr pthread_cond_wait 3 .Sh 規格 .Fn pthread_cond_broadcast -は、ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_destroy.3 b/ja_JP.eucJP/man/man3/pthread_cond_destroy.3 index b593d44917..36c6f27bb1 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_destroy.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_destroy.3 @@ -1,75 +1,78 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_destroy.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_DESTROY 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_destroy -.Nd 条件変数を破壊 +.Nd 条件変数の破壊 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_destroy "pthread_cond_t *cond" .Sh 解説 .Fn pthread_cond_destroy 関数は、条件変数 .Fa cond -が割り当てたリソースを解放します。 +によって割り当てられたリソースを開放します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_destroy -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_cond_destroy -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa cond -で指定された値が正しくない場合 +によって指定された値が無効です。 .It Bq Er EBUSY 変数 .Fa cond -が別のスレッドでロックされている場合 +が別のスレッドによってロックされています。 .El .Pp .Sh 関連項目 .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_signal 3 , .Xr pthread_cond_timedwait 3 , .Xr pthread_cond_wait 3 .Sh 規格 .Fn pthread_cond_destroy -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_init.3 b/ja_JP.eucJP/man/man3/pthread_cond_init.3 index f5665fa6d7..f85a3fbdf3 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_init.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_init.3 @@ -1,83 +1,82 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_init.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_INIT 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_init .Nd 条件変数の作成 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_init "pthread_cond_t *cond" "const pthread_condattr_t *attr" .Sh 解説 .Fn pthread_cond_init 関数は、 .Fa attr -で指定された属性で新しい条件変数を作成します。 +に指定された属性で新しい条件変数を作成します。 .Fa attr -が -NULL -である場合は、デフォルトの属性が使用されます。 +が NULL の場合には、デフォルトの属性が使用されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_init -関数は -0 -を戻し、新しい条件変数 -ID -を +関数は 0 を返し、 .Fa cond -に入れます。問題がある場合は、そのエラーを示すエラー番号を戻します。 +に新しい条件変数の ID を入れます。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_cond_init -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa attr -で指定された値が正しくない場合 +によって指定された値が無効です。 .It Bq Er ENOMEM -プロセスが、条件変数の作成に十分なメモリを割り当てできない場合 +プロセスが別の条件変数の作成のための十分なメモリを割り当てられません。 .It Bq Er EAGAIN -条件変数を作成するためのリソースが一時的に不足している場合 +別の条件変数を作成するために一時的なリソースが不足しています。 .El .Pp .Sh 関連項目 .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_destroy 3 , .Xr pthread_cond_signal 3 , .Xr pthread_cond_timedwait 3 , .Xr pthread_cond_wait 3 .Sh 規格 .Fn pthread_cond_init -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_signal.3 b/ja_JP.eucJP/man/man3/pthread_cond_signal.3 index 60a3bfb9e7..9bd4a5bb13 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_signal.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_signal.3 @@ -1,73 +1,74 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_signal.3,v 1.5.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_SIGNAL 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_signal -.Nd 条件変数を待機しているスレッドのブロック解除 +.Nd 条件変数を待っている 1 つのスレッドのブロック解除 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_signal "pthread_cond_t *cond" .Sh 解説 .Fn pthread_cond_signal 関数は、条件変数 .Fa cond -を待機している -1 -スレッドのブロックを解除します。 +を待っている 1 つのスレッドのブロックを解除します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_signal -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_cond_signal -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa cond -で指定された値が正しくない場合 +によって指定された値が無効です。 .El .Pp .Sh 関連項目 .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_destroy 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_timedwait 3 , .Xr pthread_cond_wait 3 .Sh 規格 .Fn pthread_cond_signal -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_timedwait.3 b/ja_JP.eucJP/man/man3/pthread_cond_timedwait.3 index 4b90b4cc05..bb3e5e927a 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_timedwait.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_timedwait.3 @@ -1,90 +1,92 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_timedwait.3,v 1.8.2.3 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_TIMEDWAIT 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_timedwait -.Nd 指定時間、条件変数を待つ +.Nd 指定した時間の間の条件変数の待機 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_timedwait "pthread_cond_t *cond" "pthread_mutex_t *mutex" "const struct timespec *abstime" .Sh 解説 .Fn pthread_cond_timedwait 関数は、 .Fa cond -で指定された条件変数を待つことで現行スレッドをアトミックにブロックし、 +で指定された条件変数で待っている現在のスレッドを不可分にブロックし、 .Fa mutex -で指定された -MUTEX -のブロックを解除します。待機しているスレッドのブロックは、 -別のスレッドが +で指定された mutex のブロックを解除します。 +待っているスレッドは、別のスレッドが .Xr pthread_cond_signal 3 -か +または .Xr pthread_cond_broadcast 3 -を同じ条件変数で呼び出した場合、または +を同じ条件変数で呼び出した後、またはシステム時間が .Fa abstime -で指定された時間にシステム時間が達した場合に解除されます。 -解除されると、現行スレッドは +に指定された時間に達した場合、にのみブロックが解除され、現在のスレッドは .Fa mutex -をロックします。 +のロックを再取得します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_timedwait -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_cond_timedwait -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL -.Fa cond -で指定された値、または -.Fa attr -で指定された値が正しくない場合 +.Fa cond , +.Fa mutex +または +.Fa abstime +によって指定された値が無効です。 .It Bq Er ETIMEDOUT +システム時間が、 .Fa abstime -で指定された時間にシステム時間が達したか越えた場合 +に指定した時間に達しました。または、超過しました。 .El .Pp .Sh 関連項目 .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_destroy 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_signal 3 , .Xr pthread_cond_wait 3 .Sh 規格 .Fn pthread_cond_timedwait -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_cond_wait.3 b/ja_JP.eucJP/man/man3/pthread_cond_wait.3 index f3c73c12b8..63da988ab5 100644 --- a/ja_JP.eucJP/man/man3/pthread_cond_wait.3 +++ b/ja_JP.eucJP/man/man3/pthread_cond_wait.3 @@ -1,85 +1,85 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_cond_wait.3,v 1.8.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd July 28, 1998 .Dt PTHREAD_COND_WAIT 3 .Os BSD 4 .Sh 名称 .Nm pthread_cond_wait -.Nd 条件変数を待つ +.Nd 条件変数の待機 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_cond_wait "pthread_cond_t *cond" "pthread_mutex_t *mutex" .Sh 解説 .Fn pthread_cond_wait 関数は、 .Fa cond -で指定された条件変数を待つことで現行スレッドをアトミックにブロックし、 +で指定された条件変数で待っている現在のスレッドを不可分にブロックし、 .Fa mutex -で指定された -MUTEX -のブロックを解除します。 -待機しているスレッドのブロックは、別のスレッドが +で指定された mutex のブロックを解除します。 +待っているスレッドは、別のスレッドが .Xr pthread_cond_signal 3 -か +または .Xr pthread_cond_broadcast 3 -を同じ条件変数で呼び出した場合にのみ解除されます。 -解除されると、現行スレッドは +を同じ条件変数で呼び出した後にのみブロックが解除され、現在のスレッドは .Fa mutex -をロックします。 +のロックを再取得します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_cond_wait -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_cond_wait -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa cond -で指定された値、または -.Fa attr -で指定された値が正しくない場合 +によって指定された値、または +.Fa mutex +によって指定された値が無効です。 .El .Pp .Sh 関連項目 .Xr pthread_cond_broadcast 3 , .Xr pthread_cond_destroy 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_signal 3 , .Xr pthread_cond_timedwait 3 .Sh 規格 .Fn pthread_cond_wait -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_create.3 b/ja_JP.eucJP/man/man3/pthread_create.3 index e22f69139d..419e3df2be 100644 --- a/ja_JP.eucJP/man/man3/pthread_create.3 +++ b/ja_JP.eucJP/man/man3/pthread_create.3 @@ -1,122 +1,118 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_create.3,v 1.9.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_CREATE 3 .Os BSD 4 .Sh 名称 .Nm pthread_create .Nd 新しいスレッドの作成 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_create "pthread_t *thread" "const pthread_attr_t *attr" "void *(*start_routine)(void *)" "void *arg" .Sh 解説 .Fn pthread_create -関数を使用すると、 +関数は、プロセス内に .Fa attr -で指定された属性でプロセスに新しいスレッドを作成できます。 +によって指定された属性をもつ新しいスレッドを作成するために使用されます。 .Fa attr -が -NULL -である場合は、デフォルトの属性が使用されます。 +が NULL である場合には、デフォルトの属性が使用されます。 .Fa attr -で指定した属性を後で変更しても、スレッドの属性は変化しません。 -問題なく終了すると、 +によって指定された属性が後から更新された場合には、 +スレッドの属性は変化しません。 +問題なく完了すると、 .Fn pthread_create -は、作成したスレッドの -ID -を +は .Fa thread -で指定された場所に保存します。 +によって指定された場所に作成されたスレッドの ID を格納します。 .Pp スレッドは、 .Fa arg を唯一の引数として .Fa start_routine -を実行して作成されます。 +を実行することで作成されます。 .Fa start_routine -が復帰すると、 +が戻った場合には、 .Fa start_routine -の戻り値を終了ステータスとして使用し、 +の戻り値を終了ステータスとして使用し、暗黙のうちに .Fn pthread_exit -を暗黙のうちに呼び出したような効果があります。 +を呼び出したような効果があります。 .Fn main -を呼び出したスレッドは、これとは異なることに注意してください。 +を最初にに実行したスレッドは、これとは異なることに注意してください。 +そのスレッドが .Fn main -から復帰すると、 +から戻った時には、 .Fn main -の戻り値を終了ステータスとして使用し、 +の戻り値を終了ステータスとして使用し、暗黙のうちに .Fn exit -を暗黙のうちに呼び出したような効果があります。 +を呼び出したような効果があります。 .Pp -新しいスレッドのシグナルは、以下の状態に初期化されます。 +新しいスレッドのシグナルの状態は、以下のように初期化されます。 .Bl -bullet -offset indent .It -シグナルマスクは、作成を行なうスレッドから継承されます。 +シグナルマスクは作成しているスレッドから継承されます。 .It 新しいスレッド用に保留しているシグナルのセットは空です。 .El .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_create -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_create -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EAGAIN -別のスレッドの作成に必要なリソースがシステムに不足している場合、 -または -1 -つのプロセスの総スレッド数についてシステムに課された制限 -[PTHREAD_THREADS_MAX] -を越えた場合 -.It Bq Er EINVAL +別のスレッドを作成するために必要なリソースがシステムに不足しています。 +または、1 つのプロセス内の総スレッド数についてのシステムの +制限 [PTHREAD_THREADS_MAX] を超過しました。 +.It Bq Er EINVAL .Fa attr -で指定された値が正しくない場合 +によって指定された値が、有効ではありません。 .El .Pp .Sh 関連項目 .Xr fork 2 , .Xr pthread_cleanup_pop 3 , .Xr pthread_cleanup_push 3 , .Xr pthread_exit 3 , .Xr pthread_join 3 .Sh 規格 .Fn pthread_create -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/pthread_detach.3 b/ja_JP.eucJP/man/man3/pthread_detach.3 index 4b0e4666be..6b9123ad64 100644 --- a/ja_JP.eucJP/man/man3/pthread_detach.3 +++ b/ja_JP.eucJP/man/man3/pthread_detach.3 @@ -1,87 +1,87 @@ .\" Copyright (c) 1996-1998 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_detach.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_DETACH 3 .Os BSD 4 .Sh 名称 .Nm pthread_detach -.Nd スレッドの切り離し +.Nd スレッドのデタッチ +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_detach "pthread_t thread" .Sh 解説 .Fn pthread_detach -関数は、スレッドが終了する時にスレッド +関数は、スレッドを終了する時にスレッドのための記憶領域 .Fa thread -の記憶域が再生できることをシステムに指定するために使用します。 +が再生できることを実装に示すために使用されます。 .Fa thread -が終了していない場合、 +がまだ終了していない場合に、 .Fn pthread_detach -でそのスレッドが終了することはありません。同じスレッドを対象にして +はそのスレッド終了させることはありません。 +同じ対象スレッドへの複数回の .Fn pthread_detach -を複数回呼び出す効果は未規定です。 +の呼び出しの効果は未規定です。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_detach -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を -戻します。この関数は、規格の一部のドラフトで行なわれていたようには -errno -の値を変更しないことに注意してください。また、以前のドラフトでは -pthread_t -のポインタを引数として渡していました。ご注意ください。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 +この関数は幾つかの草案で規格とされていたようには errno の値を変更しない +ことに注意してください。 +これらの早期の草案では引数として pthread_t へのポインタも渡していました。 +気を付けてください。 .Sh エラー .Fn pthread_detach -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa thread -で指定された値が、結合可能なスレッドを参照していないことを -システムが検出した場合 +によって指定された値が、 +待機されることが可能なスレッドを参照していないことを検出しました。 .It Bq Er ESRCH -指定されたスレッド -ID +与えられたスレッド ID, .Fa thread -に対応するスレッドが見つからない場合 +によって指定されたものと一致するスレッドを見つけることができません。 .El .Pp .Sh 関連項目 .Xr pthread_join 3 .Sh 規格 .Fn pthread_detach -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/pthread_equal.3 b/ja_JP.eucJP/man/man3/pthread_equal.3 index dd5ec8f102..86e5a80fad 100644 --- a/ja_JP.eucJP/man/man3/pthread_equal.3 +++ b/ja_JP.eucJP/man/man3/pthread_equal.3 @@ -1,74 +1,71 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_equal.3,v 1.4.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_EQUAL 3 .Os BSD 4 .Sh 名称 .Nm pthread_equal .Nd スレッド ID の比較 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_equal "pthread_t t1" "pthread_t t2" .Sh 解説 .Fn pthread_equal -関数は、スレッド -ID +関数は、 .Fa t1 -と +および .Fa t2 -を比較します。 +のスレッド ID を比較します。 .Sh 戻り値 .Fn pthread_equal -関数は、スレッド -ID +関数は、 .Fa t1 -と +および .Fa t2 -が同じスレッドに相当する場合、 -0 -以外を戻します。異なるスレッドである場合は -0 -を戻します。 +のスレッド ID が同じスレッドに相当する場合には非 0 を返し、 +そうでない場合には 0 を返します。 .Sh エラー ありません。 .Pp .Sh 関連項目 .Xr pthread_create 3 , .Xr pthread_exit 3 .Sh 規格 .Fn pthread_equal -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/pthread_exit.3 b/ja_JP.eucJP/man/man3/pthread_exit.3 index 46cf857a3b..62a2e24089 100644 --- a/ja_JP.eucJP/man/man3/pthread_exit.3 +++ b/ja_JP.eucJP/man/man3/pthread_exit.3 @@ -1,105 +1,106 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_exit.3,v 1.8.2.3 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_EXIT 3 .Os BSD 4 .Sh 名称 .Nm pthread_exit -.Nd 呼び出しスレッドの終了 +.Nd 呼び出しているスレッドの終了 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft void .Fn pthread_exit "void *value_ptr" .Sh 解説 .Fn pthread_exit -関数は、呼び出しスレッドを終了し、終了スレッドとの結合に +関数は、呼び出しているスレッドを終了し、 +終了するスレッドと成功裏に待ち受けするために .Fa value_ptr -の値を使用できるようにします。プッシュされたがまだポップされていない -キャンセルクリーンアップハンドラは、プッシュと逆の順序でポップ -されて実行されます。すべてのキャンセルハンドラが実行された後で -スレッドに固有なデータがスレッドにある場合は、適切な破壊関数が -順序不定で呼び出されます。スレッドが終了しても、 -MUTEX -とファイル記述子等のアプリケーションのプロセスリソースは -解放されませんし、存在する可能性がある +の値を利用可能にします。 +既にスタックに積まれていて取り出されていない取り消しクリーンアップハンドラは、 +積まれたのと逆の順序で取り出され、実行されます。 +全ての取り消しハンドラが実行された後で、スレッドがそのスレッド固有のデータを +持っている場合には、適切なデストラクタ関数が順序不定で呼び出されます。 +スレッドの終了は、アプリケーションから見える全てのプロセスリソースを +開放しません。 +このリソースは、mutex およびファイル記述子を含みますが、これに限りません。 +また、あらゆるプロセスレベルのクリーンアップの実行も行ないません。 +このクリーンアップは、存在する可能性のある .Fn atexit -関数の呼び出し等のプロセスレベルのクリーンアップアクションも -実行されません。 +ルーチンの呼び出しを含みますが、これに限りません。 .Pp .Fn main -を最初に呼び出したスレッド以外のスレッドが、作成に使用された -開始ルーチンから戻った場合は、 +を最初に実行したスレッド以外のスレッドが、その作成に使用された +開始ルーチンから戻った時に、暗黙的に .Fn pthread_exit -が暗黙のうちに呼び出されます。 +が呼び出されます。 関数の戻り値は、スレッドの終了ステータスとして使用されます。 .Pp +暗黙的なまたは明示的な .Fn pthread_exit -を暗黙のうちにあるいは明示的に呼び出したために -起動されたキャンセルハンドラや破壊関数から呼び出された +の呼び出しの結果として実行された取り消しハンドラまたはデストラクタ関数から +呼び出された場合の、 .Fn pthread_exit の動作は未定義です。 .Pp -スレッドが終了した後では、スレッドのローカル -( -自動 -) -変数へのアクセス結果は不定になります。 +スレッドが終了した後での、そのスレッドのローカル (auto) 変数へのアクセスの +結果は未定義です。 +従って、終了するスレッドのローカル変数への参照は、 .Fn pthread_exit の .Fa value_ptr -パラメータに、終了するスレッドのローカル変数の参照を -使用しないでください。 +パラメータの値に使用されるべきではありません。 .Pp -最後のスレッドが終了した後では、プロセスは終了ステータス -0 -で終了します。実装がスレッドの終了時に引数をゼロにして +最後のスレッドが終了した後で、プロセスは終了ステータス 0 で終了します。 +スレッド終了時に実装が引数 0 で .Fn exit -を呼び出したような動作となります。 +を呼び出したかのように動作します。 .Pp .Sh 戻り値 .Fn pthread_exit -関数は、呼び出し側に復帰できません。 +関数は呼び出し側には戻れません。 .Sh エラー ありません。 .Pp .Sh 関連項目 .Xr _exit 2 , -.Xr exit 2 , +.Xr exit 3 , .Xr pthread_create 3 , .Xr pthread_join 3 .Sh 規格 .Fn pthread_exit -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/pthread_getspecific.3 b/ja_JP.eucJP/man/man3/pthread_getspecific.3 index bda716ea2d..d924d00924 100644 --- a/ja_JP.eucJP/man/man3/pthread_getspecific.3 +++ b/ja_JP.eucJP/man/man3/pthread_getspecific.3 @@ -1,86 +1,84 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL 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. .\" -.\" %Id: pthread_getspecific.3,v 1.5 1998/08/03 00:58:36 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_getspecific.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % .\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_GETSPECIFIC 3 .Os BSD 4 .Sh 名称 .Nm pthread_getspecific -.Nd スレッドに固有なデータ値を入手 +.Nd スレッド固有のデータ値の取得 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft void * .Fn pthread_getspecific "pthread_key_t key" .Sh 解説 .Fn pthread_getspecific -関数は、呼び出しスレッドに代わって指定された +関数は、呼び出しているスレッドの代わりに、指定された .Fa key -に現在結合されている値を戻します。 +に現在結びつけられている値を返します。 .Pp .Fn pthread_key_create -で入手していない +から入手したのではない .Fa key -値で -.Fn pthread_getspecific -を呼び出したり、 +の値を伴った、または .Fn pthread_key_delete -で +によって .Fa key -が削除された後で +が削除された後での、 .Fn pthread_getspecific -を呼び出したりすると、結果は不定になります。 +の呼び出しの結果は未定義です。 .Pp .Fn pthread_getspecific -は、スレッドに固有なデータの破壊関数から呼び出されることがあります。 +はスレッド固有のデータのデストラクタ関数から呼び出されることがあります。 .Sh 戻り値 .Fn pthread_getspecific -関数は、指定された +関数は、与えられた .Fa key -に関連する、スレッドに固有なデータ値を戻します。 +に関連付けられたスレッド固有のデータ値を返します。 .Fa key -にスレッド固有のデータ値が関連していない場合は -NULL -が戻されます。 +に関連付けられたスレッド固有のデータ値がない場合には、値 NULL が返されます。 .Sh エラー ありません。 .Sh 関連項目 .Xr pthread_key_create 3 , .Xr pthread_key_delete 3 , .Xr pthread_setspecific 3 .Sh 規格 .Fn pthread_getspecific -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_join.3 b/ja_JP.eucJP/man/man3/pthread_join.3 index d8e1504ca3..a80991d42a 100644 --- a/ja_JP.eucJP/man/man3/pthread_join.3 +++ b/ja_JP.eucJP/man/man3/pthread_join.3 @@ -1,108 +1,107 @@ .\" Copyright (c) 1996-1998 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_join.3,v 1.7.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_JOIN 3 .Os BSD 4 .Sh 名称 .Nm pthread_join -.Nd スレッドの終了を待機 +.Nd スレッド終了の待機 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_join "pthread_t thread" "void **value_ptr" .Sh 解説 .Fn pthread_join -関数は、 +関数は、対象 .Fa thread -が終了していない場合、 +がまだ終了していない場合には、その対象 .Fa thread -が終了するまで呼び出しスレッドの実行を保留します。 +が終了するまで、呼び出しているスレッドの実行を保留します。 .Pp -非 -NULL -な +NULL ではない .Fa value_ptr -引数での +引数を持つ .Fn pthread_join -の呼び出しから正常に復帰すると、終了するスレッドが +の呼び出しから成功裏に戻った時には、終了したスレッドによって .Fn pthread_exit -に渡した値は +に渡された値が、 .Fa value_ptr -が参照する場所に保存されます。 +によって参照される位置に格納されます。 .Fn pthread_join -が正常に復帰する場合、対象スレッドは終了しています。 -同じ対象スレッドを指定して +が成功裏に戻った時には、その対象スレッドは既に終了しています。 +同じ対象スレッドを指定した複数で同時の .Fn pthread_join -を同時に複数回呼び出す結果は未定義です。 +の呼び出しによる結果は、未定義です。 .Fn pthread_join -を呼び出したスレッドがキャンセルされた場合、 -対象スレッドは切り離されません。 +を呼び出しているスレッドが取り消された場合には、その対象スレッドは +デタッチされません。 .Pp -終了したが結合していないスレッドは、 -[_POSIX_THREAD_THREADS_MAX] -にカウントされます。 +既に終了したが持ち受けされずに残っているスレッドは、 +[_POSIX_THREAD_THREADS_MAX] に対してカウントされます。 .Pp .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_join -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_join -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa thread -で指定された値が、結合可能スレッドを参照していないことを -実装が検出した場合 +によって指定された値が、 +待機されることが可能なスレッドを参照していないことを検出しました。 .It Bq Er ESRCH -指定されたスレッド -ID +与えられたスレッド ID, .Fa thread -に対応するスレッドが見つからない場合 +によって指定されたものと一致するスレッドを見つけることができません。 .It Bq Er EDEADLK -デッドロックが検出された場合、または +デッドロックを検出しました。または、 .Fa thread -の値が呼び出しスレッドを指定している場合 +の値が呼び出しているスレッドを指定しています。 .El .Pp .Sh 関連項目 .Xr wait 2 , .Xr pthread_create 3 .Sh 規格 .Fn pthread_join -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_key_create.3 b/ja_JP.eucJP/man/man3/pthread_key_create.3 index 60dd371321..b857990e1f 100644 --- a/ja_JP.eucJP/man/man3/pthread_key_create.3 +++ b/ja_JP.eucJP/man/man3/pthread_key_create.3 @@ -1,114 +1,105 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_key_create.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_KEY_CREATE 3 .Os BSD 4 .Sh 名称 .Nm pthread_key_create -.Nd スレッドに固有なデータキーの作成 +.Nd スレッド固有のデータキーの作成 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_key_create "pthread_key_t *key" "void (*destructor)(void *)" .Sh 解説 .Fn pthread_key_create -関数は、プロセスのすべてのスレッドで使用できる、スレッドに固有な -データキーを作成します。 +関数は、プロセス内の全てのスレッドに可視のスレッド固有のデータキーを +作成します。 .Fn pthread_key_create -で提供されるキー値は不透明なオブジェクトであり、スレッドに固有な -データの特定に使用されます。別のスレッドで同じキー値を使用できますが、 +によって提供されたキーの値は、スレッド固有のデータの位置を示すために +使用される不透明なオブジェクトです。 +別のスレッドによって同じキー値が使用されることが可能ですが、 .Fn pthread_setspecific -でキーに結び付けられた値はスレッドごとに維持され、 -呼び出しスレッドが終了するまで残ります。 +によってキーに結びつけられた値はスレッド毎を基準に保守され、 +呼び出しているスレッドが生きている間存続します。 .Pp -キーの作成時には、すべてのアクティブなスレッドの新しいキーに -NULL -値が関連します。スレッドの作成時には、新しいスレッドで定義された -すべてのキーに -NULL -値が関連します。 +キーの作成時には、全てのアクティブなスレッド内の新しいキーに、値 NULL が +関連付けられます。 +スレッドの作成時には、新しいスレッド内の全ての定義済のキーに、値 NULL が +関連付けられます。 .Pp -それぞれのキー値には、任意の破壊関数が関連していることがあります。 -スレッドの終了時には、キー値が破壊関数への非 -NULL -ポインタを持ち、かつスレッドでキーに非 -NULL -値が関連している場合に、現在関連している値を唯一の引数として、 -指されている関数が呼び出されます。スレッドに複数の破壊関数が -存在する場合、スレッドの終了時に破壊関数を呼び出す順序は未規定です。 +任意のデストラクタ関数は、個々のキーの値と関連付けられることができます。 +スレッドの終了時に、キー値が NULL でないデストラクタのポインタを持ち、 +かつスレッドがキーに関連付けられた NULL でない値を持っている場合には、 +現在関連付けられている値を唯一の引数として、指されている関数が呼び出されます。 +スレッドの終了時にそのスレッドのための 1 つ以上のデストラクタ関数が +存在する場合には、デストラクタの呼び出しの順序は未規定です。 .Pp -破壊関数が関連づけられたすべての非 -NULL -値に対してすべての破壊関数が呼び出された後で、 -まだ破壊関数が関連づけられた非 -NULL -値が存在する場合は、プロセスが繰り返されます。 -未処理の非 -NULL -値に対して最低でも -[PTHREAD_DESTRUCTOR_ITERATIONS] -の回数だけ破壊関数の呼び出しを繰り返した後で、関連する破壊関数で非 -NULL -値が残っている場合、実装は破壊関数の呼び出しを中止します。 +デストラクタに関連付けられた全ての NULL でない値のために、全ての +デストラクタが呼び出された後で、まだ幾つかの関連付けられたデストラクタを +持つ NULL でない値がある場合には、その過程が繰り返されます。 +最低でも [PTHREAD_DESTRUCTOR_ITERATIONS] 回のデストラクタの呼び出しの +繰り返しの後で、まだなお幾つかの関連付けられたデストラクタを +持つ NULL でない値がある場合には、実装はデストラクタの呼び出しを中止します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_key_create -関数は、新しく作成されたキー値を +関数は、新しく作成されたキーの値を .Fa key -で指定されている場所に保存して -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号が戻されます。 +で指定された場所に格納し、0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_key_create -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EAGAIN -スレッドに固有なデータキーの作成に必要なリソースが -システムで不足しているか、プロセスごとのキー総数に関する、 -システムに課せられた制限 -[PTHREAD_KEYS_MAX] -を越えた場合 +別のスレッド固有のデータキーを作成するために必要なリソースがシステムに +不足しています。または、1 つのプロセスごとのキーの総数についての +システムの制限 [PTHREAD_KEYS_MAX] を超過しました。 .It Bq Er ENOMEM -キーの作成にメモリが不足している場合 +キーを作成するための十分なメモリがありません。 .El .Pp .Sh 関連項目 .Xr pthread_getspecific 3 , .Xr pthread_key_delete 3 , .Xr pthread_setspecific 3 .Sh 規格 .Fn pthread_key_create -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_key_delete.3 b/ja_JP.eucJP/man/man3/pthread_key_delete.3 index 575dbcd47e..e7f0e19a45 100644 --- a/ja_JP.eucJP/man/man3/pthread_key_delete.3 +++ b/ja_JP.eucJP/man/man3/pthread_key_delete.3 @@ -1,94 +1,98 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_key_delete.3,v 1.6.2.2 2001/03/06 16:46:08 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_KEY_DELETE 3 .Os BSD 4 .Sh 名称 .Nm pthread_key_delete -.Nd スレッドに固有なデータキーの削除 +.Nd スレッド固有のデータキーの削除 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_key_delete "pthread_key_t key" .Sh 解説 .Fn pthread_key_delete -関数は、 +関数は、以前に .Fn pthread_key_create -で以前に戻された、スレッドに固有なデータキーを削除します。 +によって返されたスレッド固有のデータキーを削除します。 .Fa key -に関連する、スレッドに固有なデータ値は、 +に関連付けられたスレッド固有のデータ値は、 .Fn pthread_key_delete -を呼び出す時点で -NULL -になっている必要はありません。アプリケーションの記憶域の解放、 -削除されるキーに関係のあるデータ構造や任意のスレッドでの関連する -スレッド固有データのクリーンアップアクションの実行は、 -アプリケーションで行なってください。このクリーンアップは、 +が呼び出される時点で NULL である必要はありません。 +全てのアプリケーション記憶領域の開放、または削除されたキーに関連した +データ構造や全てのスレッドの中のスレッド固有のデータの全ての +クリーンアップ動作の実行は、アプリケーションの責務です。 +このクリーンアップは .Fn pthread_key_delete -の呼び出しの前後で実行できます。 +が呼び出される前後で実行されることが可能です。 .Fn pthread_key_delete -を呼び出した後で +の呼び出しの後で、 .Fa key -を使用しようとすると、結果は不定になります。 +を使用しようとする全ての試みの結果は、不定動作になります。 .Pp .Fn pthread_key_delete -関数は、破壊関数から呼び出されることがあります。 +関数は、デストラクタ関数の中から呼び出すことが可能です。 +デストラクタ関数は、 .Fn pthread_key_delete -が破壊関数を呼び出すことはありません。 +からは呼び出されません。 .Fa key -に関連していた破壊関数は、スレッドの終了時に呼び出されません。 +に関連付けられているかもしれない全てのデストラクタ関数は、 +スレッドの終了時にはもはや呼び出されません。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_key_delete -関数は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_key_delete -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa key -の値が正しくない場合 +の値が無効です。 .El .Pp .Sh 関連項目 .Xr pthread_getspecific 3 , .Xr pthread_key_create 3 , .Xr pthread_setspecific 3 .Sh 規格 .Fn pthread_key_delete -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_mutex_destroy.3 b/ja_JP.eucJP/man/man3/pthread_mutex_destroy.3 index e0857709b0..90f3be6cb2 100644 --- a/ja_JP.eucJP/man/man3/pthread_mutex_destroy.3 +++ b/ja_JP.eucJP/man/man3/pthread_mutex_destroy.3 @@ -1,73 +1,74 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_mutex_destroy.3,v 1.5.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd July 29, 1998 .Dt PTHREAD_MUTEX_DESTROY 3 .Os BSD 4 .Sh 名称 .Nm pthread_mutex_destroy -.Nd MUTEX に割り当てられたリソースの解放 +.Nd mutex のために割り当てられたリソースの開放 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_mutex_destroy "pthread_mutex_t *mutex" .Sh 解説 .Fn pthread_mutex_destroy -関数は、 -.Fa mutex -に割り当てられたリソースを解放します。 +関数は、mutex のために割り当てられたリソースを開放します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_mutex_destroy -は -0 -を戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_mutex_destroy -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa mutex -で指定された値が正しくない場合 +によって指定された値が無効です。 .It Bq Er EBUSY .Fa mutex -が別のスレッドでロックされている場合 +が別のスレッドにロックされています。 .El .Pp .Sh 関連項目 .Xr pthread_mutex_init 3 , .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh 規格 .Fn pthread_mutex_destroy -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_mutex_init.3 b/ja_JP.eucJP/man/man3/pthread_mutex_init.3 index 677961130b..9f33dd2722 100644 --- a/ja_JP.eucJP/man/man3/pthread_mutex_init.3 +++ b/ja_JP.eucJP/man/man3/pthread_mutex_init.3 @@ -1,87 +1,81 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_mutex_init.3,v 1.6.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd July 29, 1998 .Dt PTHREAD_MUTEX_INIT 3 .Os BSD 4 .Sh 名称 .Nm pthread_mutex_init -.Nd MUTEX の作成 +.Nd mutex の作成 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_mutex_init "pthread_mutex_t *mutex" "const pthread_mutexattr_t *attr" .Sh 解説 .Fn pthread_mutex_init 関数は、 .Fa attr -で指定された属性で新しい -MUTEX -を作成します。 +に指定された属性で新しい mutex を作成します。 .Fa attr -が -NULL -である場合はデフォルトの属性が使用されます。 +が NULL の場合には、デフォルトの属性が使用されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_mutex_init -は -0 -を戻し、新しい -MUTEX ID -を +は 0 を返し、 .Fa mutex -に入れます。問題がある場合は、そのエラーを示すエラー番号を戻します。 +に新しい mutex の ID を入れます。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_mutex_init -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa attr -で指定された値が正しくない場合 +によって指定された値が無効です。 .It Bq Er ENOMEM -プロセスが -MUTEX -の作成に十分なメモリを割り当てできなかった場合 +プロセスが別の mutex の作成のための十分なメモリを割り当てられません。 .It Bq Er EAGAIN -MUTEX -の作成にリソースが一時的に不足した場合 +別の mutex を作成するために一時的なリソースが不足しています。 .El .Pp .Sh 関連項目 .Xr pthread_mutex_destroy 3 , .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh 規格 .Fn pthread_mutex_init -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_mutex_lock.3 b/ja_JP.eucJP/man/man3/pthread_mutex_lock.3 index 153083189b..cdbaf3f495 100644 --- a/ja_JP.eucJP/man/man3/pthread_mutex_lock.3 +++ b/ja_JP.eucJP/man/man3/pthread_mutex_lock.3 @@ -1,71 +1,79 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_mutex_lock.3,v 1.5.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd July 30, 1998 .Dt PTHREAD_MUTEX_LOCK 3 .Os BSD 4 .Sh 名称 .Nm pthread_mutex_lock .Nd mutex のロック +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_mutex_lock "pthread_mutex_t *mutex" .Sh 解説 .Fn pthread_mutex_lock 関数は、 .Fa mutex -をロックします。 mutex がすでにロックされている場合、 -呼び出しスレッドは、 mutex が使用できるようになるまでブロックされます。 +をロックします。 +mutex が既にロックされている場合には、呼び出しているスレッドは +その mutex が利用可能になるまでブロックされます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_mutex_lock -はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_mutex_lock -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa mutex -で指定された値が正しくない場合。 +によって指定された値が無効です。 .It Bq Er EDEADLK -スレッドがブロックされて .Fa mutex -を待機している場合にデッドロックが発生した場合。 +を待つためにそのスレッドがブロックされた場合には、 +デッドロックが発生しています。 +.El +.Pp .Sh 関連項目 .Xr pthread_mutex_destroy 3 , .Xr pthread_mutex_init 3 , .Xr pthread_mutex_trylock 3 , .Xr pthread_mutex_unlock 3 .Sh 規格 .Fn pthread_mutex_lock -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_mutex_trylock.3 b/ja_JP.eucJP/man/man3/pthread_mutex_trylock.3 index d521ee1658..3ff7052a3b 100644 --- a/ja_JP.eucJP/man/man3/pthread_mutex_trylock.3 +++ b/ja_JP.eucJP/man/man3/pthread_mutex_trylock.3 @@ -1,74 +1,79 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_mutex_trylock.3,v 1.5.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd July 30, 1998 .Dt PTHREAD_MUTEX_TRYLOCK 3 .Os BSD 4 .Sh 名称 .Nm pthread_mutex_trylock -.Nd ブロックせずに mutex をロック +.Nd ブロックを伴わない mutex のロックの試行 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_mutex_trylock "pthread_mutex_t *mutex" .Sh 解説 .Fn pthread_mutex_trylock 関数は .Fa mutex -をロックします。 mutex がすでに -ロックされている場合、 +をロックします。 +mutex が既にロックされている場合には、 .Fn pthread_mutex_trylock -は mutex を待機するためにブロックせず、エラー条件を戻します。 +はその mutex を待つためにブロックせずに、エラー条件を返します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_mutex_trylock -はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_mutex_trylock -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL -.Fa mutex -で指定された値が正しくない場合。 +.Fa mutex +によって指定された値が無効です。 .It Bq Er EBUSY -.Fa mutex -がすでにロックされている場合。 +.Fa mutex +が既にロックされています。 .El .Pp .Sh 関連項目 .Xr pthread_mutex_destroy 3 , .Xr pthread_mutex_init 3 , .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_unlock 3 .Sh 規格 .Fn pthread_mutex_trylock -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_mutex_unlock.3 b/ja_JP.eucJP/man/man3/pthread_mutex_unlock.3 index e67dabf1a8..be804fd989 100644 --- a/ja_JP.eucJP/man/man3/pthread_mutex_unlock.3 +++ b/ja_JP.eucJP/man/man3/pthread_mutex_unlock.3 @@ -1,75 +1,80 @@ .\" Copyright (c) 1997 Brian Cully .\" 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. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_mutex_unlock.3,v 1.5.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd July 30, 1998 .Dt PTHREAD_MUTEX_UNLOCK 3 .Os BSD 4 .Sh 名称 .Nm pthread_mutex_unlock .Nd mutex のロックを解除 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_mutex_unlock "pthread_mutex_t *mutex" .Sh 解説 現在のスレッドが .Fa mutex -をロックしている場合、 +のロックを保持している場合には、 .Fn pthread_mutex_unlock -関数は +関数は、 .Fa mutex のロックを解除します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_mutex_unlock -はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_mutex_trylock -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL -.Fa mutex -で指定された値が正しくない場合。 +.Fa mutex +によって指定された値が無効です。 .It Bq Er EPERM 現在のスレッドが .Fa mutex -をロックしていない場合。 +のロックを保持していません。 .El .Pp .Sh 関連項目 .Xr pthread_mutex_destroy 3 , .Xr pthread_mutex_init 3 , .Xr pthread_mutex_lock 3 , .Xr pthread_mutex_trylock 3 .Sh 規格 .Fn pthread_mutex_unlock -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_once.3 b/ja_JP.eucJP/man/man3/pthread_once.3 index 220865fe6f..2a0fa3f944 100644 --- a/ja_JP.eucJP/man/man3/pthread_once.3 +++ b/ja_JP.eucJP/man/man3/pthread_once.3 @@ -1,104 +1,110 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_once.3,v 1.6.2.3 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_ONCE 3 .Os BSD 4 .Sh 名称 .Nm pthread_once -.Nd ダイナミックなパッケージの初期化 +.Nd 動的なパッケージの初期化 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Pp -pthread_once +pthread_once_t .Fa once_control = PTHREAD_ONCE_INIT; .Ft int .Fn pthread_once "pthread_once_t *once_control" "void (*init_routine)(void)" .Sh 解説 -プロセスの任意のスレッドで特定の +プロセスの全てのスレッドによる最初の、与えられた .Fa once_control -を使用して +を伴っての .Fn pthread_once -を初めて呼び出すと、引数なしで +の呼び出しは、 .Fn init_routine -が呼び出されます。その後で -.Fn pthread_once -を同じ +を引数無しで呼び出します。 +その後での同じ .Fa once_control -で呼び出しても、 +を持つ +.Fn pthread_once +の呼び出しは、 .Fn init_routine -は呼び出されません。 +を呼び出しません。 .Fn pthread_once から戻る時点では、 .Fn init_routine -は終了しています。 +が完了していることが保証されています。 .Fa once_control -パラメータは、関連する初期化ルーチンが呼び出されているかどうかを +パラメータは、関連付けられた初期化ルーチンが既に呼び出されたかどうかを 判断するために使用されます。 .Pp +関数 .Fn pthread_once -関数はキャンセルポイントではありませんが、 +は取り消しポイントではありません。 +しかしながら、 .Fn init_routine -はキャンセルポイントであるためキャンセルされます。キャンセルされると、 +が取り消しポイントですので取り消され、 .Fa once_control -には +は .Fn pthread_once -.Fa が呼び出されていないかのような -効果が生まれます。 +が一度も呼び出されていないかのような結果になります。 .Pp -ヘッダ -.Aq Pa pthread.h -で、定数 +定数 .Fa PTHREAD_ONCE_INIT -が定義されています。 +は、 +.Aq Pa pthread.h +で定義されています。 .Pp .Fa once_control -に自動保存期間がある場合、または -.Fa once_control -が +に自動保存期間がある、または .Fa PTHREAD_ONCE_INIT -で初期化されない場合、 +で初期化されていない場合には、 .Fn pthread_once -の動作は不定になります。 +の動作は未定義です。 +.Pp .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_once -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー ありません。 +.Pp .Sh 規格 .Fn pthread_once -は、 -ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 -に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlock_destroy.3 b/ja_JP.eucJP/man/man3/pthread_rwlock_destroy.3 index 059ef845b9..869db4f9fd 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlock_destroy.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlock_destroy.3 @@ -1,77 +1,82 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlock_destroy.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlock_destroy.3,v 1.3.2.1 2000/04/22 16:35:07 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_DESTROY 3 .Os .Sh 名称 .Nm pthread_rwlock_destroy -.Nd 読み書きロックの破壊 +.Nd 読取り/書込みロックの破壊 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlock_destroy "pthread_rwlock_t *lock" .Sh 解説 .Fn pthread_rwlock_destroy -関数は、 +関数は、以前に .Fn pthread_rwlock_init -で以前に作成された読み書きロックを破壊します。 +で作成された読取り/書込みロックを破壊するために使用されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlock_destroy -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 -.Xr pthread_rwlock_init 3 +.Xr pthread_rwlock_init 3 .Sh 規格 .Fn pthread_rwlock_destroy 関数は、 -.St -susv2 -に準拠する見込みです。 +.St -susv2 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlock_destroy -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EPERM -オペレーションを実行する権利が呼び出し側にない場合。 +呼び出し側が、その操作を実行するための権利を持っていません。 .El .Pp .Fn pthread_rwlock_destroy -関数は、以下のような場合にエラーになることがあります。 +関数は、以下の場合に失敗することがあります。 .Bl -tag -width Er .It Bq Er EBUSY .Fa lock -で参照されるオブジェクトがロックされている間に、 -そのオブジェクトを破壊しようとする動きがシステムによって検出された場合。 +によって参照されているオブジェクトをロックされている間に、 +破壊しようとしていることを、システムが検出しました。 .It Bq Er EINVAL -.Fa lock -で指定された値が正しくない場合。 +.Fa lock +によって指定された値が無効です。 .El .Sh 歴史 .Fn pthread_rwlock_destroy 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlock_init.3 b/ja_JP.eucJP/man/man3/pthread_rwlock_init.3 index be5de3a919..5f7093708f 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlock_init.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlock_init.3 @@ -1,93 +1,98 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlock_init.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlock_init.3,v 1.2.2.1 2000/04/22 16:35:07 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_INIT 3 .Os .Sh 名称 .Nm pthread_rwlock_init -.Nd 読み書きロックの初期化 +.Nd 読取り/書込みロックの初期化 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlock_init "pthread_rwlock_t *lock" "const pthread_rwlockattr_t *attr" .Sh 解説 .Fn pthread_rwlock_init 関数は、 .Fa attr -で指定された属性で読み書きロックを初期化します。 +で指定された属性で、読取り/書込みロックを初期化するために使用されます。 .Fa attr -が NULL である場合は、デフォルトの読み書きロック属性が使用されます。 +が NULL の場合には、デフォルトの読取り/書込みロック属性が使用されます。 .Pp -すでに初期化されているロックで +既に初期化されているロックでの .Fn pthread_rwlock_init -を呼び出すと、結果は不定になります。 +の呼び出しの結果は、未定義です。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlock_init -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_destroy 3 , .Xr pthread_rwlockattr_init 3 , .Xr pthread_rwlockattr_setpshared 3 .Sh 規格 .Fn pthread_rwlock_init 関数は、 -.St -susv2 -に準拠する見込みです。 -.Pp +.St -susv2 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlock_init -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EAGAIN -ロックの初期化に必要なリソース ( メモリ以外 ) がシステムで不足している場合。 +ロックを初期化するために必要な (メモリ以外の) リソースが、 +システムに不足しています。 .It Bq Er ENOMEM -メモリが不足しているためにロックを初期化できない場合。 +ロックを初期化するための十分なメモリがありません。 .It Bq Er EPERM -オペレーションを実行するための十分な権利が呼び出し側にない場合。 +呼び出し側が、その操作を実行するための十分な権利を持っていません。 .El .Pp .Fn pthread_rwlock_init -関数は、以下のような場合にエラーになる場合があります。 +関数は、以下の場合に失敗することがあります。 .Bl -tag -width Er .It Bq Er EBUSY -以前に初期化されたが破壊されていない読み書きロック .Fa lock -で参照されるオブジェクトをさらに初期化しようとする動きが、システムによって -検出された場合。 +によって参照されているオブジェクトで、 +以前に初期化されているがまだ破壊されていない読取り/書込みロックを +再初期化しようとしていることを、システムが検出しました。 .It Bq Er EINVAL -.Fa attr -で指定された値が正しくない場合。 +.Fa attr +によって指定された値が無効です。 .El .Sh 歴史 .Fn pthread_rwlock_init 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 .Sh バグ -PTHREAD_PROCESS_SHARED 属性はサポートされていません。 +PTHREAD_PROCESS_SHARED 属性は、サポートされていません。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlock_rdlock.3 b/ja_JP.eucJP/man/man3/pthread_rwlock_rdlock.3 index f3e3b926a9..87cfdd15e8 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlock_rdlock.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlock_rdlock.3 @@ -1,112 +1,120 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlock_rdlock.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlock_rdlock.3,v 1.2.2.1 2000/04/22 16:35:08 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_RDLOCK 3 .Os .Sh 名称 .Nm pthread_rwlock_rdlock , .Nm pthread_rwlock_tryrdlock -.Nd 読込み用に読み書きロックを取得 +.Nd 読取り用の読取り/書込みロックの獲得 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlock_rdlock "pthread_rwlock_t *lock" .Ft int .Fn pthread_rwlock_tryrdlock "pthread_rwlock_t *lock" .Sh 解説 .Fn pthread_rwlock_rdlock 関数は、 .Fa lock -が書込み用に設定されておらず、 -書込みスレッドがロックでブロックされていない場合、読込みロックを -.Fa lock -で取得します。読込みロックをすぐに取得できない場合、呼び出しスレッドはロック -を取得できるようになるまでブロックされます。 +で与えられた、ロックが現在書込み用に保持されておらず、書込みスレッドが +現在そのロックでブロックされていない、読取り用のロックを獲得します。 +読取り用のロックをすぐに獲得できない場合には、呼び出しているスレッドは +そのロックを獲得できるまでブロックします。 .Pp .Fn pthread_rwlock_tryrdlock -関数は同じアクションを実行しますが、ロックをすぐに取得できなくても - ( 書込み用にロックされているか、書込みスレッドが待機していても ) -ブロックされません。 +関数は、同じ操作を実行しますが、すぐにロックを獲得できない (すなわち、 +ロックが書込み用に保持されている、 +または待っている書込みスレッドがある) 場合には、ブロックしません。 .Pp -1つのスレッドは、複数の読込みロックを同時に取得できます。この場合は +1 つのスレッドは複数の同時の読取り用ロックを保持することができます。 +その場合には、個々の獲得されたのために .Fn pthread_rwlock_unlock -をそれぞれのロックに 1 回ずつ呼び出す必要があります。 +が 1 度ずつ呼び出されなければなりません。 .Pp -呼び出しスレッドが書込みロックを取得している場合に読込みロックを -取得しようとすると、結果は不定になります。 -.Sh システムの注意事項 -書込み側の飢餓状態を避けるため、書込み側は読込み側より優先されます。 +呼び出しているスレッドが書込み用のロックを保持している間の、 +読取り用のロックの獲得の結果は、未定義です。 +.Sh 実装に関する注 +書込み側の飢餓状態を防ぐため、書込み側が読込み側よりも優先されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlock_rdlock -関数と +および .Fn pthread_rwlock_tryrdlock -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_init 3 , .Xr pthread_rwlock_trywrlock 3 , .Xr pthread_rwlock_unlock 3 , .Xr pthread_rwlock_wrlock 3 .Sh 規格 .Fn pthread_rwlock_rdlock -関数と +および .Fn pthread_rwlock_tryrdlock 関数は、 -.St -susv2 +.St -susv2 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlock_tryrdlock -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBUSY -書込み側がロックしているかブロックされているため、ロック -を取得できない場合。 +書込みスレッドがロックを保持している、またはブロックされているため、 +ロックを獲得できません。 .El .Pp .Fn pthread_rwlock_rdlock -関数と +および .Fn pthread_rwlock_tryrdlock -関数は、 -以下のような場合にエラーになる場合があります。 +関数は、以下の場合に失敗することがあります。 .Bl -tag -width Er .It Bq Er EAGAIN .Fa lock -に対する読込みロックの最大数を越えたため、ロックを取得できない場合。 +に対する読取り用のロックの最大数を既に越えているため、 +ロックを獲得できません。 .It Bq Er EDEADLK -現在のスレッドが、書込み用にロックをすでに取得している場合。 +現在のスレッドが既に書込み用の +.Fa lock +を所有しています。 .It Bq Er EINVAL -.Fa lock -で指定されている値が正しくない場合。 +.Fa lock +によって指定された値が無効です。 .It Bq Er ENOMEM -メモリが不足しているため、ロックを初期化できない場合 ( 静的に -初期化されるロックのみに適用 ) 。 +ロック (静的に初期化されたロックのみに適用) の初期化のために +十分なメモリがありません。 .El .Sh 歴史 .Fn pthread_rwlock_rdlock 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlock_unlock.3 b/ja_JP.eucJP/man/man3/pthread_rwlock_unlock.3 index 0d6eaa7304..2cccf2522f 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlock_unlock.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlock_unlock.3 @@ -1,78 +1,82 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlock_unlock.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlock_unlock.3,v 1.2.2.1 2000/04/22 16:35:08 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_UNLOCK 3 .Os .Sh 名称 .Nm pthread_rwlock_unlock -.Nd 読み書きロックの解除 +.Nd 読取り/書込みロックの開放 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlock_unlock "pthread_rwlock_t *lock" .Sh 解説 .Fn pthread_rwlock_unlock -関数は、 +関数は、以前に .Fn pthread_rwlock_rdlock , .Fn pthread_rwlock_wrlock , -.Fn pthread_rwlock_tryrdlock -あるいは +.Fn pthread_rwlock_tryrdlock , +または .Fn pthread_rwlock_trywrlock -で以前に取得した読み書きロックを解除します。 +で獲得された読取り/書込みロックを開放するために使用されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlock_unlock -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Pp -呼び出しスレッドが .Fa lock -を取得していない場合、結果は不定になります。 +が呼び出しているスレッドによって保持されていない場合には、 +その結果は未定義です。 .Sh 関連項目 .Xr pthread_rwlock_rdlock 3 , .Xr pthread_rwlock_wrlock 3 .Sh 規格 .Fn pthread_rwlock_unlock 関数は、 -.St -susv2 -に準拠する見込みです。 -.SH エラー +.St -susv2 +に適合しているはずです。 +.Sh エラー .Fn pthread_rwlock_unlock -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗することがあります。 .Bl -tag -width Er -.It Bq Er EINVAL -.Fa lock -で指定されている値が正しくない場合。 +.It Bq Er EINVAL +.Fa lock +によって指定された値が無効です。 .It Bq Er EPERM -現在のスレッドが読み書きロックを取得していない場合。 +現在のスレッドが、その読取り/書込みロックを所有していません。 .El -.Pp .Sh 歴史 .Fn pthread_rwlock_unlock 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlock_wrlock.3 b/ja_JP.eucJP/man/man3/pthread_rwlock_wrlock.3 index e3cfec33e7..56c3f5dcad 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlock_wrlock.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlock_wrlock.3 @@ -1,98 +1,103 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlock_wrlock.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlock_wrlock.3,v 1.2.2.1 2000/04/22 16:35:08 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCK_WRLOCK 3 .Os .Sh 名称 .Nm pthread_rwlock_wrlock , .Nm pthread_rwlock_trywrlock -.Nd 書込み用に読み書きロックを取得 +.Nd 書込み用の読取り/書込みロックの獲得 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlock_wrlock "pthread_rwlock_t *lock" .Ft int .Fn pthread_rwlock_trywrlock "pthread_rwlock_t *lock" .Sh 解説 .Fn pthread_rwlock_wrlock 関数は、 .Fa lock -に対して書込みロックを取得できるようになるまでブロックされます。 +に対して書込み用のロックを獲得できるまで、ブロックします。 .Fn pthread_rwlock_trywrlock -関数は同じアクションを実行しますが、ロックをすぐに取得できなくてもブロック -されません。 +関数は、同じ操作を実行しますが、すぐにロックを獲得できない場合には、 +ブロックしません。 .Pp -呼び出しスレッドが呼び出しを行なう時点でロックをすでに取得している -場合、結果は不定になります。 -.Sh システムの注意事項 -書込み側の飢餓状態を避けるため、書込みが読込みより優先されます。 +呼び出しているスレッドが、呼び出しが行なわれたのと同時に既にそのロックを +保持している場合には、その結果は未定義です。 +.Sh 実装に関する注 +書込み側の飢餓状態を防ぐため、書込み側が読込み側よりも優先されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlock_wrlock -関数と +および .Fn pthread_rwlock_trywrlock -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_trywrlock 3 , .Xr pthread_rwlock_unlock 3 , .Xr pthread_rwlock_wrlock 3 .Sh 規格 .Fn pthread_rwlock_wrlock -関数と +および .Fn pthread_rwlock_trywrlock 関数は、 -.St -susv2 -に準拠する見込みです。 +.St -susv2 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlock_trywrlock -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EBUSY -呼び出しスレッドが、ブロックせずにロックを取得できない場合。 +呼び出しているスレッドがブロック無しでロックを獲得できません。 .El .Pp .Fn pthread_rwlock_wrlock -関数と +および .Fn pthread_rwlock_trywrlock -関数は、以下のような場合にエラーとなります。 +関数は、以下の場合に失敗することがあります。 .Bl -tag -width Er .It Bq Er EDEADLK -呼び出しスレッドが、読み書きロック ( 読込み用か書込み用 ) を -すでに取得している場合。 -.It Bq Er EINVAL +呼び出しているスレッドが既にその読取り/書込みロックを (読取り用または +書込み用に) 所有しています。 +.It Bq Er EINVAL .Fa lock -で指定された値が正しくない場合。 +によって指定された値が無効です。 .It Bq Er ENOMEM -メモリが不足しているため、ロックを初期化できない場合 ( 静的に -初期化されるロックのみに適用 ) 。 +ロック (静的に初期化されたロックのみに適用) の初期化のために +十分なメモリがありません .El .Sh 歴史 .Fn pthread_rwlock_wrlock 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlockattr_destroy.3 b/ja_JP.eucJP/man/man3/pthread_rwlockattr_destroy.3 index 983d802b4b..48c799a68d 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlockattr_destroy.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlockattr_destroy.3 @@ -1,66 +1,71 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlockattr_destroy.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_destroy.3,v 1.3.2.1 2000/04/22 16:35:09 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCKATTR_DESTROY 3 .Os .Sh 名称 .Nm pthread_rwlockattr_destroy -.Nd 読み書きロックの破壊 +.Nd 読取り/書込みロックの属性の破壊 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlockattr_destroy "pthread_rwlockattr_t *attr" .Sh 解説 .Fn pthread_rwlockattr_destroy -関数は、 +関数は、以前に .Fn pthread_rwlockattr_init -で以前に作成された読み書きロック属性オブジェクトを破壊します。 +で作成された読取り/書込みロックの属性オブジェクトを破壊します。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlockattr_destroy -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 -.Xr pthread_rwlockattr_init 3 +.Xr pthread_rwlockattr_init 3 .Sh 規格 .Fn pthread_rwlockattr_destroy 関数は、 .St -susv2 -に準拠する見込みです。 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlockattr_destroy -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa attr -で指定された値が正しくない場合。 +によって指定された値が無効です。 .El .Sh 歴史 .Fn pthread_rwlockattr_destroy 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlockattr_getpshared.3 b/ja_JP.eucJP/man/man3/pthread_rwlockattr_getpshared.3 index ef8d6772fb..758f607293 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlockattr_getpshared.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlockattr_getpshared.3 @@ -1,79 +1,84 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlockattr_getpshared.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_getpshared.3,v 1.4.2.2 2001/03/06 16:46:09 ru Exp % .\" .\" $FreeBSD$ -.Dd August 4, 1998 +.Dd March 22, 1999 .Dt PTHREAD_RWLOCKATTR_GETPSHARED 3 .Os .Sh 名称 .Nm pthread_rwlockattr_getpshared -.Nd プロセス共有属性の設定 +.Nd プロセス共有属性の取得 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int -.Fn pthread_rwlockattr_getpshared "pthread_rwlockattr_t *attr" "int *pshared" +.Fn pthread_rwlockattr_getpshared "const pthread_rwlockattr_t *attr" "int *pshared" .Sh 解説 .Fn pthread_rwlockattr_getpshared -関数は、読み書きロック属性オブジェクトのプロセス共有設定を入手します。設定は +関数は、読取り/書込みロックの属性オブジェクトのプロセス共有設定を +取得するために使用されます。 +その設定は .Fa pshared -で戻されますが、以下のうちどちらかの値になります。 -.Bl -hang -offset flag -width 123456789012345678901234 -.It Ar PTHREAD_PROCESS_SHARED -読み書きロックが常駐するメモリにアクセス -できるプロセスのスレッドが、ロックを操作できます。 -.It Ar PTHREAD_PROCESS_PRIVATE -読み書きロックを初期化したスレッドと同じ -プロセスで作成されたスレッドのみが、ロックを操作できます。これが -デフォルト値です。 +を通して返され、以下の 2 つの内の 1 つになります。 +.Bl -tag -width PTHREAD_PROCESS_PRIVATE +.It Dv PTHREAD_PROCESS_SHARED +読取り/書込みロックが属するメモリにアクセスする全てのプロセスの +全てのスレッドは、ロックを操作できます。 +.It Dv PTHREAD_PROCESS_PRIVATE +読取り/書込みロックを初期化したスレッドと同じプロセスの中で作成された +スレッドのみが、ロックを操作できます。 +これがデフォルト値です。 .El .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlockattr_getpshared -関数はゼロを戻します。 -問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_init 3 , .Xr pthread_rwlockattr_setpshared 3 .Sh 規格 .Fn pthread_rwlockattr_getpshared 関数は、 .St -susv2 -に準拠する見込みです。 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlockattr_getpshared -は、以下のような場合にエラー -となります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa attr -で指定された値が正しくない場合。 +によって指定された値が無効です。 .El -.Sh 歴史 +.Sh HISTORY .Fn pthread_rwlockattr_getpshared 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlockattr_init.3 b/ja_JP.eucJP/man/man3/pthread_rwlockattr_init.3 index f595d850ba..85263dd90b 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlockattr_init.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlockattr_init.3 @@ -1,70 +1,71 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlockattr_init.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_init.3,v 1.3.2.1 2000/04/22 16:35:09 phantom Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCKATTR_INIT 3 .Os .Sh 名称 .Nm pthread_rwlockattr_init -.Nd 読み書きロックの初期化 +.Nd 読取り/書込みロックの属性の作成 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_rwlockattr_init "pthread_rwlockattr_t *attr" .Sh 解説 .Fn pthread_rwlockattr_init -関数は、読み書きロック属性オブジェクトを -初期化します。 +関数は、読取り/書込みロックの属性オブジェクトを初期化するために使用されます。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlockattr_init -関数はゼロを戻します。 -問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_destroy 3 , -.Xr pthread_rwlock-attr_getpshared 3 , +.Xr pthread_rwlockattr_getpshared 3 , .Xr pthread_rwlockattr_setpshared 3 .Sh 規格 .Fn pthread_rwlockattr_init 関数は、 -.St -susv2 -に準拠する見込みです。 +.St -susv2 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlockattr_init -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er ENOMEM -メモリが不足しているため、属性オブジェクトを -初期化できない場合。 +属性オブジェクトを初期化するために十分なメモリがありません。 .El -.Pp .Sh 歴史 .Fn pthread_rwlockattr_init 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/pthread_rwlockattr_setpshared.3 b/ja_JP.eucJP/man/man3/pthread_rwlockattr_setpshared.3 index 03f2fff04f..a0511ec732 100644 --- a/ja_JP.eucJP/man/man3/pthread_rwlockattr_setpshared.3 +++ b/ja_JP.eucJP/man/man3/pthread_rwlockattr_setpshared.3 @@ -1,88 +1,90 @@ .\" Copyright (c) 1998 Alex Nash .\" 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. .\" -.\" %Id: pthread_rwlockattr_setpshared.3,v 1.1 1998/09/07 19:01:43 alex Exp % +.\" %FreeBSD: src/lib/libc_r/man/pthread_rwlockattr_setpshared.3,v 1.3.2.2 2001/03/06 16:46:09 ru Exp % .\" .\" $FreeBSD$ .Dd August 4, 1998 .Dt PTHREAD_RWLOCKATTR_SETPSHARED 3 .Os .Sh 名称 .Nm pthread_rwlockattr_setpshared -.Nd プロセス共有属性を設定 +.Nd プロセス共有属性の設定 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int -.Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int *pshared" +.Fn pthread_rwlockattr_setpshared "pthread_rwlockattr_t *attr" "int pshared" .Sh 解説 .Fn pthread_rwlockattr_setpshared 関数は、 .Fa attr のプロセス共有属性を .Fa pshared -が参照する値に設定します。 +によって参照されている値に設定します。 .Fa pshared -は、以下のうちどちらかの -値になります。 -.Bl -hang -offset flag -width 123456789012345678901234 -.It Ar PTHREAD_PROCESS_SHARED -読み書きロックが常駐するメモリにアクセス -できるプロセスのスレッドが、ロックを操作できます。 -.It Ar PTHREAD_PROCESS_PRIVATE -読み書きロックを初期化したスレッドと同じ -プロセスで作成されたスレッドのみが、ロックを操作できます。これが -デフォルト値です。 +は、以下の 2 つの内の 1 つになります。 +.Bl -tag -width PTHREAD_PROCESS_PRIVATE +.It Dv PTHREAD_PROCESS_SHARED +読取り/書込みロックが属するメモリにアクセスする全てのプロセスの +全てのスレッドは、ロックを操作できます。 +.It Dv PTHREAD_PROCESS_PRIVATE +読取り/書込みロックを初期化したスレッドと同じプロセスの中で作成された +スレッドのみが、ロックを操作できます。 +これがデフォルト値です。 .El .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_rwlockattr_setpshared -関数はゼロを戻します。 -問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh 関連項目 .Xr pthread_rwlock_init 3 , .Xr pthread_rwlockattr_init 3 , .Xr pthread_rwlockattr_setpshared 3 .Sh 規格 .Fn pthread_rwlockattr_setpshared 関数は、 .St -susv2 -に準拠する見込みです。 +に適合しているはずです。 .Sh エラー .Fn pthread_rwlockattr_setpshared -は、以下のような場合にエラー -となります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er EINVAL .Fa attr -か +または .Fa pshared -で指定された値が正しくない場合。 +によって指定された値が無効です。 .El .Sh 歴史 .Fn pthread_rwlockattr_setpshared 関数は、 .Fx 3.0 -に追加されました。 +で初めて登場しました。 .Sh バグ -PTHREAD_PROCESS_SHARED 属性はサポートされていません。 +.Dv PTHREAD_PROCESS_SHARED +属性は、サポートされていません。 + diff --git a/ja_JP.eucJP/man/man3/pthread_self.3 b/ja_JP.eucJP/man/man3/pthread_self.3 index 37fc91e902..29ac8d653c 100644 --- a/ja_JP.eucJP/man/man3/pthread_self.3 +++ b/ja_JP.eucJP/man/man3/pthread_self.3 @@ -1,57 +1,62 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_self.3,v 1.4.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_SELF 3 .Os BSD 4 .Sh 名称 .Nm pthread_self -.Nd 呼び出しスレッドの ID の入手 +.Nd 呼び出しているスレッドの ID の取得 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft pthread_t .Fn pthread_self "void" .Sh 解説 .Fn pthread_self -関数は、呼び出しスレッドのスレッド ID を戻します。 +関数は、呼び出しているスレッドのスレッド ID を返します。 .Sh 戻り値 .Fn pthread_self -関数は、呼び出しスレッドのスレッド ID を戻します。 +関数は、呼び出しているスレッドのスレッド ID を返します。 .Sh エラー ありません。 +.Pp .Sh 関連項目 .Xr pthread_create 3 , .Xr pthread_equal 3 .Sh 規格 .Fn pthread_self -は、ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/pthread_setspecific.3 b/ja_JP.eucJP/man/man3/pthread_setspecific.3 index 2bcfde1ed7..0f2cfc0eec 100644 --- a/ja_JP.eucJP/man/man3/pthread_setspecific.3 +++ b/ja_JP.eucJP/man/man3/pthread_setspecific.3 @@ -1,92 +1,98 @@ .\" Copyright (c) 1996 John Birrell . .\" 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 John Birrell. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY JOHN BIRRELL AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc_r/man/pthread_setspecific.3,v 1.6.2.2 2001/03/06 16:46:09 ru Exp % +.\" .\" $FreeBSD$ .Dd April 4, 1996 .Dt PTHREAD_SETSPECIFIC 3 .Os BSD 4 .Sh 名称 .Nm pthread_setspecific -.Nd スレッドに固有なデータ値の設定 +.Nd スレッド固有のデータ値の設定 +.Sh ライブラリ +.Lb libc_r .Sh 書式 .Fd #include .Ft int .Fn pthread_setspecific "pthread_key_t key" "const void *value" .Sh 解説 .Fn pthread_setspecific -関数は、 +関数は、以前の .Fn pthread_key_create -を以前に呼び出して入手した +の呼び出しを通して入手した .Fa key -に、スレッドに固有な値を関連させます。別のスレッドでは、同じキーに -別の値を結び付けられます。この値は、呼び出しスレッドでの使用に予約した、 -ダイナミックに割り振られたメモリのブロックを指すポインタであることが -一般的です。 +に、スレッド固有の値を関連付けます。 +異なるスレッドは同じキーに対して異なる値を、結びつけることができます。 +これらの値は、通常は呼び出しているスレッドによって既に予約されて、 +動的に割り当てられたメモリブロックを指すポインタです。 .Pp .Fn pthread_key_create -で入手していないキー値で、または -.Fn pthread_key_delete -で +から入手したのではない .Fa key -を削除した後で +の値を伴った、または +.Fn pthread_key_delete +によって +.Fa key +が削除された後での、 .Fn pthread_setspecific -を呼び -出すと、結果は不定になります。 +の呼び出しの結果は未定義です。 .Pp .Fn pthread_setspecific -は、スレッドに固有なデータの破壊関数で呼び -出されることがありますが、このように呼び出されると、記憶域が失われたり無限 -ループに陥ったりすることがあります。 +はスレッド固有のデータのデストラクタ関数から呼び出されることがあります。 +しかしながら、これは記憶領域を失ったり、 +無限ループに陥ったりすることがあります。 .Sh 戻り値 -問題がない場合、 +問題がない場合は、 .Fn pthread_setspecific -関数はゼロを戻します。問題がある場合は、そのエラーを示すエラー番号を戻します。 +関数は 0 を返します。 +問題がある場合は、そのエラーを示すためにエラー番号が返されます。 .Sh エラー .Fn pthread_setspecific -は、以下のような場合にエラーとなります。 +は以下の場合に失敗します。 .Bl -tag -width Er .It Bq Er ENOMEM -メモリが不足しているため、値を .Fa key -に関連させられない場合。 +と関連付けるための値の十分なメモリがありません。 .It Bq Er EINVAL .Fa key -の値が正しくない場合。 +の値が無効です。 .El .Pp .Sh 関連項目 .Xr pthread_getspecific 3 , .Xr pthread_key_create 3 , .Xr pthread_key_delete 3 .Sh 規格 .Fn pthread_setspecific -は、ISO/IEC 9945-1 ANSI/IEEE -.Pq Dq Tn POSIX -Std 1003.1 Second Edition 1996-07-12 に準拠しています。 +は +.St -p1003.1-96 +に適合しています。 + diff --git a/ja_JP.eucJP/man/man3/rint.3 b/ja_JP.eucJP/man/man3/rint.3 index 52ee0ebace..0a430592e7 100644 --- a/ja_JP.eucJP/man/man3/rint.3 +++ b/ja_JP.eucJP/man/man3/rint.3 @@ -1,71 +1,70 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)rint.3 5.1 (Berkeley) 5/2/91 -.\" %Id: rint.3,v 1.5 1997/02/22 15:09:40 peter Exp % +.\" %FreeBSD: src/lib/msun/man/rint.3,v 1.6 1999/08/28 00:06:23 peter Exp % .\" .\" $FreeBSD$ .Dd March 10, 1994 .Dt RINT 3 .Os .Sh 名称 .Nm rint , .Nm rintf -.Nd 浮動小数点形式で整数値に丸める +.Nd 浮動小数点形式で整数値への丸め .Sh 書式 .Fd #include .Ft double .Fn rint "double x" .Ft float .Fn rintf "float x" .Sh 解説 .Fn rint -関数と +および .Fn rintf -関数は、現行の丸めモードに従い、 -.Fa x -に最も近い整数値 -( -倍精度数値か浮動精度数値として表現 -) -を戻します。 +関数は、広く行なわれている丸め方法に従って、 +(倍精度数または単精度数として表現される) +.Fa x +に最も近い整数値を返します。 .Sh 関連項目 .Xr abs 3 , .Xr ceil 3 , .Xr fabs 3 , .Xr floor 3 , .Xr ieee 3 , .Xr math 3 .Sh 歴史 .Fn rint 関数は、 .At v6 で登場しました。 + + diff --git a/ja_JP.eucJP/man/man3/setlocale.3 b/ja_JP.eucJP/man/man3/setlocale.3 index 4cdf5127ec..36bf5a9326 100644 --- a/ja_JP.eucJP/man/man3/setlocale.3 +++ b/ja_JP.eucJP/man/man3/setlocale.3 @@ -1,337 +1,311 @@ .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Donn Seeley at BSDI. .\" .\" 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. .\" .\" @(#)setlocale.3 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/lib/libc/locale/setlocale.3,v 1.15.2.2 2001/03/06 16:45:58 ru Exp % .\" .\" $FreeBSD$ .Dd June 9, 1993 .Dt SETLOCALE 3 .Os .Sh 名称 .Nm setlocale , .Nm localeconv -.Nd C 用の自然言語をフォーマットする +.Nd C 用の自然言語の整形 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn setlocale "int category" "const char *locale" .Ft struct lconv * .Fn localeconv "void" .Sh 解説 .Fn setlocale -関数は、特定のルーチンのセットに関して、 -C -ライブラリにとっての -自然言語フォーマットスタイルの概念を設定します。 -このような各スタイル -は +関数は、特定のルーチンの集合について、C ライブラリでいうところの +自然言語整形のスタイルを設定します。 +それぞれのスタイルを .Sq ロケール -と呼ばれ、 -C -文字列として渡される適切な名前を使用して呼び出されます。 +と呼び、C 文字列として渡される適切な名前によって呼び出します。 .Fn localeconv -ルーチンは、現在のロケールの -数値フォーマット用パラメータを返します。 +ルーチンは、現在のロケールの数値整形用パラメータを返します。 .Pp .Fn setlocale -関数は、ルーチンに関する複数のカテゴリを識別します。 -以下は、カテゴリとカテゴリが選択したルーチンのセットです。 +関数は、いくつかのルーチンのカテゴリを識別します。 +以下は、カテゴリとカテゴリが選択したルーチンの組です。 .Pp .Bl -tag -width LC_MONETARY .It Dv LC_ALL -ロケール全体を一般的に設定します。 +ロケール全体をまとめて設定します。 .It Dv LC_COLLATE -文字列照合ルーチン用にロケールを設定します。これは +文字列照合ルーチン用のロケールを設定します。これは .Fn strcoll -と +および .Fn strxfrm でのアルファベット順を制御します。 .It Dv LC_CTYPE .Xr ctype 3 , .Xr mbrune 3 , .Xr multibyte 3 および .Xr rune 3 の各関数のロケールを設定します。 これは、大文字と小文字、アルファベットと非アルファベット文字 などの識別を制御します。実際の作業は .Fn setrunelocale 関数によって行われます。 .It Dv LC_MESSAGES メッセージカタログのロケールを設定します。 .Xr catopen 3 関数を参照してください。 .It Dv LC_MONETARY -通貨値のフォーマット用ロケールを設定します。これは +通貨値の整形用ロケールを設定します。これは .Fn localeconv 関数に影響を及ぼします。 .It Dv LC_NUMERIC -数字をフォーマットするためのロケールを設定します。これは、 +数字を整形するためのロケールを設定します。これは、 +.Fn localeconv +によって返される値を制御するのに加えて、 .Fn printf -と +および .Fn scanf -のような関数の浮動小数点入出力の小数点フォーマットを -制御します。 -.Fn localeconv -によって返される値も制御します。 +のような関数の浮動小数点入出力の小数点整形方法も制御します。 .It Dv LC_TIME .Fn strftime -関数を使用して日付と時刻をフォーマットするための -ロケールを設定します。 +関数を使用して日付と時刻を整形するためのロケールを設定します。 .El .Pp -デフォルトでは -3 -つのロケールだけが定義されています。空の文字列 +デフォルトでは 3 つのロケールだけが定義されています。空の文字列 .Li "\&""\|"" -はネイティブの環境を表記します。そして +はネイティブの環境を表します。そして .Li "\&""C"" および .Li "\&""POSIX"" -ロケール、これは -C -言語環境を表記します。 +ロケールは C 言語環境を表します。 .Fa locale 引数が .Dv NULL -の場合、 +の場合には、 .Fn setlocale -は現在のロケールを戻します。デフォルトでは、 -C -プログラムは +は現在のロケールを戻します。デフォルトでは、 C プログラムは .Li "\&""C"" ロケールで開始します。ロケールを設定する唯一のライブラリ内関数は .Fn setlocale -です。 -ロケールは他のルーチンの副作用として変更されることはありません。 +です。ロケールは他のルーチンの副作用として変更されることはありません。 .Pp .Fn localeconv -関数は、数字、特に通貨値のフォーマット用パラメータを +関数は、数字、特に通貨値の整形用パラメータを 提供する構造体を指すポインタを返します。 .Bd -literal -offset indent struct lconv { char *decimal_point; char *thousands_sep; char *grouping; char *int_curr_symbol; char *currency_symbol; char *mon_decimal_point; char *mon_thousands_sep; char *mon_grouping; char *positive_sign; char *negative_sign; char int_frac_digits; char frac_digits; char p_cs_precedes; char p_sep_by_space; char n_cs_precedes; char n_sep_by_space; char p_sign_posn; char n_sign_posn; }; .Ed .Pp 個々のフィールドには次の意味があります。 .Pp .Bl -tag -width mon_decimal_point .It Fa decimal_point -小数点文字。通貨値は除きます。 +通貨値を除く、小数点文字です。 .It Fa thousands_sep -小数点の前の数字のグループ間の分離記号。通貨値は除きます。 +通貨値を除く、小数点の前の桁のグループ間の区切り文字です。 .It Fa grouping -数字のグループのサイズ。通貨値は除きます。 -これは、整数のベクトルを指すポインタです。各整数のサイズは +通貨値を除く、桁のグループの大きさです。 +これは、 .Va char -であり、低い位の数字から高い位の数字 -( -右から左 -) -までのグループのサイズを表します。リストは、 -0 -または +型の、低い位の桁から高い位の桁 (右から左) までのグループの大きさを表す +整数の配列を指すポインタです。 +そのリストは、0 または .Dv CHAR_MAX -で終了できます。リストが -0 -で終了する場合、 -0 -の前の最後のグループサイズは、すべての数字を埋めるために反復されます。 -リストが +で終わります。リストが 0 で終了する場合には、0 の前の最後のグループの +大きさを、全ての桁が埋まるまで繰り返し用います。 .Dv CHAR_MAX -で終了される場合、それ以上のグループ化は実行されません。 +で終了する場合には、それ以上のグループ化は実行されません。 .It Fa int_curr_symbol -標準化された国際通貨シンボル +標準で定められた国際通貨記号です。 .It Fa currency_symbol -ローカルな通貨シンボル +ローカルな通貨記号です。 .It Fa mon_decimal_point -通貨値に対する小数点文字 +通貨値に対する小数点文字です。 .It Fa mon_thousands_sep -通貨値内の数字グループについての分離記号 +通貨値内の桁のグループについての区切り文字です。 .It Fa mon_grouping .Fa grouping -に類似していますが、通貨用 +に類似していますが、通貨用です。 .It Fa positive_sign -非負の通貨値を表記するのに使用される文字。 -通常は空の文字列 +非負の通貨値を表記するのに使用される文字で、通常は空の文字列です。 .It Fa negative_sign -負の通貨値を表現するのに使用される文字。 -通常はマイナス符号 +負の通貨値を表現するのに使用される文字で、 +通常はマイナス符号です。 .It Fa int_frac_digits -国際スタイルの通貨値における小数点以下の桁数 +国際スタイルの通貨値における小数点以下の桁数です。 .It Fa frac_digits -ローカルスタイルの通貨値における小数点以下の桁数 +ローカルスタイルの通貨値における小数点以下の桁数です。 .It Fa p_cs_precedes -非負の値に対して通貨値の前に通貨シンボルが置かれる場合は -1 -、通貨シンボルが通貨値の後に続く場合は -0 +非負の値に対して通貨値の前に通貨記号が置かれる場合には 1、 +そうでない場合には 0 です。 .It Fa p_sep_by_space -非負の値について通貨シンボルと通貨値の間に -空白が挿入されている場合は -1 、そうでない場合は -0 +非負の値に対して通貨記号と通貨値の間に空白が挿入されている場合は 1、 +そうでない場合には 0 です。 .It Fa n_cs_precedes -負の値について +負の値に対して .Fa p_cs_precedes -と同様 +と同様です。 .It Fa n_sep_by_space -負の値について +負の値に対して .Fa p_sep_by_space -と同様 +と同様です。 .It Fa p_sign_posn 非負の量および .Fa currency_symbol に関する .Fa positive_sign -の位置。コードは次のとおり。 +の位置です。コードは次の通りです。 .Bl -tag -width 3n -compact .It Li 0 -文字列全体を囲む丸括弧 +文字列全体を囲む丸括弧です。 .It Li 1 -文字列の前 +文字列の前です。 .It Li 2 -文字列の後 +文字列の後です。 .It Li 3 .Fa currency_symbol -の直前 +の直前です。 .It Li 4 .Fa currency_symbol -の直後 +の直後です。 .El .It Fa n_sign_posn -負の通貨値について +負の通貨値に対して .Fa p_sign_posn -と同様 +と同様です。 .El .Pp 前述した場合を除いて、フィールドの値としての空の文字列は、 結果の長さがゼロであるか、または現在のロケール内にはない値で あることを示します。 同様に .Dv CHAR_MAX の結果は利用できない値を表記します。 .Sh 戻り値 .Fn setlocale 関数は、指定の .Fa category と .Fa locale -の組み合わせが意味をなさない場合は +の組み合わせが意味をなさない場合には、 .Dv NULL -を返してロケールを変更するのに失敗します。 +を返してロケールの変更は失敗します。 .Fn localeconv 関数は、後の .Fn setlocale または .Fn localeconv -への呼び出しで変更される可能性のある静的オブジェクトを指す -ポインタを返します。 +の呼び出しで変更される可能性のある静的オブジェクトを指すポインタを返します。 .Sh ファイル .Bl -tag -width /usr/share/locale/locale/category -compact .It Pa $PATH_LOCALE/ Ns Em locale/category .It Pa /usr/share/locale/ Ns Em locale/category ロケール .Em locale とカテゴリ .Em category 用のロケールファイル .El .Sh 関連項目 .Xr colldef 1 , .Xr mklocale 1 , .Xr catopen 3 , .Xr ctype 3 , .Xr mbrune 3 , .Xr multibyte 3 , .Xr rune 3 , .Xr strcoll 3 , .Xr strxfrm 3 , .Xr euc 4 , .Xr utf2 4 .Sh 規格 .Fn setlocale -関数と +および .Fn localeconv -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 .Sh 歴史 .Fn setlocale -関数と +および .Fn localeconv -関数は最初に +関数は、 .Bx 4.4 -に登場しました。 +で初めて登場しました。 .Sh バグ -現時点では、 +現在の実装は、 .Dv LC_COLLATE , .Dv LC_CTYPE および .Dv LC_TIME -の各カテゴリ以外では、 +のカテゴリ以外では、 .Li "\&""C"" と .Li "\&""POSIX"" -ロケールだけしかサポートされていません。 +ロケールのみサポートしています。 .Pp .Fn localeconv における整然としない通貨サポートにも関わらず、規格は、 一般化された通貨フォーマットのための関数を組み入れていません。 .Pp われわれがリアルタイムの通貨変換機能を持つまでは、 .Dv LC_MONETARY の使用は間違った結果を導く可能性があります。 .Dv LC_NUMERIC -と +および .Dv LC_TIME -は個人的な選択肢であり、他のカテゴリでおおい隠すことはしないでください。 +は個人的な選択肢であり、他のカテゴリで覆い隠すべきではありません。 diff --git a/ja_JP.eucJP/man/man3/sin.3 b/ja_JP.eucJP/man/man3/sin.3 index 56328564a3..a1e94d3301 100644 --- a/ja_JP.eucJP/man/man3/sin.3 +++ b/ja_JP.eucJP/man/man3/sin.3 @@ -1,79 +1,80 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" @(#)sin.3 6.7 (Berkeley) 4/19/91 .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)sin.3 6.7 (Berkeley) 4/19/91 -.\" %Id: sin.3,v 1.5 1997/02/22 15:09:40 peter Exp % +.\" %FreeBSD: src/lib/msun/man/sin.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd April 19, 1991 .Dt SIN 3 .Os .Sh 名称 .Nm sin , .Nm sinf .Nd 正弦関数 .Sh 書式 .Fd #include .Ft double .Fn sin "double x" .Ft float .Fn sinf "float x" .Sh 解説 .Fn sin -関数と +および .Fn sinf -関数は、 -.Fa x -(ラジアン単位)の正弦を計算します。 -引数の大きさがあまりに大きいと、少ししか意味がないか、 -まったく意味のない結果が出されることになります。 +関数は、(ラジアンで計測された) +.Fa x +の正弦を計算します。 +大きな引数は、ほとんどまたは全く意味のない結果を生じることがあります。 .Sh 戻り値 .Fn sin -関数と +および .Fn sinf -関数は正弦値を返します。 +関数は、正弦の値を返します。 .Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh 規格 .Fn sin -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/sinh.3 b/ja_JP.eucJP/man/man3/sinh.3 index 9dcba68ff1..1bc0f41b7a 100644 --- a/ja_JP.eucJP/man/man3/sinh.3 +++ b/ja_JP.eucJP/man/man3/sinh.3 @@ -1,83 +1,85 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)sinh.3 6.6 (Berkeley) 4/19/91 -.\" %Id: sinh.3,v 1.5 1997/02/22 15:09:41 peter Exp % +.\" %FreeBSD: src/lib/msun/man/sinh.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" $FreeBSD$ .Dd April 19, 1991 .Dt SINH 3 .Os .Sh 名称 .Nm sinh , .Nm sinhf -.Nd 双曲線正弦関数 +.Nd 双曲正弦関数 .Sh 書式 .Fd #include .Ft double .Fn sinh "double x" .Ft float .Fn sinhf "float x" .Sh 解説 +The .Fn sinh -関数と +および .Fn sinhf -関数は -.Fa x -の双曲線正弦を計算します。 +関数は、 +.Fa x +の双曲正弦を計算します。 .Sh 戻り値 .Fn sinh -関数と +および .Fn sinhf -関数は双曲線正弦値を返します。ただし、 +関数は、 .Fa x -があまりに -大きい場合は除きます。この場合、グローバル変数 +の大きさが大きすぎる場合以外は、双曲正弦を返します。 +大きすぎる場合は、グローバル変数 .Va errno が .Er ERANGE -に -設定されます。 +に設定されます。 .Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr tan 3 , .Xr tanh 3 .Sh 規格 .Fn sinh -関数は -.St -ansiC -に準拠しています。 +関数は、 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/sqrt.3 b/ja_JP.eucJP/man/man3/sqrt.3 index bc378f4469..e601f16ab2 100644 --- a/ja_JP.eucJP/man/man3/sqrt.3 +++ b/ja_JP.eucJP/man/man3/sqrt.3 @@ -1,134 +1,128 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)sqrt.3 6.4 (Berkeley) 5/6/91 -.\" %Id: sqrt.3,v 1.5 1997/02/22 15:09:42 peter Exp % +.\" %FreeBSD: src/lib/msun/man/sqrt.3,v 1.6.2.2 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 6, 1991 .Dt SQRT 3 .Os .Sh 名称 .Nm cbrt , .Nm cbrtf , .Nm sqrt , .Nm sqrtf -.Nd 立方根関数と平方根関数 -.Sh 書式 +.Nd 立方根および平方根関数 +.Sh SYNOPSIS .Fd #include .Ft double .Fn cbrt "double x" .Ft float .Fn cbrtf "float x" .Ft double .Fn sqrt "double x" .Ft float .Fn sqrtf "float x" .Sh 解説 .Fn cbrt -関数と +および .Fn cbrtf -関数は +関数は、 .Ar x の立方根を計算します。 .Pp .Fn sqrt -関数と +および .Fn sqrtf -関数は、 +関数は、非負の .Ar x -の負でない平方根を計算します。 +の平方根を計算します。 .Sh 戻り値 .Fn cbrt -関数と +および .Fn cbrtf 関数は、要求された立方根を返します。 .Fn sqrt -関数と +および .Fn sqrtf -関数は、エラーが発生した場合を除いて、要求された平方根を返します。 +関数は、エラーが発生しなければ、要求された平方根を返します。 .Tn VAX -または +および .Tn Tahoe -プロセッサは、負の +では、負の .Fa x の .Fn sqrt -を取ろうとするとエラーが発生します。この場合、 -グローバル変数 +を取ることの試みは、エラーを引き起こします。 +この場合には、グローバル変数 .Va errno -が -.Dv EDOM -に設定され、予備のオペランド障害が生成されます。 -.Sh エラー (切り捨てなどによるもの) +を +.Er EDOM +に設定し、予約されたオペランドフォルトが生成されます。 +.Sh エラー (丸めなどによるもの) .Fn cbrt -関数は、 -0.7 +関数は、0.7 .Em ulp -まで正確です。 +の範囲内で正確です。 .Pp .Tn VAX 上の .Fn sqrt -関数は -0.501 +関数は、0.501 .Em ulp -内まで正確です。 +の範囲内で正確です。 .Tn IEEE -754 に準拠するマシン上の -.\" .Fn sqrt -sqrt は、実施中の丸めモードに従って正確に丸められます。エラー -は、デフォルトモード(四捨五入)で +754 に適合しているマシン上の sqrt は、実施中の丸め方法に従って、 +正確に丸められます。 +その誤差は、デフォルトの方法 (四捨五入) では、 .Em ulp の半分未満です。 .Em ulp -は、実行された -最後の場所の単位 -( +とは、最後に繰り上げられた位置の位 ( .Em U Ns nit in the .Em L Ns ast -.Em P Ns lace -) -です。 +.Em P Ns lacce +) です。 .Sh 関連項目 .Xr math 3 -.Pp .Sh 規格 -.Nm sqrt -関数は -.St -ansiC -に準拠しています。 +.Fn sqrt +関数は、 +.St -isoC +に適合しています。 .Sh 歴史 .Fn cbrt -関数は +関数は、 .Bx 4.3 -で現れました。 +で登場しました。 + diff --git a/ja_JP.eucJP/man/man3/strcasecmp.3 b/ja_JP.eucJP/man/man3/strcasecmp.3 index 9bd3a29b4f..57f21b1b3e 100644 --- a/ja_JP.eucJP/man/man3/strcasecmp.3 +++ b/ja_JP.eucJP/man/man3/strcasecmp.3 @@ -1,88 +1,92 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" 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. .\" .\" @(#)strcasecmp.3 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/lib/libc/string/strcasecmp.3,v 1.6.2.1 2000/04/22 17:06:39 phantom Exp % .\" .\" $FreeBSD$ .\" .Dd June 9, 1993 .Dt STRCASECMP 3 .Os .Sh 名称 .Nm strcasecmp , .Nm strncasecmp .Nd 大文字小文字を無視した文字列の比較 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn strcasecmp "const char *s1" "const char *s2" .Ft int .Fn strncasecmp "const char *s1" "const char *s2" "size_t len" .Sh 解説 .Fn strcasecmp および .Fn strncasecmp -関数は、ナル文字で終了する文字列 +関数は、ヌル文字で終了する文字列 .Fa s1 および .Fa s2 を比較して、それぞれの文字を小文字に変換した後に .Fa s1 が .Fa s2 -よりも辞書学的に大きいか、等しいか、あるいは小さいかに応じて、 +よりも辞書式順序で大きいか、等しいか、あるいは小さいかに応じて、 それぞれ、0 より大きい、0 に等しい、 あるいは 0 より小さい整数を返します。 文字列自体は修正されません。比較は、 .Sq Li \e200 が .Ql \e0 -よりも大きくなるように、符号なしキャラクタを使って行います。 +よりも大きくなるように、unsigned char を使って行います。 .Pp .Fn strncasecmp は、最大で .Fa len 個の文字を比較します。 .Sh 参照 .Xr bcmp 3 , .Xr memcmp 3 , .Xr strcmp 3 , .Xr strcoll 3 , -.Xr strxfrm 3 +.Xr strxfrm 3 , +.Xr tolower 3 .Sh 歴史 .Fn strcasecmp および .Fn strncasecmp -関数は、最初に +関数は、 .Bx 4.4 -に現れました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man3/strcat.3 b/ja_JP.eucJP/man/man3/strcat.3 index 31d582dd90..e53b3f0050 100644 --- a/ja_JP.eucJP/man/man3/strcat.3 +++ b/ja_JP.eucJP/man/man3/strcat.3 @@ -1,93 +1,98 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strcat.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strcat.3,v 1.5.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt STRCAT 3 .Os .Sh 名称 .Nm strcat .Nd 文字列の連結 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strcat "char *s" "const char *append" .Ft char * .Fn strncat "char *s" "const char *append" "size_t count" .Sh 解説 .Fn strcat および .Fn strncat -関数は、ナル文字で終了する文字列 +関数は、ヌル文字で終了する文字列 .Fa append -をナル文字で終了する文字列 +をヌル文字で終了する文字列 .Fa s の終わりに追加し、次に終端の .Ql \e0 を追加します。文字列 .Fa s は、結果を保持するのに十分なスペースを持っていなければなりません。 .Pp .Fn strncat 関数は、 .Fa append から .Fa count を超えない数の文字を追加し、次に終端の .Ql \e0 を追加します。 .Sh 戻り値 .Fn strcat および .Fn strncat 関数は、ポインタ .Fa s を返します。 .Sh 参照 .Xr bcopy 3 , .Xr memccpy 3 , .Xr memcpy 3 , .Xr memmove 3 , -.Xr strcpy 3 +.Xr strcpy 3 , +.Xr strlcat 3 , +.Xr strlcpy 3 .Sh 規格 .Fn strcat および .Fn strncat 関数は、 -.St -ansiC -準拠しています。 +.St -isoC +適合しています。 diff --git a/ja_JP.eucJP/man/man3/strchr.3 b/ja_JP.eucJP/man/man3/strchr.3 index 73775bc612..14019976a2 100644 --- a/ja_JP.eucJP/man/man3/strchr.3 +++ b/ja_JP.eucJP/man/man3/strchr.3 @@ -1,85 +1,86 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strchr.3 8.2 (Berkeley) 4/19/94 +.\" %FreeBSD: src/lib/libc/string/strchr.3,v 1.4.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd April 19, 1994 .Dt STRCHR 3 .Os .Sh 名称 .Nm strchr .Nd 文字列中の文字を検索 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strchr "const char *s" "int c" .Sh 解説 .Fn strchr 関数は、 .Ar s によって指される文字列の中で最初に出会う文字 .Ar c -を見つけます。終端のナル文字は、文字列の一部とみなします。 +を見つけます。終端のヌル文字は、文字列の一部とみなします。 .Fa c が .Ql \e0 である場合は、 .Fn strchr は終端の .Ql \e0 を見つけます。 .Sh 戻り値 関数 .Fn strchr は、見つけた文字へのポインタか、 -または文字が文字列中に見つからない場合はヌルを返します。 +または文字が文字列中に見つからない場合は NULL を返します。 .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strcspn 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strchr 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strcmp.3 b/ja_JP.eucJP/man/man3/strcmp.3 index 0c85f8f47b..8524e17626 100644 --- a/ja_JP.eucJP/man/man3/strcmp.3 +++ b/ja_JP.eucJP/man/man3/strcmp.3 @@ -1,94 +1,97 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strcmp.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strcmp.3,v 1.6.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ -,\" +.\" .Dd June 4, 1993 .Dt STRCMP 3 .Os .Sh 名称 .Nm strcmp , .Nm strncmp , .Nd 文字列の比較 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn strcmp "const char *s1" "const char *s2" .Ft int .Fn strncmp "const char *s1" "const char *s2" "size_t len" .Sh 解説 .Fn strcmp および .Fn strncmp -関数は、ナル文字で終了する文字列 +関数は、ヌル文字で終了する文字列 .Fa s1 および .Fa s2 -を辞書学的に比較します。 +を辞書式順序で比較します。 .Sh 戻り値 .Fn strcmp および .Fn strncmp は、 .Fa s1 が .Fa s2 よりも大きいか、等しいか、あるいは小さいかに応じて、 それぞれ 0 よりも大きい、0 に等しい、 あるいは 0 よりも小さい整数を返します。比較は、 .Ql \e200 が .Ql \e0 -よりも大きくなるように、符号なしキャラクタを使って行います。 +よりも大きくなるように、unsigned char を使って行います。 .Pp .Fn strncmp は、 .Fa len を超えない数の文字を比較します。 .Sh 参照 .Xr bcmp 3 , .Xr memcmp 3 , .Xr strcasecmp 3 , .Xr strcoll 3 , .Xr strxfrm 3 .Sh 規格 .Fn strcmp および .Fn strncmp 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strcoll.3 b/ja_JP.eucJP/man/man3/strcoll.3 index e4daa8eef1..0e4b372eb2 100644 --- a/ja_JP.eucJP/man/man3/strcoll.3 +++ b/ja_JP.eucJP/man/man3/strcoll.3 @@ -1,73 +1,76 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strcoll.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strcoll.3,v 1.8.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt STRCOLL 3 .Os .Sh 名称 .Nm strcoll .Nd 現在の照合に従って文字列を比較 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn strcoll "const char *s1" "const char *s2" .Sh 解説 .Fn strcoll -関数は、ナル文字で終了する文字列 +関数は、ヌル文字で終了する文字列 .Fa s1 と .Fa s2 -を現在のロケールの照合とするものがあれば、 -それに従って辞書学的に比較し、ない場合には +を現在ロケールにおいて照合とするものがあれば、 +それに従って辞書式順序で比較し、ない場合には .Fa strcmp を呼び出して、 .Fa s1 が .Fa s2 よりも大きいか、等しいか、小さいかによってそれぞれ、 0 よりも大きい、または等しい、または小さい整数を返します。 .Sh 参照 .Xr setlocale 3 , .Xr strcmp 3 , .Xr strxfrm 3 .Sh 規格 .Fn strcoll 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strcpy.3 b/ja_JP.eucJP/man/man3/strcpy.3 index 5c74a46b27..24298becce 100644 --- a/ja_JP.eucJP/man/man3/strcpy.3 +++ b/ja_JP.eucJP/man/man3/strcpy.3 @@ -1,118 +1,122 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strcpy.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strcpy.3,v 1.4.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt STRCPY 3 .Os BSD 4 .Sh 名称 .Nm strcpy .Nd 文字列のコピー +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strcpy "char *dst" "const char *src" .Ft char * .Fn strncpy "char *dst" "const char *src" "size_t len" .Sh 解説 .Fn strcpy および .Fn strncpy 関数は、文字列 .Fa src を .Fa dst にコピーします (終端の .Ql \e0 文字を含めて)。 .Pp .Fn strncpy は、 .Fa len 個以上の文字は .Fa dst にコピーせず、 .Fa src の長さが .Fa len 文字以下の場合には .Ql \e0 文字を追加します。また、 .Fa src の長さが .Fa len 文字以上である場合は、 .Fa dst -を終端しません。 +を終了させません。 .Sh 戻り値 .Fn strcpy および .Fn strncpy 関数は、 .Fa dst を返します。 .Sh 例 次の行は、 .Dq Li chararray を .Dq Li abc\e0\e0\e0 に設定します : .Bd -literal -offset indent (void)strncpy(chararray, "abc", 6). .Ed .Pp -次の行はは、 +次の行は、 .Dq Li chararray を .Dq Li abcdef に設定します : .Bd -literal -offset indent (void)strncpy(chararray, "abcdefgh", 6); .Ed .Sh 参照 .Xr bcopy 3 , .Xr memccpy 3 , .Xr memcpy 3 , -.Xr memmove 3 +.Xr memmove 3 , +.Xr strlcpy 3 .Sh 規格 .Fn strcpy および .Fn strncpy 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strcspn.3 b/ja_JP.eucJP/man/man3/strcspn.3 index 7e94571ede..32b70f23c5 100644 --- a/ja_JP.eucJP/man/man3/strcspn.3 +++ b/ja_JP.eucJP/man/man3/strcspn.3 @@ -1,79 +1,84 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strcspn.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strcspn.3,v 1.3.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt STRCSPN 3 .Os .Sh 名称 .Nm strcspn -.Nd 文字列の補集合をスパン +.Nd 文字列の補集合の長さを測る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft size_t .Fn strcspn "const char *s" "const char *charset" .Sh 解説 .Fn strcspn -関数は、ナル文字で終了する文字列 +関数は、ヌル文字で終了する文字列 .Fa s -の文字が文字列 +から文字列 .Fa charset -の中に現れるまで、その文字列の最初の部分をスパンします +にない文字列の長さだけ +.Fa s +の最初の部分の長さを測ります .Fa ( charset -の補集合をスパンします)。 +の +.Em 補集合 +の長さを測ります)。 .Pp .Sh 戻り値 .Fn strcspn -関数はスパンされた文字の数を返します。 +関数は測られた文字の数を返します。 .Pp .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strcspn 関数は -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strdup.3 b/ja_JP.eucJP/man/man3/strdup.3 index b97c6ddbc5..91583acfa3 100644 --- a/ja_JP.eucJP/man/man3/strdup.3 +++ b/ja_JP.eucJP/man/man3/strdup.3 @@ -1,64 +1,66 @@ .\" Copyright (c) 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. .\" .\" @(#)strdup.3 8.1 (Berkeley) 6/9/93 -.\" %Id: strdup.3,v 1.6 1997/02/22 15:03:27 peter Exp % +.\" %FreeBSD: src/lib/libc/string/strdup.3,v 1.7.2.1 2000/04/22 17:06:40 phantom Exp % .\" .\" $FreeBSD$ .\" .Dd June 9, 1993 .Dt STRDUP 3 .Os .Sh 名称 .Nm strdup .Nd 文字列のコピーを保存 +.Sh ライブラリ +.Lb libc .Sh 書式 -.Fd #include +.Fd #include .Ft char * .Fn strdup "const char *str" .Sh 解説 .Fn strdup 関数は、文字列 .Fa str -のコピーのために十分なメモリを割り振り、コピーを行い、 -コピーへのポインタを返します。ポインタはその後に関数 +のコピーのために十分なメモリを割り当て、コピーを行い、 +コピーへのポインタを返します。ポインタは後で関数 .Xr free 3 -の引数として使うことができます。 +の引数として使ってください。 .Pp -十分なメモリが使用できない場合は、ヌルを返します。 +利用可能なメモリが十分ではない場合、NULL を返します。 .Sh 参照 .Xr free 3 , .Xr malloc 3 .Sh 歴史 .Fn strdup -関数は最初に +関数は、 .Bx 4.4 -に現れました。 +ではじめて登場しました。 diff --git a/ja_JP.eucJP/man/man3/strerror.3 b/ja_JP.eucJP/man/man3/strerror.3 index 6f1ffac432..0b57830b29 100644 --- a/ja_JP.eucJP/man/man3/strerror.3 +++ b/ja_JP.eucJP/man/man3/strerror.3 @@ -1,116 +1,119 @@ .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)strerror.3 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/lib/libc/string/strerror.3,v 1.7.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 9, 1993 .Dt STRERROR 3 .Os BSD 4 .Sh 名称 .Nm perror , .Nm strerror , .Nm sys_errlist , .Nm sys_nerr .Nd システムのエラーメッセージ +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn perror "const char *string" -.Vt extern const char * const sys_errlist[]; -.Vt extern const int sys_nerr; +.Vt extern const char * const sys_errlist[] ; +.Vt extern const int sys_nerr ; .Fd #include .Ft char * .Fn strerror "int errnum" .Sh 解説 .Fn strerror および .Fn perror 関数は、エラー番号に対応するエラーメッセージ文字列を探し出します。 .Pp .Fn strerror 関数は、エラー番号の引数 .Fa errnum を受け取って、それに対応するメッセージ文字列へのポインタを返します。 .Pp .Fn perror 関数は、大域変数 .Va errno .Pq Xr intro 2 の現在の値に対応するエラーメッセージを探して、 それに改行をつけて標準エラーファイル記述子に書込みます。引数 .Fa string -が非ヌルであり、ナル文字を指さない場合は、 +が非ヌルであり、ヌル文字を指さない場合は、 この文字列はメッセージ文字列の前にコロンとスペース -.Pq Ql \&:\ \& +.Pq Ql \&:\ \& ; で区切って追加されます。 それ以外の場合は、エラーメッセージ文字列のみが印字されます。 .Pp .Fa errnum がエラー番号として認識できない場合は、 エラーメッセージ文字列は -.Dq Li "Unknown error:\0 +.Dq Li "Unknown error:\ " の後に 10 進数のエラー番号が続いたものとなります。 .Pp メッセージ文字列には、外部配列 .Va sys_errlist を使って直接アクセスすることができます。外部値 .Va sys_nerr には .Va sys_errlist の中にあるメッセージのカウントが入っています。 -これらの変数を使用することには賛成できません。代りに、 +これらの変数を使用することには賛成できません。代わりに、 .Fn strerror を使った方がよいでしょう。 .Sh 参照 .Xr intro 2 , .Xr psignal 3 .Sh 歴史 .Fn strerror および .Fn perror -関数は、最初に +関数は、 .Bx 4.4 -に現れました。 +で初めて登場しました。 .Sh バグ 認識できないエラー番号に対しては、 .Fn strerror 関数はその結果を静的バッファに返し、 それは以降の呼び出しによって上書きされる可能性があります。 .Pp .Va sys_errlist 変数を使用している好ましくないプログラムは、 その変数を一貫性なく宣言するために失敗することがしばしばあります。 diff --git a/ja_JP.eucJP/man/man3/strftime.3 b/ja_JP.eucJP/man/man3/strftime.3 index 84175f2d6d..88673f5fcc 100644 --- a/ja_JP.eucJP/man/man3/strftime.3 +++ b/ja_JP.eucJP/man/man3/strftime.3 @@ -1,240 +1,254 @@ .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)strftime.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdtime/strftime.3,v 1.18.2.6 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd October 4, 1997 .Dt STRFTIME 3 .Os .Sh 名称 .Nm strftime .Nd 日付と時間をフォーマット +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft size_t .Fn strftime "char *buf" "size_t maxsize" "const char *format" "const struct tm *timeptr" .Sh 解説 .Fn strftime 関数は、 .Fa timeptr からの情報を .Fa format によって指される文字列に従ってバッファ .Fa buf にフォーマットします。 .Pp .Fa format -文字列は、ゼロ以上の変換仕様および通常の文字から構成されます。 +文字列は、0 以上の変換指定および通常の文字から構成されます。 すべての通常文字は、直接バッファにコピーされます。 -変換仕様は、パーセント記号 +変換指定は、パーセント記号 .Dq Ql % ともう 1 つの文字から構成されます。 .Pp 配列には .Fa maxsize 個を超えない文字が置かれます。 -結果として生じる文字の総数が終端のナル文字を含めて +結果として生じる文字の総数が終端のヌル文字を含めて .Fa maxsize を超えない場合は、 .Fn strftime -は終端のナルを数えないで配列中の文字数を返します。 -それ以外の場合はゼロを返し、バッファの内容は不定になります。 +は終端のヌルを数えないで配列中の文字数を返します。 +それ以外の場合は 0 を返し、バッファの内容は不定になります。 .Pp -変換仕様は、以下に示すような形で展開した後バッファにコピーされます : +変換指定は、以下に示すような形で展開した後バッファにコピーされます : .Bl -tag -width "xxxx" .It Cm \&%A -全国標準の完全な曜日名で置き換えられます。 +各国の表現で完全な曜日名で置き換えられます。 .It Cm %a -全国標準の省略した曜日名で置き換えられます。 -ここで、略称は最初の 3 文字です。 +各国の表現で省略した曜日名で置き換えられます。 +ここでの略称は最初の 3 文字です。 .It Cm \&%B -全国標準の完全な月名で置き換えられます。 +各国の表現で完全な月名で置き換えられます。 .It Cm %b -全国標準の省略した月名で置き換えられます。 -ここで、略称は最初の 3 文字です。 +各国の表現で省略した月名で置き換えられます。 +ここでの略称は最初の 3 文字です。 .It Cm \&%C (西暦年 / 100) の 10 進数で置き換えられます。 1 桁の数字の前には 0 が付きます。 .It Cm %c -全国標準の時刻と日付で置き換えられます -(フォーマットは -.Xr asctime 3 -によって作られるものと同じです)。 +各国の表現で時刻と日付で置き換えられます +フォーマットは +.Xr ctime 3 +または "%a %Ef %T %Y" と同等です。 +これはまた、"3+1+6+1+8+1+4" の出力フォーマットを意味します。 .It Cm \&%D .Dq Li %m/%d/%y と同等です。 .It Cm %d 日を示す 10 進数 (01-31) で置き換えられます。 -.It Cm \&%E* -POSIX の地域拡張です。 -%Ec %EC %Ex %Ey %EY +.It Cm \&%E* Cm \&%O* +POSIX のロケール拡張です。 +%Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy -というシーケンスは、代替的な表現を与えるものと見なされます。 +というシーケンスは、代替的な表現を与えるものとなっています。 +.Pp +加えて %Ef は月名と日の短い表現を、 +%EF は月名と日の長い表現を、 +%OB は代替的な月名の表現 (日を出さず、単独で使われる場合) が実装されています。 .It Cm %e 日を示す 10 進数 (1-31) で置き換えられます。 1 桁の数字の前には空白が付きます。 .It Cm \&%G 百年紀付きの年の 10 進数で置き換えられます。 この年は、週の大部分を含んだものとなります (月曜日を週の最初の日として)。 .It Cm %g .Dq Li %G と同じ年ですが、百年紀なしの 10 進数 (00-99) で置き換えられます。 .It Cm \&%H -(24 時間時計で) 時間を示す 10 進数 (00-23) で置き換えられます。 +(24 時間単位で) 時間を示す 10 進数 (00-23) で置き換えられます。 .It Cm %h %b と同じです。 .It Cm \&%I -(12 時間時計で) 時間を示す 10 進数 (01-12) で置き換えられます。 +(12 時間単位で) 時間を示す 10 進数 (01-12) で置き換えられます。 .It Cm %j 1 年の日を示す 10 進数 (001-366) で置き換えられます。 .It Cm %k -(24 時間時計で) 時間を示す 10 進数 (0-23) で置き換えられます。 +(24 時間単位で) 時間を示す 10 進数 (0-23) で置き換えられます。 1 桁の数字の前には空白が付きます。 .It Cm %l -(12 時間時計で) 時間を示す 10 進数 (1-12) で置き換えられます。 +(12 時間単位で) 時間を示す 10 進数 (1-12) で置き換えられます。 1 桁の数字の前には空白が付きます。 .It Cm \&%M 分を示す 10 進数 (00-59) で置き換えられます。 .It Cm %m 月を示す 10 進数 (01-12) で置き換えられます。 .It Cm %n 改行で置き換えられます。 .It Cm \&%O* %E* と同じです。 .It Cm %p -全国標準の "午前" または "午後" 表示の -いずれか該当する表示で置き換えられます。 +各国の表現で "午前" または "午後" の +いずれか適切な表示に置き換えられます。 .It Cm \&%R .Dq Li %H:%M と同等です。 .It Cm %r .Dq Li %I:%M:%S %p と同等です。 .It Cm \&%S 秒を示す 10 進数 (00-60) で置き換えられます。 .It Cm %s -世界標準時基準時点からの秒数で置き換えられます +UTC での基準時点からの秒数で置き換えられます .Xr (mktime 3 参照) 。 .It Cm \&%T .Dq Li %H:%M:%S と同等です。 .It Cm %t タブで置き換えられます。 .It Cm \&%U 1 年のうちの週数 (日曜日を週の最初の日として) を示す 10 進数 (00-53) で置き換えられます。 .It Cm %u 1 週のうちの日 (月曜日を週の最初の日として) を示す 10 進数 (1-7) で置き換えられます。 .It Cm \&%V 1 年のうちの週数 (月曜日を週の最初の日として) を示す 10 進数 (01-53) で置き換えられます。 新年の 1 月 1 日を含む週に 4 日以上の日がある場合は、 その週が第 1 週となります。 それ以外の場合は、その週は前年の最後の週となり、 その次の週が第 1 週となります。 .It Cm %v .Dq Li %e-%b-%Y と同等です。 .It Cm \&%W 1 年のうちの週数 (月曜日を週の最初の日として) を示す 10 進数 (00-53) で置き換えられます。 .It Cm %w 1 週のうちの日 (日曜日を週の最初の日として) を示す 10 進数 (0-6) で置き換えられます。 .It Cm \&%X -全国標準の時刻で置き換えられます。 +各国の表現で時刻で置き換えられます。 .It Cm %x -全国標準の日付で置き換えられます。 +各国の表現で日付で置き換えられます。 .It Cm \&%Y 百年紀付きの年を示す 10 進数で置き換えられます。 .It Cm %y 百年紀なしの年を示す 10 進数 (00-99) で置き換えられます。 .It Cm \&%Z 時間帯名で置き換えられます。 +.It Cm \&%z +UTC からの時間帯のオフセットで置き換えられます。 +先頭にプラス符号が付いている場合は UTC よりも東を、 +マイナス符号が付いている場合には UTC よりも西を指し、 +時間と分で 2 桁毎の数字で表し、これらをデリミタで分けません (RFC 822 データヘッダ共通形式)。 .It Cm %+ -全国標準の日付と時刻を示すもので置き換えられます +各国の表現で日付と時刻を示すもので置き換えられます (フォーマットは .Xr date 1 によって作成されるものと同じです)。 .It Cm %% .Ql % で置き換えられます。 .El .Sh 参照 .Xr date 1 , .Xr printf 1 , .Xr ctime 3 , .Xr printf 3 , .Xr strptime 3 .Sh 規格 .Fn strftime 関数は、 .Ql %C , -.Ql %D , +.Ql \&%D , .Ql %E* , .Ql %e , .Ql %G , .Ql %g , .Ql %h , .Ql %k , .Ql %l , .Ql %n , .Ql %O* , .Ql \&%R , .Ql %r , .Ql %s , .Ql \&%T , .Ql %t , .Ql %u , .Ql \&%V , -.Ql %+ +.Ql %z , +.Ql %+ . などを含む多くの拡張を含めて、 -.St -ansiC -に準拠しています。 - +.St -isoC +に適合しています。 +.Pp .Ql %G , .Ql %g , および .Ql \&%V の置き換えにおける特殊な週数および年数は、 ISO 8601: 1988 に定義されています。 .Sh バグ -月の象に関する変換仕様は備えていません。 +月の象に関する変換指定は備えていません。 diff --git a/ja_JP.eucJP/man/man3/string.3 b/ja_JP.eucJP/man/man3/string.3 index 3f251fa674..f0b4d5500f 100644 --- a/ja_JP.eucJP/man/man3/string.3 +++ b/ja_JP.eucJP/man/man3/string.3 @@ -1,156 +1,158 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" 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. .\" .\" @(#)string.3 8.2 (Berkeley) 12/11/93 +.\" %FreeBSD: src/lib/libc/string/string.3,v 1.6.2.2 2001/03/06 16:46:04 ru Exp % .\" %Id: string.3,v 1.5 1997/02/22 15:03:29 peter Exp % .\" .\" $FreeBSD$ .\" .Dd December 11, 1993 .Dt STRING 3 .Os BSD 4 .Sh 名称 .Nm strcat , .Nm strncat , .Nm strchr , .Nm strrchr , .Nm strcmp , .Nm strncmp , .Nm strcasecmp, .Nm strncasecmp , .Nm strcpy , .Nm strncpy , .Nm strerror , .Nm strlen , .Nm strpbrk , .Nm strsep, .Nm strspn , .Nm strcspn , .Nm strstr , .Nm strtok , .Nm index , .Nm rindex .Nd 文字列に特有の関数 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strcat "char *s" "const char * append" .Ft char * .Fn strncat "char *s" "const char *append" "size_t count" .Ft char * .Fn strchr "const char *s" "int c" .Ft char * .Fn strrchr "const char *s" "int c" .Ft int .Fn strcmp "const char *s1" "const char *s2" .Ft int .Fn strncmp "const char *s1" "const char *s2" "size_t count" .Ft int .Fn strcasecmp "const char *s1" "const char *s2" .Ft int .Fn strncasecmp "const char *s1" "const char *s2" "size_t count" .Ft char * .Fn strcpy "char *dst" "const char *src" .Ft char * .Fn strncpy "char *dst" "const char *src" "size_t count" .Ft char * .Fn strerror "int errno" .Ft size_t .Fn strlen "const char *s" .Ft char * .Fn strpbrk "const char *s" "const char *charset" .Ft char * .Fn strsep "char **stringp" "const char *delim" .Ft size_t .Fn strspn "const char *s" "const char *charset" .Ft size_t .Fn strcspn "const char *s" "const char *charset" .Ft char * .Fn strstr "const char *big" "const char *little" .Ft char * .Fn strtok "char *s" "const char *delim" .Ft char * .Fn index "const char *s" "int c" .Ft char * .Fn rindex "const char *s" "int c" .Sh 解説 これらの文字列関数は、ヌルバイトで終了する文字列を操作します。 .Pp 詳しくは、個々の関数についてのマニュアルページを参照してください。 -可変長の汎用オブジェクトをバイト文字列 -(ヌルバイトのチェックなしに) として操作することについては、 +可変長の汎用オブジェクトを (ヌルバイトのチェックなしの) バイト列 +として操作することについては、 .Xr bstring 3 を参照してください。 .Pp 個々のマニュアルページに記されたものを除いては、 文字列関数はサイズの制限についての検査は行いません。 .Sh 参照 .Xr bstring 3 , .Xr index 3 , .Xr rindex 3 , .Xr strcasecmp 3 , .Xr strcat 3 , .Xr strchr 3 , .Xr strcmp 3 , .Xr strcpy 3 , .Xr strcspn 3 , .Xr strerror 3 , .Xr strlen 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strcat , .Fn strncat , .Fn strchr , .Fn strrchr , .Fn strcmp , .Fn strncmp , .Fn strcpy , .Fn strncpy , .Fn strerror , .Fn strlen , .Fn strpbrk , .Fn strsep , .Fn strspn , .Fn strcspn , .Fn strstr , および .Fn strtok 関数は、 -.St -ansiC -に -準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/stringlist.3 b/ja_JP.eucJP/man/man3/stringlist.3 index 66e2dcd04b..4d1438ecca 100644 --- a/ja_JP.eucJP/man/man3/stringlist.3 +++ b/ja_JP.eucJP/man/man3/stringlist.3 @@ -1,117 +1,121 @@ .\" %NetBSD: stringlist.3,v 1.2 1997/04/09 08:59:25 kleink Exp % .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This file was contributed to The NetBSD Foundation by Luke Mewburn. .\" .\" 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 NetBSD .\" Foundation, Inc. and its contributors. .\" 4. Neither the name of The NetBSD Foundation 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 NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" +.\" %FreeBSD: src/lib/libc/gen/stringlist.3,v 1.3.2.2 2001/03/06 16:45:54 ru Exp % +.\" .\" $FreeBSD$ .\" .Dd February 24, 1997 .Os NetBSD 1.3 .Dt STRINGLIST 3 .Sh 名称 .Nm stringlist , .Nm sl_init , .Nm sl_add , .Nm sl_free , .Nm sl_find .Nd 文字列リスト操作関数 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft StringList * .Fn sl_init .Ft void .Fn sl_add "StringList *sl" "char *item" .Ft void .Fn sl_free "StringList *sl" "int freeall" .Ft char * .Fn sl_find "StringList *sl" "char *item" .Sh 解説 .Nm 関数は、必要に応じて自動的に展開する文字列の一覧である 文字列リストを操作します。 .Pp .Ar StringList 構造は、次のような定義を持ちます : .Bd -literal -offset indent typedef struct _stringlist { char **sl_str; size_t sl_max; size_t sl_cur; } StringList; .Ed .Pp .Bl -tag -width "sl_str" -offset indent .It Ar sl_str 一覧が入っている配列の基底ポインタです。 .It Ar sl_max .Ar sl_str のサイズ。 .It Ar sl_cur 現在の要素の .Ar sl_str におけるオフセット。 .El .Pp 以下のような文字列リスト操作関数が使用できます : .Bl -tag -width "sl_init()" .It Fn sl_init 文字列リストを作成します。 .Ar StringList へのポインタを 返します。 .It Fn sl_free .Ar sl および .Ar sl->sl_str 配列が占有するメモリを解放します。 .Ar freeall -が非ゼロの場合は、 +が非 0 の場合は、 .Ar sl->sl_str の中の項目も解放されます。 .It Fn sl_add .Ar sl->sl_str のサイズを拡張して、 .Ar item を .Ar sl->sl_str の .Ar sl->sl_cur の位置に追加します。 .It Fn sl_find .Ar sl の中の .Ar item -を探し、見つからない場合はヌルを返します。 +を探し、見つからない場合は NULL を返します。 .Sh 参照 .Xr free 3 , .Xr malloc 3 diff --git a/ja_JP.eucJP/man/man3/strlen.3 b/ja_JP.eucJP/man/man3/strlen.3 index ccc0fa4367..f128f1667f 100644 --- a/ja_JP.eucJP/man/man3/strlen.3 +++ b/ja_JP.eucJP/man/man3/strlen.3 @@ -1,64 +1,67 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strlen.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strlen.3,v 1.3.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .\" .Dd June 4, 1993 .Dt STRLEN 3 .Os .Sh 名称 .Nm strlen .Nd 文字列の長さを測定 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft size_t .Fn strlen "const char *s" .Sh 解説 .Fn strlen 関数は、文字列 .Fa s の長さを計算します。 .Sh 戻り値 .Fn strlen -関数は、終端のナル文字以前の文字数を返します。 +関数は、終端のヌル文字を含まない文字数を返します。 .Sh 参照 .Xr string 3 .Sh 規格 .Fn strlen 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strmode.3 b/ja_JP.eucJP/man/man3/strmode.3 index 6233e6b277..6322753163 100644 --- a/ja_JP.eucJP/man/man3/strmode.3 +++ b/ja_JP.eucJP/man/man3/strmode.3 @@ -1,162 +1,165 @@ .\" Copyright (c) 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. .\" .\" @(#)strmode.3 8.3 (Berkeley) 7/28/94 +.\" %FreeBSD: src/lib/libc/string/strmode.3,v 1.6.2.1 2000/04/22 17:06:40 phantom Exp % .\" .\" $FreeBSD$ .\" .Dd July 28, 1994 .Dt STRMODE 3 .Os .Sh 名称 .Nm strmode .Nd inode ステータス情報をシンボル文字列に変換 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft void .Fn strmode "mode_t mode" "char *bp" .Sh 解説 .Fn strmode 関数は、ファイル .Fa mode -(inode に結合されるタイプと許可の情報については、 +(inode に結合されるタイプとパーミッションの情報については、 .Xr stat 2 を参照) をシンボル文字列に変換し、それを .Fa bp で参照される場所に保存します。 -保存されるこの文字列は、長さが 11 文字で最後にナル文字が付きます。 +保存されるこの文字列は、長さが 11 文字で最後にヌル文字が付きます。 .Pp 最初の文字は inode タイプで、次のいずれかになります : .Pp .Bl -tag -width flag -offset indent -compact .It \- 通常ファイル .It b ブロック型特殊ファイル .It c -キャラクタ型特殊ファイル +文字型特殊ファイル .It d ディレクトリ .It l シンボリックリンク .It p fifo .It s ソケット .It w whiteout .It ? 未知の inode タイプ .El .Pp -次に続く 9 つの文字は、3 文字毎に 3 つの許可セットをコード化します。 -最初の 3 つの文字はファイル所有者のための許可で、 +次に続く 9 つの文字は、3 文字毎に 3 つのパーミッションセットをコード化します。 +最初の 3 つの文字はファイル所有者のためのパーミッションで、 2 番目の 3 文字はファイルが所属するグループのためのもの、 そして 3 番目の 3 文字は -``その他'' またはデフォルトのユーザーセット用です。 +``他者'' またはデフォルトのユーザセット用です。 .Pp -許可チェックは、できる限り明確に限定して行われます。 -最初の許可セットでファイルの所有者に対して +パーミッションチェックは、できる限り明確に限定して行われます。 +最初のパーミッションセットでファイルの所有者に対して 読み取り許可が拒否された場合は、 ファイルの所有者はそのファイルを読み取ることができません。 このことは、その所有者がファイルのグループに入っており、 -そのグループ許可によって読み取り許可が与えられている場合、 -または読み取りを許可する ``その他'' の許可が +そのグループパーミッションによって読み取り許可が与えられている場合、 +または読み取りを許可する ``他者'' のパーミッションが 与えられている場合でも当てはまります。 .Pp 3 文字セットの最初の文字が ``r'' である場合は、 -そのファイルはそのユーザーセットに対して読み取り可能です。 +そのファイルはそのユーザセットに対して読み取り可能です。 文字がダッシュ ``\-'' 場合は、読み取りできません。 .Pp 3 文字セットの 2 番目の文字が ``w'' である場合は、 -そのファイルはそのユーザーセットに対して書込み可能です。 -文字がダッシュ ``\-'' である場合は、書込みできません。 +そのファイルはそのユーザセットに対して書き込み可能です。 +文字がダッシュ ``\-'' である場合は、書き込みできません。 .Pp 3 番目の文字は、次の該当する文字です : .Bl -tag -width xxxx .It S -キャラクタが所有者許可の一部であり、 +文字が所有者パーミッションの一部であり、 ファイルが実行可能ではないか、 またはディレクトリが所有者によって検索可能ではなく、 set-user-id ビットが設定されている場合。 .It S -キャラクタがグループ許可の一部であり、 +文字がグループパーミッションの一部であり、 ファイルが実行可能ではないか、 またはディレクトリがグループによって検索可能ではなく、 set-group-id ビットが設定されている場合。 .It T -キャラクタがその他の許可の一部であり、 +文字が他者のパーミッションの一部であり、 ファイルが実行可能ではないか、 -またはディレクトリがその他のものによって検索可能ではなく、 +またはディレクトリが他者のものによって検索可能ではなく、 ``sticky'' .Pq Dv S_ISVTX ビットが設定されている場合。 .It s -キャラクタが所有者許可の一部であり、 +文字が所有者パーミッションの一部であり、 ファイルが実行可能であるか、 またはディレクトリが所有者によって検索可能であり、 set-user-id ビットが設定されている場合。 .It s -キャラクタがグループ許可の一部であり、 +文字がグループパーミッションの一部であり、 ファイルが実行可能であるか、 またはディレクトリがグループによって検索可能であり、 set-group-id ビットが設定されている場合。 .It t -キャラクタがその他の許可の一部であり、 +文字が他者のパーミッションの一部であり、 ファイルが実行可能であるか、 -またはディレクトリがその他のものによって検索可能であり、 +またはディレクトリが他者のものによって検索可能であり、 ``sticky'' .Pq Dv S_ISVTX ビットが設定されている場合。 .It x ファイルが実行可能であるか、またはディレクトリが検索可能。 .It \- 上のいずれにも該当しない。 .El .Pp 最後の文字は inode に結合された別のアクセス制御方法が何かある場合は、 プラス記号 ``+'' です。 それ以外の場合は、文字はスペースになります。 .Sh 戻り値 .Fn strmode 関数は、常に 0 を返します。 .Sh 参照 .Xr chmod 1 , .Xr find 1 , .Xr stat 2 , .Xr getmode 3 , .Xr setmode 3 .Sh 歴史 .Fn strmode -関数は最初 +関数は .Bx 4.4 -に現れました。 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man3/strpbrk.3 b/ja_JP.eucJP/man/man3/strpbrk.3 index 8925f5a5a8..3cb6e427e9 100644 --- a/ja_JP.eucJP/man/man3/strpbrk.3 +++ b/ja_JP.eucJP/man/man3/strpbrk.3 @@ -1,79 +1,80 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strpbrk.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strpbrk.3,v 1.3.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRPBRK 3 .Os .Sh 名称 .Nm strpbrk .Nd 複数の文字について文字列の中の位置を探す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strpbrk "const char *s" "const char *charset" .Sh 解説 .Fn strpbrk 関数は、文字列 .Fa charset のうちのいずれかの文字が、 -ヌルで終端された文字列 +ヌル文字で終了する文字列 .Fa s の中に最初に出現する位置を探し、 その文字へのポインタを返します。 .Fa s の中に .Fa charset のどの文字も出現しない場合は、 .Fn strpbrk は NULL を返します。 .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strcspn 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strpbrk 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strptime.3 b/ja_JP.eucJP/man/man3/strptime.3 index 2a4d1a22bb..a95bd2f94a 100644 --- a/ja_JP.eucJP/man/man3/strptime.3 +++ b/ja_JP.eucJP/man/man3/strptime.3 @@ -1,89 +1,196 @@ .\" .\" Copyright (c) 1997 Joerg Wunsch .\" .\" 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 DEVELOPERS ``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 DEVELOPERS 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. .\" -.\" %Id: strptime.3,v 1.2 1998/09/12 21:13:29 dt Exp % +.\" %FreeBSD: src/lib/libc/stdtime/strptime.3,v 1.9.2.3 2000/12/29 14:44:51 ru Exp % .\" " .\" $FreeBSD$ .Dd May 8, 1997 .Dt STRPTIME 3 .Os .Sh 名称 .Nm strptime .Nd 日付および時刻を表す文字列を解釈する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strptime "const char *buf" "const char *format" "struct tm *timeptr" .Sh 解説 .Fn strptime 関数は、バッファ .Fa buf 中の文字列を .Fa format で示される文字列に従って解釈し、 .Fa timeptr が指す構造体の要素に入れます。 +.\" The resulting values will be relative to the local time zone. +この結果は地域時間に適切に合わされます。 したがって、これは .Xr strftime 3 の逆方向の操作と考えることができます。 .Pp .Fa format -文字列は、ゼロ以上の変換則と通常文字からなります。 +文字列は、 0 以上の変換則と通常文字からなります。 すべての通常文字は、バッファと厳密にマッチされます。 そして、フォーマット文字列の空白文字は バッファ中の任意の数の空白文字とマッチします。 すべての変換則は、 .Xr strftime 3 に記述したものと同じです。 +.\".Pp +.\"Two-digit year values, including formats +.\".Fa %y +.\"and +.\".Fa \&%D , +.\"are now interpreted as beginning at 1969 per POSIX requirements. +.\"Years 69-00 are interpreted in the 20th century (1969-2000), years +.\"01-68 in the 21st century (2001-2068). +.Pp +形式に含まれる +.Fa %y +で示される 2 桁の年の値、および +.Fa \&%D +は、 POSIX 要求仕様によって 1969 年から始まるように解釈されます。 +年が 69-00 の場合は 20 世紀 (1969-2000) と、 +年が 01-68 の場合は 21 世紀 (2001-2068) と解釈されます。 .Sh 戻り値 成功して終了した場合、 .Fn strptime は .Fa format -中の変換則を満足させるためには要求されなかった、 +中の変換指定を満たすためには必要とされなかった .Fa buf 中の最初の文字へのポインタを返します。 変換が一つでも失敗した場合は .Dv NULL を返します。 .Sh 参照 .Xr date 1 , .Xr scanf 3 , .Xr strftime 3 .Sh 作者 .Fn strptime 関数は、 Powerdog Industries によって寄贈されました。 .Pp このマニュアルページは、 -.ie t J\(:org Wunsch -.el Joerg Wunsch +.An J\(:org Wunsch . によって書かれました。 .Sh 歴史 .Fn strptime -関数は、 +関数は .Fx 3.0 -に現れました。 +で登場しました。 +.\".Pp +.\".Sh BUGS +.\"Both the +.\".Fa %e +.\"and +.\".Fa %l +.\"format specifiers may incorrectly scan one too many digits +.\"if the intended values comprise only a single digit +.\"and that digit is followed immediately by another digit. +.\"Both specifiers accept zero-padded values, +.\"even though they are both defined as taking unpadded values. +.Pp +.Sh バグ +変換形式 +.Fa %e +と +.Fa %l +の両方は +もし意図された値が一桁の数値だけで成り、 +かつその数値にすぐに続けて他の整数が続く場合、 +一桁を越えて不正確なスキャンを行います。 +これらの変換形式には、たとえ詰めていない値を取得する場合でも +0 詰めした値を渡してください。 +.\".Pp +.\"The +.\".Fa %p +.\"format specifier has no effect unless it is parsed +.\".Em after +.\"hour-related specifiers. +.\"Specifying +.\".Fa %l +.\"without +.\".Fa %p +.\"will produce undefined results. +.\"Note that 12AM +.\".Pq ante meridiem +.\"is taken as midnight +.\"and 12PM +.\".Pq post meridiem +.\"is taken as noon. +.Pp +変換形式 +.Fa %p +は時間を示す変換形式が解析された +.Em 後 +でないと意味を持ちません。 +変換形式 +.Fa %l +は +.Fa %p +が無いと未定義の結果を作り出します。 +注 12AM +.Pq 午前 +は深夜を指し、12PM +.Pq 午後 +は正午を指します。 +.\".Pp +.\"The +.\".Fa %U +.\"and +.\".Fa %W +.\"format specifiers accept any value within the range 00 to 53 +.\"without validating against other values supplied (like month +.\"or day of the year, for example). +.Pp +変換仕様 +.Fa %U +と +.Fa %W +は他の値 (例えば年の中の月や日など) を取得する場合とは対照に、 +正当性の検査なしに 00 から 53 の範囲の中での値を受け付けます。 +.\".Pp +.\"The +.\".Fa %Z +.\"format specifier only accepts time zone abbreviations of the local time zone, +.\"or the value "GMT". +.\"This limitation is because of ambiguity due to of the over loading of time +.\"zone abbreviations. One such example is +.\".Fa EST +.\"which is both Eastern Standard Time and Eastern Australia Summer Time. +.Pp +変換仕様 +.Fa %Z +は時間帯として省略された地域時間か "GMT" のみを受け付けます。 +この制限は多義的な時間帯の省略がオーバロードされる場合に影響します。 +たとえば一つの例として +.Fa EST +は東部標準時と東部オーストラリア夏時間が挙げられます。 diff --git a/ja_JP.eucJP/man/man3/strrchr.3 b/ja_JP.eucJP/man/man3/strrchr.3 index 1d85c84331..85bbcb1dc2 100644 --- a/ja_JP.eucJP/man/man3/strrchr.3 +++ b/ja_JP.eucJP/man/man3/strrchr.3 @@ -1,87 +1,88 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strrchr.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strrchr.3,v 1.5.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRRCHR 3 .Os .Sh 名称 .Nm strrchr .Nd 文字列中での文字の位置を探す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strrchr "const char *s" "int c" .Sh 解説 .Fn strrchr 関数は、文字列 .Fa s 中の (char に変換された) .Fa c が最後に出現する位置を探します。 .Fa c が .Ql \e0 のときは .Fn strrchr は終端の .Ql \e0 の位置を示します。 .Sh 戻り値 .Fn strrchr 関数は該当する文字へのポインタを返します。 また、 .Fa s 中のどこにも .Fa c -が出現しない場合は null ポインタを返します。 +が出現しない場合は NULL ポインタを返します。 .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strcspn 3 , .Xr strpbrk 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strrchr 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strsep.3 b/ja_JP.eucJP/man/man3/strsep.3 index 6906be8bea..2d16623123 100644 --- a/ja_JP.eucJP/man/man3/strsep.3 +++ b/ja_JP.eucJP/man/man3/strsep.3 @@ -1,111 +1,123 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek. .\" .\" 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. .\" .\" @(#)strsep.3 8.1 (Berkeley) 6/9/93 +.\" %FreeBSD: src/lib/libc/string/strsep.3,v 1.6.2.4 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 9, 1993 .Dt STRSEP 3 .Os .Sh 名称 .Nm strsep .Nd 文字列の分割 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strsep "char **stringp" "const char *delim" .Sh 解説 .Fn strsep 関数は、 .Fa *stringp により参照される文字列の中で、文字列 .Fa delim 中のいずれかの文字 ( または終端の .Ql \e0 ) のうちで最初に出現する文字の位置をを探し、その箇所を .Ql \e0 で置き換えます。 区切り文字 ( または文字列の末尾に達した場合は .Dv NULL ) の次の文字の位置は、 .Fa *stringp に格納されます。 .Fa *stringp の元の値は戻り値となります。 .Pp 「空」のフィールド、すなわち、 2 つの隣接する区切り文字によって生じたフィールドは、 .Fa *stringp の中に返されたポインタが参照する位置を .Ql \e0 と比較することで検出可能です。 .Pp .Fa *stringp が最初から .Dv NULL である場合は、 .Fn strsep は .Dv NULL を返します。 .Sh 例 以下では、 空白文字によって区切られたトークンで構成されている文字列を、 引数ベクタへと解釈するために .Fn strsep を使っています。 .Bd -literal -offset indent char **ap, *argv[10], *inputstring; for (ap = argv; (*ap = strsep(&inputstring, " \et")) != NULL;) if (**ap != '\e0') if (++ap >= &argv[10]) break; .Ed +.Sh 参照 +.Xr memchr 3 , +.Xr strchr 3 , +.Xr strcspn 3 , +.Xr strpbrk 3 , +.Xr strrchr 3 , +.Xr strspn 3 , +.Xr strstr 3 , +.Xr strtok 3 .Sh 歴史 .Fn strsep 関数は、 .Fn strtok 関数を置き換えるものとして考えられています。 .Fn strtok 関数は移植性の点では好ましいのですが ( -.St -ansiC -に準拠しています ) 、 +.St -isoC +に適合しています ) 、 空のフィールドを扱う、すなわち、 2 つの隣接する区切り文字によって区切られたフィールドを検出するとか、 一回で複数の文字列に対して使用する、といったことができません。 .Fn strsep -関数は、最初に +関数は、 .Bx 4.4 -に現れました。 +で初めて登場しました。 diff --git a/ja_JP.eucJP/man/man3/strspn.3 b/ja_JP.eucJP/man/man3/strspn.3 index efd7095336..6f2d4552be 100644 --- a/ja_JP.eucJP/man/man3/strspn.3 +++ b/ja_JP.eucJP/man/man3/strspn.3 @@ -1,77 +1,78 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strspn.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strspn.3,v 1.4.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRSPN 3 .Os .Sh 名称 .Nm strspn .Nd 文字列を測る +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft size_t .Fn strspn "const char *s" "const char *charset" .Sh 解説 .Fn strspn -関数は、ヌルで終端された文字列 +関数は、ヌル文字で終了する文字列 .Fa s について、 .Fa s から取り出した文字が .Fa charset 中に存在する 最初の区間の長さを測ります。 .Sh 戻り値 .Fn strspn -関数は、測定された文字数を返します。 +関数は、測られた文字数を返します。 .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strcspn 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strstr 3 , .Xr strtok 3 .Sh 規格 .Fn strspn 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strstr.3 b/ja_JP.eucJP/man/man3/strstr.3 index 2c73d4e70a..3975504854 100644 --- a/ja_JP.eucJP/man/man3/strstr.3 +++ b/ja_JP.eucJP/man/man3/strstr.3 @@ -1,89 +1,90 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strstr.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strstr.3,v 1.3.2.3 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRSTR 3 .Os .Sh 名称 .Nm strstr .Nd 文字列中の部分文字列の位置を探す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strstr "const char *big" "const char *little" .Sh 解説 .Fn strstr -関数は、ヌルで終端された文字列 +関数は、ヌル文字で終了する文字列 .Fa big 中で、 -ヌルで終端された文字列 +ヌル文字で終了する文字列 .Fa little が最初に出現する位置を探します。 .Fa little が空の文字列のとき、 .Fn strstr は .Fa big を返します。 .Fa little が .Fa big の中に現れないとき、 .Fn strstr は NULL を返します。 それ以外のときは、 .Fn strstr は最初に出現した .Fa little の最初の文字へのポインタを返します。 .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strcspn 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strtok 3 .Sh 規格 .Fn strstr 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/strtod.3 b/ja_JP.eucJP/man/man3/strtod.3 index 886ef87dc9..5f72f7f257 100644 --- a/ja_JP.eucJP/man/man3/strtod.3 +++ b/ja_JP.eucJP/man/man3/strtod.3 @@ -1,137 +1,141 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)strtod.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/strtod.3,v 1.4.2.5 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRTOD 3 .Os .Sh 名称 .Nm strtod -.Nd +.Nd .Tn ASCII 文字列を double に変換 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft double .Fn strtod "const char *nptr" "char **endptr" .Sh 解説 .Fn strtod 関数は、 .Fa nptr が指す文字列の最初の部分を .Em double による表現に変換します。 .Pp 文字列に想定される形は、 オプションのプラス (``+'') またはマイナス (``\-'') 記号、 -続いて数字の並び ( これはオプションで小数点文字を含みます ) 、 +続いて数字の並び (これはオプションで小数点文字を含みます) 、 オプションで指数が続くというものです。 指数は、 ``E'' または ``e'' に オプションでプラスまたはマイナス記号が続いて、 さらに数字の並びが続くという形です。 .Pp -文字列の先頭の空白文字 ( -.Xr isspace 3 +文字列の先頭の空白文字 +.Xr (isspace 3 関数により定義されるような) はスキップします。 .Sh 戻り値 .Fn strtod 関数は、どんなときでも変換された値を返します。 .Pp .Fa endptr が .Dv NULL でない場合は、変換に使われた最後の文字の次の文字へのポインタが、 .Fa endptr により参照される場所に格納されます。 .Pp -変換が行われなかった場合はゼロが返され、 +変換が行われなかった場合は 0 が返され、 .Fa nptr の値は .Fa endptr によって参照される場所に格納されます。 .Pp 正しい値がオーバーフローとなると思われるときは、 -( その値の符号にしたがって ) プラスまたはマイナスの +(その値の符号にしたがって) プラスまたはマイナスの .Dv HUGE_VAL が返され、 -.Dv ERANGE +.Er ERANGE が .Va errno に保存されます。 正しい値がアンダーフローとなると思われるときは、 -ゼロが返され、 -.Dv ERANGE +0 が返され、 +.Er ERANGE が .Va errno に保存されます。 .Sh エラー -.Bl -tag -width [ERANGE] +.Bl -tag -width Er .It Bq Er ERANGE オーバーフローまたはアンダーフローが起きました。 +.El .Sh 参照 .Xr atof 3 , .Xr atoi 3 , .Xr atol 3 , .Xr strtol 3 , .Xr strtoul 3 .Sh 規格 .Fn strtod 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 .Sh 作者 このソフトウェアの作者は .An David M. Gay です。 .Pp Copyright (c) 1991 by AT&T. .Pp 本ソフトウェアのコピーや修正版、またはそれらを含むソフトウェア のすべてのコピー、およびそのようなソフトウェアのサポートドキュメント のすべてのコピーにこの注意書き全体が含まれていることを条件として、この ソフトウェアを無料であらゆる目的に使用し、コピーし、修正し、 配布することをここに許諾します。 .Pp 本ソフトウェアは、いかなる明示的または暗黙的な保証なしに、 「そのままの形」で提供されています。 特に、作者あるいは AT&T は、 本ソフトウェアの商品性または特定の目的に対する適合性に関する 説明または保証を一切行いません。 .Pp .Fn strtod およびそれに付随する関数のソースコードの無料 コピー入手については、ベンダーに連絡してください。 diff --git a/ja_JP.eucJP/man/man3/strtok.3 b/ja_JP.eucJP/man/man3/strtok.3 index 95724fab58..271dc1f9a4 100644 --- a/ja_JP.eucJP/man/man3/strtok.3 +++ b/ja_JP.eucJP/man/man3/strtok.3 @@ -1,169 +1,177 @@ .\" Copyright (c) 1998 Softweyr LLC. All rights reserved. .\" .\" strtok_r, from Berkeley strtok .\" Oct 13, 1998 by Wes Peters .\" .\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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 .\" notices, this list of conditions and the following disclaimer. .\" .\" 2. Redistributions in binary form must reproduce the above .\" copyright notices, 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 Softweyr LLC, the .\" University of California, Berkeley, and its contributors. .\" .\" 4. Neither the name of Softweyr LLC, 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 SOFTWEYR LLC, 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 SOFTWEYR LLC, 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. .\" .\" @(#)strtok.3 8.2 (Berkeley) 2/3/94 +.\" %FreeBSD: src/lib/libc/string/strtok.3,v 1.10.2.5 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd November 27, 1998 .Dt STRTOK 3 -.Os FreeBSD 3.0 +.Os FreeBSD .Sh 名称 -.Nm strtok, strtok_r +.Nm strtok , strtok_r .Nd 文字列のトークン +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft char * .Fn strtok "char *str" "const char *sep" .Ft char * .Fn strtok_r "char *str" "const char *sep" "char **last" .Sh 解説 .Bf -symbolic このインタフェースは strsep(3) によって置き換えられました。 .Ef .Pp .Fn strtok 関数は、ヌルで終端された文字列 .Fa str の中の連続するトークンを分割するために用いられます。 これらのトークンは、その文字列内で .Fa sep の中の文字の少なくとも 1 つによって区分されています。 最初に .Fn strtok を呼び出すときには、 .Fa str を指定する必要があります。 同じ文字列からさらにトークンを取得するために 続いて呼び出すときには、 -代りにヌルポインタを渡す必要があります。 +代わりに空ポインタを渡す必要があります。 セパレータ文字列 .Fa sep は毎回与えなければなりませんが、 呼び出しのたびに変更しても構いません。 +.\".Pp +.\"The implementation will behave as if no library function calls +.\".Fn strtok . +.Pp +ライブラリは、実装上、他のライブラリ関数が +.Fn strtok +を呼び出したりしないかのように動作します。 .Pp .Fn strtok_r 関数は .Fn strtok の再入可能なバージョンです。 コンテキストポインタ .Fa last は、呼び出し毎に与えなければなりません。 .Fn strtok_r は、別々のコンテキストポインタが使われている限りでは、 -お互いの内部で 2 つのパースループをネストするためにも使えます。 +お互いの内部で 2 つのパースループを入れ子にするためにも使えます。 .Pp .Fn strtok および .Fn strtok_r -関数は、そのトークン自体を -.Dv NUL -文字で置き換えた後、 +関数は、そのトークン自体をヌル文字で置き換えた後、 文字列の次のトークンの先頭へのポインタを返します。 -トークンがなくなっると、ヌルポインタを返します。 +トークンがなくなると、NULL ポインタを返します。 .Sh 例 次の例では、別々のコンテキストを使って 2 つの文字列を パースするために .Fn strtok_r を使っています: .Bd -literal char test[80], blah[80]; -char *sep = "\\/:;=-"; +char *sep = "\e\e/:;=-"; char *word, *phrase, *brkt, *brkb; -strcpy(test, "This;is.a:test:of=the/string\\tokenizer-function."); +strcpy(test, "This;is.a:test:of=the/string\e\etokenizer-function."); for (word = strtok_r(test, sep, &brkt); word; word = strtok_r(NULL, sep, &brkt)) { strcpy(blah, "blah:blat:blab:blag"); for (phrase = strtok_r(blah, sep, &brkb); phrase; phrase = strtok_r(NULL, sep, &brkb)) { - printf("So far we're at %s:%s\n", word, phrase); + printf("So far we're at %s:%s\en", word, phrase); } } .Ed .Sh 参照 -.Xr index 3 , .Xr memchr 3 , -.Xr rindex 3 , .Xr strchr 3 , .Xr strcspn 3 , .Xr strpbrk 3 , .Xr strrchr 3 , .Xr strsep 3 , .Xr strspn 3 , .Xr strstr 3 .Sh 規格 .Fn strtok 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 .Sh バグ System V の .Fn strtok は、区切り文字のみからなる文字列を渡された場合は、 次の開始点を変更しません。 -異なる ( または空の ) 区切り文字列を使った +異なる (または空の) 区切り文字列を使った .Fn strtok の呼び出しで、 .Dv NULL 以外の値を返せるようにするためです。 この実装では常に次の開始点を変更するので、 そのような呼び出しが続く時は常に .Dv NULL を返すことになります。 .Sh 作者 -.An Wes Peters, Softweyr LLC: Aq wes@softweyr.com -.br +.An Wes Peters , +Softweyr LLC: +.Aq wes@softweyr.com +.Pp .Fx 3.0 での実装に基づきます。 diff --git a/ja_JP.eucJP/man/man3/strtol.3 b/ja_JP.eucJP/man/man3/strtol.3 index 3056f6290e..075aa3e04f 100644 --- a/ja_JP.eucJP/man/man3/strtol.3 +++ b/ja_JP.eucJP/man/man3/strtol.3 @@ -1,170 +1,200 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strtol.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/strtol.3,v 1.4.2.4 2001/03/02 09:45:20 obrien Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRTOL 3 .Os .Sh 名称 .Nm strtol, strtoq -.Nd 文字列の数値を long または quad_t 整数に変換 +.Nd 文字列の数値を long 値、long long 値または quad_t 値に変換 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft long .Fn strtol "const char *nptr" "char **endptr" "int base" - +.Ft long long +.Fn strtoll "const char *nptr" "char **endptr" "int base" .Fd #include .Fd #include .Fd #include .Ft quad_t .Fn strtoq "const char *nptr" "char **endptr" "int base" .Sh 解説 .Fn strtol 関数は、 .Fa nptr にある文字列を .Em long 値に変換します。 +.Fn strtoll +関数は、 +.Fa nptr +にある文字列を +.Em long long +値に変換します。 .Fn strtoq 関数は、 .Fa nptr にある文字列を .Em quad_t 値に変換します。 変換は与えられた .Fa base に従って行われます。 この .Fa base の値は 2 から 36 の間か、 または特別な値である 0 でなければなりません。 .Pp -文字列は、任意の数の空白文字 ( -.Xr isspace 3 -により決められるような ) で始まり、 +文字列は、任意の数の空白文字 +.Xr (isspace 3 +により決められるような) で始まり、 オプションで一つの .Ql + または .Ql - 記号がそれに続きます。 .Fa base -がゼロか 16 のときは、文字列は接頭辞 +が 0 か 16 のときは、文字列は接頭辞 .Ql 0x を含むことができ、数字は基数を 16 として読み取られます。 -そうでないときの、ゼロの +そうでないときの、0 の .Fa base では、その次の文字が .Ql 0 でなければ -10 ( 10 進数 ) と見なされ、 +10 (10 進数) と見なされ、 .Ql 0 であれば -8 ( 8 進数) と見なされます。 +8 (8 進数) と見なされます。 .Pp 文字列の残りは、 与えられた基数では有効な数字ではない最初の文字のところで中止するという わかりやすいやり方で .Em long 値に変換されます。 -( 10 以上の基数では、大文字または小文字の +(10 以上の基数では、大文字または小文字の .Ql A は 10 を、 .Ql B は 11 を表し、 .Ql Z -は 35 を表します。 ) +は 35 を表します。) .Pp .Fa endptr -が nil ではない場合は、 +が空ポインタではない場合は、 .Fn strtol は最初の無効な文字のアドレスを .Fa *endptr に格納します。 数字が全くなかった場合は、 .Fn strtol は .Fa nptr の元の値を .Fa *endptr に格納します。 -( 従って、戻ったときに +(従って、戻ったときに .Fa *nptr が .Ql \e0 ではなく、 .Fa **endptr が .Ql \e0 である場合は、文字列全体が -有効だったことになります。 ) +有効だったことになります。) .Sh 戻り値 .Fn strtol 関数は、値がアンダーフローやオーバーフローを起こさない限り、 変換の結果を返します。 アンダーフローが起こった場合は、 .Fn strtol は .Dv LONG_MIN を返します。オーバーフローが起こった場合は、 .Fn strtol は .Dv LONG_MAX -を返します。いずれの場合も、 +を返します。 +.Fn strtoll +関数は、値がアンダーフローやオーバーフローを起こさない限り、 +変換の結果を返します。 +アンダーフローが起こった場合は、 +.Fn strtoll +は +.Dv LLONG_MIN +を返します。オーバーフローが起こった場合は、 +.Fn strtoll +は +.Dv LLONG_MAX +を返します。 +全ての場合、 .Va errno は .Er ERANGE に設定されます。 .Sh エラー -.Bl -tag -width [ERANGE] +.Bl -tag -width Er .It Bq Er ERANGE 与えられた文字列が値域を超えました。 変換された値は固定されています。 .El .Sh 参照 .Xr atof 3 , .Xr atoi 3 , .Xr atol 3 , .Xr strtod 3 , .Xr strtoul 3 .Sh 規格 .Fn strtol 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 +.Fn strtoll +関数は、 +.St -isoC-99 +に適合しています。 +.Bx +.Fn strtoq +関数は推奨されません。 .Sh バグ 現在のロケールを無視します。 diff --git a/ja_JP.eucJP/man/man3/strtoul.3 b/ja_JP.eucJP/man/man3/strtoul.3 index 3f25fe0464..3357ff7e78 100644 --- a/ja_JP.eucJP/man/man3/strtoul.3 +++ b/ja_JP.eucJP/man/man3/strtoul.3 @@ -1,164 +1,190 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strtoul.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/strtoul.3,v 1.3.2.5 2001/03/02 09:45:20 obrien Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRTOUL 3 .Os .Sh 名称 -.Nm strtoul, strtouq -.Nd 文字列を unsigned long 値または uquad_t 値に変換 +.Nm strtoul , strtoull , strtouq +.Nd 文字列を unsigned long 値、unsigned long long 値または uquad_t 値に変換 +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Fd #include .Ft unsigned long .Fn strtoul "const char *nptr" "char **endptr" "int base" - +.Ft unsigned long long +.Fn strtoull "const char *nptr" "char **endptr" "int base" .Fd #include .Fd #include .Fd #include .Ft u_quad_t .Fn strtouq "const char *nptr" "char **endptr" "int base" .Sh 解説 .Fn strtoul 関数は、 .Fa nptr にある文字列を .Em unsigned long -値に -変換します。 +値に変換します。 +.Fn strtoull +関数は、 +.Fa nptr +にある文字列を +.Em unsigned long long +値に変換します。 .Fn strtouq 関数は、 .Fa nptr にある文字列を .Em u_quad_t 値に変換します。 変換は与えられた .Fa base に従って行われます。 この .Fa base の値は 2 から 36 の間か、 または特別な値である 0 でなければなりません。 .Pp -文字列は、任意の数の空白文字 ( -.Xr isspace 3 -により決められるような ) で始まり、 +文字列は、任意の数の空白文字 +.Xr (isspace 3 +により決められるような) で始まり、 オプションで一つの .Ql + または .Ql - 記号が続きます。 .Fa base -がゼロか 16 のとき、文字列は接頭辞 +が 0 か 16 のとき、文字列は接頭辞 .Ql 0x を含むことができ、数字は基数を 16 として読み取られます。 -そうでないときの、ゼロの +そうでないときの、0 の .Fa base では、その次の文字が .Ql 0 でなければ -10 ( 10 進数 ) と見なされ、 +10 (10 進数) と見なされ、 .Ql 0 であれば -8 ( 8 進数 ) と見なされます。 +8 (8 進数) と見なされます。 .Pp 文字列の残りは、 与えられた基数では有効な数字ではない最初の文字のところで中止するという わかりやすいやり方で .Em unsigned long 値に変換されます。 -( 10 以上の基数では、大文字または小文字の +(10 以上の基数では、大文字または小文字の .Ql A は 10 を、 .Ql B は 11 を表し、 .Ql Z -は 35 を表します。 ) +は 35 を表します。) .Pp .Fa endptr -が nil ではない場合は、 +が空ポインタではない場合は、 .Fn strtoul は最初の無効な文字のアドレスを .Fa *endptr に格納します。 数字が全くなかった場合は、 .Fn strtoul は .Fa nptr の元の値を .Fa *endptr に格納します。 -( 従って、戻ったときに +(従って、戻ったときに .Fa *nptr が .Ql \e0 ではなく、 .Fa **endptr が .Ql \e0 である場合は、文字列全体が -有効だったことになります。 ) +有効だったことになります。) .Sh 戻り値 .Fn strtoul 関数は、 -元の ( 否定されていない ) 値がオーバーフローを起こしそうにない限り、 +元の (否定されていない) 値がオーバーフローを起こしそうにない限り、 変換の結果、もしくは先頭にマイナス記号がある場合には変換結果の否定を返します。 オーバーフローを起こす場合、 .Fn strtoul は .Dv ULONG_MAX -を返し、 +を返します。 +.Fn strtoull +関数は、 +元の (否定されていない) 値がオーバーフローを起こしそうにない限り、 +変換の結果、もしくは先頭にマイナス記号がある場合には変換結果の否定を返します。 +オーバーフローを起こす場合、 +.Fn strtoull +は +.Dv ULLONG_MAX +を返します。 +全ての場合で、 .Va errno -を +に .Er ERANGE -に設定します。 +を設定します。 .Sh エラー -.Bl -tag -width [ERANGE] +.Bl -tag -width Er .It Bq Er ERANGE 与えられた文字列が値域を超えました。 変換された値は固定されています。 .El .Sh 参照 .Xr strtol 3 .Sh 規格 .Fn strtoul 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 +.Fn strtoll +関数は、 +.St -isoC-99 +に適合しています。 +.Bx +.Fn strtoq +関数は推奨されません。 .Sh バグ 現在のロケールを無視します。 diff --git a/ja_JP.eucJP/man/man3/strxfrm.3 b/ja_JP.eucJP/man/man3/strxfrm.3 index f758560231..6af42390e1 100644 --- a/ja_JP.eucJP/man/man3/strxfrm.3 +++ b/ja_JP.eucJP/man/man3/strxfrm.3 @@ -1,79 +1,120 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" 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. .\" .\" @(#)strxfrm.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/string/strxfrm.3,v 1.11.2.2 2001/03/06 16:46:04 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt STRXFRM 3 .Os .Sh 名称 .Nm strxfrm .Nd 文字列をロケールにしたがって変換する +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft size_t .Fn strxfrm "char *dst" "const char *src" "size_t n" .Sh 解説 .Fn strxfrm 関数は、 .Fa src -により示されたヌルで終端された文字列を、 -現在のロケール対照 (localle collation) がある場合には、 +により示されたヌル文字で終了する文字列を、 +現在のロケール照合 (localle collation) がある場合には、 それに従って変換し、 -結果の文字列の -.Fa n-1 -を超えない文字を +.\"then copies the transformed string +.\"into +.\".Fa dst . +変換した文字列を .Fa dst -にコピーし、それをナル文字で終端してから -結果の長さを返します。 +にコピーします。 +.\"Not more than +.\".Fa n +.\"characters are copied into +.\".Fa dst , +.\"including the terminating null character added. +.Fa n +を越えない文字数が +.Fa dst +にヌル文字を付加してコピーされます。 +.\"If +.\".Fa n +.\"is set to 0 +.\"(it helps to determine an actual size needed +.\"for transformation), +.\".Fa dst +.\"is permitted to be a NULL pointer. +もし +.Fa n +に 0 がセットされた場合 (この場合変換に必要となる実サイズを決定するのを助けます) 、 +.Fa dst +には NULL ポインタにする事が許されます。 +.Pp .Fn strxfrm の後で .Fn strcmp を使って 2 つの文字列を比較することは、 元の 2 つの文字列を .Fn strcoll を使って比較することと同じになります。 -.Sh バグ -この関数は、時によっては予測不可能な挙動を示します。 +.Sh 戻り値 +.\"Upon successful completion, +.\".Fn strxfrm +.\"returns the length of the transformed string not including +.\"the terminating null character. +.\"If this value is +.\".Fa n +.\"or more, the contents of +.\".Fa dst +.\"are indeterminate. +完全に成功した場合、 +.Fn strxfrm +は終端のヌル文字を含まない変換された文字列の長さを返します。 +もしこの値が +.Fa n +と同じかそれより大きい場合、 +.Fa dst +の内容は不定です。 .Sh 参照 .Xr setlocale 3 , .Xr strcmp 3 , .Xr strcoll 3 .Sh 規格 .Fn strxfrm 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 diff --git a/ja_JP.eucJP/man/man3/system.3 b/ja_JP.eucJP/man/man3/system.3 index 5a012a222e..20c76a810f 100644 --- a/ja_JP.eucJP/man/man3/system.3 +++ b/ja_JP.eucJP/man/man3/system.3 @@ -1,94 +1,103 @@ .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" 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. .\" .\" @(#)system.3 8.1 (Berkeley) 6/4/93 +.\" %FreeBSD: src/lib/libc/stdlib/system.3,v 1.6.2.2 2001/03/06 16:46:02 ru Exp % .\" .\" $FreeBSD$ .Dd June 4, 1993 .Dt SYSTEM 3 .Os .Sh 名称 .Nm system .Nd コマンドをシェルに渡す +.Sh ライブラリ +.Lb libc .Sh 書式 .Fd #include .Ft int .Fn system "const char *string" .Sh 解説 .Fn system 関数は、引数 .Fa string -をコマンドインタープリタ +をコマンドインタプリタ .Xr sh 1 -に -渡します。呼び出し側プロセスは、シェルがそのコマンドの実行を完了するまで -待ち、 +に渡します。 +呼び出し元プロセスは、シェルがそのコマンドの実行を +完了するまで待ち、 .Dv SIGINT および .Dv SIGQUIT を無視し、 .Dv SIGCHLD をブロックします。 .Pp .Fa string が .Dv NULL -ポインタである場合は、 +ポインタの場合、 .Fn system -はコマンドインタープリタ +はコマンドインタプリタ .Xr sh 1 -が利用できる場合は非ゼロの値を返し、利用できない場合はゼロを -返します。 +が利用できる場合は 0 でない値を返し、 +利用できない場合は 0 を返します。 .Pp +.Xr fork 2 +もしくは +.Xr waitpid 2 +を呼び出したときにエラーが発生した場合、 .Fn system -関数は、シェルの終了ステータス、またはシェルについての -.Xr wait 2 -が失敗した場合は -\-1 を返します。戻り値 -127 は、シェルの実行が +関数は、 +.Xr waitpid 2 +で返されるシェルの終了状態、 +あるいは +\-1 を返します。 +戻り値 127 は、シェルの実行が 失敗したことを意味します。 .Sh 参照 .Xr sh 1 , .Xr execve 2 , .Xr wait 2 , +.Xr fork 2 , +.Xr waitpid 2 , .Xr popen 3 -.Pp .Sh 規格 .Fn system 関数は、 -.St -ansiC -に準拠しており、 +.St -isoC +に適合しており、 .St -p1003.2 -と互換性があると考えられます。 +と互換性があると思われます。 diff --git a/ja_JP.eucJP/man/man3/tan.3 b/ja_JP.eucJP/man/man3/tan.3 index af2666782b..f564299b82 100644 --- a/ja_JP.eucJP/man/man3/tan.3 +++ b/ja_JP.eucJP/man/man3/tan.3 @@ -1,89 +1,80 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)tan.3 5.1 (Berkeley) 5/2/91 -.\" %Id: tan.3,v 1.5 1997/02/22 15:09:45 peter Exp % +.\" %FreeBSD: src/lib/msun/man/tan.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt TAN 3 .Os .Sh 名称 .Nm tan , .Nm tanf -.Nd 正接 ( タンジェント ) 関数 +.Nd 正接関数 .Sh 書式 .Fd #include .Ft double .Fn tan "double x" .Ft float .Fn tanf "float x" .Sh 解説 .Fn tan および .Fn tanf -関数は、 -.Fa x -( -単位はラジアン -) -の正接 -( -タンジェント -) -を -計算します。引数の値が大きい場合は、意味のない結果が出る場合があります。 -丸めによる誤差については、 +関数は、(ラジアンで計測された) +.Fa x +の正接を計算します。 +大きな引数は、ほとんどまたは全く意味のない結果を生じることがあります。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 .Sh 戻り値 .Fn tan -関数は、正接 -( -タンジェント -) -値を返します。 -.Sh 参照 +関数は、正接の値を返します。 +.Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tanh 3 .Sh 規格 .Fn tan 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 + + diff --git a/ja_JP.eucJP/man/man3/tanh.3 b/ja_JP.eucJP/man/man3/tanh.3 index e3a73f22b6..b54bf58514 100644 --- a/ja_JP.eucJP/man/man3/tanh.3 +++ b/ja_JP.eucJP/man/man3/tanh.3 @@ -1,88 +1,81 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)tanh.3 5.1 (Berkeley) 5/2/91 -.\" %Id: tanh.3,v 1.5 1997/02/22 15:09:46 peter Exp % +.\" %FreeBSD: src/lib/msun/man/tanh.3,v 1.6.2.1 2001/03/06 16:46:24 ru Exp % .\" .\" $FreeBSD$ .Dd May 2, 1991 .Dt TANH 3 .Os .Sh 名称 .Nm tanh , .Nm tanhf -.Nd 双曲線正接 ( ハイパボリックタンジェント ) 関数 +.Nd 双曲正接関数 .Sh 書式 .Fd #include .Ft double .Fn tanh "double x" .Ft float .Fn tanhf "float x" .Sh 解説 +The .Fn tanh -および +and the .Fn tanhf 関数は、 -x ( -単位はラジアン -) -の双曲線正接 -( -ハイパボリックタンジェント -) -を計算します。丸めによる誤差については、 +.Fa x +の双曲正接を計算します。 +丸めによる誤差の議論は、 .Xr math 3 を参照してください。 .Sh 戻り値 .Fn tanh および .Fn tanhf -関数は、双曲線正接 -( -ハイパボリックタンジェント -) -値を返します。 -.Sh 参照 +関数は、双曲正接の値を返します。 +.Sh 関連項目 .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 .Sh 規格 .Fn tanh 関数は、 -.St -ansiC -に準拠しています。 +.St -isoC +に適合しています。 +