.\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-applied-psychology.cambridge.ac.uk>
.\"
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
.\"
.\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze <joey@infodrom.org>
.\" Modified 2001-12-14 aeb
.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
.\" all rights reserved.
.\" Translated Tue Dec 16 19:43:18 JST 1997
.\" 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"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O catopen, catclose \- open/close a message catalog
-catopen, catclose \- ¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤Î¥ª¡¼¥×¥ó/¥¯¥í¡¼¥º
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <nl_types.h>
+.TH CATOPEN 3 2001\-12\-14 GNU "Linux Programmer's Manual"
+.SH 名前
+catopen, catclose \- メッセージカタログのオープン/クローズ
+.SH 書式
+\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 );
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The function
-.\"O .BR catopen ()
-.\"O opens a message catalog and returns a catalog descriptor.
-´Ø¿ô
-.BR catopen ()
-¤Ï¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤ò¥ª¡¼¥×¥ó¤·¡¢¥«¥¿¥í¥°¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-.\"O The descriptor remains valid until
-.\"O .BR catclose ()
-.\"O or
-.\"O .BR execve (2).
-.\"O If a file descriptor is used to implement catalog descriptors
-.\"O then the
-.\"O .B FD_CLOEXEC
-.\"O flag will be set.
-¤³¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï
-.BR catclose ()
-¤Þ¤¿¤Ï
-.BR execve (2)
-¤¬¸Æ¤Ó½Ð¤µ¤ì¤ë¤Þ¤Ç͸ú¤Ç¤¢¤ë¡£
-¥«¥¿¥í¥°¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¼ÂÁõ¤¹¤ë¤¿¤á¤Ë
-¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò»ÈÍѤ¹¤ë¤È¡¢
-.B FD_CLOEXEC
-¥Õ¥é¥°¤¬ÀßÄꤵ¤ì¤ë¡£
+\fBint catclose(nl_catd \fP\fIcatalog\fP\fB);\fP
+.SH 説明
+関数 \fBcatopen\fP() はメッセージカタログをオープンし、カタログディスクリプタを返す。 このディスクリプタは \fBcatclose\fP()
+または \fBexecve\fP(2) が呼び出されるまで有効である。 カタログディスクリプタを実装するために ファイルディスクリプタを使用すると、
+\fBFD_CLOEXEC\fP フラグが設定される。
.LP
-.\"O The argument
-.\"O .I name
-.\"O specifies the name of the message catalog to be opened.
-°ú¤¿ô
-.I name
-¤Ï¥ª¡¼¥×¥ó¤¹¤ë¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤Î̾Á°¤ò»ØÄꤹ¤ë¡£
-.\"O If
-.\"O .I name
-.\"O specifies and absolute path (i.e., contains a \(aq/\(aq),
-.\"O then
-.\"O .I name
-.\"O specifies a pathname for the message catalog.
-.I name
-¤¬ÀäÂХѥ¹¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç (¤¹¤Ê¤ï¤Á \(aq/\(aq ¤ò´Þ¤ó¤Ç¤¤¤ë¾ì¹ç)¡¢
-.I name
-¤Ï¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤Ø¤Î¥Ñ¥¹Ì¾¤Ç¤¢¤ë¡£
-.\"O Otherwise, the environment variable
-.\"O .B NLSPATH
-.\"O is used with
-.\"O .I name
-.\"O substituted for
-.\"O .B %N
-.\"O (see
-.\"O .BR locale (7)).
-¤½¤ì°Ê³°¤Î¾ì¹ç¡¢´Ä¶ÊÑ¿ô
-.B NLSPATH
-¤¬
-.I name
-¤È¤È¤â¤Ë»ÈÍѤµ¤ì
-.B %N
-¤òÃÖ¤´¹¤¨¤ë
-.RB ( locale (7)
-»²¾È)¡£
-.\"O It is unspecified whether
-.\"O .B NLSPATH
-.\"O will be used when the process has root privileges.
-¥×¥í¥»¥¹¤¬ root ¸¢¸Â¤ò»ý¤Ã¤Æ¤¤¤ë¤È¤¤Ë
-.B NLSPATH
-¤¬»È¤ï¤ì¤ë¤«¤É¤¦¤«¤Ï»ØÄꤵ¤ì¤Æ¤¤¤Ê¤¤¡£
-.\"O If
-.\"O .B NLSPATH
-.\"O does not exist in the environment,
-.\"O or if a message catalog cannot be opened
-.\"O in any of the paths specified by it,
-.\"O then an implementation defined path is used.
-.B NLSPATH
-´Ä¶ÊÑ¿ô¤¬Â¸ºß¤·¤Ê¤¤¤«¡¢
-.B NLSPATH
-¤Ç»ØÄꤵ¤ì¤¿¥Ñ¥¹¤ÎÃæ¤Î
-¤É¤Î¥Ñ¥¹¤Ë¤ª¤¤¤Æ¤â¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤ò¥ª¡¼¥×¥ó¤Ç¤¤Ê¤¤¾ì¹ç¡¢
-¼ÂÁõ¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë¥Ñ¥¹¤¬»È¤ï¤ì¤ë¡£
-.\"O This latter default path may depend on the
-.\"O .B LC_MESSAGES
-.\"O locale setting when the
-.\"O .I flag
-.\"O argument is
-.\"O .B NL_CAT_LOCALE
-.\"O and on the
-.\"O .B LANG
-.\"O environment variable when the
-.\"O .I flag
-.\"O argument is 0.
-¸å¼Ô¤Î¥Ç¥Õ¥©¥ë¥È¥Ñ¥¹¤Ï¡¢
-.I flag
-°ú¤¿ô¤¬
-.B NL_CAT_LOCALE
-¤Î¾ì¹ç¤Ë¤Ï
-.B LC_MESSAGES
-¤Î¥í¥±¡¼¥ëÀßÄê¤Ë°Í¸¤·¡¢
-.I flag
-°ú¤¿ô¤¬ 0 ¤Î¾ì¹ç¤Ë¤Ï
-.B LANG
-´Ä¶ÊÑ¿ô¤Ë°Í¸¤¹¤ë¡£
-.\"O Changing the
-.\"O .B LC_MESSAGES
-.\"O part of the locale may invalidate
-.\"O open catalog descriptors.
-¥í¥±¡¼¥ë¤Î
-.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
-.\"O The
-.\"O .I flag
-.\"O argument to
-.\"O .BR catopen ()
-.\"O is used to indicate the source for the language to use.
-.BR catopen ()
-¤Î
-.I flag
-°ú¤¿ô¤Ï¡¢»ÈÍѤµ¤ì¤ë¸À¸ì¤Î¥½¡¼¥¹¤ò¼¨¤¹¤¿¤á¤Ë»È¤ï¤ì¤ë¡£
-.\"O If it is set to
-.\"O .B NL_CAT_LOCALE
-.\"O then it will use the current locale setting for
-.\"O .BR LC_MESSAGES .
-.B NL_CAT_LOCALE
-¤ËÀßÄꤵ¤ì¤ë¤È¡¢
-.B LC_MESSAGES
-¤Î¸½ºß¤Î¥í¥±¡¼¥ëÀßÄ꤬»È¤ï¤ì¤ë¡£
-.\"O Otherwise it will use the
-.\"O .B LANG
-.\"O environment variable.
-¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï
-.B LANG
-´Ä¶ÊÑ¿ô¤¬»È¤ï¤ì¤ë¡£
+\fBcatopen\fP() の \fIflag\fP 引き数は、使用される言語のソースを示すために使われる。 \fBNL_CAT_LOCALE\fP
+に設定されると、 \fBLC_MESSAGES\fP の現在のロケール設定が使われる。 それ以外の場合は \fBLANG\fP 環境変数が使われる。
.LP
-.\"O The function
-.\"O .BR catclose ()
-.\"O closes the message catalog identified by
-.\"O .IR catalog .
-´Ø¿ô
-.BR catclose ()
-¤Ï
-.I catalog
-¤Ç»ØÄꤵ¤ì¤¿¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
-.\"O It invalidates any subsequent references to the message catalog
-.\"O defined by
-.\"O .IR catalog .
-¤³¤ì¤Ï¡¢°Ê¹ß¤Î
-.I catalog
-¤Ç»ØÄꤵ¤ì¤ë¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¤Ø¤ÎÁ´¤Æ¤Î»²¾È¤ò̵¸ú¤Ë¤¹¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The function
-.\"O .BR catopen ()
-.\"O returns a message catalog descriptor of type
-.\"O .I nl_catd
-.\"O on success.
-´Ø¿ô
-.BR catopen ()
-¤¬À®¸ù¤¹¤ë¤È¡¢
-.I nl_catd
-·¿¤Î¥á¥Ã¥»¡¼¥¸¥«¥¿¥í¥°¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-.\"O On failure, it returns \fI(nl_catd)\ \-1\fP
-.\"O and sets
-.\"O .I errno
-.\"O to indicate the error.
-.\"O The possible error values include all
-.\"O possible values for the
-.\"O .BR open (2)
-.\"O call.
-¼ºÇÔ¤·¤¿¾ì¹ç¤Ï \fI(nl_catdv) \-1\fP ¤òÊÖ¤·¡¢
-.I errno
-¤òÀßÄꤷ¤Æ¥¨¥é¡¼¤ò¼¨¤¹¡£
-¤³¤³¤Çµ¯¤³¤êÆÀ¤ë¥¨¥é¡¼¤ÎÃͤˤϡ¢
-.BR open (2)
-¤Î¸Æ¤Ó½Ð¤·¤ÎºÝ¤Ëµ¯¤³¤êÆÀ¤ëÁ´¤Æ¤Î¥¨¥é¡¼¤ÎÃͤ¬´Þ¤Þ¤ì¤ë¡£
+関数 \fBcatclose\fP() は \fIcatalog\fP で指定されたメッセージカタログをクローズする。 これは、以降の \fIcatalog\fP
+で指定されるメッセージカタログへの全ての参照を無効にする。
+.SH 返り値
+関数 \fBcatopen\fP() が成功すると、 \fInl_catd\fP 型のメッセージカタログディスクリプタを返す。 失敗した場合は
+\fI(nl_catdv) \-1\fP を返し、 \fIerrno\fP を設定してエラーを示す。 ここで起こり得るエラーの値には、 \fBopen\fP(2)
+の呼び出しの際に起こり得る全てのエラーの値が含まれる。
.LP
-.\"O The function
-.\"O .BR catclose ()
-.\"O returns 0 on success, or \-1 on failure.
-´Ø¿ô
-.BR catclose ()
-¤Ï¡¢À®¸ù¤·¤¿¾ì¹ç 0 ¤ò¡¢¼ºÇÔ¤·¤¿¾ì¹ç \-1 ¤òÊÖ¤¹¡£
-.\"O .SH ENVIRONMENT
-.SH ´Ä¶ÊÑ¿ô
-.TP
-.B LC_MESSAGES
-.\"O May be the source of the
-.\"O .B LC_MESSAGES
-.\"O locale setting, and thus
-.\"O determine the language to use if
-.\"O .I flag
-.\"O is set to
-.\"O .BR NL_CAT_LOCALE .
-.B LC_MESSAGES
-¥í¥±¡¼¥ëÀßÄê¤Î¥½¡¼¥¹¤Ë¤Ê¤ë¤³¤È¤â²Äǽ¤Ê¤Î¤Ç¡¢
-.I flag
-¤¬
-.B NL_CAT_LOCALE
-¤ËÀßÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢»ÈÍѤ¹¤ë¸À¸ì¤ò·èÄꤹ¤ë¤Î¤Ë»È¤ï¤ì¤ë¡£
-.TP
-.B LANG
-.\"O The language to use if
-.\"O .I flag
-.\"O is 0.
-.I flag
-¤¬ 0 ¤Î¾ì¹ç¡¢»ÈÍѤ¹¤ë¸À¸ì¤ò·èÄꤹ¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2001.
-.\"O .\" In XPG 1987, Vol. 3 it says:
-.\"O .\" .I "The flag argument of catopen is reserved for future use"
-.\"O .\" .IR "and should be set to 0" .
-.\"O It is unclear what the source was for the constants
-.\"O .B MCLoadBySet
-.\"O and
-.\"O .B MCLoadAll
-.\"O (see below).
-.\" XPG 1987, Vol. 3 ¤Ë¤Ï¡¢¡Ö\fIcatopen ¤Î flag °ú¤¿ô¤Ï
-.\" ¾Íè»ÈÍѤ¹¤ë¤¿¤á¤ËͽÌ󤵤ì¤Æ¤¤¤ë¤Î¤Ç¡¢
-.\" 0 ¤ËÀßÄꤷ¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£\fR¡×¤È½ñ¤«¤ì¤Æ¤¤¤ë¡£
-Äê¿ô
-.B MCLoadBySet
-¤È
-.B MCLoadAll
-¤ËÂбþ¤¹¤ë¥½¡¼¥¹¤¬²¿¤Ç¤¢¤ë¤Î¤«¤¬¤Ï¤Ã¤¤ê¤·¤Æ¤¤¤Ê¤¤ (²¼µ»²¾È)¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O The above is the POSIX.1-2001 description.
-.\"O The glibc value for
-.\"O .B NL_CAT_LOCALE
-.\"O is 1.
-.\"O (Compare
-.\"O .B MCLoadAll
-.\"O below.)
-.\"O The default path varies, but usually looks at a number of places below
-.\"O .IR /usr/share/locale .
-°Ê¾å¤Ï POSIX.1-2001 ¤Ë¤ª¤±¤ëÀâÌÀ¤Ç¤¢¤ë¡£
-glibc ¤Ç¤Ï
-.B NL_CAT_LOCALE
-¤ÎÃÍ¤Ï 1 ¤Ç¤¢¤ë
-(°Ê²¼¤Î
-.B MCLoadAll
-¤ÈÈæ³Ó¤Î¤³¤È)¡£
-¥Ç¥Õ¥©¥ë¥È¤Î¥Ñ¥¹¤Ï¾ì¹ç¤Ë¤è¤Ã¤ÆÍÍ¡¹¤Ç¤¢¤ë¤¬¡¢Ä̾ï¤Ï
-.I /usr/share/locale
-°Ê²¼¤Î¥Õ¥¡¥¤¥ë¤¬Ä´¤Ù¤é¤ì¤ë¡£
-.\"O .SS Linux Notes
-.SS Linux ¤Ë¤ª¤±¤ëÃí°Õ
-.\"O These functions are available for Linux since libc 4.4.4c.
-¤³¤ì¤é¤Î´Ø¿ô¤Ï libc.so.4.4.4c °Ê¹ß¤Ç»ÈÍѲÄǽ¤Ç¤¢¤ë¡£
-.\"O In the case of linux libc4 and libc5, the catalog descriptor
-.\"O .I nl_catd
-.\"O is a
-.\"O .BR mmap (2)'ed
-.\"O area of memory and not a file descriptor.
-linux ¤Î libc4 ¤È libc5 ¤Ë¤ª¤¤¤Æ¤Ï¡¢¥«¥¿¥í¥°¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I nl_catd
-¤Ï
-.BR mmap (2)
-¤µ¤ì¤¿¥á¥â¥ê¤ÎÎΰè¤Ç¤¢¤Ã¤Æ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ï¤Ê¤¤¡£
-.\"O The
-.\"O .I flag
-.\"O argument to
-.\"O .BR catopen ()
-.\"O should be either
-.\"O .B MCLoadBySet
-.\"O (=0) or
-.\"O .B MCLoadAll
-.\"O (=1).
-.BR catopen ()
-¤Î
-.I flag
-¤Ï¡¢
-.B MCLoadBySet
-(=0) ¤«
-.B MCLoadAll
-(=1) ¤Î¤É¤Á¤é¤«¤Ç¤¢¤ë¡£
-.\"O The former value indicates that a set from the catalog is to be
-.\"O loaded when needed, whereas the latter causes the initial call to
-.\"O .BR catopen ()
-.\"O to load the entire catalog into memory.
-Á°¼Ô¤Î¾ì¹ç¡¢¥«¥¿¥í¥°¤Î¥»¥Ã¥È¤ÏɬÍ×»þ¤Ë¥í¡¼¥É¤µ¤ì¤ë¡£
-¸å¼Ô¤Î¾ì¹ç¡¢ºÇ½é¤Î
-.BR catopen ()
-¤Î¸Æ¤Ó½Ð¤·¤Î¤È¤¤ËÁ´¤Æ¤Î¥«¥¿¥í¥°¤¬¥á¥â¥êÆâ¤Ë¥í¡¼¥É¤µ¤ì¤ë¡£
-.\"O The default search path varies, but usually looks at a number of places below
-.\"O .I /etc/locale
-.\"O and
-.\"O .IR /usr/lib/locale .
-¥Ç¥Õ¥©¥ë¥È¤Î¥Ñ¥¹¤Ï¾ì¹ç¤Ë¤è¤Ã¤ÆÍÍ¡¹¤Ç¤¢¤ë¤¬¡¢Ä̾ï¤Ï
-.I /etc/locale
-¤È
-.I /usr/share/locale
-°Ê²¼¤Î¥Õ¥¡¥¤¥ë¤¬Ä´¤Ù¤é¤ì¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR catgets (3),
-.BR setlocale (3)
+関数 \fBcatclose\fP() は、成功した場合 0 を、失敗した場合 \-1 を返す。
+.SH 環境変数
+.TP
+\fBLC_MESSAGES\fP
+\fBLC_MESSAGES\fP ロケール設定のソースになることも可能なので、 \fIflag\fP が \fBNL_CAT_LOCALE\fP
+に設定されている場合は、使用する言語を決定するのに使われる。
+.TP
+\fBLANG\fP
+\fIflag\fP が 0 の場合、使用する言語を決定する。
+.SH 準拠
+.\" 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 では \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 関連項目
+\fBcatgets\fP(3), \fBsetlocale\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
