Convert release and draft pages to UTF-8.

[linuxjm/jm.git] / manual / LDP_man-pages / release / man3 / dirfd.3

diff --git a/manual/LDP_man-pages/release/man3/dirfd.3 b/manual/LDP_man-pages/release/man3/dirfd.3
index 0e19cfa..8228581 100644 (file)
--- a/manual/LDP_man-pages/release/man3/dirfd.3
+++ b/manual/LDP_man-pages/release/man3/dirfd.3
@@ -29,9 +29,9 @@
 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
 .\"
 .TH DIRFD 3 2010-09-26 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-dirfd \- ¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤Î¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+dirfd \- ディレクトリ・ストリームのファイル・ディスクリプタを取得する
+.SH 書式
 .B #include <sys/types.h>
 .br
 .B #include <dirent.h>
@@ -39,9 +39,9 @@ dirfd \- 
 .BI "int dirfd(DIR *" dirp );
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
 .RB ( feature_test_macros (7)
-»²¾È):
+参照):
 .in
 .sp
 .BR dirfd ():
@@ -51,57 +51,57 @@ glibc 
 .ad l
 _BSD_SOURCE || _SVID_SOURCE
 .br
-|| /* glibc 2.10 °Ê¹ß: */
+|| /* glibc 2.10 以降: */
 .RS 4
 (_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700)
 .RE
 .PD
 .RE
 .ad
-.SH ÀâÌÀ
-´Ø¿ô
+.SH 説明
+関数
 .BR dirfd ()
-¤Ï¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à
+はディレクトリ・ストリーム
 .I dirp
-¤Ë´ØÏ¢¤Å¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
+に関連づけられたファイル・ディスクリプタを返す。
 .LP
-¤³¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤¬ÆâÉô¤Ç»ÈÍѤ¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
-¤è¤Ã¤Æ¡¢¥Õ¥¡¥¤¥ë¤Î°ÌÃ֤˰͸¤»¤º¡¢¤«¤Ä¤½¤Î°ÌÃÖ¤òÊѹ¹¤·¤Ê¤¤´Ø¿ô
+このディスクリプタはディレクトリ・ストリームが内部で使用するものである。
+よって、ファイルの位置に依存せず、かつその位置を変更しない関数
 .BR fstat (2)
-¤ä
+や
 .BR fchdir (2)
-¤Ê¤É¤Ç¤·¤«Ìò¤ËΩ¤¿¤Ê¤¤¡£
-¤³¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï
+などでしか役に立たない。
+このディスクリプタは
 .BR closedir (3)
-¤¬¸Æ¤Ð¤ì¤¿¤È¤­¤Ë¼«Æ°Åª¤Ë¥¯¥í¡¼¥º¤µ¤ì¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢Éé¤Ç¤Ê¤¤ÃͤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬ÊÖ¤µ¤ì¤ë¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-POSIX.1-2008 ¤Ç¤Ï 2 ¤Ä¤Î¥¨¥é¡¼¤¬µ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
-¸½ºß¤Î¼ÂÁõ¤Ç¤Ï¤É¤Á¤é¤Î¥¨¥é¡¼¤âÊÖ¤µ¤ì¤Ê¤¤¡£
+が呼ばれたときに自動的にクローズされる。
+.SH 返り値
+成功すると、負でない値のファイルディスクリプタが返される。
+エラーの場合は \-1 が返される。
+.SH ã\82¨ã\83©ã\83¼
+POSIX.1-2008 では 2 つのエラーが規定されている。
+現在の実装ではどちらのエラーも返されない。
 .\" glibc 2.8
 .TP
 .B EINVAL
 .I dirp
-¤¬Í­¸ú¤Ê¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤ò»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
+が有効なディレクトリ・ストリームを参照していない。
 .TP
 .B ENOTSUP
-¤³¤Î¼ÂÁõ¤Ç¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¥Ç¥£¥ì¥¯¥È¥ê¤È¤Î´ØÏ¢ÉÕ¤±¤¬
-¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.SH ½àµò
+この実装では、ファイルディスクリプタのディレクトリとの関連付けが
+サポートされていない。
+.SH 準拠
 POSIX.1-2008.
-¤³¤Î´Ø¿ô¤Ï BSD ³ÈÄ¥¤Ç¤¢¤Ã¤¿¡£
-4.3BSD-Reno ¤Ë¤Ï¸ºß¤¹¤ë¤¬¡¢4.2BSD ¤Ë¤Ï¸ºß¤·¤Ê¤¤¡£
-.\" libc5 (5.1.2 °Ê¹ß) ¤È glibc2 ¤Ë¸ºß¤¹¤ë¡£
-.SH Ãí°Õ
+この関数は BSD 拡張であった。
+4.3BSD-Reno には存在するが、4.2BSD には存在しない。
+.\" libc5 (5.1.2 以降) と glibc2 に存在する。
+.SH 注意
 .BR dirfd ()
-¤Î¥×¥í¥È¥¿¥¤¥×¤¬»ÈÍѲÄǽ¤Ê¤Î¤Ï¡¢
+のプロトタイプが使用可能なのは、
 .B _BSD_SOURCE
-¤Þ¤¿¤Ï
+または
 .B _SVID_SOURCE
-¤¬ÄêµÁ¤µ¤ì¤¿¤È¤­¤Î¤ß¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
+が定義されたときのみである。
+.SH 関連項目
 .BR open (2),
 .BR closedir (3),
 .BR opendir (3),