OSDN Git Service

Update release for LDP 3.67
[linuxjm/LDP_man-pages.git] / release / man3 / dirfd.3
index 0e19cfa..3d9f414 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2002 Andries Brouwer (aeb@cwi.nl)
 .\"
+.\" %%%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
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
 .\"
 .\" Japanese Version Copyright (c) 2002-2003 Yuichi SATO
 .\"         all rights reserved.
 .\" Updated & Modified Sun Sep  7 01:23:08 JST 2003
 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
 .\"
-.TH DIRFD 3 2010-09-26 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-dirfd \- ¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤Î¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
-.B #include <sys/types.h>
+.TH DIRFD 3 2013\-07\-05 Linux "Linux Programmer's Manual"
+.SH 名前
+dirfd \- ディレクトリストリームのファイルディスクリプタを取得する
+.SH 書式
+\fB#include <sys/types.h>\fP
 .br
-.B #include <dirent.h>
+\fB#include <dirent.h>\fP
 .sp
-.BI "int dirfd(DIR *" dirp );
+\fBint dirfd(DIR *\fP\fIdirp\fP\fB);\fP
 .sp
 .in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR dirfd ():
+\fBdirfd\fP():
 .br
 .RS 4
 .PD 0
 .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 ÀâÌÀ
-´Ø¿ô
-.BR dirfd ()
-¤Ï¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à
-.I dirp
-¤Ë´ØÏ¢¤Å¤±¤é¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
+.SH 説明
+関数 \fBdirfd\fP()  はディレクトリストリーム \fIdirp\fP に関連づけられたファイルディスクリプタを返す。
 .LP
-¤³¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤¬ÆâÉô¤Ç»ÈÍѤ¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
-¤è¤Ã¤Æ¡¢¥Õ¥¡¥¤¥ë¤Î°ÌÃ֤˰͸¤»¤º¡¢¤«¤Ä¤½¤Î°ÌÃÖ¤òÊѹ¹¤·¤Ê¤¤´Ø¿ô
-.BR fstat (2)
-¤ä
-.BR fchdir (2)
-¤Ê¤É¤Ç¤·¤«Ìò¤ËΩ¤¿¤Ê¤¤¡£
-¤³¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï
-.BR closedir (3)
-¤¬¸Æ¤Ð¤ì¤¿¤È¤­¤Ë¼«Æ°Åª¤Ë¥¯¥í¡¼¥º¤µ¤ì¤ë¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤¹¤ë¤È¡¢Éé¤Ç¤Ê¤¤ÃͤΥե¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤¬ÊÖ¤µ¤ì¤ë¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-POSIX.1-2008 ¤Ç¤Ï 2 ¤Ä¤Î¥¨¥é¡¼¤¬µ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
-¸½ºß¤Î¼ÂÁõ¤Ç¤Ï¤É¤Á¤é¤Î¥¨¥é¡¼¤âÊÖ¤µ¤ì¤Ê¤¤¡£
+このディスクリプタはディレクトリストリームが内部で使用するものである。 よって、ファイルの位置に依存せず、かつその位置を変更しない関数
+\fBfstat\fP(2)  や \fBfchdir\fP(2)  などでしか役に立たない。 このディスクリプタは \fBclosedir\fP(3)
+が呼ばれたときに自動的にクローズされる。
+.SH 返り値
+成功すると、負でない値のファイルディスクリプタが返される。 エラーの場合は \-1 が返され、 \fIerrno\fP にエラーの原因を示す値が設定される。
+.SH エラー
 .\" glibc 2.8
-.TP
-.B EINVAL
-.I dirp
-¤¬Í­¸ú¤Ê¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤ò»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B ENOTSUP
-¤³¤Î¼ÂÁõ¤Ç¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Î¥Ç¥£¥ì¥¯¥È¥ê¤È¤Î´ØÏ¢ÉÕ¤±¤¬
-¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.SH ½àµò
-POSIX.1-2008.
-¤³¤Î´Ø¿ô¤Ï BSD ³ÈÄ¥¤Ç¤¢¤Ã¤¿¡£
-4.3BSD-Reno ¤Ë¤Ï¸ºß¤¹¤ë¤¬¡¢4.2BSD ¤Ë¤Ï¸ºß¤·¤Ê¤¤¡£
-.\" libc5 (5.1.2 °Ê¹ß) ¤È glibc2 ¤Ë¸ºß¤¹¤ë¡£
-.SH Ãí°Õ
-.BR dirfd ()
-¤Î¥×¥í¥È¥¿¥¤¥×¤¬»ÈÍѲÄǽ¤Ê¤Î¤Ï¡¢
-.B _BSD_SOURCE
-¤Þ¤¿¤Ï
-.B _SVID_SOURCE
-¤¬ÄêµÁ¤µ¤ì¤¿¤È¤­¤Î¤ß¤Ç¤¢¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR open (2),
-.BR closedir (3),
-.BR opendir (3),
-.BR readdir (3),
-.BR rewinddir (3),
-.BR scandir (3),
-.BR seekdir (3),
-.BR telldir (3)
+POSIX.1\-2008 では 2 つのエラーが規定されている。 現在の実装ではどちらのエラーも返されない。
+.TP 
+\fBEINVAL\fP
+\fIdirp\fP が有効なディレクトリストリームを参照していない。
+.TP 
+\fBENOTSUP\fP
+この実装では、ファイルディスクリプタのディレクトリとの関連付けが サポートされていない。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBdirfd\fP() 関数はスレッドセーフである。
+.SH 準拠
+.\" It is present in libc5 (since 5.1.2) and in glibc2.
+POSIX.1\-2008.  この関数は BSD 拡張であった。 4.3BSD\-Reno には存在するが、4.2BSD には存在しない。
+.SH 注意
+\fBdirfd\fP()  のプロトタイプが使用可能なのは、 \fB_BSD_SOURCE\fP または \fB_SVID_SOURCE\fP
+が定義されたときのみである。
+.SH 関連項目
+\fBopen\fP(2), \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
+\fBscandir\fP(3), \fBseekdir\fP(3), \fBtelldir\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。