(split) LDP: Update release from the latest PO files

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

diff --git a/release/man3/telldir.3 b/release/man3/telldir.3
index 867b38f..2df8837 100644 (file)
--- a/release/man3/telldir.3
+++ b/release/man3/telldir.3
@@ -63,13 +63,11 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参
 では \fIlong\fP と規定されており、glibc 2.1.2 以降では \fIlong\fP になっている。
 
 .\" https://lwn.net/Articles/544298/
-In early file systems, the value returned by \fBtelldir\fP()  was a simple file
-offset within a directory.  Modern file systems use tree or hash structures,
-rather than flat tables, to represent directories.  On such file systems,
-the value returned by \fBtelldir\fP()  (and used internally by \fBreaddir\fP(3))
-is a "cookie" that is used by the implementation to derive a position within
-a directory.  Application programs should treat this strictly as an opaque
-value, making \fIno\fP assumptions about its contents.
+初期のファイルシステムでは、 \fBtelldir\fP()
+が返す値は単なるディレクトリ内のファイルオフセットであった。新しめのファイルシステムでは、ディレクトリを表現するのに、フラットなテーブルではなく、ツリーやハッシュ構造が使用されている。このようなファイルシステムでは、
+\fBtelldir\fP() が返す値 (および \fBreaddir\fP(3) が内部で使用する値)
+は、ディレクトリ内での値を示すのにファイルシステム実装が使っている "cookie"
+となる。アプリケーションプログラムでは、必ずこの値を内容を意識せず単なる値として扱うべきであり、その内容について前提を持つべきでは「ない」。
 .SH 関連項目
 \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
 \fBscandir\fP(3), \fBseekdir\fP(3)