X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=draft%2Fman2%2Fstat.2;h=49376e3f08f3fb73d73af7c670af43c80e35b7b0;hb=fe231d72006b46400bc8bf48d8bca24b62994b25;hp=186abc479fdf6b64ef7869fe95bb4d72a3f26fb9;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git

diff --git a/draft/man2/stat.2 b/draft/man2/stat.2
index 186abc47..49376e3f 100644
--- a/draft/man2/stat.2
+++ b/draft/man2/stat.2
@@ -1,10 +1,9 @@
-'\" t
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
+.\" t
 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
 .\" Parts Copyright (c) 1995 Nicolai Langfeldt (janl@ifi.uio.no), 1/1/95
-.\" and Copyright (c) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
+.\" and Copyright (c) 2006, 2007, 2014 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%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.
@@ -24,6 +23,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" Modified by Michael Haardt <michael@moria.de>
 .\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
@@ -37,9 +37,14 @@
 .\" 2007-06-08 mtk: Added example program
 .\" 2007-07-05 mtk: Added details on underlying system call interfaces
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1998-1999 HANATAKA Shinya
 .\" and Copyright (c) 2005-2008 Akihiro MOTOKI
-.\"
 .\" Translated 1998-06-21, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
 .\" Modified 1999-04-16, HANATAKA Shinya
 .\" Updated 2000-01-03, Kentaro Shirakata <argrath@ub32.org>
@@ -52,861 +57,463 @@
 .\" Updated 2006-07-21, Akihiro MOTOKI, LDP v2.36
 .\" Updated 2007-06-13, Akihiro MOTOKI, LDP v2.55
 .\" Updated 2008-09-19, Akihiro MOTOKI, LDP v3.08
+.\" Updated 2012-04-30, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2012-05-29, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
 .\"
-.\"WORD:	status			¾õÂÖ
-.\"WORD:	directory		¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD:	open			¥ª¡¼¥×¥ó
-.\"WORD:	implement		¼ÂÁõ
-.\"WORD:	owner			½êÍ­¼Ô
-.\"WORD:	group			¥°¥ë¡¼¥×
-.\"WORD:	user			¥æ¡¼¥¶¡¼
-.\"WORD:	other			¾¿Í
-.\"WORD:	hard link count		¥Ï¡¼¥É¡¦¥ê¥ó¥¯¿ô
-.\"WORD:	symbolic link		¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
-.\"WORD:	socket			¥½¥±¥Ã¥È
-.\"WORD:	device			¥Ç¥Ð¥¤¥¹
-.\"WORD:	sticky bit		¥¹¥Æ¥£¥Ã¥­¡¼¡¦¥Ó¥Ã¥È
-.\"WORD:	mandatory locking	¶¯À©¥í¥Ã¥¯
-.\"
-.TH STAT 2 2009-09-30 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O stat, fstat, lstat \- get file status
-stat, fstat, lstat \- ¥Õ¥¡¥¤¥ë¤Î¾õÂÖ¤ò¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <sys/types.h>
+.TH STAT 2 2014\-05\-10 Linux "Linux Programmer's Manual"
+.SH 名前
+stat, fstat, lstat, fstatat \- ファイルの状態を取得する
+.SH 書式
+.nf
+\fB#include <sys/types.h>\fP
 .br
-.B #include <sys/stat.h>
+\fB#include <sys/stat.h>\fP
 .br
-.B #include <unistd.h>
+\fB#include <unistd.h>\fP
 .sp
-.BI "int stat(const char *" path ", struct stat *" buf );
+\fBint stat(const char *\fP\fIpathname\fP\fB, struct stat *\fP\fIbuf\fP\fB);\fP
 .br
-.BI "int fstat(int " fd ", struct stat *" buf );
+\fBint fstat(int \fP\fIfd\fP\fB, struct stat *\fP\fIbuf\fP\fB);\fP
 .br
-.BI "int lstat(const char *" path ", struct stat *" buf );
+\fBint lstat(const char *\fP\fIpathname\fP\fB, struct stat *\fP\fIbuf\fP\fB);\fP
+.sp
+\fB#include <fcntl.h>           \fP/* AT_* 定数の定義 */
+\fB#include <sys/stat.h>\fP
+.sp
+\fBint fstatat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpathname\fP\fB, struct stat *\fP\fIbuf\fP\fB,\fP
+\fB            int \fP\fIflags\fP\fB);\fP
+.fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
+.ad l
+.PD 0
 .sp
-.BR lstat ():
-_BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+\fBlstat\fP():
+.RS 4
+/* glibc 2.19 以前 */ _BSD_SOURCE ||
+.br
+/* glibc 2.20 以降 */_DEFAULT_SOURCE ||
+.br
+_XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+.br
+|| /* glibc 2.10 以降: */ _POSIX_C_SOURCE\ >=\ 200112L
+.RE
+.sp
+\fBfstatat\fP():
+.PD 0
+.ad l
+.RS 4
+.TP  4
+glibc 2.10 以降:
+_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
+.TP 
+glibc 2.10 より前:
+_ATFILE_SOURCE
+.RE
+.PD
+.ad
+.SH 説明
 .PP
-.\"O These functions return information about a file.
-.\"O No permissions are required on the file itself, but \(em in the case of
-.\"O .BR stat ()
-.\"O and
-.\"O .BR lstat ()
-.\"O \(em
-.\"O execute (search) permission is required on all of the directories in
-.\"O .I path
-.\"O that lead to the file.
-¤³¤ì¤é¤Î´Ø¿ô¤Ï¥Õ¥¡¥¤¥ë¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤òÊÖ¤¹¡£
-¥Õ¥¡¥¤¥ë¤½¤Î¤â¤Î¤ËÂФ¹¤ë¥¢¥¯¥»¥¹µö²Ä¤ÏɬÍפȤ·¤Ê¤¤¤¬¡¢
-\(em
-.BR stat ()
-¤È
-.BR lstat ()
-¤Î¾ì¹ç¤Ë¤Ï
-\(em
-¤½¤Î¥Õ¥¡¥¤¥ë¤Ø»ê¤ë
-.I path
-¤ò¹½À®¤¹¤ëÁ´¤Æ¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ËÂФ¹¤ë¼Â¹Ô (¸¡º÷) µö²Ä¤¬É¬ÍפǤ¢¤ë¡£
+これらの関数は、ファイルについての情報を \fIstat\fP が指すバッファに格納して返す。 ファイルそのものに対するアクセス許可は必要としないが、
+\(em\fBstat\fP(), \fBfstatat\fP(), \fBlstat\fP() の場合には \(emそのファイルへ至る \fIpathname\fP
+を構成する全てのディレクトリに対する実行 (検索) 許可が必要である。
 .PP
-.\"O .BR stat ()
-.\"O stats the file pointed to by
-.\"O .I path
-.\"O and fills in
-.\"O .IR buf .
-.BR stat ()
-¤Ï
-.I path
-¤Ç»ØÄꤵ¤ì¤¿¥Õ¥¡¥¤¥ë¤Î¾õÂÖ¤ò¼èÆÀ¤·¤Æ
-.I buf
-¤Ø³ÊǼ¤¹¤ë¡£
-
-.\"O .BR lstat ()
-.\"O is identical to
-.\"O .BR stat (),
-.\"O except that if
-.\"O .I path
-.\"O is a symbolic link, then the link itself is stat-ed,
-.\"O not the file that it refers to.
-.BR lstat ()
-¤Ï
-.BR stat ()
-¤ÈƱ¤¸¤Ç¤¢¤ë¤¬¡¢
-.I path
-¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¤Ç¤Ï¤Ê¤¯¡¢
-¥ê¥ó¥¯¼«¿È¤Î¾õÂÖ¤ò¼èÆÀ¤¹¤ëÅÀ¤¬°Û¤Ê¤ë¡£
-
-.\"O .BR fstat ()
-.\"O is identical to
-.\"O .BR stat (),
-.\"O except that the file to be stat-ed is specified by the file descriptor
-.\"O .IR fd .
-.BR fstat ()
-¤Ï
-.BR stat ()
-¤ÈƱ¤¸¤À¤¬¡¢
-¾õÂÖ¤ò¼èÆÀ¤¹¤ë¥Õ¥¡¥¤¥ë¤ò¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿
-.I fd
-¤Ç»ØÄꤹ¤ë¡£
+\fBstat\fP() と \fBfstatat\fP() は \fIpathname\fP が指すファイルに関する情報を取得する。 \fBfstatat\fP()
+の違いについては後で説明する。
+
+\fBlstat\fP()  は \fBstat\fP()  と同じであるが、 \fIpathnames\fP
+がシンボリックリンクの場合、リンクが参照しているファイルではなく、 リンク自身の状態を返す点が異なる。
+
+\fBfstat\fP()  は \fBstat\fP()  と同じだが、 状態を取得するファイルをファイルディスクリプタ \fIfd\fP で指定する点が異なる。
 .PP
-.\"O All of these system calls return a
-.\"O .I stat
-.\"O structure, which contains the following fields:
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¤¤¤º¤ì¤â¡¢·ë²Ì¤ò
-.I stat
-¹½Â¤ÂΤËÆþ¤ì¤ÆÊÖ¤¹¡£
-.I stat
-¹½Â¤ÂΤˤϰʲ¼¤Î¥Õ¥£¡¼¥ë¥É¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë:
+これらのシステムコールはいずれも、結果を \fIstat\fP 構造体に入れて返す。 \fIstat\fP 構造体には以下のフィールドが含まれている:
 .PP
 .in +4n
 .nf
 struct stat {
-.\"O     dev_t     st_dev;     /* ID of device containing file */
-.\"O     ino_t     st_ino;     /* inode number */
-.\"O     mode_t    st_mode;    /* protection */
-.\"O     nlink_t   st_nlink;   /* number of hard links */
-.\"O     uid_t     st_uid;     /* user ID of owner */
-.\"O     gid_t     st_gid;     /* group ID of owner */
-.\"O     dev_t     st_rdev;    /* device ID (if special file) */
-.\"O     off_t     st_size;    /* total size, in bytes */
-.\"O     blksize_t st_blksize; /* blocksize for file system I/O */
-.\"O     blkcnt_t  st_blocks;  /* number of 512B blocks allocated */
-.\"O     time_t    st_atime;   /* time of last access */
-.\"O     time_t    st_mtime;   /* time of last modification */
-.\"O     time_t    st_ctime;   /* time of last status change */
-    dev_t     st_dev;     /* ¥Õ¥¡¥¤¥ë¤¬¤¢¤ë¥Ç¥Ð¥¤¥¹¤Î ID */
-    ino_t     st_ino;     /* inode ÈÖ¹æ */
-    mode_t    st_mode;    /* ¥¢¥¯¥»¥¹Êݸî */
-    nlink_t   st_nlink;   /* ¥Ï¡¼¥É¥ê¥ó¥¯¤Î¿ô */
-    uid_t     st_uid;     /* ½êÍ­¼Ô¤Î¥æ¡¼¥¶ ID */
-    gid_t     st_gid;     /* ½êÍ­¼Ô¤Î¥°¥ë¡¼¥× ID */
-    dev_t     st_rdev;    /* ¥Ç¥Ð¥¤¥¹ ID (Æüì¥Õ¥¡¥¤¥ë¤Î¾ì¹ç) */
-    off_t     st_size;    /* Á´ÂΤΥµ¥¤¥º (¥Ð¥¤¥Èñ°Ì) */
-    blksize_t st_blksize; /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à I/O ¤Ç¤Î
-                             ¥Ö¥í¥Ã¥¯¥µ¥¤¥º */
-    blkcnt_t  st_blocks;  /* ³ä¤êÅö¤Æ¤é¤ì¤¿ 512B ¤Î¥Ö¥í¥Ã¥¯¿ô */
-    time_t    st_atime;   /* ºÇ½ª¥¢¥¯¥»¥¹»þ¹ï */
-    time_t    st_mtime;   /* ºÇ½ª½¤Àµ»þ¹ï */
-    time_t    st_ctime;   /* ºÇ½ª¾õÂÖÊѹ¹»þ¹ï */
+    dev_t     st_dev;     /* ファイルがあるデバイスの ID */
+    ino_t     st_ino;     /* inode 番号 */
+    mode_t    st_mode;    /* アクセス保護 */
+    nlink_t   st_nlink;   /* ハードリンクの数 */
+    uid_t     st_uid;     /* 所有者のユーザ ID */
+    gid_t     st_gid;     /* 所有者のグループ ID */
+    dev_t     st_rdev;    /* デバイス ID (特殊ファイルの場合) */
+    off_t     st_size;    /* 全体のサイズ (バイト単位) */
+    blksize_t st_blksize; /* ファイルシステム I/O での
+                             ブロックサイズ */
+    blkcnt_t  st_blocks;  /* 割り当てられた 512B のブロック数 */
+};
+
+    /* Linux 2.6 以降では、カーネルは以下のタイムスタンプ
+       フィールドでナノ秒の精度をサポートしている。
+       Linux 2.6 より前のバージョンでの詳細は
+       下記の「注意」を参照。 */
+
+    struct timespec st_atim;  /* 最終アクセス時刻 */
+    struct timespec st_mtim;  /* 最終修正時刻 */
+    struct timespec st_ctim;  /* 最終状態変更時刻 */
+
+#define st_atime st_atim.tv_sec      /* 後方互換性 */
+#define st_mtime st_mtim.tv_sec
+#define st_ctime st_ctim.tv_sec
 };
 .fi
 .in
+
+\fI注意:\fP \fIstat\fP 構造体のフィールドの順序はアーキテクチャにより様々である。
+また、上記の定義では、フィールド間に存在することがあるパディングバイトは書かれていない。このパディングバイトはアーキテクチャによっても異なる。詳細を知る必要がある場合は
+glibc とカーネルのソースを調べてほしい。
+
+\fIst_dev\fP フィールドは、このファイルが存在するデバイスを示す (マクロ \fBmajor\fP(3), \fBminor\fP(3)
+は、このフィールドのデバイス ID を分解するのに役立つだろう)。
+
+\fIst_rdev\fP フィールドは、このファイル (inode) が表すデバイスを示す。
+
+\fIst_size\fP フィールドは、(通常のファイルかシンボリックリンクの場合に)
+ファイルの大きさをバイト単位で示す。 シンボリックリンクの大きさは、
+シンボリックリンクに含まれている パス名の長さ (終端のヌルバイトは含まない)
+である。
+
+\fIst_blocks\fP フィールドは、ファイルの大きさを 512 バイトのブロックサイズ単位で示す フィールドは、ファイルに割り当てされたブロック数を
+512 バイト単位で示す。 (ファイルに穴があるような場合、この値は \fIst_size\fP/512 より小さくなることもある)。
+
+\fIst_blksize\fP フィールドは、効率的にファイルシステム I/O ができる「好ましい」 ブロックサイズを示す
+(もっと小さい単位でファイルに書き込みを行うと、 読み出し\-\-修正\-\-再書き込みといった非効率な動作になってしまうかもしれない)。
 .PP
-.\"O The
-.\"O .I st_dev
-.\"O field describes the device on which this file resides.
-.\"O (The
-.\"O .BR major (3)
-.\"O and
-.\"O .BR minor (3)
-.\"O macros may be useful to decompose the device ID in this field.)
-.I st_dev
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¤³¤Î¥Õ¥¡¥¤¥ë¤¬Â¸ºß¤¹¤ë¥Ç¥Ð¥¤¥¹¤ò¼¨¤¹
-(¥Þ¥¯¥í
-.BR major (3),
-.BR minor (3)
-¤Ï¡¢¤³¤Î¥Õ¥£¡¼¥ë¥É¤Î¥Ç¥Ð¥¤¥¹ ID ¤òʬ²ò¤¹¤ë¤Î¤ËÌòΩ¤Ä¤À¤í¤¦)¡£
-
-.\"O The
-.\"O .I st_rdev
-.\"O field describes the device that this file (inode) represents.
-.I st_rdev
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¤³¤Î¥Õ¥¡¥¤¥ë (inode) ¤¬É½¤¹¥Ç¥Ð¥¤¥¹¤ò¼¨¤¹¡£
-
-.\"O The
-.\"O .I st_size
-.\"O field gives the size of the file (if it is a regular
-.\"O file or a symbolic link) in bytes.
-.\"O The size of a symlink is the length of the pathname
-.\"O it contains, without a trailing null byte.
-.I st_size
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢(Ä̾ï¤Î¥Õ¥¡¥¤¥ë¤«¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë)
-¥Õ¥¡¥¤¥ë¤ÎÂ礭¤µ¤ò¥Ð¥¤¥Èñ°Ì¤Ç¼¨¤¹¡£
-¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤ÎÂ礭¤µ¤Ï¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë
-¥Ñ¥¹Ì¾¤ÎŤµ (ºÇ¸å¤Î NULL ¥Ð¥¤¥È¤Ï´Þ¤Þ¤Ê¤¤) ¤Ç¤¢¤ë¡£
-
-.\"O The
-.\"O .I st_blocks
-.\"O field indicates the number of blocks allocated to the file, 512-byte units.
-.\"O (This may be smaller than
-.\"O .IR st_size /512
-.\"O when the file has holes.)
-.I st_blocks
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥Õ¥¡¥¤¥ë¤ÎÂ礭¤µ¤ò 512 ¥Ð¥¤¥È¤Î¥Ö¥í¥Ã¥¯¥µ¥¤¥ºÃ±°Ì¤Ç¼¨¤¹
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥Õ¥¡¥¤¥ë¤Ë³ä¤êÅö¤Æ¤µ¤ì¤¿¥Ö¥í¥Ã¥¯¿ô¤ò 512 ¥Ð¥¤¥Èñ°Ì¤Ç¼¨¤¹¡£
-(¥Õ¥¡¥¤¥ë¤Ë·ê¤¬¤¢¤ë¤è¤¦¤Ê¾ì¹ç¡¢¤³¤ÎÃͤÏ
-.IR st_size /512
-¤è¤ê¾®¤µ¤¯¤Ê¤ë¤³¤È¤â¤¢¤ë)¡£
-
-.\"O The
-.\"O .I st_blksize
-.\"O field gives the "preferred" blocksize for efficient file system I/O.
-.\"O (Writing to a file in smaller chunks may cause
-.\"O an inefficient read-modify-rewrite.)
-.I st_blksize
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¸úΨŪ¤Ë¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à I/O ¤¬¤Ç¤­¤ë¡Ö¹¥¤Þ¤·¤¤¡×
-¥Ö¥í¥Ã¥¯¥µ¥¤¥º¤ò¼¨¤¹ (¤â¤Ã¤È¾®¤µ¤¤Ã±°Ì¤Ç¥Õ¥¡¥¤¥ë¤Ë½ñ¤­¹þ¤ß¤ò¹Ô¤¦¤È¡¢
-Æɤ߽Ф·--½¤Àµ--ºÆ½ñ¤­¹þ¤ß¤È¤¤¤Ã¤¿Èó¸úΨ¤ÊÆ°ºî¤Ë¤Ê¤Ã¤Æ¤·¤Þ¤¦¤«¤â¤·¤ì¤Ê¤¤)¡£
+全ての Linux のファイルシステムが全ての時間フィールドを 実装しているわけではない。 ファイルやディレクトリのアクセスが \fIst_atime\fP
+フィールドを更新しないようなかたちでマウントできるファイルシステムもある。 (\fBmount\fP(8)  の \fInoatime\fP,
+\fInodiratime\fP, \fIrelatime\fP や \fBmount\fP(2)  の関連する情報を参照)。 また、ファイルが \fBO_NOATIME\fP
+付きでオープンされている場合には \fIst_atime\fP は更新されない。 \fBopen\fP(2)  参照。
+
+\fIst_atime\fP フィールドはファイルアクセスがあった場合に変更される (例えば、 \fBexecve\fP(2), \fBmknod\fP(2),
+\fBpipe\fP(2), \fButime\fP(2)  を使用した場合や \fBread\fP(2)  で 1 バイト以上読み込んだ場合など)。
+\fBmmap\fP(2)  などの他のルーチンでは、 \fIst_atime\fP は更新されることもあれば、そうでない場合もある。
+
+\fIst_mtime\fP フィールドは、ファイルが修正された場合に変更される (例えば、 \fBmknod\fP(2), \fBtruncate\fP(2),
+\fButime\fP(2)  を使用した場合や \fBwrite\fP(2)  で 1 バイト以上書き込みをした場合など)。 さらに、ディレクトリの
+\fIst_mtime\fP は、そのディレクトリで ファイルが作成されたり削除されたりすると変更される。 \fIst_mtime\fP フィールドは
+所有者やグループやハード・リンク数やモードの変更では変更 \fIされない。\fP
+
+\fIst_ctime\fP フィールドは書き込みや inode 情報 (所有者、グループ、リンク数、モードなど) の 設定によって変更される。
+.PP
+以下のマスク値が \fIst_mode\fP フィールドのファイル種別の検査用に定義されている。
+.in +4n
+.TS
+lB l l.
+S_IFMT	0170000	ファイル種別を示すビット領域を表すビットマスク
+
+S_IFSOCK	0140000	ソケット
+S_IFLNK	0120000	シンボリックリンク
+S_IFREG	0100000	通常のファイル
+S_IFBLK	0060000	ブロック・デバイス
+S_IFDIR	0040000	ディレクトリ
+S_IFCHR	0020000	キャラクター・デバイス
+S_IFIFO	0010000	FIFO
+.TE
+.in
 .PP
-.\"O Not all of the Linux file systems implement all of the time fields.
-.\"O Some file system types allow mounting in such a way that file
-.\"O and/or directory accesses do not cause an update of the
-.\"O .I st_atime
-.\"O field.
-.\"O (See
-.\"O .IR noatime ,
-.\"O .IR nodiratime ,
-.\"O and
-.\"O .I relatime
-.\"O in
-.\"O .BR mount (8),
-.\"O and related information in
-.\"O .BR mount (2).)
-Á´¤Æ¤Î Linux ¤Î¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤¬Á´¤Æ¤Î»þ´Ö¥Õ¥£¡¼¥ë¥É¤ò
-¼ÂÁõ¤·¤Æ¤¤¤ë¤ï¤±¤Ç¤Ï¤Ê¤¤¡£
-¥Õ¥¡¥¤¥ë¤ä¥Ç¥£¥ì¥¯¥È¥ê¤Î¥¢¥¯¥»¥¹¤¬
-.I st_atime
-¥Õ¥£¡¼¥ë¥É¤ò¹¹¿·¤·¤Ê¤¤¤è¤¦¤Ê¤«¤¿¤Á¤Ç¥Þ¥¦¥ó¥È¤Ç¤­¤ë¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤â¤¢¤ë¡£
-.RB ( mount (8)
-¤Î
-.IR noatime ,
-.IR nodiratime ,
-.I relatime
-¤ä
-.BR mount (2)
-¤Î´ØÏ¢¤¹¤ë¾ðÊó¤ò»²¾È)¡£
-.\"O In addition,
-.\"O .I st_atime
-.\"O is not updated if a file is opened with the
-.\"O .BR O_NOATIME ;
-.\"O see
-.\"O .BR open (2).
-¤Þ¤¿¡¢¥Õ¥¡¥¤¥ë¤¬
-.B O_NOATIME
-ÉÕ¤­¤Ç¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï
-.I st_atime
-¤Ï¹¹¿·¤µ¤ì¤Ê¤¤¡£
-.BR open (2)
-»²¾È¡£
-
-.\"O The field
-.\"O .I st_atime
-.\"O is changed by file accesses, for example, by
-.\"O .BR execve (2),
-.\"O .BR mknod (2),
-.\"O .BR pipe (2),
-.\"O .BR utime (2)
-.\"O and
-.\"O .BR read (2)
-.\"O (of more than zero bytes).
-.\"O Other routines, like
-.\"O .BR mmap (2),
-.\"O may or may not update
-.\"O .IR st_atime .
-.I st_atime
-¥Õ¥£¡¼¥ë¥É¤Ï¥Õ¥¡¥¤¥ë¥¢¥¯¥»¥¹¤¬¤¢¤Ã¤¿¾ì¹ç¤ËÊѹ¹¤µ¤ì¤ë
-(Î㤨¤Ð¡¢
-.BR execve (2),
-.BR mknod (2),
-.BR pipe (2),
-.BR utime (2)
-¤ò»ÈÍѤ·¤¿¾ì¹ç¤ä
-.BR read (2)
-¤Ç 1 ¥Ð¥¤¥È°Ê¾åÆɤ߹þ¤ó¤À¾ì¹ç¤Ê¤É)¡£
-.BR mmap (2)
-¤Ê¤É¤Î¾¤Î¥ë¡¼¥Á¥ó¤Ç¤Ï¡¢
-.I st_atime
-¤Ï¹¹¿·¤µ¤ì¤ë¤³¤È¤â¤¢¤ì¤Ð¡¢¤½¤¦¤Ç¤Ê¤¤¾ì¹ç¤â¤¢¤ë¡£
-
-.\"O The field
-.\"O .I st_mtime
-.\"O is changed by file modifications, for example, by
-.\"O .BR mknod (2),
-.\"O .BR truncate (2),
-.\"O .BR utime (2)
-.\"O and
-.\"O .BR write (2)
-.\"O (of more than zero bytes).
-.I st_mtime
-¥Õ¥£¡¼¥ë¥É¤Ï¡¢¥Õ¥¡¥¤¥ë¤¬½¤Àµ¤µ¤ì¤¿¾ì¹ç¤ËÊѹ¹¤µ¤ì¤ë
-(Î㤨¤Ð¡¢
-.BR mknod (2),
-.BR truncate (2),
-.BR utime (2)
-¤ò»ÈÍѤ·¤¿¾ì¹ç¤ä
-.BR write (2)
-¤Ç 1 ¥Ð¥¤¥È°Ê¾å½ñ¤­¹þ¤ß¤ò¤·¤¿¾ì¹ç¤Ê¤É)¡£
-.\"O Moreover,
-.\"O .I st_mtime
-.\"O of a directory is changed by the creation or deletion of files
-.\"O in that directory.
-¤µ¤é¤Ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¤Î
-.I st_mtime
-¤Ï¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ç
-¥Õ¥¡¥¤¥ë¤¬ºîÀ®¤µ¤ì¤¿¤êºï½ü¤µ¤ì¤¿¤ê¤¹¤ë¤ÈÊѹ¹¤µ¤ì¤ë¡£
-.\"O The
-.\"O .I st_mtime
-.\"O field is
-.\"O .I not
-.\"O changed for changes in owner, group, hard link count, or mode.
-.I st_mtime
-¥Õ¥£¡¼¥ë¥É¤Ï
-½êÍ­¼Ô¤ä¥°¥ë¡¼¥×¤ä¥Ï¡¼¥É¡¦¥ê¥ó¥¯¿ô¤ä¥â¡¼¥É¤ÎÊѹ¹¤Ç¤ÏÊѹ¹
-.I ¤µ¤ì¤Ê¤¤¡£
-
-.\"O The field
-.\"O .I st_ctime
-.\"O is changed by writing or by setting inode information
-.\"O (i.e., owner, group, link count, mode, etc.).
-.I st_ctime
-¥Õ¥£¡¼¥ë¥É¤Ï½ñ¤­¹þ¤ß¤ä inode ¾ðÊó
-(½êÍ­¼Ô¡¢¥°¥ë¡¼¥×¡¢¥ê¥ó¥¯¿ô¡¢¥â¡¼¥É¤Ê¤É) ¤Î
-ÀßÄê¤Ë¤è¤Ã¤ÆÊѹ¹¤µ¤ì¤ë¡£
+したがって、(例えば) 通常のファイルかどうかを検査するには、以下のようにすればよい。
+
+.nf
+.in +4n
+stat(pathname, &sb);
+if ((sb.st_mode & S_IFMT) == S_IFREG) {
+    /* Handle regular file */
+}
+.in
+.fi
 .PP
-.\"O The following POSIX macros are defined to check the file type using the
-.\"O .I st_mode
-.\"O field:
-°Ê²¼¤Î POSIX ¥Þ¥¯¥í¤Ï¡¢
-.I st_mode
-¥Õ¥£¡¼¥ë¥É
-¤Ç»ÈÍѤµ¤ì¤ë¥Õ¥¡¥¤¥ë¼ïÊ̤ΥÁ¥§¥Ã¥¯¤Î¤¿¤á¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë :
+上記の形の検査はよくあるので、 POSIX では以下のマクロが定義されており、 \fIst_mode\fP
+のファイル種別の検査をより簡単に書けるようになっている。
 .RS 4
-.TP 1.2i
-.BR S_ISREG (m)
-.\"O is it a regular file?
-Ä̾ï¤Î¥Õ¥¡¥¤¥ë¤«?
-.TP
-.BR S_ISDIR (m)
-.\"O directory?
-¥Ç¥£¥ì¥¯¥È¥ê¤«?
-.TP
-.BR S_ISCHR (m)
-.\"O character device?
-¥­¥ã¥é¥¯¥¿¡¼¡¦¥Ç¥Ð¥¤¥¹¤«?
-.TP
-.BR S_ISBLK (m)
-.\"O block device?
-¥Ö¥í¥Ã¥¯¡¦¥Ç¥Ð¥¤¥¹¤«?
-.TP
-.BR S_ISFIFO (m)
-.\"O FIFO (named pipe)?
-FIFO (̾Á°ÉÕ¤­¥Ñ¥¤¥×) ¤«?
-.TP
-.BR S_ISLNK (m)
-.\"O symbolic link? (Not in POSIX.1-1996.)
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤«? (POSIX.1-1996 ¤Ë¤Ï¤Ê¤¤)
-.TP
-.BR S_ISSOCK (m)
-.\"O socket? (Not in POSIX.1-1996.)
-¥½¥±¥Ã¥È¤«? (POSIX.1-1996 ¤Ë¤Ï¤Ê¤¤)
+.TP  1.2i
+\fBS_ISREG\fP(m)
+通常のファイルか?
+.TP 
+\fBS_ISDIR\fP(m)
+ディレクトリか?
+.TP 
+\fBS_ISCHR\fP(m)
+キャラクター・デバイスか?
+.TP 
+\fBS_ISBLK\fP(m)
+ブロック・デバイスか?
+.TP 
+\fBS_ISFIFO\fP(m)
+FIFO (名前付きパイプ) か?
+.TP 
+\fBS_ISLNK\fP(m)
+シンボリックリンクか? (POSIX.1\-1996 にはない)
+.TP 
+\fBS_ISSOCK\fP(m)
+ソケットか? (POSIX.1\-1996 にはない)
 .RE
 .PP
-.\"O The following flags are defined for the
-.\"O .I st_mode
-.\"O field:
-°Ê²¼¤Î¥Õ¥é¥°¤¬
-.I st_mode
-¥Õ¥£¡¼¥ë¥ÉÍѤËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+上で挙げたコードは以下のように書き換えることができる。
+
+.nf
+.in +4n
+stat(pathname, &sb);
+if (S_ISREG(sb.st_mode)) {
+    /* Handle regular file */
+}
+.in
+.fi
+.PP
+上記のほとんどのファイル種別検査マクロの定義は、 機能検査マクロ \fB_BSD_SOURCE\fP (glibc 2.19 以前の場合)、
+\fB_SVID_SOURCE\fP (glibc 2.19 以前の場合)、 \fB_DEFAULT_SOURCE\fP (glibc 2.20 以降の場合)
+のいずれかが定義されている場合に公開される。 さらに、 \fBS_IFSOCK\fP と \fBS_ISSOCK\fP 以外の上記のすべてのマクロの定義は
+\fB_XOPEN_SOURCE\fP が定義されている場合にも公開される。 \fBS_IFSOCK\fP の定義は \fB_XOPEN_SOURCE\fP が値 500
+以上で定義された場合にも公開される。
+
+\fBS_ISSOCK\fP() の定義が公開されるのは以下の機能検査マクロが定義されている場合である: \fB_BSD_SOURCE\fP (glibc 2.19
+以前の場合)、 \fB_DEFAULT_SOURCE\fP (glibc 2.20 以降の場合)、 値 500 以上の \fB_XOPEN_SOURCE\fP、
+値が 200112L 以上の \fB_POSIX_C_SOURCE\fP。
+.PP
+以下のマスク値が \fIst_mode\fP フィールドのファイルのアクセス許可の検査用に定義されている。
 .in +4n
 .TS
 lB l l.
-.\"O S_IFMT	0170000	bit mask for the file type bit fields
-.\"O S_IFSOCK	0140000	socket
-.\"O S_IFLNK	0120000	symbolic link
-.\"O S_IFREG	0100000	regular file
-.\"O S_IFBLK	0060000	block device
-.\"O S_IFDIR	0040000	directory
-.\"O S_IFCHR	0020000	character device
-.\"O S_IFIFO	0010000	FIFO
-S_IFMT	0170000	¥Õ¥¡¥¤¥ë¼ïÊ̤ò¼¨¤¹¥Ó¥Ã¥ÈÎΰè¤òɽ¤¹¥Ó¥Ã¥È¥Þ¥¹¥¯
-S_IFSOCK	0140000	¥½¥±¥Ã¥È
-S_IFLNK	0120000	¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
-S_IFREG	0100000	Ä̾ï¤Î¥Õ¥¡¥¤¥ë
-S_IFBLK	0060000	¥Ö¥í¥Ã¥¯¡¦¥Ç¥Ð¥¤¥¹
-S_IFDIR	0040000	¥Ç¥£¥ì¥¯¥È¥ê
-S_IFCHR	0020000	¥­¥ã¥é¥¯¥¿¡¼¡¦¥Ç¥Ð¥¤¥¹
-S_IFIFO	0010000	FIFO
-.\"O S_ISUID	0004000	set-user-ID bit
-.\"O S_ISGID	0002000	set-group-ID bit (see below)
-.\"O S_ISVTX	0001000	sticky bit (see below)
-S_ISUID	0004000	set-user-ID bit
-S_ISGID	0002000	set-group-ID bit (²¼µ­»²¾È)
-S_ISVTX	0001000	¥¹¥Æ¥£¥Ã¥­¡¼¡¦¥Ó¥Ã¥È (²¼µ­»²¾È)
-.\"O S_IRWXU	00700	mask for file owner permissions
-.\"O S_IRUSR	00400	owner has read permission
-.\"O S_IWUSR	00200	owner has write permission
-.\"O S_IXUSR	00100	owner has execute permission
-S_IRWXU	00700	¥Õ¥¡¥¤¥ë½êÍ­¼Ô¤Î¥¢¥¯¥»¥¹µö²ÄÍѤΥӥåȥޥ¹¥¯
-S_IRUSR	00400	½êÍ­¼Ô¤ÎÆɤ߹þ¤ßµö²Ä
-S_IWUSR	00200	½êÍ­¼Ô¤Î½ñ¤­¹þ¤ßµö²Ä
-S_IXUSR	00100	½êÍ­¼Ô¤Î¼Â¹Ôµö²Ä
-.\"O S_IRWXG	00070	mask for group permissions
-.\"O S_IRGRP	00040	group has read permission
-.\"O S_IWGRP	00020	group has write permission
-.\"O S_IXGRP	00010	group has execute permission
-S_IRWXG	00070	¥°¥ë¡¼¥×¤Î¥¢¥¯¥»¥¹µö²ÄÍѤΥӥåȥޥ¹¥¯
-S_IRGRP	00040	¥°¥ë¡¼¥×¤ÎÆɤ߹þ¤ßµö²Ä
-S_IWGRP	00020	¥°¥ë¡¼¥×¤Î½ñ¤­¹þ¤ßµö²Ä
-S_IXGRP	00010	¥°¥ë¡¼¥×¤Î¼Â¹Ôµö²Ä
-.\"O S_IRWXO	00007	mask for permissions for others (not in group)
-.\"O S_IROTH	00004	others have read permission
-.\"O S_IWOTH	00002	others have write permission
-.\"O S_IXOTH	00001	others have execute permission
-S_IRWXO	00007	¾¿Í (others) ¤Î¥¢¥¯¥»¥¹µö²ÄÍѤΥӥåȥޥ¹¥¯
-S_IROTH	00004	¾¿Í¤ÎÆɤ߹þ¤ßµö²Ä
-S_IWOTH	00002	¾¿Í¤Î½ñ¤­¹þ¤ßµö²Ä
-S_IXOTH	00001	¾¿Í¤Î¼Â¹Ôµö²Ä
+S_ISUID	0004000	set\-user\-ID bit
+S_ISGID	0002000	set\-group\-ID bit (下記参照)
+S_ISVTX	0001000	スティッキー・ビット (下記参照)
+
+S_IRWXU	  00700	ファイル所有者のアクセス許可用のビットマスク
+S_IRUSR	  00400	所有者の読み込み許可
+S_IWUSR	  00200	所有者の書き込み許可
+S_IXUSR	  00100	所有者の実行許可
+
+S_IRWXG	  00070	グループのアクセス許可用のビットマスク
+S_IRGRP	  00040	グループの読み込み許可
+S_IWGRP	  00020	グループの書き込み許可
+S_IXGRP	  00010	グループの実行許可
+
+S_IRWXO	  00007	T{
+他人 (others) のアクセス許可用のビットマスク
+T}
+S_IROTH	  00004	他人の読み込み許可
+S_IWOTH	  00002	他人の書き込み許可
+S_IXOTH	  00001	他人の実行許可
 .TE
 .in
 .P
-.\"O The set-group-ID bit
-.\"O .RB ( S_ISGID )
-.\"O has several special uses.
-.\"O For a directory it indicates that BSD semantics is to be used
-.\"O for that directory: files created there inherit their group ID from
-.\"O the directory, not from the effective group ID of the creating process,
-.\"O and directories created there will also get the
-.\"O .B S_ISGID
-.\"O bit set.
-.\"O For a file that does not have the group execution bit
-.\"O .RB ( S_IXGRP )
-.\"O set,
-.\"O the set-group-ID bit indicates mandatory file/record locking.
-set-group-ID bit
-.RB ( S_ISGID )
-¤Ë¤Ï¤¤¤¯¤Ä¤«¤ÎÆüì¤Ê»ÈÍÑË¡¤¬¤¢¤ë:
-¥Ç¥£¥ì¥¯¥È¥ê¤ËÀßÄꤷ¤¿¾ì¹ç¤Ë¤Ï¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤¬ BSD Êý¼°¤Ç»ÈÍѤµ¤ì¤ë
-¤³¤È¤ò¼¨¤¹¡£¤Ä¤Þ¤ê¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ËºîÀ®¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤Î¥°¥ë¡¼¥×ID ¤Ï
-ºîÀ®¤·¤¿¥×¥í¥»¥¹¤Î¼Â¸ú (effective) ¥°¥ë¡¼¥×ID ¤Ç¤Ï¤Ê¤¯¡¢¥Ç¥£¥ì¥¯¥È¥ê¤Î
-¥°¥ë¡¼¥×ID ¤ò·Ñ¾µ¤¹¤ë¡£¤Þ¤¿¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤ËºîÀ®¤µ¤ì¤¿¥Ç¥£¥ì¥¯¥È¥ê¤Ë¤â
-.B S_ISGID
-¥Ó¥Ã¥È¤¬ÀßÄꤵ¤ì¤ë¡£¥°¥ë¡¼¥×¼Â¹Ô¥Ó¥Ã¥È
-.RB ( S_IXGRP )
-¤¬ÀßÄꤵ¤ì¤Æ¤¤¤Ê¤¤¥Õ¥¡¥¤¥ë¤ËÀßÄꤵ¤ì¤¿¾ì¹ç¤Ï¡¢
-set-group-ID ¥Ó¥Ã¥È¤Ï¥Õ¥¡¥¤¥ë/¥ì¥³¡¼¥É¤Î
-¶¯À©Åª¤Ê (mandatory) ¥í¥Ã¥¯¤òɽ¤¹¡£
+set\-group\-ID bit (\fBS_ISGID\fP)  にはいくつかの特殊な使用法がある: ディレクトリに設定した場合には、そのディレクトリが
+BSD 方式で使用される ことを示す。つまり、そのディレクトリに作成されたファイルのグループID は 作成したプロセスの実効 (effective)
+グループID ではなく、ディレクトリの グループID を継承する。また、そのディレクトリに作成されたディレクトリにも \fBS_ISGID\fP
+ビットが設定される。グループ実行ビット (\fBS_IXGRP\fP)  が設定されていないファイルに設定された場合は、 set\-group\-ID
+ビットはファイル/レコードの 強制的な (mandatory) ロックを表す。
 .P
-.\"O The sticky bit (S_ISVTX) on a directory means that a file
-.\"O in that directory can be renamed or deleted only by the owner
-.\"O of the file, by the owner of the directory, and by a privileged
-.\"O process.
-¥Ç¥£¥ì¥¯¥È¥ê¤Ë¥¹¥Æ¥£¥Ã¥­¡¼¥Ó¥Ã¥È (S_ISVTX) ¤¬ÀßÄꤵ¤ì¤¿¾ì¹ç¤Ï¡¢
-¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Î¥Õ¥¡¥¤¥ë¤Î̾Á°¤òÊѹ¹¤·¤¿¤ê¡¢ºï½ü¤·¤¿¤ê¤Ç¤­¤ë¤Î¤Ï¡¢
-¤½¤Î¥Õ¥¡¥¤¥ë¤Î½êÍ­¼Ô¤«¡¢¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Î½êÍ­¼Ô¤«¡¢Æø¢¥×¥í¥»¥¹
-¤À¤±¤È¤Ê¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O On success, zero is returned.
-.\"O On error, \-1 is returned, and
-.\"O .I errno
-.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤ËŬÀÚ¤ÊÃͤ¬ÀßÄꤵ¤ì¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EACCES
-.\"O Search permission is denied for one of the directories
-.\"O in the path prefix of
-.\"O .IR path .
-.\"O (See also
-.\"O .BR path_resolution (7).)
-.I path
-¤¬½ê°¤¹¤ë¥Ç¥£¥ì¥¯¥È¥ê¤È¤½¤Î¾å°Ì¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Î¤¤¤º¤ì¤«¤Ë
-ÂФ¹¤ë¸¡º÷µö²Ä¤¬¤Ê¤«¤Ã¤¿
-.RB ( path_resolution (7)
-¤â»²¾È¤Î¤³¤È)¡£
-.TP
-.B EBADF
-.\"O .I fd
-.\"O is bad.
-.I fd
-¤¬ÉÔÀµ¤Ç¤¢¤ë¡£
-.TP
-.B EFAULT
-.\"O Bad address.
-¥¢¥É¥ì¥¹¤¬´Ö°ã¤Ã¤Æ¤¤¤ë¡£
-.TP
-.B ELOOP
-.\"O Too many symbolic links encountered while traversing the path.
-¥Ñ¥¹¤òé¤ëºÝ¤Ë²ò·è¤¹¤Ù¤­¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤¬Â¿²á¤®¤¿¡£
-.TP
-.B ENAMETOOLONG
-.\"O File name too long.
-¥Õ¥¡¥¤¥ë̾¤¬Ä¹²á¤®¤ë¡£
-.TP
-.B ENOENT
-.\"O A component of
-.\"O .I path
-.\"O does not exist, or
-.\"O .I path
-.\"O is an empty string.
-.I path
-¤Î¹½À®Í×ÁǤ¬Â¸ºß¤·¤Ê¤¤¤«¡¢
-.I path
-¤¬¶õʸ»úÎó¤Ç¤¢¤ë¡£
-.TP
-.B ENOMEM
-.\"O Out of memory (i.e., kernel memory).
-¥«¡¼¥Í¥ë¤Î¥á¥â¥ê¤¬Â­¤ê¤Ê¤¤¡£
-.TP
-.B ENOTDIR
-.\"O A component of the path prefix of
-.\"O .I path
-.\"O is not a directory.
-.I path
-¤ÎÁ°È¾Éôʬ (prefix) ¤Î¹½À®Í×ÁǤ¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ï¤Ê¤¤¡£
-.TP
-.B EOVERFLOW
-.\"O .RB ( stat ())
-.\"O .I path
-.\"O refers to a file whose size cannot be represented in the type
-.\"O .IR off_t .
-.\"O This can occur when an application compiled on a 32-bit platform without
-.\"O .I -D_FILE_OFFSET_BITS=64
-.\"O calls
-.\"O .BR stat ()
-.\"O on a file whose size exceeds
-.\"O .I (2<<31)-1
-.\"O bits.
-.RB ( stat ())
-.I path
-¤¬¡¢¥Õ¥¡¥¤¥ë¥µ¥¤¥º¤ò
-.I off_t
-·¿¤Çɽ¸½¤Ç¤­¤Ê¤¤¥Õ¥¡¥¤¥ë¤ò»²¾È¤·¤Æ¤¤¤ë¡£
-¤³¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë¤Î¤Ï¡¢32 ¥Ó¥Ã¥È¥×¥é¥Ã¥È¥Õ¥©¡¼¥à¾å¤Ç
-.I -D_FILE_OFFSET_BITS=64
-¤ò»ØÄꤻ¤º¤Ë¥³¥ó¥Ñ¥¤¥ë¤µ¤ì¤¿¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤¬¡¢¥Õ¥¡¥¤¥ë¥µ¥¤¥º¤¬
-.I (2<31)-1
-¥Ó¥Ã¥È¤òĶ¤¨¤ë¥Õ¥¡¥¤¥ë¤ËÂФ·¤Æ
-.BR stat ()
-¤ò¸Æ¤Ó½Ð¤·¤¿¾ì¹ç¤Ç¤¢¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O These system calls conform to SVr4, 4.3BSD, POSIX.1-2001.
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï SVr4, 4.3BSD, POSIX.1-2001 ¤Ë½àµò¤·¤Æ¤¤¤ë¡£
-.\"O .\" SVr4 documents additional
-.\"O .\" .BR fstat ()
-.\"O .\" error conditions EINTR, ENOLINK, and EOVERFLOW.  SVr4
-.\"O .\" documents additional
-.\"O .\" .BR stat ()
-.\"O .\" and
-.\"O .\" .BR lstat ()
-.\"O .\" error conditions EINTR, EMULTIHOP, ENOLINK, and EOVERFLOW.
-.BR stat ()
-¤È
-.BR fstat ()
-¥³¡¼¥ë¤Ï SVr4, SVID, POSIX, X/OPEN, 4.3BSD ¤Ë½àµò¤·¤Æ¤¤¤ë¡£
-.BR lstat ()
-¥³¡¼¥ë¤Ï 4.3BSD ¤È SVr4 ¤Ë½àµò¤·¤Æ¤¤¤ë¡£
-.\" SVr4 ¤Ë¤Ï¾¤Ë
+.\"
+.\"
+ディレクトリにスティッキービット (S_ISVTX) が設定された場合は、 そのディレクトリのファイルの名前を変更したり、削除したりできるのは、
+そのファイルの所有者か、そのディレクトリの所有者か、特権プロセス だけとなる。
+.SS fstatat()
+\fBfstatat\fP() システムコールは \fBstat\fP() と全く同様に動作するが、以下で説明する点が異なる。
+
+指定された \fIpathname\fP が相対パスの場合、 ファイルディスクリプタ \fIdirfd\fP が参照するディレクトリに対する相対パスと解釈される
+(\fBstat\fP() に相対パスを渡した場合のように、呼び出したプロセスのカレントワーキングディレクトリに対する相対パスではない)。
+
+\fIpathname\fP が相対パスで、 \fIdirfd\fP が特別な値 \fBAT_FDCWD\fP の場合、 (\fBstat\fP(2) と同様に)
+\fIpathname\fP は呼び出したプロセスのカレントワーキングディレクトリに対する相対パスと解釈される。
+
+\fIpathname\fP で指定されたパス名が絶対パスの場合、 \fIdirfd\fP は無視される。
+
+この \fIflags\fP 引き数は下記のフラグの 0 個以上の論理和を取ったものである:
+.TP 
+\fBAT_EMPTY_PATH\fP (Linux 2.6.39 以降)
+.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d
+.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
+\fIpathname\fP が空文字列の場合、 \fIdirfd\fP が参照するファイルに対して操作を行う (\fIdirfd\fP は \fBopen\fP(2) の
+\fBO_PATH\fP フラグを使って取得できる)。 \fBdirfd\fP が \fBAT_FDCWD\fP
+の場合、呼び出しはカレントワーキングディレクトリに対して操作を行う。 この場合、 \fIdirfd\fP
+は、ディレクトリだけでなく、任意のタイプのファイルを参照することができる。 このフラグは Linux 固有であり、その定義を得るには
+\fB_GNU_SOURCE\fP を定義すること。
+.TP 
+\fBAT_NO_AUTOMOUNT\fP (Linux 2.6.38 以降)
+.\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
+\fIpathname\fP がオートマウントポイントとなっているディレクトリの場合、 \fIpathname\fP の最終 ("basename")
+要素のオートマウントを行わない。 これにより (マウントされるはずの場所ではなく) オートマウントポイントの属性を取得することができる。
+このフラグを使うと、 ディレクトリをスキャンするツールがオートマウントポイントのディレクトリを大量にオートマウントしてしまうのを防ぐことができる。
+マウントポイントがすでにマウントされている場合 \fBAT_NO_AUTOMOUNT\fP フラグは何の効果もない。 このフラグは Linux
+固有であり、その定義を得るには \fB_GNU_SOURCE\fP を定義すること。
+.TP 
+\fBAT_SYMLINK_NOFOLLOW\fP
+(\fBlstat\fP() 同様) \fIpathname\fP がシンボリックリンクの場合リンクの展開を行わず、 リンク自身の情報を返す (デフォルトでは、
+\fBfstatat\fP() は、 \fBstat\fP() と同様に、シンボリックリンクの展開を行う)。
+.PP
+\fBfstatat\fP() の必要性についての説明については \fBopenat\fP(2) を参照。
+.SH 返り値
+成功した場合、0 が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
+.SH エラー
+.TP 
+\fBEACCES\fP
+\fIpathname\fP が所属するディレクトリとその上位のディレクトリのいずれかに 対する検索許可がなかった
+(\fBpath_resolution\fP(7)  も参照のこと)。
+.TP 
+\fBEBADF\fP
+\fIfd\fP が不正である。
+.TP 
+\fBEFAULT\fP
+アドレスが間違っている。
+.TP 
+\fBELOOP\fP
+パスを辿る際に解決すべきシンボリックリンクが多過ぎた。
+.TP 
+\fBENAMETOOLONG\fP
+\fIpathname\fP が長過ぎる。
+.TP 
+\fBENOENT\fP
+\fIpathname\fP の構成要素が存在しないか、 \fIpathname\fP が空文字列である。
+.TP 
+\fBENOMEM\fP
+カーネルのメモリが足りない。
+.TP 
+\fBENOTDIR\fP
+\fIpathname\fP の前半部分 (prefix) の構成要素がディレクトリではない。
+.TP 
+\fBEOVERFLOW\fP
+\fIpathname\fP または \fIfd\fP が、ファイルサイズ、inode 番号、ブロック数が
+それぞれ \fIoff_t\fP 型、 \fIino_t\fP 型、 \fIblkcnt_t\fP 型で表現できないファイルを
+参照している。このエラーが起こるのは、例えば、32 ビットプラットフォーム上で
+\fI\-D_FILE_OFFSET_BITS=64\fP を指定せずにコンパイルされたアプリケーションが、
+ファイルサイズが \fI(1<<31)\-1\fP バイトを超えるファイルに対して
+\fBstat\fP() を呼び出した場合である。
+.PP
+\fBfstatat\fP() では以下のエラーも発生することがある。
+.TP 
+\fBEBADF\fP
+\fIdirfd\fP が有効なファイルディスクリプタでない。
+.TP 
+\fBEINVAL\fP
+\fIflags\fP に無効なフラグが指定された。
+.TP 
+\fBENOTDIR\fP
+\fIpathname\fP が相対パスで、 \fIdirfd\fP がディレクトリ以外のファイルを参照しているファイルディスクリプタである。
+.SH バージョン
+\fBfstatat\fP()  はカーネル 2.6.16 で Linux に追加された。 ライブラリによるサポートはバージョン 2.4 で glibc
+に追加された。
+.SH 準拠
+.\" SVr4 documents additional
 .\" .BR fstat ()
-.\" ¤Î¥¨¥é¡¼¤È¤·¤Æ EINTR, ENOLINK, EOVERFLOW ¤¬µ­ºÜ¤µ¤ì¤Æ¤¤¤ë¡£
-.\" SVr4 ¤Ë¤Ï¾¤Ë
+.\" error conditions EINTR, ENOLINK, and EOVERFLOW.  SVr4
+.\" documents additional
 .\" .BR stat ()
-.\" ¤È
+.\" and
 .\" .BR lstat ()
-.\" ¤Î¥¨¥é¡¼¤È¤·¤Æ EINTR, EMULTIHOP, ENOLINK, EOVERFLOW ¤¬µ­ºÜ¤µ¤ì¤Æ¤¤¤ë¡£
-
-.\"O Use of the
-.\"O .I st_blocks
-.\"O and
-.\"O .I st_blksize
-.\"O fields may be less portable.
-.\"O (They were introduced in BSD.
-.\"O The interpretation differs between systems,
-.\"O and possibly on a single system when NFS mounts are involved.)
-.I st_blocks
-¤È
-.I st_blksize
-¥Õ¥£¡¼¥ë¥É¤Î»ÈÍѤϤ¢¤Þ¤ê°Ü¿¢À­¤¬¤Ê¤¤¡£
-(¤³¤ì¤é¤Î¥Õ¥£¡¼¥ë¥É¤Ï BSD ¤Ë¤è¤Ã¤ÆƳÆþ¤µ¤ì¤¿¡£
-¥·¥¹¥Æ¥à¤´¤È¤Ë²ò¼á¤¬°Û¤Ê¤Ã¤Æ¤ª¤ê¡¢
-NFS ¥Þ¥¦¥ó¥È¤Î¾ì¹ç¤Ë¤ÏƱ¤¸¥·¥¹¥Æ¥à¤Ç¤â°Û¤Ê¤ë²ÄǽÀ­¤¬¤¢¤ë)
+.\" error conditions EINTR, EMULTIHOP, ENOLINK, and EOVERFLOW.
+\fBstat\fP(), \fBfstat\fP(), \fBlstat\fP(): SVr4, 4.3BSD, POSIX.1\-2001, POSIX.1.2008.
+
+\fBfstatat\fP(): POSIX.1\-2008.
+
+POSIX.1\-2001 では、シンボリックリンクに対する \fBlstat\fP() で
+有効な情報を返すように求められていたのは、 \fIstat\fP 構造体の \fIst_size\fP
+と \fIst_mode\fP のファイル種別要素だけであった。
+POSIX.1\-2008 では規定が厳しくなり、 \fBlstat\fP() は \fIst_mode\fP の
+アクセス許可ビット以外の全てのフィールドに有効な情報を返すことが
+求められるようになっている。
+
+\fIst_blocks\fP と \fIst_blksize\fP フィールドの使用はあまり移植性がない
+(これらのフィールドは BSD によって導入された。 システムごとに解釈が
+異なっており、 NFS マウントの場合には同じシステムでも異なる可能性がある)。
+\fI<sys/stat.h>\fP から \fIblkcnt_t\fP の \fIblksize_t\fP 型定義を
+読み込みたい場合は、(\fIどの\fPヘッダファイルをインクルードするよりも前に)
+\fB_XOPEN_SOURCE\fP を 500 以上の値で定義すること。
 .LP
-.\"O POSIX does not describe the
-.\"O .BR S_IFMT ,
-.\"O .BR S_IFSOCK ,
-.\"O .BR S_IFLNK ,
-.\"O .BR S_IFREG ,
-.\"O .BR S_IFBLK ,
-.\"O .BR S_IFDIR ,
-.\"O .BR S_IFCHR ,
-.\"O .BR S_IFIFO ,
-.\"O .B S_ISVTX
-.\"O bits, but instead demands the use of
-.\"O the macros
-.\"O .BR S_ISDIR (),
-.\"O etc.
-.\"O The
-.\"O .BR S_ISLNK ()
-.\"O and
-.\"O .BR S_ISSOCK ()
-.\"O macros are not in
-.\"O POSIX.1-1996, but both are present in POSIX.1-2001;
-.\"O the former is from SVID 4, the latter from SUSv2.
-POSIX ¤Ë¤Ï
-.BR S_IFMT ,
-.BR S_IFSOCK ,
-.BR S_IFLNK ,
-.BR S_IFREG ,
-.BR S_IFBLK ,
-.BR S_IFDIR ,
-.BR S_IFCHR ,
-.BR S_IFIFO ,
-.B S_ISVTX
-¥Ó¥Ã¥È¤Ë¤Ä¤¤¤Æ¤Îµ­½Ò¤Ï¤Ê¤¤¡£¤«¤ï¤ê¤Ë
-.BR S_ISDIR ()
-¤Î¤è¤¦¤Ê¥Þ¥¯¥í¤ò»ÈÍѤ¹¤ë¤è¤¦¤ËÍ׵ᤷ¤Æ¤¤¤ë¡£
-¥Þ¥¯¥í
-.BR S_ISLNK ()
-¤È
-.BR S_ISSOCK ()
-¤Ï POSIX.1-1996 ¤Ë¤Ï¤Ê¤¤¤¬¡¢
-POSIX.1-2001 ¤Ë¤ÏξÊý¤È¤â¸ºß¤¹¤ë¡£
-Á°¼Ô¤Ï SVID 4 ¤Ë¡¢¸å¼Ô¤Ï SUSv2 ¤ËͳÍ褷¤Æ¤¤¤ë¡£
+POSIX.1\-1990 には \fBS_IFMT\fP, \fBS_IFSOCK\fP, \fBS_IFLNK\fP, \fBS_IFREG\fP,
+\fBS_IFBLK\fP, \fBS_IFDIR\fP, \fBS_IFCHR\fP, \fBS_IFIFO\fP, \fBS_ISVTX\fP 定数に関する
+記述はなかったが、代わりに \fBS_ISDIR\fP() のようなマクロを使用するように
+要求していた。 \fBS_IF*\fP 定数は POSIX.1\-2001 以降には存在する。
+
+マクロ \fBS_ISLNK\fP() と \fBS_ISSOCK\fP() は POSIX.1\-1996 にはないが、
+POSIX.1\-2001 には両方とも存在する。 前者は SVID 4 に、後者は SUSv2 に
+由来している。
 .LP
-.\"O Unix V7 (and later systems) had S_IREAD, S_IWRITE, S_IEXEC, where POSIX
-.\"O prescribes the synonyms S_IRUSR, S_IWUSR, S_IXUSR.
-.\"O Unix V7 (and later systems) had
-.\"O .BR S_IREAD ,
-.\"O .BR S_IWRITE ,
-.\"O .BR S_IEXEC ,
-.\"O where POSIX
-.\"O prescribes the synonyms
-.\"O .BR S_IRUSR ,
-.\"O .BR S_IWUSR ,
-.\"O .BR S_IXUSR .
-Unix V7 (¤È¤½¤Î¸å¤Î¥·¥¹¥Æ¥à) ¤Ï
-.BR S_IREAD ,
-.BR S_IWRITE ,
-.B S_IEXEC
-¤ò»ý¤Ã¤Æ¤ª¤ê¡¢
-POSIX ¤Ï¤½¤ÎƱµÁ¸ì¤È¤·¤Æ
-.BR S_IRUSR ,
-.BR S_IWUSR ,
-.B S_IXUSR
-¤òµ¬Äꤷ¤Æ¤¤¤ë¡£
-.\"O .SS "Other Systems"
-.SS ¾¤Î¥·¥¹¥Æ¥à
-.\"O Values that have been (or are) in use on various systems:
-³Æ¼ï¥·¥¹¥Æ¥à¤Ç»ÈÍѤµ¤ì¤Æ¤¤¤¿(¤¤¤ë)ÃÍ:
+UNIX\ V7 (とその後のシステム) は \fBS_IREAD\fP, \fBS_IWRITE\fP, \fBS_IEXEC\fP を持っており、
+POSIX はその同義語として \fBS_IRUSR\fP, \fBS_IWUSR\fP, \fBS_IXUSR\fP を規定している。
+.SS 他のシステム
+各種システムで使用されていた(いる)値:
+.ad l
 .TS
 l l l l l.
-.\"O hex	name	ls	octal	description
-16¿Ê	̾Á°	ls	8¿Ê¿ô	ÀâÌÀ
-.\"O f000	S_IFMT		170000	mask for file type
-.\"O 0000			000000	SCO out-of-service inode, BSD unknown
-.\"O 				type; SVID-v2 and XPG2 have both
-.\"O 				0 and 0100000 for ordinary file
-f000	S_IFMT		170000	¥Õ¥¡¥¤¥ë¼ïÊÌ¥Õ¥£¡¼¥ë¥É¤Î¥Ó¥Ã¥È¥Þ¥¹¥¯
-0000			000000	SCO ¤Ç¤Ï »ÈÍÑÉÔǽ inode;
-				BSD ¤Ç¤Ï̤ÃΤΥե¡¥¤¥ë¼ïÊÌ;
-				SVID-v2 ¤È XPG2 ¤Ç¤Ï 0 ¤È 0100000 ¤Î
-				ξÊý¤¬ÉáÄ̤Υե¡¥¤¥ë
-.\"O 1000	S_IFIFO	p|	010000	FIFO (named pipe)
-.\"O 2000	S_IFCHR	c	020000	character special (V7)
-.\"O 3000	S_IFMPC		030000	multiplexed character special (V7)
-.\"O 4000	S_IFDIR	d/	040000	directory (V7)
-.\"O 5000	S_IFNAM		050000	XENIX named special file
-.\"O 				with two subtypes, distinguished by
-.\"O 				\fIst_rdev\fP values 1, 2
-.\"O 0001	S_INSEM	s	000001	XENIX semaphore subtype of IFNAM
-.\"O 0002	S_INSHD	m	000002	XENIX shared data subtype of IFNAM
-1000	S_IFIFO	p|	010000	FIFO (̾Á°ÉÕ¤­¥Ñ¥¤¥×)
-2000	S_IFCHR	c	020000	¥­¥ã¥é¥¯¥¿Æüì¥Õ¥¡¥¤¥ë (V7)
-3000	S_IFMPC		030000	¿½Å²½¤µ¤ì¤¿¥­¥ã¥é¥¯¥¿Æüì¥Õ¥¡¥¤¥ë (V7)
-4000	S_IFDIR	d/	040000	¥Ç¥£¥ì¥¯¥È¥ê (V7)
-5000	S_IFNAM		050000	XENIX Æó¤Ä¤ÎÉû·¿¤ò»ý¤Ä̾Á°ÉÕ¤­¤Î
-				Æüì¥Õ¥¡¥¤¥ë
-				Éû·¿¤Ï \fIst_rdev\fP ¤ÎÃÍ 1,2 ¤Ç¶èÊ̤µ¤ì¤ë:
-0001	S_INSEM	s	000001	XENIX IFNAM¤Î¥»¥Þ¥Õ¥©¡¼Éû·¿
-0002	S_INSHD	m	000002	XENIX IFNAM¤Î¶¦Í­¥Ç¡¼¥¿Éû·¿
-.\"O 6000	S_IFBLK	b	060000	block special (V7)
-.\"O 7000	S_IFMPB		070000	multiplexed block special (V7)
-.\"O 8000	S_IFREG	-	100000	regular (V7)
-.\"O 9000	S_IFCMP		110000	VxFS compressed
-.\"O 9000	S_IFNWK	n	110000	network special (HP-UX)
-.\"O a000	S_IFLNK	l@	120000	symbolic link (BSD)
-6000	S_IFBLK	b	060000	¥Ö¥í¥Ã¥¯Æüì¥Õ¥¡¥¤¥ë (V7)
-7000	S_IFMPB		070000	¿½Å²½¤µ¤ì¤¿¥Ö¥í¥Ã¥¯Æüì¥Õ¥¡¥¤¥ë (V7)
-8000	S_IFREG	-	100000	Ä̾ï¥Õ¥¡¥¤¥ë (V7)
-9000	S_IFCMP		110000	VxFS °µ½Ì¥Õ¥¡¥¤¥ë
-9000	S_IFNWK	n	110000	¥Í¥Ã¥È¥ï¡¼¥¯Æüì¥Õ¥¡¥¤¥ë (HP-UX)
-a000	S_IFLNK	l@	120000	¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯ (BSD)
-.\"O b000	S_IFSHAD		130000	Solaris shadow inode for ACL
-.\"O 				(not seen by userspace)
-.\"O c000	S_IFSOCK	s=	140000	socket (BSD; also "S_IFSOC" on VxFS)
-.\"O d000	S_IFDOOR	D>	150000	Solaris door
-.\"O e000	S_IFWHT	w%	160000	BSD whiteout (not used for inode)
-b000	S_IFSHAD		130000	Solaris ACL ¤Î¤¿¤á¤Î±£¤µ¤ì¤¿ inode
-				(¥æ¡¼¥¶¶õ´Ö¤«¤é¤Ï¸«¤¨¤Ê¤¤)
-c000	S_IFSOCK	s=	140000	¥½¥±¥Ã¥È (BSD; VxFS ¤Î "S_IFSOC")
-d000	S_IFDOOR	D>	150000	Solaris ¥É¥¢¡¦¥Õ¥¡¥¤¥ë
-e000	S_IFWHT	w%	160000	BSD ¶õÇò¥Õ¥¡¥¤¥ë (inode ¤ò»ÈÍѤ·¤Ê¤¤)
-.\"O 0200	S_ISVTX		001000	sticky bit: save swapped text even
-.\"O 				after use (V7)
-.\"O 				reserved (SVID-v2)
-.\"O 				On nondirectories: don't cache this
-.\"O 				file (SunOS)
-.\"O 				On directories: restricted deletion
-.\"O 				flag (SVID-v4.2)
-.\"O 0400	S_ISGID		002000	set-group-ID on execution (V7)
-.\"O 				for directories: use BSD semantics for
-.\"O 				propagation of GID
-.\"O 0400	S_ENFMT		002000	System V file locking enforcement (shared
-.\"O 				with S_ISGID)
-.\"O 0800	S_ISUID		004000	set-user-ID on execution (V7)
-.\"O 0800	S_CDF		004000	directory is a context dependent
-.\"O 				file (HP-UX)
-0200	S_ISVTX		001000	`¥¹¥Æ¥£¥Ã¥­¡¼¡¦¥Ó¥Ã¥È':»ÈÍѸå¤â
-				¥¹¥ï¥Ã¥×¤Ë»Ä¤¹ (V7)
-				ͽÌó (SVID-v2)
-				¥Ç¥£¥ì¥¯¥È¥ê°Ê³°: ¥Õ¥¡¥¤¥ë¤ò¥­¥ã¥Ã¥·¥å
-				¤·¤Ê¤¤ (SunOS)
-				¥Ç¥£¥ì¥¯¥È¥ê: ºï½üÀ©¸Â¥Õ¥é¥° (SVID-v4.2)
-0400	S_ISGID		002000	¼Â¹Ô»þ¤Î set-group-ID (V7)
-				¥Ç¥£¥ì¥¯¥È¥ê¤ËÂФ·¤Æ¤Ï GID ¤ÎÅÁã¤Ë
-				BSD Êý¼°¤ò»ÈÍѤ¹¤ë
-0400	S_ENFMT		002000	System V ¥Õ¥¡¥¤¥ë¡¦¥í¥Ã¥¯¤ò¶¯À©¤¹¤ë
-				(S_ISGID ¤È¶¦Í­)
-0800	S_ISUID		004000	¼Â¹Ô»þ¤Î set-user-ID (V7)
-0800	S_CDF		004000	¥Ç¥£¥ì¥¯¥È¥ê¤¬¾õ¶·°Í¸¥Õ¥¡¥¤¥ë (HP-UX)
+16進	名前	ls	8進数	説明
+f000	S_IFMT		170000	ファイル種別フィールドのビットマスク
+0000			000000	T{
+SCO では 使用不能 inode; BSD では不明なファイル種別;
+SVID\-v2 と XPG2 では 0 と 0100000 の両方が通常のファイル
+T}
+1000	S_IFIFO	p|	010000	FIFO (名前付きパイプ)
+2000	S_IFCHR	c	020000	キャラクタ特殊ファイル (V7)
+3000	S_IFMPC		030000	多重化されたキャラクタ特殊ファイル (V7)
+4000	S_IFDIR	d/	040000	ディレクトリ (V7)
+5000	S_IFNAM		050000	T{
+XENIX の二つの副型を持つ名前付きの特殊ファイル
+副型は \fIst_rdev\fP の値 1, 2 で区別される
+T}
+0001	S_INSEM	s	000001	XENIX の IFNAM セマフォ副型
+0002	S_INSHD	m	000002	XENIX の IFNAM 共有データ副型
+6000	S_IFBLK	b	060000	ブロック特殊ファイル (V7)
+7000	S_IFMPB		070000	多重化されたブロック特殊ファイル (V7)
+8000	S_IFREG	\-	100000	通常ファイル (V7)
+9000	S_IFCMP		110000	VxFS 圧縮ファイル
+9000	S_IFNWK	n	110000	ネットワーク特殊ファイル (HP\-UX)
+a000	S_IFLNK	l@	120000	シンボリックリンク (BSD)
+b000	S_IFSHAD		130000	T{
+Solaris の ACL 用の隠し inode (ユーザ空間からは見えない)
+T}
+c000	S_IFSOCK	s=	140000	ソケット (BSD; VxFS の "S_IFSOC")
+d000	S_IFDOOR	D>	150000	Solaris の door ファイル
+e000	S_IFWHT	w%	160000	BSD の空白ファイル (inode を使用しない)
+0200	S_ISVTX		001000	T{
+スティッキービット: 使用後もスワップに残す (V7)
+.br
+予約 (SVID\-v2)
+.br
+ディレクトリ以外: ファイルをキャッシュしない (SunOS)
+.br
+ディレクトリの場合: 削除制限フラグ (SVID\-v4.2)
+T}
+0400	S_ISGID		002000	T{
+実行時の set\-group\-ID (V7)
+.br
+ディレクトリの場合: GID の伝搬に BSD 方式を使用する
+T}
+0400	S_ENFMT		002000	T{
+System V ファイルロックを強制する (S_ISGID と共有)
+T}
+0800	S_ISUID		004000	実行時の set\-user\-ID (V7)
+0800	S_CDF		004000	T{
+ディレクトリがコンテキスト依存ファイル (HP\-UX)
+T}
 .TE
+.ad
+
+スティッキー コマンドは Version 32V AT&T UNIX で登場した。
+.SH 注意
+Linux では、 \fBlstat\fP() は一般には自動マウント動作 (automounter action) の
+きっかけとならないが、 \fBstat\fP() はきっかけとなる (\fBfstatat\fP(2) を参照)。
+
+\fI/proc\fP ディレクトリ以下にあるファイルのほとんどでは、 \fBstat\fP()  を呼び出した際に、 \fIst_size\fP
+フィールドにファイルサイズが返されない。 代わりに \fIst_size\fP フィールドには 0 が返される。
+.SS タイムスタンプフィールド
+古いカーネルや古い標準では、ナノ秒精度のタイムスタンプフィールドはサポートされていなかった。 代わりに 3 つの \fItime_t\fP
+型のタイムスタンプフィールド \fIst_atime\fP, \fIst_mtime\fP, and \fIst_ctime\fP があった。これらのフィールドには 1
+秒単位のタイムスタンプが記録されていた。
 
-.\"O A sticky command appeared in Version 32V AT&T UNIX.
-¥¹¥Æ¥£¥Ã¥­¡¼ ¥³¥Þ¥ó¥É¤Ï Version 32V AT&T UNIX ¤ÇÅо줷¤¿¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O Since kernel 2.5.48, the
-.\"O .I stat
-.\"O structure supports nanosecond resolution for the three
-.\"O file timestamp fields.
-.\"O Glibc exposes the nanosecond component of each field using names either
-.\"O of the form
-.\"O .IR st_atim.tv_nsec ,
-.\"O if the
-.\"O .B _BSD_SOURCE
-.\"O or
-.\"O .B _SVID_SOURCE
-.\"O feature test macro is defined,
-.\"O or of the form
-.\"O .IR st_atimensec ,
-.\"O if neither of these macros is defined.
-.\"O On file systems that do not support subsecond timestamps,
-.\"O these nanosecond fields are returned with the value 0.
-¥«¡¼¥Í¥ë 2.5.48 °Ê¹ß¤Ç¤Ï¡¢
-.I stat
-¹½Â¤ÂÎ¤Ï 3¤Ä¤Î¥Õ¥¡¥¤¥ë¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×´ØÏ¢¤Î¥Õ¥£¡¼¥ë¥É¤Ç
-¥Ê¥ÎÉÃñ°Ì¤ÎÀºÅÙ¤ËÂбþ¤·¤Æ¤¤¤ë¡£
-glibc ¤Ç¤Ï¡¢³Æ¥Õ¥£¡¼¥ë¥É¤Î¥Ê¥ÎÉäξðÊó¤ò
-.I st_atim.tv_nsec
-¤ä
-.I st_atimensec
-¤È¤¤¤Ã¤¿·Á¤Ç»²¾È¤Ç¤­¤ë¡£
-µ¡Ç½¸¡ºº¥Þ¥¯¥í
-.B _BSD_SOURCE
-¤«
-.B _SVID_SOURCE
-¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï
-.I st_atim.tv_nsec
-¤Î·Á¼°¤Ç¡¢¤½¤ì°Ê³°¤Î¾ì¹ç¤Ë¤Ï
-.I st_atimensec
-¤Î·Á¼°¤È¤Ê¤ë¡£
-Éäè¤êºÙ¤«¤¤¥¿¥¤¥à¥¹¥¿¥ó¥×¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¤Ï¡¢
-¤³¤ì¤é¤Î¥Ê¥ÎÉäΥե£¡¼¥ë¥É¤Ï 0 ¤ËÀßÄꤵ¤ì¤ë¡£
-.\" As at kernel 2.6.25, XFS and JFS support nanosecond timestamps,
-.\" but ext2, ext3, and Reiserfs do not.
-.\" FIXME . SUSv4 specifies nanosecond timestamps.
-
-.\"O On Linux,
-.\"O .BR lstat ()
-.\"O will generally not trigger automounter action, whereas
-.\"O .BR stat ()
-.\"O will.
-Linux ¤Ç¤Ï¡¢
-.BR lstat ()
-¤Ï°ìÈ̤ˤϼ«Æ°¥Þ¥¦¥ó¥ÈÆ°ºî (automounter action) ¤Î¤­¤Ã¤«¤±¤È¤Ê¤é¤Ê¤¤¤¬¡¢
-.BR stat ()
-¤Ï¤­¤Ã¤«¤±¤È¤Ê¤ë¡£
-
-.\"O For most files under the
-.\"O .I /proc
-.\"O directory,
-.\"O .BR stat ()
-.\"O does not return the file size in the
-.\"O .I st_size
-.\"O field; instead the field is returned with the value 0.
-.I /proc
-¥Ç¥£¥ì¥¯¥È¥ê°Ê²¼¤Ë¤¢¤ë¥Õ¥¡¥¤¥ë¤Î¤Û¤È¤ó¤É¤Ç¤Ï¡¢
-.BR stat ()
-¤ò¸Æ¤Ó½Ð¤·¤¿ºÝ¤Ë¡¢
-.I st_size
-¥Õ¥£¡¼¥ë¥É¤Ë¥Õ¥¡¥¤¥ë¥µ¥¤¥º¤¬ÊÖ¤µ¤ì¤Ê¤¤¡£
-Âå¤ï¤ê¤Ë
-.I st_size
-¥Õ¥£¡¼¥ë¥É¤Ë¤Ï 0 ¤¬ÊÖ¤µ¤ì¤ë¡£
-.\"O .SS Underlying kernel interface
-.SS Çظå¤Î¥«¡¼¥Í¥ë¡¦¥¤¥ó¥¿¥Õ¥§¡¼¥¹
-.\"O Over time, increases in the size of the
-.\"O .I stat
-.\"O structure have led to three successive versions of
-.\"O .BR stat ():
-»þ´Ö¤Î·Ð²á¤È¤È¤â¤Ë¡¢
-.I stat
-¹½Â¤ÂΤΥµ¥¤¥º¤¬Â礭¤¯¤Ê¤ê¡¢¤³¤Î±Æ¶Á¤Ç
-.BR stat ()
-¤Ë¤Ï 3¤Ä¤Î¥Ð¡¼¥¸¥ç¥ó¤¬Â¸ºß¤¹¤ë:
-.\"O .IR sys_stat ()
-.\"O (slot
-.\"O .IR __NR_oldstat ),
-.\"O .IR sys_newstat ()
-.\"O (slot
-.\"O .IR __NR_stat ),
-.\"O and
-.\"O .I sys_stat64()
-.\"O (new in kernel 2.4; slot
-.\"O .IR __NR_stat64 ).
-.IR sys_stat ()
-(¥¹¥í¥Ã¥È¤Ï
-.IR __NR_oldstat )¡¢
-.IR sys_newstat ()
-(¥¹¥í¥Ã¥È¤Ï
-.IR __NR_stat )¡¢
-.IR sys_stat64 ()
-(¥«¡¼¥Í¥ë 2.4 ¤ÇƳÆþ; ¥¹¥í¥Ã¥È¤Ï
-.IR __NR_stat64 ).
-.\"O The glibc
-.\"O .BR stat ()
-.\"O wrapper function hides these details from applications,
-.\"O invoking the most recent version of the system call provided by the kernel,
-.\"O and repacking the returned information if required for old binaries.
-glibc ¤Î
-.BR stat ()
-¥é¥Ã¥Ñ¡¼´Ø¿ô¤Ï¤³¤ì¤é¤Î¾ÜºÙ¤ò¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤«¤é±£Ê䷤Ƥ¯¤ì¤ë¡£
-¶ñÂÎŪ¤Ë¤Ï¡¢¥«¡¼¥Í¥ë¤¬Ä󶡤·¤Æ¤¤¤ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¤¦¤ÁºÇ¿·¤Î¥Ð¡¼¥¸¥ç¥ó¤ò
-µ¯Æ°¤·¡¢¸Å¤¤¥Ð¥¤¥Ê¥ê¤Î¾ì¹ç¤Ë¤ÏɬÍפ˱þ¤¸¤ÆÊÖ¤µ¤ì¤¿¾ðÊó¤òºÆ¹½À® (repack) ¤¹¤ë¡£
-.\"O Similar remarks apply for
-.\"O .BR fstat ()
-.\"O and
-.\"O .BR lstat ().
-.BR fstat ()
-¤È
-.BR lstat ()
-¤Ë¤Ä¤¤¤Æ¤âƱÍͤǤ¢¤ë¡£
+カーネル 2.5.48 以降では、 \fIstat\fP 構造体は 3 つのファイルのタイムスタンプ関連のフィールドでナノ秒単位の精度に対応している。
+機能検査マクロ \fB_BSD_SOURCE\fP か \fB_SVID_SOURCE\fP が定義された場合に、各タイムスタンプのナノ秒の情報は
+\fIst_atim.tv_nsec\fP という形式の名前で参照できる。 ナノ秒のタイムスタンプは現在では標準化されており、 POSIX.1\-2008
+からである。 バージョン 2.12 以降の glibc では、 \fB_POSIX_C_SOURCE\fP が 200809L 以上の値で定義されるか、
+\fB_XOPEN_SOURCE\fP が 700 以上の値で定義された場合にも、 このナノ秒のタイムスタンプが公開される。
+上記のマクロのいずれも定義されていない場合、ナノ秒の値は \fIst_atimensec\fP という形式の名前で公開される。
+
+.\" commit ef7f38359ea8b3e9c7f2cae9a4d4935f55ca9e80
+ナノ秒のタイムスタンプは XFS, JFS, Btrfs, ext4 でサポートされている (Linux 2.6.23 以降)。
+ナノ秒のタイムスタンプは ext2, ext3, Reiserfs ではサポートされていない。
+サブ秒のタイムスタンプをサポートしていないファイルシステムでは、 ナノ秒のフィールドには値 0 が入る。
+.SS 背後のカーネル・インタフェース
 .\"
 .\" A note from Andries Brouwer, July 2007
 .\"
@@ -935,18 +542,16 @@ glibc 
 .\" interface, rather than the libc-kernel interface.
 .\"
 .\" (Note that the details depend on gcc being used as c compiler.)
-.\"O .SH EXAMPLE
-.SH Îã
-.\"O The following program calls
-.\"O .BR stat ()
-.\"O and displays selected fields in the returned
-.\"O .I stat
-.\"O structure.
-°Ê²¼¤Î¥×¥í¥°¥é¥à¤Ï
-.BR stat ()
-¤ò¸Æ¤Ó½Ð¤·¡¢Ê֤äƤ­¤¿
-.I stat
-¹½Â¤ÂΤΥե£¡¼¥ë¥É¤Î¤¤¤¯¤Ä¤«¤òɽ¼¨¤¹¤ë¡£
+時間の経過とともに、 \fIstat\fP 構造体のサイズが大きくなり、この影響で \fBstat\fP()  には 3つのバージョンが存在する:
+\fIsys_stat\fP()  (スロットは \fI__NR_oldstat\fP)、 \fIsys_newstat\fP()  (スロットは
+\fI__NR_stat\fP)、 \fIsys_stat64\fP()  (カーネル 2.4 で導入; スロットは \fI__NR_stat64\fP).  glibc
+の \fBstat\fP()  ラッパー関数はこれらの詳細をアプリケーションから隠蔽してくれる。
+具体的には、カーネルが提供しているシステムコールのうち最新のバージョンを 起動し、古いバイナリの場合には必要に応じて返された情報を再構成
+(repack) する。 \fBfstat\fP()  と \fBlstat\fP()  についても同様である。
+
+glibc の \fBfstatat\fP() ラッパー関数が内部で利用するシステムコールは、実際には \fBfstatat64\fP() である。
+.SH 例
+以下のプログラムは \fBstat\fP()  を呼び出し、返ってきた \fIstat\fP 構造体のフィールドのいくつかを表示する。
 .nf
 
 #include <sys/types.h>
@@ -961,7 +566,7 @@ main(int argc, char *argv[])
     struct stat sb;
 
     if (argc != 2) {
-        fprintf(stderr, "Usage: %s <pathname>\\n", argv[0]);
+        fprintf(stderr, "Usage: %s <pathname>\en", argv[0]);
         exit(EXIT_FAILURE);
     }
 
@@ -973,30 +578,30 @@ main(int argc, char *argv[])
     printf("File type:                ");
 
     switch (sb.st_mode & S_IFMT) {
-    case S_IFBLK:  printf("block device\\n");            break;
-    case S_IFCHR:  printf("character device\\n");        break;
-    case S_IFDIR:  printf("directory\\n");               break;
-    case S_IFIFO:  printf("FIFO/pipe\\n");               break;
-    case S_IFLNK:  printf("symlink\\n");                 break;
-    case S_IFREG:  printf("regular file\\n");            break;
-    case S_IFSOCK: printf("socket\\n");                  break;
-    default:       printf("unknown?\\n");                break;
+    case S_IFBLK:  printf("block device\en");            break;
+    case S_IFCHR:  printf("character device\en");        break;
+    case S_IFDIR:  printf("directory\en");               break;
+    case S_IFIFO:  printf("FIFO/pipe\en");               break;
+    case S_IFLNK:  printf("symlink\en");                 break;
+    case S_IFREG:  printf("regular file\en");            break;
+    case S_IFSOCK: printf("socket\en");                  break;
+    default:       printf("unknown?\en");                break;
     }
 
-    printf("I\-node number:            %ld\\n", (long) sb.st_ino);
+    printf("I\-node number:            %ld\en", (long) sb.st_ino);
 
-    printf("Mode:                     %lo (octal)\\n",
+    printf("Mode:                     %lo (octal)\en",
             (unsigned long) sb.st_mode);
 
-    printf("Link count:               %ld\\n", (long) sb.st_nlink);
-    printf("Ownership:                UID=%ld   GID=%ld\\n",
+    printf("Link count:               %ld\en", (long) sb.st_nlink);
+    printf("Ownership:                UID=%ld   GID=%ld\en",
             (long) sb.st_uid, (long) sb.st_gid);
 
-    printf("Preferred I/O block size: %ld bytes\\n",
+    printf("Preferred I/O block size: %ld bytes\en",
             (long) sb.st_blksize);
-    printf("File size:                %lld bytes\\n",
+    printf("File size:                %lld bytes\en",
             (long long) sb.st_size);
-    printf("Blocks allocated:         %lld\\n",
+    printf("Blocks allocated:         %lld\en",
             (long long) sb.st_blocks);
 
     printf("Last status change:       %s", ctime(&sb.st_ctime));
@@ -1006,13 +611,10 @@ main(int argc, char *argv[])
     exit(EXIT_SUCCESS);
 }
 .fi
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR access (2),
-.BR chmod (2),
-.BR chown (2),
-.BR fstatat (2),
-.BR readlink (2),
-.BR utime (2),
-.BR capabilities (7),
-.BR symlink (7)
+.SH 関連項目
+\fBls\fP(1), \fBstat\fP(1), \fBaccess\fP(2), \fBchmod\fP(2), \fBchown\fP(2),
+\fBreadlink\fP(2), \fButime\fP(2), \fBcapabilities\fP(7), \fBsymlink\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。