fstat函数及struct stat结构
(2011-08-04 17:29:10)
转载标签： 杂谈 | 分类： Linux |
一、fstat 函数
功能：由文件描述符取得文件状态。
相关函数：stat 、lstat 、chmod 、chown 、readlink 、utime。
头文件： #include <sys/stat.h>
#include <unistd.h>
函数声明： int fstat （int filedes，struct ＊buf）；
描述： fstat（）用来将参数filedes 所指向的文件状态复制到参数buf 所指向的结构中（struct stat）。fstat（）与stat（）作用完全相同，不同之处在于传入的参数为已打开的文件描述符。
返回值：执行成功返回0，失败返回－1，错误代码保存在errno。
下面举一个小例子：
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <unistd.h>
#include <fcntl.h>
main()
{
struct stat buf;
int fd;
fd = open ( "/etc/passwd", O_RDONLY);
fstat (fd, &buf);
printf("/etc/passwd file size = %d\n",(int)(buf.st_size));
}
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
执行结果：
/etc/passwd file size = 1656
也许，你看到这里会产生和我一样的疑惑：这个struct stat 结构到底是什么样的呢？
下面我就来详细的介绍一下它了哦～～～
二、struct stat结构体
定义如下：
struct stat {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; // 上次状态更改时间
};
st_dev 字段描述该文件所在的设备。(major() 和minor()宏可能在分析这个设备ID域时有用。)
st_rdev 字段描述这个文件(inode)本身代表的设备。
st_size 字段给出文件字节尺寸(如果它是一个普通文件或符号链接)。对于符号链接而言是它所有包含路径名长度，不包括结尾的空字符。
st_blocks 字段指明文件已经分配数据块的个数，数据块以 512 字节为单位。(这可能小于 st_size/512，当文件有空洞时。)
st_blksize 给出对于高效文件系统 I/O 操作的优先块尺寸。(数据以小尺寸块写入文件时可能导致低效的 读-更改-覆盖 操作。)
不是所有的 Linux 文件系统实现了所有的时间域。一些文件系统允许挂载时不去访问文件或目录且不会导致st_atime 字段更新。(参考 mount() 的 noatime、nodiratime 和 relatime，以及mount() 中相关的信息。)此外，如果文件以 O_NOATIME 标志打开，st_atime 不会被更新。
st_atime 字段在文件访问时更改，比如，execve()、mknod()、pipe()、utime() 和read()(多于零个字节)。
域 st_mtime 在文件更改时更新，比如，mknod()、truncate()、utime() 和 write()(多于零个字节)。再者，一个目录的 st_mtime 在这个目录里创建或删除文件时更新。st_mtime 在更改所有者、组、硬链接个数或权限模式时 不会 更新。
st_ctime 字段在写入或设置结点(inode)信息(如所有者、组、链接数、权限等等)时会更改。
下面 POSIX 宏用于使用 st_mode 字段测试文件类型：
S_ISREG(m)
它是普通文件吗？
S_ISDIR(m)
目录吗？
S_ISCHR(m)
字符设备？
S_ISBLK(m)
块设备？
S_ISFIFO(m)
FIFO(命名管道)？
S_ISLNK(m)
符号链接？(不在 POSIX.1-1996。)
S_ISSOCK(m)
套接口？(不在 POSIX.1-1996。)
下面标志为 st_mode 域定义：
| 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 | 设置 UID 位 |
| S_ISGID | 0002000 | 设置 组ID 位 (看下面) |
| 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 | 其他用户权限掩码(不在组内) |
| S_IROTH | 00004 | 其他有读权限 |
| S_IWOTH | 00002 | 其他有写权限 |
| S_IXOTH | 00001 | 其他有执行权限 |
设置组ID位S_ISGID)有多个特殊用处。对于一个目录而言，它指明 BSD 语义应用到这个目录；创建的文件继承其父目录的组ID，而不是来自创建进程的有效组ID，并且创建的目录同时也会获得 S_SIGID 位设置。对于一个没有组执行权限位(S_IXGRP)文件而言，设置组ID位用于指明托管文件/记录锁。
在目录上的粘滞位(S_ISVTX)表示目录里的文件只有其所有者，目录所有者，和特权进程，可以对其进行重命名或删除。
