diff options
| author | Tobias Klauser <tklauser@distanz.ch> | 2008-01-27 11:37:44 +0100 |
|---|---|---|
| committer | Tobias Klauser <tklauser@xenon.tklauser.home> | 2008-01-27 11:37:44 +0100 |
| commit | 7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch) | |
| tree | b1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/FUNCTIONS/stat.html | |
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/FUNCTIONS/stat.html')
| -rw-r--r-- | reference/C/FUNCTIONS/stat.html | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/reference/C/FUNCTIONS/stat.html b/reference/C/FUNCTIONS/stat.html new file mode 100644 index 0000000..601aeaa --- /dev/null +++ b/reference/C/FUNCTIONS/stat.html @@ -0,0 +1,124 @@ +<title>stat/fstat/lstat functions.</title> + +<head> +<script language="JavaScript"> +</script> +</head> + +<body bgcolor=#ffffcc> +<hr> +<center> +<h1>stat/fstat/lstat functions.</h1> +</center> +<hr> +<p> + +All three functions return information about a file. Please note +that devices are seen as files to Unix, so you could 'stat' things +like /dev/mouse to see when the mouse was last moved.<p> + +<b>stat</b> return the status of a file.<p> + +<b>fstat</b> stats an open file.<p> + +<b>lstat</b> reports on a link, not the file it points too.<p> +<pre> +Libraries: sys/stat.h + unistd.h + +Syntax: struct stat stat_p; + stat ("martin", &stat_p); + +Stat Structure: + + struct stat + { + dev_t st_dev; /* device */ + ino_t st_ino; /* inode */ + umode_t st_mode; /* protection */ + nlink_t st_nlink; /* number of hard links */ + uid_t st_uid; /* user ID of owner */ + gid_t st_gid; /* group ID of owner */ + dev_t st_rdev; /* device type (if inode device) */ + off_t st_size; /* total size, in bytes */ + unsigned long st_blksize; /* blocksize for filesystem I/O */ + unsigned long st_blocks; /* number of blocks allocated */ + time_t st_atime; /* time of last access */ + time_t st_mtime; /* time of last modification */ + time_t st_ctime; /* time of last change */ + }; + +</pre> + +<b>st_mode</b> can be used with the following macros to discover the +type of file being statted. + +<a name=filetype> +<pre> + S_ISLNK(st_mode) is it a symbolic link + + S_ISREG(st_mode) regular file + + S_ISDIR(st_mode) directory + + S_ISCHR(st_mode) character device + + S_ISBLK(st_mode) block device + + S_ISFIFO(st_mode) fifo + + S_ISSOCK(st_mode) socket +</pre> + +These functions return a large amount of information. See the man page +(below) for details. You will need to understand +<a href="../SYNTAX/struct.html">structures</a> to work with stat.<p> + +<img src=../../GRAPHICS/man.gif> +<a href="../MAN/stat.htm"> +man page to provide all the details.</a> +<p> +<hr> +<h2>Examples</h2> +<img src=../../GRAPHICS/computer.gif> +<a href="../EXAMPLES/stat.c"> +example program.</a> +<p> +<hr> +<h2>See also:</h2> +<img src=../../GRAPHICS/whiteball.gif> +<a href=directory.html>POSIX functions to read directory information.</a> +<p> +<hr> +<h2>Note</h2> +I have seen a problem with the 'access time', it only seems to get updated +if the file system is local. If the filesystem is NFS mounted and +accessed via 'cat' or 'head' the access date is not updated. + + +<p> + +<hr> +<p> +<center> +<table border=2 width="80%" bgcolor="ivory"> +<tr align=center> +<td width="25%"> +<a href="../cref.html"> Top</a> +</td><td width="25%"> +<a href="../master_index.html"> Master Index</a> +</td><td width="25%"> +<a href="../SYNTAX/keywords.html"> Keywords</a> +</td><td width="25%"> +<a href="funcref.htm"> Functions</a> +</td> +</tr> +</table> +</center> +<p> +<hr> +<address>Martin Leslie +</address><p> +</body> +</html> + |