OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / dirfd.3
index 0e19cfa..3a1810a 100644 (file)
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 2002-2003 Yuichi SATO
-.\"         all rights reserved.
-.\" Translated Mon May  6 21:32:36 JST 2002
-.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
-.\" Updated & Modified Sun Sep  7 01:23:08 JST 2003
-.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH DIRFD 3 2010-09-26 "Linux" "Linux Programmer's Manual"
-.SH Ì¾Á°
-dirfd \- ¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¹¥È¥ê¡¼¥à¤Î¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
-.B #include <sys/types.h>
+.\"*******************************************************************
+.TH DIRFD 3 2010\-09\-26 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 が返される。
+.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 準拠
+.\" 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)