AT&T UNIX™PC Unix System V Users Manual - tenox

STAT ( 2 ) STAT ( 2 )
NAME
stat, fstat - get file status
SYNOPSIS
#include
#include
int stat (path, bur)
char *path;
struct stat •bur;
int rstat (tildes, bur)
int tildes;
struct stat •bur;
DESCRIPTION
Path points to a path name naming a file. Read, write or execute
permission of the named file is not required, but all directories
listed in the path name leading to the file must be searchable.
Stat obtains information about the named file.
Similarly, fstat obtains information about an open file known by
the file descriptor fildes, obtained from a successful open, ere at,
dup , fcntl, or pipe system call.
Buf is a pointer to a stat structure into which information is
placed concerning the file.
The contents of the structure pointed to by buf include the following
members:
dev_t
ino_t
ushort
short
ushort
ushort
dev_t
off_t
time_t
time_t
time_t
st_dev;
st_ino;
st_mode;
st_nlink;
st_uid;
st_gid;
st_rdev;
st_size;
st_atime;
st_mtime;
st_ctime;
/• ID of device containing •I
I* a directory entry for this file •/
I* Inode number *I
I• File mode; see mknod(2) •I
I* Number of links •I
I* User ID of the file's owner •I
I* Group ID of the file's group •I
I* ID of device •I
I* This entry is defined only for *I
I• character special or block •I
I* special files •I
I* File size in bytes *I
I• Time of last access *I
I* Time of last data modification *I
I• Time of last file status change •I
I* Times measured in seconds •I
I* since 00:00:00 GMT, *I
I* Jan. 1, 1970 •I
st_atime Time when file data was last accessed. Changed by
the following system calls: creat(2), mknod(2),
pipe(2), utime (2), and read(2).
st_mtime Time when data was last modified. Changed by the
following system calls: creat(2), mknod(2), pipe(2),
utime(2), and write(2).
- 1 -