'\" t
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" 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
.\"
.\" 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.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt <michael@moria.de>
.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
.\" Modified 1995-05-18 by Todd Larason <jtl@molehill.org>
.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified 1995-01-09 by Richard Kettlewell <richard@greenend.org.uk>
.\" Modified 1998-05-13 by Michael Haardt <michael@cantor.informatik.rwth-aachen.de>
.\" Modified 1999-07-06 by aeb & Albert Cahalan
.\" Modified 2000-01-07 by aeb
.\" Modified 2004-06-23 by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
.\" Japanese Version Copyright (c) 1998-1999 HANATAKA Shinya
.\"         all rights reserved.
.\" Translated 1998-06-21, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Modified 1999-04-16, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
.\" Updated 2000-01-03, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2000-10-06, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2001-04-09, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2001-06-25, Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2005-02-28, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.\"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 2004-06-23 "Linux 2.6.7" "Linux Programmer's Manual"
.SH ̾
stat, fstat, lstat \- եξ֤
.SH 
.B #include <sys/types.h>
.br
.B #include <sys/stat.h>
.br
.B #include <unistd.h>
.sp
.BI "int stat(const char *" file_name ", struct stat *" buf );
.br
.BI "int fstat(int " filedes ", struct stat *" buf );
.br
.BI "int lstat(const char *" file_name ", struct stat *" buf );
.SH 
.PP
δؿϻꤵ줿եˤĤƤξ֤ξ
뤿ˤΥեФƤΥĤɬפȤʤ
Υեػǥ쥯ȥƤФ븡ĤɬפǤ롣
.PP
.B stat

.I file_name
ǻꤵ줿եξ֤
.I buf 
سǼ롣

.B lstat

.B stat
ƱǤ뤬оݤܥå󥯤ξ硢
󥯤ȤƤեǤϤʤ󥯼Ȥξ֤ۤʤ롣

.B fstat

.B stat
Ʊ
.I file_name 
ǤϤʤ
.RB ( open (2)
֤)
.I filedes
ˤäƻꤵ롢ץ󤵤줿եξ֤롣

.PP
δؿϡ̤
.I stat
¤Τ֤
.I stat
¤ΤˤϰʲΥեɤޤޤƤ:
.PP
.RS
.nf
struct stat {
    dev_t         st_dev;      /* ǥХ */
    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;     /* ǥХ (inode ǥХξ) */
    off_t         st_size;     /* ե륵 (Хȿ) */
    blksize_t     st_blksize;  /* ե륷ƥ I/O ǤΥ֥å */
    blkcnt_t      st_blocks;   /* Ƥ줿֥å */
    time_t        st_atime;    /* ǽ */
    time_t        st_mtime;    /* ǽѹ */
    time_t        st_ctime;    /* ǽơѹ */
};
.fi
.RE
.PP
.I st_size
 (̾Υե뤫ܥå󥯤ξ)
ե礭Хȿ򼨤
ܥå󥯤礭ϡޤޤƤѥ̾Ĺ
(Ǹ NUL ʸϴޤޤʤ) Ǥ롣

.I st_blocks
ϥե礭 512 ХȤΥ֥åñ̤򼨤
(ե˷꤬褦ʾ硢ͤ
.IR st_size /512
꾮ʤ뤳Ȥ⤢)
.I st_blksize
ϸΨŪ˥ե롦ƥ I/O Ǥֹޤץ֥å򼨤
(äȾñ̤ǥե˽񤭹ߤԤȡ
ɤ߽Ф----ƽ񤭹ߤȤäΨưˤʤäƤޤ⤷ʤ)
.PP
Ƥ Linux Υե롦ƥबƤλ֥եɤ
Ƥ櫓ǤϤʤ
ե륢
.I st_atime
եɤ򹹿ʤ褦ʤǥޥȤǤե륷ƥ⤢롣
.RB ( mount (8)
 `noatime' ץ򻲾)

.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
Ϲ뤳Ȥ⤢СǤʤ⤢롣

.I st_mtime
եɤϡե뤬줿ѹ
(㤨С
.BR mknod (2),
.BR truncate (2),
.BR utime (2)
Ѥ
.BR write (2)
 1 ХȰʾ񤭹ߤ򤷤ʤ)
ˡǥ쥯ȥ
.I st_mtime
ϡΥǥ쥯ȥ
ե뤬줿줿ꤹѹ롣
.I st_mtime
եɤ
ͭԤ䥰롼פϡɡ󥯿⡼ɤѹǤѹ
.I ʤ

.I st_ctime
եɤϽ񤭹ߤ inode 
(ͭԡ롼ס󥯿⡼ɤʤ) 
ˤäѹ롣
.PP
ʲ POSIX ޥϡ
.I st_mode
ե
ǻѤե̤ΥåΤƤ :
.RS
.TP 1.2i
S_ISREG(m)
̾Υե뤫?
.TP
S_ISDIR(m)
ǥ쥯ȥ꤫?
.TP
S_ISCHR(m)
饯ǥХ?
.TP
S_ISBLK(m)
֥åǥХ?
.TP
S_ISFIFO(m)
fifo ?
.TP
S_ISLNK(m)
ܥå󥯤 (POSIX.1-1996 ˤϤʤ)
.TP
S_ISSOCK(m)
åȤ? (POSIX.1-1996 ˤϤʤ)
.RE
.PP
ʲΥե饰
.I st_mode
եѤƤ:
.P
.TS
l 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
S_ISUID	0004000	set UID bit
S_ISGID	0002000	set GID 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	¾ (others) ΥѤΥӥåȥޥ
S_IROTH	00004	¾ͤɤ߹ߵ
S_IWOTH	00002	¾ͤν񤭹ߵ
S_IXOTH	00001	¾ͤμ¹Ե
.TE
.P
set GID bit (S_ISGID) ˤϤĤüʻˡ:
ǥ쥯ȥꤷˤϡΥǥ쥯ȥ꤬ BSD ǻѤ
Ȥ򼨤ĤޤꡢΥǥ쥯ȥ˺줿եΥ롼ID 
ץμ¸ (effective) 롼ID ǤϤʤǥ쥯ȥ
롼ID Ѿ롣ޤΥǥ쥯ȥ˺줿ǥ쥯ȥˤ
S_ISGID ӥåȤꤵ롣롼׼¹ԥӥå (S_IXGRP) ꤵƤʤ
եꤵ줿ϡե/쥳ɤζŪ (mandatory)
åɽ
.P
ǥ쥯ȥˡ֥ƥåץӥå (S_ISVTX) ꤵ줿ϡ
Υǥ쥯ȥΥե̾ѹꡢǤΤϡ
ΥեνͭԤΥǥ쥯ȥνͭԤøץ
Ȥʤ롣
.SH ֤
 0 ֤顼ξ \-1 ֤
.I errno
Ŭڤͤꤵ롣
.SH 顼
.TP
.B EACCES
.I file_name
°ǥ쥯ȥȤξ̤Υǥ쥯ȥΤ줫
Ф븡Ĥʤä
.RB ( path_resolution (2)
⻲ȤΤ)
.TP
.B EBADF
.I filedes
Ǥ롣
.TP
.B EFAULT
ɥ쥹ְäƤ롣
.TP
.B ELOOP
ѥéݤ˲褹٤ܥå󥯤¿᤮
.TP
.B ENAMETOOLONG
ե̾Ĺ᤮롣
.TP
.B ENOENT
ѥ
.I file_name
ιǤ¸ߤʤѥʸǤ롣
.TP
.B ENOMEM
ͥΥ꤬­ʤ
.TP
.B ENOTDIR
ѥιǤǥ쥯ȥǤϤʤ
.SH 
.B stat

.B fstat
 SVr4, SVID, POSIX, X/OPEN, 4.3BSD ˽򤷤Ƥ롣
.B lstat
 4.3BSD  SVr4 ˽򤷤Ƥ롣
SVr4 ˤ¾
.B fstat
Υ顼Ȥ EINTR, ENOLINK, EOVERFLOW ܤƤ롣
SVr4 ˤ¾
.B stat

.B lstat
Υ顼Ȥ EINTR, EMULTIHOP, ENOLINK, EOVERFLOW ܤƤ롣
.I st_blocks

.I st_blksize
եɤλѤϤޤܿʤ
(Υեɤ BSD ˤäƳ줿
POSIX ˤϵꤵƤ롣ƥऴȤ˲᤬ۤʤäƤꡢ
NFS ޥȤξˤƱƥǤۤʤǽ)
.LP
POSIX ˤ  S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK, S_IFDIR, S_IFCHR,
S_IFIFO, S_ISVTX ӥåȤˤĤƤεҤϤʤ S_ISDIR() Τ褦
ޥѤ褦׵ᤷƤ롣
S_ISLNK  S_ISSOCK ޥ POSIX.1-1996 ˤϤʤξȤ
POSIX ʤμΥСˤϴޤޤԤ SVID 4v2 ˡ
Ԥ SUSv2 ͳ褷Ƥ롣
.LP
Unix V7 (ȤθΥƥ)  S_IREAD, S_IWRITE, S_IEXEC äƤꡢ
POSIX ϤƱȤ S_IRUSR, S_IWUSR, S_IXUSR ؼƤ롣
.SH ¾Υƥ
Ƽ亮ƥǻѤƤ():
.P
.TS
l l l l l.
16	̾	ls	8ʿ	
f000	S_IFMT		170000	ե̥եɤΥӥåȥޥ
0000			000000	SCO Ǥ ǽ inode, BSD Ǥ̤ΤΥե
				SVID-v2  XPG2 Ǥ 0  0100000 ξ̤Υե
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 Ĥ̾դüե
				 st_rdev  1,2 Ƕ̤:
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	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 Ѥʤ)

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	SysV ե롦å(S_ISGID ȶͭ)
0800	S_ISUID		004000	¹Ի set user ID (V7)
0800	S_CDF		004000	ǥ쥯ȥ꤬¸ե (HP-UX)
.TE

ƥå ޥɤ Version 32V AT&T UNIX о줷

.SH Ϣ
.BR chmod (2),
.BR chown (2),
.BR readlink (2),
.BR utime (2),
.BR capabilities (7)