Linux 函数--fstat/stat/lstat系统调用

秒速五厘米 2022-06-12 10:37 223阅读 0赞

### [Linux 函数--fstat/stat/lstat系统调用][Linux _--fstat_stat_lstat]  ###

[Linux][]

表头文件: \#include <sys/stat.h>  
\#include <unistd.h>  
定义函数: int stat(const char \*file\_name, struct stat \*buf);  
  
函数说明: 通过文件名filename获取文件信息，并保存在buf所指的结构体stat中  
返回值: 执行成功则返回0，失败返回-1，错误代码存于errno  
错误代码:  
ENOENT 参数file\_name指定的文件不存在  
ENOTDIR 路径中的目录存在但却非真正的目录  
ELOOP 欲打开的文件有过多符号连接问题，上限为16符号连接  
EFAULT 参数buf为无效指针，指向无法存在的内存空间  
EACCESS 存取文件时被拒绝  
ENOMEM 核心内存不足  
ENAMETOOLONG 参数file\_name的路径名称太长  
\#include <sys/stat.h>  
\#include <unistd.h>  
\#include <stdio.h>  
int main() \{  
struct stat buf;  
stat("/etc/hosts", &buf);  
printf("/etc/hosts file size = %d\\n", buf.st\_size);  
\}  
\-----------------------------------------------------  
struct stat \{  
dev\_t st\_dev; //文件的设备编号  
ino\_t st\_ino; //节点  
mode\_t st\_mode; //文件的类型和存取的权限  
nlink\_t st\_nlink; //连到该文件的硬连接数目，刚建立的文件值为1  
uid\_t st\_uid; //用户ID  
gid\_t st\_gid; //组ID  
dev\_t st\_rdev; //(设备类型)若此文件为设备文件，则为其设备编号  
off\_t st\_size; //文件字节数(文件大小)  
unsigned long st\_blksize; //块大小(文件系统的I/O 缓冲区大小)  
unsigned long st\_blocks; //块数  
time\_t st\_atime; //最后一次访问时间  
time\_t st\_mtime; //最后一次修改时间  
time\_t st\_ctime; //最后一次改变时间(指属性)  
\};  
先前所描述的st\_mode 则定义了下列数种情况：  
S\_IFMT 0170000 文件类型的位遮罩  
S\_IFSOCK 0140000 scoket  
S\_IFLNK 0120000 符号连接  
S\_IFREG 0100000 一般文件  
S\_IFBLK 0060000 区块装置  
S\_IFDIR 0040000 目录  
S\_IFCHR 0020000 字符装置  
S\_IFIFO 0010000 先进先出  
S\_ISUID 04000 文件的(set user-id on execution)位  
S\_ISGID 02000 文件的(set group-id on execution)位  
S\_ISVTX 01000 文件的sticky位  
S\_IRUSR(S\_IREAD) 00400 文件所有者具可读取权限  
S\_IWUSR(S\_IWRITE)00200 文件所有者具可写入权限  
S\_IXUSR(S\_IEXEC) 00100 文件所有者具可执行权限  
S\_IRGRP 00040 用户组具可读取权限  
S\_IWGRP 00020 用户组具可写入权限  
S\_IXGRP 00010 用户组具可执行权限  
S\_IROTH 00004 其他用户具可读取权限  
S\_IWOTH 00002 其他用户具可写入权限  
S\_IXOTH 00001 其他用户具可执行权限  
上述的文件类型在POSIX中定义了检查这些类型的宏定义：  
S\_ISLNK (st\_mode) 判断是否为符号连接  
S\_ISREG (st\_mode) 是否为一般文件  
S\_ISDIR (st\_mode) 是否为目录  
S\_ISCHR (st\_mode) 是否为字符装置文件  
S\_ISBLK (s3e) 是否为先进先出  
S\_ISSOCK (st\_mode) 是否为socket  
若一目录具有sticky位(S\_ISVTX)，则表示在此目录下的文件只能被该文件所有者、此目录所有者或root来删除或改名。  
\-----------------------------------------------------  
struct statfs \{  
long f\_type; //文件系统类型  
long f\_bsize; //块大小  
long f\_blocks; //块多少  
long f\_bfree; //空闲的块  
long f\_bavail; //可用块  
long f\_files; //总文件节点  
long f\_ffree; //空闲文件节点  
fsid\_t f\_fsid; //文件系统id  
long f\_namelen; //文件名的最大长度  
long f\_spare\[6\]; //spare for later  
\};  
stat、fstat和lstat函数(UNIX)  
\#include<sys/types.h>  
\#include<sys/stat.h>  
int stat(const char \*restrict pathname, struct stat \*restrict buf);  
提供文件名字，获取文件对应属性。感觉一般是文件没有打开的时候这样操作。  
int fstat(int filedes, struct stat \*buf);  
通过文件描述符获取文件对应的属性。文件打开后这样操作  
int lstat(const char \*restrict pathname, struct stat \*restrict buf);  
连接文件  
三个函数的返回：若成功则为0，若出错则为-1  
给定一个pathname，stat函数返回一个与此命名文件有关的信息结构，fstat函数获得已在描述符filedes上打开的文件的有关信息。lstat函数类似于stat，但是当命名的文件是一个符号连接时，lstat返回该符号连接的有关信息，而不是由该符号连接引用的文件的信息。  
第二个参数是个指针，它指向一个我们应提供的结构。这些函数填写由buf指向的结构。该结构的实际定义可能随实现而有所不同，但其基本形式是：  
struct stat\{  
mode\_t st\_mode; /\*file tpye &mode (permissions)\*/  
ino\_t st\_ino; /\*i=node number (serial number)\*/  
dev\_t st\_rdev; /\*device number for special files\*/  
nlink\_t st\_nlink; /\*number of links\*/  
uid\_t st\_uid; /\*user id of owner\*/  
gid\_t st\_gid; /\*group ID of owner\*/  
off\_t st\_size; /\*size in bytes for regular files\*/  
time\_t st\_atime; /\*time of last access\*/  
time\_t st\_mtime; /\*time of last modification\*/  
time\_t st\_ctime; /\*time of last file status change\*/  
long st\_blksize; /\*best I/O block size \*/  
long st\_blocks; /\*number of 512-byte blocks allocated\*/  
\};  
注意，除最后两个以外，其他各成员都为基本系统数据类型。我们将说明此结构的每个成员以了解文件属性。  
  
使用stat函数最多的可能是ls-l命令，用其可以获得有关一个文件的所有信息。  
1 函数都是获取文件（普通文件，目录，管道，socket，字符，块（）的属性。  
函数原型  
\#include <sys/stat.h>  
int stat(const char \*restrict pathname, struct stat \*restrict buf);  
提供文件名字，获取文件对应属性。  
int fstat(int filedes, struct stat \*buf);  
通过文件描述符获取文件对应的属性。  
int lstat(const char \*restrict pathname, struct stat \*restrict buf);  
连接文件描述命，获取文件属性。  
2 文件对应的属性  
struct stat \{  
mode\_t st\_mode; //文件对应的模式，文件，目录等  
ino\_t st\_ino; //inode节点号  
dev\_t st\_dev; //设备号码  
dev\_t st\_rdev; //特殊设备号码  
nlink\_t st\_nlink; //文件的连接数  
uid\_t st\_uid; //文件所有者  
gid\_t st\_gid; //文件所有者对应的组  
off\_t st\_size; //普通文件，对应的文件字节数  
time\_t st\_atime; //文件最后被访问的时间  
time\_t st\_mtime; //文件内容最后被修改的时间  
time\_t st\_ctime; //文件状态改变时间  
blksize\_t st\_blksize; //文件内容对应的块大小  
blkcnt\_t st\_blocks; //伟建内容对应的块数量  
\};  
可以通过上面提供的函数，返回一个结构体，保存着文件的信息。

[Linux _--fstat_stat_lstat]: http://xinzhiwen198941-163-com.iteye.com/blog/993213
[Linux]: http://www.iteye.com/blogs/tag/Linux