Update release for LDP 3.67

[linuxjm/LDP_man-pages.git] / release / man3 / fts.3

diff --git a/release/man3/fts.3 b/release/man3/fts.3
index 70506ea..3c3fbff 100644 (file)
--- a/release/man3/fts.3
+++ b/release/man3/fts.3
@@ -48,7 +48,7 @@
 .\" Translated Tue Jul 11 19:02:58 JST 2000
 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
 .\"
-.TH FTS 3 2012\-10\-25 Linux "Linux Programmer's Manual"
+.TH FTS 3 2014\-03\-18 Linux "Linux Programmer's Manual"
 .SH 名前
 fts, fts_open, fts_read, fts_children, fts_set, fts_close \- ファイル階層をたどる
 .SH 書式
@@ -192,8 +192,8 @@ postorder でたどられるディレクトリ。 \fIFTSENT\fP 構造体の内
 \fIfts_pointer\fP フィールドのみの初期化しか保証されない。
 .TP 
 \fIfts_link\fP
-\fBfts_children\fP()  から返される場合、 \fIfts_link\fP フィールドはディレクトリメンバーの NUL
-終端されたリンクリストの形式で、 次の構造体を指し示す。 それ以外の場合、 \fIfts_link\fP フィールドは定義されない。
+\fBfts_children\fP()  から返される場合、 \fIfts_link\fP フィールドはディレクトリメンバーのヌル終端されたリンクリストの形式で、
+次の構造体を指し示す。 それ以外の場合、 \fIfts_link\fP フィールドは定義されない。
 .TP 
 \fIfts_cycle\fP
 2 つのディレクトリにハードリンクが張られているため、 または、シンボリックリンクがあるディレクトリを指しているために、
@@ -206,14 +206,14 @@ postorder でたどられるディレクトリ。 \fIFTSENT\fP 構造体の内
 このファイルの \fBstat\fP(2)  情報へのポインタ。
 .PP
 ファイル階層中のすべてのファイルのパスに対して、 ただ 1 つのバッファーが使われる。 したがって、 \fIfts_path\fP と
-\fIfts_accpath\fP フィールドは、 \fBfts_read\fP()  によって返された最も新しいファイルに対して「のみ」 NULL
-終端されることが保証される。 これらのフィールドを、他の \fIFTSENT\fP 構造体で表現されるファイルを参照するために使うには、 \fIFTSENT\fP
-æ§\8bé\80 ä½\93ã\81® \fIfts_pathlen\fP ã\83\95ã\82£ã\83¼ã\83«ã\83\89ã\81«ã\81\82ã\82\8bæ\83\85å ±ã\82\92使ã\81£ã\81¦ã\83\91ã\82¹ã\81®ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82\92修正ã\81\99ã\82\8bå¿\85è¦\81ã\81\8cã\81\82ã\82\8bã\80\82 ã\81\93ã\82\8cã\82\89ã\81®ä¿®æ­£ã\81¯ã\80\81ã\81\95ã\82\89ã\81«
-\fBfts_read\fP()  を呼び出そうとする場合には、元に戻しておかなければならない。 \fIfts_name\fP フィールドは、常に \fBNUL\fP
-終端される。
+\fIfts_accpath\fP フィールドは、 \fBfts_read\fP()
+によって返された最も新しいファイルに対して「のみ」ヌル終端されることが保証される。 これらのフィールドを、他の \fIFTSENT\fP
+æ§\8bé\80 ä½\93ã\81§è¡¨ç\8f¾ã\81\95ã\82\8cã\82\8bã\83\95ã\82¡ã\82¤ã\83«ã\82\92å\8f\82ç\85§ã\81\99ã\82\8bã\81\9fã\82\81ã\81«ä½¿ã\81\86ã\81«ã\81¯ã\80\81 \fIFTSENT\fP æ§\8bé\80 ä½\93ã\81® \fIfts_pathlen\fP
+フィールドにある情報を使ってパスのバッファーを修正する必要がある。 これらの修正は、さらに \fBfts_read\fP()
+を呼び出そうとする場合には、元に戻しておかなければならない。 \fIfts_name\fP フィールドは、常に \fBNUL\fP 終端される。
 .SS fts_open()
 \fBfts_open\fP()  関数は、文字列ポインタの配列へのポインタを引き数に取る。 この文字列ポインタは、論理ファイル階層をつくる 1
-つ以上のパスの名前になる。 配列は、 \fBNULL\fP ポインタで終端されなければならない。
+つ以上のパスの名前になる。 配列は、 null ポインタで終端されなければならない。
 .PP
 .\" .Bl -tag -width "FTS_PHYSICAL"
 多くのオプションがあり、少なくとも 1 つ (\fBFTS_LOGICAL\fP または \fBFTS_PHYSICAL\fP)  が指定されなければならない。
@@ -277,7 +277,7 @@ postorder でたどられるディレクトリ。 \fIFTSENT\fP 構造体の内
 \fIFTSENT\fP 構造体が返された後、 \fBfts_read\fP()  の呼出しがあるまで、 これらの構造体は上書きされない。
 .SS fts_children()
 \fBfts_children\fP()  関数は、 \fIFTSENT\fP 構造体へのポインタを返す。 この構造体は、( \fBfts_read\fP()
-で最も新しく返された \fIFTSENT\fP 構造体で表現されるディレクトリにあるファイルの)  NUL 終端されたリンクリストの最初のエントリを記述する。
+で最も新しく返された \fIFTSENT\fP 構造体で表現されるディレクトリにあるファイルの) ヌル終端されたリンクリストの最初のエントリを記述する。
 このリストは、 \fIFTSENT\fP 構造体の \fIfts_link\fP フィールドを使ってリンクされ、
 ユーザー指定の比較関数がある場合は、それで順序づけられる。 \fBfts_children\fP()  の呼出しを繰り返すことで、
 このリンクリストは再生成される。
@@ -350,6 +350,10 @@ preorder でたどられたディレクトリでない場合や 何も含んで
 .SH バージョン
 これらの関数は、Linux では glibc2 から使用可能である。
 .SH 準拠
+4.4BSD.
+.SH バグ
+.\" https://sourceware.org/bugzilla/show_bug.cgi?id=15838
+.\" https://sourceware.org/bugzilla/show_bug.cgi?id=11460
 .\" The following statement is years old, and seems no closer to
 .\" being true -- mtk
 .\" The
@@ -357,10 +361,11 @@ preorder でたどられたディレクトリでない場合や 何も含んで
 .\" utility is expected to be included in a future
 .\" POSIX.1
 .\" revision.
-4.4BSD.
+このマニュアルページで説明した API はいずれも、 LFS API を使うプログラムをコンパイルする場合
+(例えば、\fI\-D_FILE_OFFSET_BITS=64\fP でコンパイルする場合など)、安全ではない。
 .SH 関連項目
 \fBfind\fP(1), \fBchdir\fP(2), \fBstat\fP(2), \fBftw\fP(3), \fBqsort\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。