.\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze <joey@infodrom.org>
.\" Modified 2001-12-14 aeb
.\"
-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\" all rights reserved.
-.\" Translated Tue Dec 16 19:43:18 JST 1997
-.\" by HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
-.\" Updated & Modified Mon Jan 14 06:48:39 JST 2002
-.\" by Yuichi SATO <ysato@h4.dion.ne.jp>
+.\"*******************************************************************
.\"
-.TH CATOPEN 3 2001-12-14 "GNU" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH CATOPEN 3 2001\-12\-14 GNU "Linux Programmer's Manual"
.SH 名前
catopen, catclose \- メッセージカタログのオープン/クローズ
.SH 書式
-.B #include <nl_types.h>
+\fB#include <nl_types.h>\fP
.sp
-.BI "nl_catd catopen(const char *" name ", int " flag );
+\fBnl_catd catopen(const char *\fP\fIname\fP\fB, int \fP\fIflag\fP\fB);\fP
-.BI "int catclose(nl_catd " catalog );
+\fBint catclose(nl_catd \fP\fIcatalog\fP\fB);\fP
.SH 説明
-関数
-.BR catopen ()
-はメッセージカタログをオープンし、カタログディスクリプタを返す。
-このディスクリプタは
-.BR catclose ()
-または
-.BR execve (2)
-が呼び出されるまで有効である。
-カタログディスクリプタを実装するために
-ファイルディスクリプタを使用すると、
-.B FD_CLOEXEC
-フラグが設定される。
+関数 \fBcatopen\fP() はメッセージカタログをオープンし、カタログディスクリプタを返す。 このディスクリプタは \fBcatclose\fP()
+または \fBexecve\fP(2) が呼び出されるまで有効である。 カタログディスクリプタを実装するために ファイルディスクリプタを使用すると、
+\fBFD_CLOEXEC\fP フラグが設定される。
.LP
-引き数
-.I name
-はオープンするメッセージカタログの名前を指定する。
-.I name
-が絶対パスで指定されている場合 (すなわち \(aq/\(aq を含んでいる場合)、
-.I name
-はメッセージカタログへのパス名である。
-それ以外の場合、環境変数
-.B NLSPATH
-が
-.I name
-とともに使用され
-.B %N
-を置き換える
-.RB ( locale (7)
-参照)。
-プロセスが root 権限を持っているときに
-.B NLSPATH
-が使われるかどうかは指定されていない。
-.B NLSPATH
-環境変数が存在しないか、
-.B NLSPATH
-で指定されたパスの中の
-どのパスにおいてもメッセージカタログをオープンできない場合、
-実装で定義されているパスが使われる。
-後者のデフォルトパスは、
-.I flag
-引き数が
-.B NL_CAT_LOCALE
-の場合には
-.B LC_MESSAGES
-のロケール設定に依存し、
-.I flag
-引き数が 0 の場合には
-.B LANG
-環境変数に依存する。
-ロケールの
-.B LC_MESSAGES
-を変更すると、
+引き数 \fIname\fP はオープンするメッセージカタログの名前を指定する。 \fIname\fP が絶対パスで指定されている場合 (すなわち
+\(aq/\(aq を含んでいる場合)、 \fIname\fP はメッセージカタログへのパス名である。 それ以外の場合、環境変数 \fBNLSPATH\fP が
+\fIname\fP とともに使用され \fB%N\fP を置き換える (\fBlocale\fP(7) 参照)。 プロセスが root 権限を持っているときに
+\fBNLSPATH\fP が使われるかどうかは指定されていない。 \fBNLSPATH\fP 環境変数が存在しないか、 \fBNLSPATH\fP
+で指定されたパスの中の どのパスにおいてもメッセージカタログをオープンできない場合、 実装で定義されているパスが使われる。 後者のデフォルトパスは、
+\fIflag\fP 引き数が \fBNL_CAT_LOCALE\fP の場合には \fBLC_MESSAGES\fP のロケール設定に依存し、 \fIflag\fP 引き数が
+0 の場合には \fBLANG\fP 環境変数に依存する。 ロケールの \fBLC_MESSAGES\fP を変更すると、
オープンされているカタログディスクリプタが無効になるかもしれない。
.LP
-.BR catopen ()
-の
-.I flag
-引き数は、使用される言語のソースを示すために使われる。
-.B NL_CAT_LOCALE
-に設定されると、
-.B LC_MESSAGES
-の現在のロケール設定が使われる。
-それ以外の場合は
-.B LANG
-環境変数が使われる。
+\fBcatopen\fP() の \fIflag\fP 引き数は、使用される言語のソースを示すために使われる。 \fBNL_CAT_LOCALE\fP
+に設定されると、 \fBLC_MESSAGES\fP の現在のロケール設定が使われる。 それ以外の場合は \fBLANG\fP 環境変数が使われる。
.LP
-関数
-.BR catclose ()
-は
-.I catalog
-で指定されたメッセージカタログをクローズする。
-これは、以降の
-.I catalog
+関数 \fBcatclose\fP() は \fIcatalog\fP で指定されたメッセージカタログをクローズする。 これは、以降の \fIcatalog\fP
で指定されるメッセージカタログへの全ての参照を無効にする。
.SH 返り値
-関数
-.BR catopen ()
-が成功すると、
-.I nl_catd
-型のメッセージカタログディスクリプタを返す。
-失敗した場合は \fI(nl_catdv) \-1\fP を返し、
-.I errno
-を設定してエラーを示す。
-ここで起こり得るエラーの値には、
-.BR open (2)
+関数 \fBcatopen\fP() が成功すると、 \fInl_catd\fP 型のメッセージカタログディスクリプタを返す。 失敗した場合は
+\fI(nl_catdv) \-1\fP を返し、 \fIerrno\fP を設定してエラーを示す。 ここで起こり得るエラーの値には、 \fBopen\fP(2)
の呼び出しの際に起こり得る全てのエラーの値が含まれる。
.LP
-関数
-.BR catclose ()
-は、成功した場合 0 を、失敗した場合 \-1 を返す。
+関数 \fBcatclose\fP() は、成功した場合 0 を、失敗した場合 \-1 を返す。
.SH 環境変数
-.TP
-.B LC_MESSAGES
-.B LC_MESSAGES
-ロケール設定のソースになることも可能なので、
-.I flag
-が
-.B NL_CAT_LOCALE
+.TP
+\fBLC_MESSAGES\fP
+\fBLC_MESSAGES\fP ロケール設定のソースになることも可能なので、 \fIflag\fP が \fBNL_CAT_LOCALE\fP
に設定されている場合は、使用する言語を決定するのに使われる。
-.TP
-.B LANG
-.I flag
-が 0 の場合、使用する言語を決定する。
+.TP
+\fBLANG\fP
+\fIflag\fP が 0 の場合、使用する言語を決定する。
.SH 準拠
-POSIX.1-2001.
-.\" XPG 1987, Vol. 3 には、「\fIcatopen の flag 引き数は
-.\" 将来使用するために予約されているので、
-.\" 0 に設定しておくべきである。\fR」と書かれている。
-定数
-.B MCLoadBySet
-と
-.B MCLoadAll
-に対応するソースが何であるのかがはっきりしていない (下記参照)。
+.\" In XPG 1987, Vol. 3 it says:
+.\" .I "The flag argument of catopen is reserved for future use"
+.\" .IR "and should be set to 0" .
+POSIX.1\-2001. 定数 \fBMCLoadBySet\fP と \fBMCLoadAll\fP に対応するソースが何であるのかがはっきりしていない
+(下記参照)。
.SH 注意
-以上は POSIX.1-2001 における説明である。
-glibc では
-.B NL_CAT_LOCALE
-の値は 1 である
-(以下の
-.B MCLoadAll
-と比較のこと)。
-デフォルトのパスは場合によって様々であるが、通常は
-.I /usr/share/locale
-以下のファイルが調べられる。
-.SS Linux における注意
-これらの関数は libc.so.4.4.4c 以降で使用可能である。
-linux の libc4 と libc5 においては、カタログディスクリプタ
-.I nl_catd
-は
-.BR mmap (2)
-されたメモリの領域であってファイルディスクリプタではない。
-.BR catopen ()
-の
-.I flag
-は、
-.B MCLoadBySet
-(=0) か
-.B MCLoadAll
-(=1) のどちらかである。
-前者の場合、カタログのセットは必要時にロードされる。
-後者の場合、最初の
-.BR catopen ()
-の呼び出しのときに全てのカタログがメモリ内にロードされる。
-デフォルトのパスは場合によって様々であるが、通常は
-.I /etc/locale
-と
-.I /usr/share/locale
+以上は POSIX.1\-2001 における説明である。 glibc では \fBNL_CAT_LOCALE\fP の値は 1 である (以下の
+\fBMCLoadAll\fP と比較のこと)。 デフォルトのパスは場合によって様々であるが、通常は \fI/usr/share/locale\fP
以下のファイルが調べられる。
+.SS "Linux における注意"
+これらの関数は libc.so.4.4.4c 以降で使用可能である。 linux の libc4 と libc5 においては、カタログディスクリプタ
+\fInl_catd\fP は \fBmmap\fP(2) されたメモリの領域であってファイルディスクリプタではない。 \fBcatopen\fP() の
+\fIflag\fP は、 \fBMCLoadBySet\fP (=0) か \fBMCLoadAll\fP (=1) のどちらかである。
+前者の場合、カタログのセットは必要時にロードされる。 後者の場合、最初の \fBcatopen\fP()
+の呼び出しのときに全てのカタログがメモリ内にロードされる。 デフォルトのパスは場合によって様々であるが、通常は \fI/etc/locale\fP と
+\fI/usr/share/locale\fP 以下のファイルが調べられる。
.SH 関連項目
-.BR catgets (3),
-.BR setlocale (3)
+\fBcatgets\fP(3), \fBsetlocale\fP(3)
OSDN Git Service
