OSDN Git Service

(split) LDP: Update release from ja.po of LDP v3.51
[linuxjm/LDP_man-pages.git] / release / man3 / telldir.3
index 5e8b282..867b38f 100644 (file)
@@ -32,7 +32,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH TELLDIR 3 2009\-03\-11 "" "Linux Programmer's Manual"
+.TH TELLDIR 3 2013\-03\-24 "" "Linux Programmer's Manual"
 .SH 名前
 telldir \- ディレクトリストリーム中の現在位置を返す
 .SH 書式
@@ -61,10 +61,19 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参
 .SH 注意
 バージョン 2.1.1 以前の glibc では、 \fBtelldir\fP()9 の返り値の型は \fIoff_t\fP であった。 POSIX.1\-2001
 では \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.
 .SH 関連項目
 \fBclosedir\fP(3), \fBopendir\fP(3), \fBreaddir\fP(3), \fBrewinddir\fP(3),
 \fBscandir\fP(3), \fBseekdir\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.51 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。