文件权限控制篇

access

（判断是否具有存取文件的权限）

相关函数
stat, open, chmod, chown, setuid, setgid

表头文件
#include <unistd.h>

定义函数
int access(const char * pathname, int mode);

函数说明
access()会检查是否可以读/写某一已存在的文件。参数mode有几种情况组合, R_OK, W_OK, X_OK 和F_OK。R_OK, W_OK与X_OK用来检查文件是否具有读取、写入和执行的权限。F_OK则是用来判断该文件是否存在。由于access()只作权限的核查, 并不理会文件形态或文件内容, 因此, 如果一目录表示为"可写入", 表示可以在该目录中建立新文件等操作, 而非意味此目录可以被当做文件处理。例如, 你会发现DOS的文件都具有"可执行"权限, 但用execve()执行时则会失败。

返回值
若所有欲查核的权限都通过了检查则返回0值, 表示成功, 只要有一权限被禁止则返回-1。

错误代码
EACCESS 参数pathname 所指定的文件不符合所要求测试的权限。 EROFS 欲测试写入权限的文件存在于只读文件系统内。 EFAULT 参数pathname指针超出可存取内存空间。 EINVAL 参数mode 不正确。 ENAMETOOLONG 参数pathname太长。 ENOTDIR 参数pathname为一目录。 ENOMEM 核心内存不足 ELOOP 参数pathname有过多符号连接问题。 EIO I/O 存取错误。

附加说明
使用access()作用户认证方面的判断要特别小心, 例如在access()后再做open()的空文件可能会造成系统安全上的问题。

范例

/* 判断是否允许读取/etc/passwd */
#include<unistd.h>
int main()
{
    if (access("/etc/passwd",R_OK) == 0)
        printf("/etc/passwd can be read\n");
}
执行
/etc/passwd can be read

alphasort

（依字母顺序排序目录结构）

相关函数
scandir, qsort

表头文件
#include <dirent.h>

定义函数
int alphasort(const struct dirent **a, const struct dirent **b);

函数说明
alphasort()为scandir()最后调用qsort()函数时传给qsort()作为判断的函数, 详细说明请参考scandir()及qsort()。

返回值
参考qsort()。

范例

/* 读取/目录下所有的目录结构, 并依字母顺序排列*/
main()
{
    struct dirent **namelist;
    int i,total;
    total = scandir("/",&namelist ,0,alphasort);
    if(total <0)
        perror("scandir");
    else{
        for(i=0;i<total;i++)
            printf("%s\n",namelist[i]->d_name);
        printf("total = %d\n",total);
    }
}
执行
..
.gnome
.gnome_private
ErrorLog
Weblog
bin
boot
dev
dosc
dosd
etc
home
lib
lost+found
misc
mnt
opt
proc
root
sbin
tmp
usr
var
total = 24

chdir

（改变当前的工作（目录）

相关函数
getcwd, chroot

表头文件
#include <unistd.h>

定义函数
int chdir(const char * path);

函数说明
chdir()用来将当前的工作目录改变成以参数path所指的目录。

返回值
执行成功则返回0, 失败返回-1, errno为错误代码。

范例

#include<unistd.h>
main()
{
    chdir("/tmp");
    printf("current working directory: %s\n",getcwd(NULL,NULL));
}
执行
current working directory :/tmp

chmod

（改变文件的权限）

相关函数
fchmod, stat, open, chown

表头文件
#include <sys/types.h>
#include <sys/stat.h>

定义函数
int chmod(const char * path, mode_t mode);

函数说明
chmod()会依参数mode 权限来更改参数path 指定文件的权限。

参数
mode 有下列数种组合

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 其他用户具可执行权限只有该文件的所有者或有效用户识别码为0, 才可以修改该文件权限。基于系统安全, 如果欲将数据写入一执行文件, 而该执行文件具有S_ISUID 或S_ISGID 权限, 则这两个位会被清除。如果一目录具有S_ISUID 位权限, 表示在此目录下只有该文件的所有者或root可以删除该文件。

返回值
权限改变成功返回0, 失败返回-1, 错误原因存于errno。

错误代码

EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同, 而且也不具root权限。
EACCESS 参数path所指定的文件无法存取。
EROFS 欲写入权限的文件存在于只读文件系统内。
EFAULT 参数path指针超出可存取内存空间。
EINVAL 参数mode不正确
ENAMETOOLONG 参数path太长
ENOENT 指定的文件不存在
ENOTDIR 参数path路径并非一目录
ENOMEM 核心内存不足
ELOOP 参数path有过多符号连接问题。
EIO I/O 存取错误

范例

/* 将/etc/passwd 文件权限设成S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH */
#include<sys/types.h>
#include<sys/stat.h>
main()
{
    chmod("/etc/passwd",S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH);
}

chown

（改变文件的所有者）

相关函数
fchown, lchown, chmod

表头文件
#include <sys/types.h> #include <unistd.h>

定义函数
int chown(const char * path, uid_t owner, gid_t group);

函数说明
chown()会将参数path指定文件的所有者变更为参数owner代表的用户, 而将该文件的组变更为参数group组。如果参数owner或group为-1, 对应的所有者或组不会有所改变。root与文件所有者皆可改变文件组, 但所有者必须是参数group组的成员。当root用chown()改变文件所有者或组时, 该文件若具有S_ISUID或S_ISGID权限, 则会清除此权限位, 此外如果具有S_ISGID权限但不具S_IXGRP位, 则该文件会被强制锁定, 文件模式会保留。

返回值
成功则返回0, 失败返回-1, 错误原因存于errno。

错误代码
参考chmod()。

范例

/* 将/etc/passwd 的所有者和组都设为root */
#include<sys/types.h>
#include<unistd.h>
main()
{
    chown("/etc/passwd",0,0);
}

chroot

（改变根目录）

相关函数
chdir

表头文件
#include<unistd.h>

定义函数
int chroot(const char * path);

函数说明
chroot()用来改变根目录为参数path 所指定的目录。只有超级用户才允许改变根目录, 子进程将继承新的根目录。

返回值
调用成功则返回0, 失败则返-1, 错误代码存于errno。

错误代码

EPERM 权限不足, 无法改变根目录。
EFAULT 参数path指针超出可存取内存空间。
ENAMETOOLONG 参数path太长。
ENOTDIR 路径中的目录存在但却非真正的目录。
EACCESS 存取目录时被拒绝
ENOMEM 核心内存不足。
ELOOP 参数path有过多符号连接问题。
EIO I/O 存取错误。

范例

/* 将根目录改为/tmp ,并将工作目录切换至/tmp */
#include<unistd.h>
main()
{
    chroot("/tmp");
    chdir("/");
}

closedir

（关闭目录）

相关函数
opendir

表头文件
#include <sys/types.h> #include <dirent.h>

定义函数
int closedir(DIR *dir);

函数说明
closedir()关闭参数dir所指的目录流。

返回值
关闭成功则返回0, 失败返回-1, 错误原因存于errno 中。

错误代码
EBADF 参数dir为无效的目录流

范例
参考readir()。

fchdir

（改变当前的工作目录）

相关函数
getcwd, chroot

表头文件
#include<unistd.h>

定义函数
int fchdir(int fd);

函数说明
fchdir()用来将当前的工作目录改变成以参数fd 所指的文件描述词。

返回值
执行成功则返回0, 失败返回-1, errno为错误代码。

附加说明

范例

#include<sys/types.h>
#include<sys/stat.h>
#include<fcntl.h>
#include<unistd.h>
main()
{
    int fd;
    fd = open("/tmp",O_RDONLY);
    fchdir(fd);
    printf("current working directory : %s \n",getcwd(NULL,NULL));
    close(fd);
}
执行
current working directory : /tmp

fchmod

（改变文件的权限）

相关函数
chmod, stat, open, chown

表头文件
#include <sys/types.h> #include <sys/stat.h>

定义函数
int fchmod(int fildes,mode_t mode);

函数说明
fchmod()会依参数mode权限来更改参数fildes所指文件的权限。参数fildes为已打开文件的文件描述词。参数mode请参考chmod()。

返回值
权限改变成功则返回0, 失败返回-1, 错误原因存于errno。

错误原因

EBADF 参数fildes为无效的文件描述词。
EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同, 而且也不具root权限。
EROFS 欲写入权限的文件存在于只读文件系统内。
EIO I/O 存取错误。

范例

#include<sys/stat.h>
#include<fcntl.h>
main()
{
    int fd;
    fd = open ("/etc/passwd",O_RDONLY);
    fchmod(fd,S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH);
    close(fd);
}

fchown

（改变文件的所有者）

相关函数
chown, lchown, chmod

表头文件
#include<sys/types.h>
#include<unistd.h>

定义函数
int fchown(int fd, uid_t owner, gid_t group);

函数说明
fchown()会将参数fd指定文件的所有者变更为参数owner代表的用户, 而将该文件的组变更为参数group组。如果参数owner或group为-1, 对映的所有者或组有所改变。参数fd 为已打开的文件描述词。当root用fchown()改变文件所有者或组时, 该文件若具S_ISUID或S_ISGID权限, 则会清除此权限位。

返回值
成功则返回0, 失败则返回-1, 错误原因存于errno。

错误代码

EBADF 参数fd文件描述词为无效的或该文件已关闭。
EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同, 而且也不具root权限, 或是参数owner、group不正确。
EROFS 欲写入的文件存在于只读文件系统内。
ENOENT 指定的文件不存在
EIO I/O存取错误

范例

#include<sys/types.h>
#include<unistd.h>
#include<fcntl.h>
main()
{
    int fd;
    fd = open ("/etc/passwd",O_RDONLY);
    chown(fd,0,0);
    close(fd);
}

fstat

（由文件描述词取得文件状态）

相关函数
stat, lstat, chmod, chown, readlink, utime

表头文件
#include <sys/stat.h> #include <unistd.h>

定义函数
int fstat(int fildes, struct stat *buf);

函数说明
fstat()用来将参数fildes所指的文件状态, 复制到参数buf所指的结构中(struct stat)。Fstat()与stat()作用完全相同, 不同处在于传入的参数为已打开的文件描述词。详细内容请参考stat()。

返回值
执行成功则返回0, 失败返回-1, 错误代码存于errno。

范例

#include<sys/stat.h>
#include<unistd.h>
#include<fcntk.h>
main()
{
    struct stat buf;
    int fd;
    fd = open ("/etc/passwd",O_RDONLY);
    fstat(fd,&buf);
    printf("/etc/passwd file size +%d\n ",buf.st_size);
}
执行
/etc/passwd file size = 705

ftruncate

（改变文件大小）

相关函数
open, truncate

表头文件
#include<unistd.h>

定义函数
int ftruncate(int fd, off_t length);

函数说明
ftruncate()会将参数fd指定的文件大小改为参数length指定的大小。参数fd为已打开的文件描述词, 而且必须是以写入模式打开的文件。如果原来的文件大小比参数length大, 则超过的部分会被删去。

返回值
执行成功则返回0, 失败返回-1, 错误原因存于errno。

错误代码

EBADF 参数fd文件描述词为无效的或该文件已关闭。
EINVAL 参数fd 为一socket 并非文件, 或是该文件并非以写入模式打开。

getcwd

（取得当前的工作目录）

相关函数
get_current_dir_name, getwd, chdir

表头文件
#include<unistd.h>

定义函数
char * getcwd(char * buf, size_t size);

函数说明
getcwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间, 参数size为buf的空间大小。在调用此函数时, buf所指的内存空间要足够大, 若工作目录绝对路径的字符串长度超过参数size大小, 则回值NULL, errno的值则为ERANGE。倘若参数buf为NULL, getcwd()会依参数size的大小自动配置内存(使用malloc()), 如果参数size也为0, 则getcwd()会依工作目录绝对路径的字符串程度来决定所配置的内存大小, 进程可以在使用完此字符串后利用free()来释放此空间。

返回值
执行成功则将结果复制到参数buf所指的内存空间, 或是返回自动配置的字符串指针。失败返回NULL, 错误代码存于errno。

范例

#include<unistd.h>
main()
{
    char buf[80];
    getcwd(buf,sizeof(buf));
    printf("current working directory : %s\n",buf);
}
执行
current working directory :/tmp

link

（建立文件连接）

相关函数
symlink, unlink

表头文件
#include<unistd.h>

定义函数
int link (const char * oldpath, const char * newpath);

函数说明
link()以参数newpath指定的名称来建立一个新的连接(硬连接)到参数oldpath所指定的已存在文件。如果参数newpath指定的名称为一已存在的文件则不会建立连接。

返回值
成功则返回0, 失败返回-1, 错误原因存于errno。

附加说明
link()所建立的硬连接无法跨越不同文件系统, 如果需要请改用symlink()。

错误代码

EXDEV 参数oldpath与newpath不是建立在同一文件系统。
EPERM 参数oldpath与newpath所指的文件系统不支持硬连接
EROFS 文件存在于只读文件系统内
EFAULT 参数oldpath或newpath 指针超出可存取内存空间。
ENAMETOLLONG 参数oldpath或newpath太长
ENOMEM 核心内存不足
EEXIST 参数newpath所指的文件名已存在。
EMLINK 参数oldpath所指的文件已达最大连接数目。
ELOOP 参数pathname有过多符号连接问题
ENOSPC 文件系统的剩余空间不足。
EIO I/O 存取错误。

范例

/* 建立/etc/passwd 的硬连接为pass */
#include<unistd.h>
main()
{
    link("/etc/passwd","pass");
}

lstat

（由文件描述词取得文件状态）

相关函数
stat, fstat, chmod, chown, readlink, utime

表头文件
#include <sys/stat.h> #include <unistd.h>

定义函数
int lstat (const char * file_name.struct stat * buf);

函数说明
lstat()与stat()作用完全相同, 都是取得参数file_name所指的文件状态, 其差别在于, 当文件为符号连接时, lstat()会返回该link本身的状态。详细内容请参考stat()。

返回值
执行成功则返回0, 失败返回-1, 错误代码存于errno。

范例
参考stat()。

opendir

（打开目录）

相关函数
open, readdir, closedir, rewinddir, seekdir, telldir, scandir

表头文件
#include <sys/types.h> #include <dirent.h>

定义函数
DIR * opendir(const char * name);

函数说明
opendir()用来打开参数name指定的目录, 并返回DIR*形态的目录流, 和open()类似, 接下来对目录的读取和搜索都要使用此返回值。

返回值
成功则返回DIR* 型态的目录流, 打开失败则返回NULL。

错误代码

EACCESS 权限不足
EMFILE 已达到进程可同时打开的文件数上限。
ENFILE 已达到系统可同时打开的文件数上限。
ENOTDIR 参数name非真正的目录
ENOENT 参数name 指定的目录不存在, 或是参数name 为一空字符串。
ENOMEM 核心内存不足。

readdir

（读取目录）

相关函数
open, opendir, closedir, rewinddir, seekdir, telldir, scandir

表头文件
#include<sys/types.h>
#include<dirent.h>

定义函数
struct dirent * readdir(DIR * dir);

函数说明
readdir()返回参数dir目录流的下个目录进入点。结构dirent定义如下

struct dirent
{
    ino_t d_ino;
    ff_t d_off;
    signed short int d_reclen;
    unsigned char d_type;
    har d_name[256;
};

d_ino 此目录进入点的inode
d_off 目录文件开头至此目录进入点的位移
d_reclen _name的长度, 不包含NULL字符
d_type d_name 所指的文件类型
d_name 文件名

返回值
成功则返回下个目录进入点。有错误发生或读取到目录文件尾则返回NULL。

附加说明
EBADF参数dir为无效的目录流。

范例

#include<sys/types.h>
#include<dirent.h>
#include<unistd.h>
main()
{
    DIR * dir;
    struct dirent * ptr;
    int i;
    dir =opendir("/etc/rc.d");
    while((ptr = readdir(dir))!=NULL)
    {
        printf("d_name: %s\n",ptr->d_name);
    }
    closedir(dir);
}
执行
d_name:.
d_name:..
d_name:init.d
d_name:rc0.d
d_name:rc1.d
d_name:rc2.d
d_name:rc3.d
d_name:rc4.d
d_name:rc5.d
d_name:rc6.d
d_name:rc
d_name:rc.local
d_name:rc.sysinit

readlink

（取得符号连接所指的文件）

相关函数
stat, lstat, symlink

表头文件
#include <unistd.h>

定义函数
int readlink(const char * path ,char * buf,size_t bufsiz);

函数说明
readlink()会将参数path的符号连接内容存到参数buf所指的内存空间, 返回的内容不是以NULL作字符串结尾, 但会将字符串的字符数返回。若参数bufsiz小于符号连接的内容长度, 过长的内容会被截断。

返回值
执行成功则传符号连接所指的文件路径字符串, 失败则返回-1, 错误代码存于errno。

错误代码

EACCESS 取文件时被拒绝, 权限不够
EINVAL 参数bufsiz 为负数
EIO I/O 存取错误。
ELOOP 欲打开的文件有过多符号连接问题。
ENAMETOOLONG 参数path的路径名称太长
ENOENT 参数path所指定的文件不存在
ENOMEM 核心内存不足
ENOTDIR 参数path路径中的目录存在但却非真正的目录。

remove

（删除文件）

相关函数
link, rename, unlink

表头文件
#include<stdio.h>

定义函数
int remove(const char * pathname);

函数说明
remove()会删除参数pathname指定的文件。如果参数pathname为一文件, 则调用unlink()处理, 若参数pathname为一目录, 则调用rmdir()来处理。请参考unlink()与rmdir()。

返回值
成功则返回0, 失败则返回-1, 错误原因存于errno。

错误代码

EROFS 欲写入的文件存在于只读文件系统内
EFAULT 参数pathname指针超出可存取内存空间
ENAMETOOLONG 参数pathname太长
ENOMEM 核心内存不足
ELOOP 参数pathname有过多符号连接问题
EIO I/O 存取错误。

rename

（更改文件名称或位置）

相关函数
link, unlink, symlink

表头文件
#include <stdio.h>

定义函数
int rename(const char * oldpath,const char * newpath);

函数说明
rename()会将参数oldpath 所指定的文件名称改为参数newpath所指的文件名称。若newpath所指定的文件已存在, 则会被删除。

返回值
执行成功则返回0, 失败返回-1, 错误原因存于errno

范例

/* 设计一个DOS下的rename指令rename 旧文件名新文件名*/
#include <stdio.h>
void main(int argc,char **argv)
{
    if(argc<3) {
        printf("Usage: %s old_name new_name\n",argv[0]);
        return;
    }
    printf("%s=>%s",argc[1],argv[2]);
    if(rename(argv[1],argv[2]<0)
        printf("error!\n");
    else
        printf("ok!\n");
}

rewinddir

（重设读取目录的位置为开头位置）

相关函数
open, opendir, closedir, telldir, seekdir, readdir, scandir

表头文件
#include <sys/types.h> #include <dirent.h>

定义函数
void rewinddir(DIR *dir);

函数说明
rewinddir()用来设置参数dir 目录流目前的读取位置为原来开头的读取位置。

返回值

错误代码
EBADF dir为无效的目录流

范例

#include<sys/types.h>
#include<dirent.h>
#include<unistd.h>
main()
{
    DIR * dir;
    struct dirent *ptr;
    dir = opendir("/etc/rc.d");
    while((ptr = readdir(dir))!=NULL)
    {
        printf("d_name :%s\n",ptr->d_name);
    }
    rewinddir(dir);
    printf("readdir again!\n");
    while((ptr = readdir(dir))!=NULL)
    {
        printf("d_name: %s\n",ptr->d_name);
    }
    closedir(dir);
}
执行
d_name:.
d_name:..
d_name:init.d
d_name:rc0.d
d_name:rc1.d
d_name:rc2.d
d_name:rc3.d
d_name:rc4.d
d_name:rc5.d
d_name:rc6.d
d_name:rc
d_name:rc.local
d_name:rc.sysinit
readdir again!
d_name:.
d_name:..
d_name:init.d
d_name:rc0.d
d_name:rc1.d
d_name:rc2.d
d_name:rc3.d
d_name:rc4.d
d_name:rc5.d
d_name:rc6.d
d_name:rc
d_name:rc.local
d_name:rc.sysinit

seekdir

（设置下回读取目录的位置）

相关函数
open, opendir, closedir, rewinddir, telldir, readdir, scandir

表头文件
#include <dirent.h>

定义函数
void seekdir(DIR * dir,off_t offset);

函数说明
seekdir()用来设置参数dir目录流目前的读取位置, 在调用readdir()时便从此新位置开始读取。参数offset 代表距离目录文件开头的偏移量。

返回值

错误代码
EBADF 参数dir为无效的目录流

范例

#include<sys/types.h>
#include<dirent.h>
#include<unistd.h>
main()
{
    DIR * dir;
    struct dirent * ptr;
    int offset,offset_5,i=0;
    dir=opendir("/etc/rc.d");
    while((ptr = readdir(dir))!=NULL)
    {
        offset = telldir(dir);
        if(++i = =5) offset_5 =offset;
        printf("d_name :%s offset :%d \n",ptr->d_name,offset);
    }
    seekdir(dir offset_5);
    printf("Readdir again!\n");
    while((ptr = readdir(dir))!=NULL)
    {
        offset = telldir(dir);
        printf("d_name :%s offset :%d\n",ptr->d_name.offset);
    }
    closedir(dir);
}
执行
d_name : . offset :12
d_name : .. offset:24
d_name : init.d offset 40
d_name : rc0.d offset :56
d_name :rc1.d offset :72
d_name:rc2.d offset :88
d_name:rc3.d offset 104
d_name:rc4.d offset:120
d_name:rc5.d offset:136
d_name:rc6.d offset:152
d_name:rc offset 164
d_name:rc.local offset :180
d_name:rc.sysinit offset :4096
readdir again!
d_name:rc2.d offset :88
d_name:rc3.d offset 104
d_name:rc4.d offset:120
d_name:rc5.d offset:136
d_name:rc6.d offset:152
d_name:rc offset 164
d_name:rc.local offset :180
d_name:rc.sysinit offset :4096

stat

（取得文件状态）

相关函数
fstat, lstat, chmod, chown, readlink, utime

表头文件
#include <sys/stat.h>
#include <unistd.h>

定义函数
int stat(const char * file_name,struct stat *buf);

函数说明
stat()用来将参数file_name所指的文件状态, 复制到参数buf所指的结构中。下面是struct stat内各参数的说明

struct stat
{
    dev_t st_dev; /*device*/
    ino_t st_ino; /*inode*/
    mode_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 */
    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 lastaccess*/
    time_t st_mtime; /* time of last modification */
    time_t st_ctime; /* time of last change */
};

st_dev 文件的设备编号
st_ino 文件的i-node
st_mode 文件的类型和存取的权限
st_nlink 连到该文件的硬连接数目, 刚建立的文件值为1。
st_uid 文件所有者的用户识别码
st_gid 文件所有者的组识别码
st_rdev 若此文件为装置设备文件, 则为其设备编号
st_size 文件大小, 以字节计算
st_blksize 文件系统的I/O 缓冲区大小。
st_blcoks 占用文件区块的个数, 每一区块大小为512 个字节。
st_atime 文件最近一次被存取或被执行的时间, 一般只有在用mknod、utime、read、write与tructate时改变。
st_mtime 文件最后一次被修改的时间, 一般只有在用mknod、utime和write时才会改变
st_ctime i-node最近一次被更改的时间, 此参数会在文件所有者、组、权限被更改时更新

先前所描述的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来删除或改名。

返回值
执行成功则返回0, 失败返回-1, 错误代码存于errno

错误代码

ENOENT 参数file_name指定的文件不存在
ENOTDIR 路径中的目录存在但却非真正的目录
ELOOP 欲打开的文件有过多符号连接问题, 上限为16符号连接
EFAULT 参数buf为无效指针, 指向无法存在的内存空间
EACCESS 存取文件时被拒绝
ENOMEM 核心内存不足
ENAMETOOLONG 参数file_name的路径名称太长

范例

#include<sys/stat.h>
#include<unistd.h>
mian()
{
    struct stat buf;
    stat ("/etc/passwd",&buf);
    printf("/etc/passwd file size = %d \n",buf.st_size);
}
执行
/etc/passwd file size = 705

symlink

（建立文件符号连接）

相关函数
link, unlink

表头文件
#include <unistd.h>

定义函数
int symlink(const char * oldpath,const char * newpath);

函数说明
symlink()以参数newpath指定的名称来建立一个新的连接(符号连接)到参数oldpath所指定的已存在文件。参数oldpath指定的文件不一定要存在, 如果参数newpath指定的名称为一已存在的文件则不会建立连接。

返回值
成功则返回0, 失败返回-1, 错误原因存于errno。

错误代码

EPERM 参数oldpath与newpath所指的文件系统不支持符号连接
EROFS 欲测试写入权限的文件存在于只读文件系统内
EFAULT 参数oldpath或newpath指针超出可存取内存空间。
ENAMETOOLONG 参数oldpath或newpath太长
ENOMEM 核心内存不足
EEXIST 参数newpath所指的文件名已存在。
EMLINK 参数oldpath所指的文件已达到最大连接数目
ELOOP 参数pathname有过多符号连接问题
ENOSPC 文件系统的剩余空间不足
EIO I/O 存取错误

范例

#include<unistd.h>
main()
{
    symlink("/etc/passwd","pass");
}

telldir

（取得目录流的读取位置）

相关函数
open, opendir, closedir, rewinddir, seekdir, readdir, scandir

表头文件
#include <dirent.h>

定义函数
off_t telldir(DIR *dir);

函数说明
telldir()返回参数dir目录流目前的读取位置。此返回值代表距离目录文件开头的偏移量返回值返回下个读取位置, 有错误发生时返回-1。

错误代码
EBADF参数dir为无效的目录流。

范例

#include<sys/types.h>
#include<dirent.h>
#include<unistd.h>
main()
{
    DIR *dir;
    struct dirent *ptr;
    int offset;
    dir = opendir("/etc/rc.d");
    while((ptr = readdir(dir))!=NULL)
    {
        offset = telldir (dir);
        printf("d_name : %s offset :%d\n", ptr->d_name,offset);
    }
    closedir(dir);
}
执行
d_name : . offset :12
d_name : .. offset:24
d_name : init.d offset 40
d_name : rc0.d offset :56
d_name :rc1.d offset :72
d_name:rc2.d offset :88
d_name:rc3.d offset 104
d_name:rc4.d offset:120
d_name:rc5.d offset:136
d_name:rc6.d offset:152
d_name:rc offset 164
d_name:rc.local offset :180
d_name:rc.sysinit offset :4096

truncate

（改变文件大小）

相关函数
open, ftruncate

表头文件
#include <unistd.h>

定义函数
int truncate(const char * path,off_t length);

函数说明
truncate()会将参数path 指定的文件大小改为参数length 指定的大小。如果原来的文件大小比参数length大, 则超过的部分会被删去。

返回值
执行成功则返回0, 失败返回-1, 错误原因存于errno。

错误代码

EACCESS 参数path所指定的文件无法存取。
EROFS 欲写入的文件存在于只读文件系统内
EFAULT 参数path指针超出可存取内存空间
EINVAL 参数path包含不合法字符
ENAMETOOLONG 参数path太长
ENOTDIR 参数path路径并非一目录
EISDIR 参数path 指向一目录
ETXTBUSY 参数path所指的文件为共享程序, 而且正被执行中
ELOOP 参数path’有过多符号连接问题
EIO I/O 存取错误。

umask

（设置建立新文件时的权限遮罩）

相关函数
creat, open

表头文件
#include<sys/types.h>
#include<sys/stat.h>

定义函数
mode_t umask(mode_t mask);

函数说明
umask()会将系统umask值设成参数mask&0777后的值, 然后将先前的umask值返回。在使用open()建立新文件时, 该参数mode并非真正建立文件的权限, 而是(mode&~umask)的权限值。例如, 在建立文件时指定文件权限为0666, 通常umask值默认为022, 则该文件的真正权限则为0666&～022＝0644, 也就是rw-r--r--返回值此调用不会有错误值返回。返回值为原先系统的umask值。

unlink

（删除文件）

相关函数
link, rename, remove

表头文件
#include <unistd.h>

定义函数
int unlink(const char * pathname);

函数说明
unlink()会删除参数pathname指定的文件。如果该文件名为最后连接点, 但有其他进程打开了此文件, 则在所有关于此文件的文件描述词皆关闭后才会删除。如果参数pathname为一符号连接, 则此连接会被删除。

返回值
成功则返回0, 失败返回-1, 错误原因存于errno

错误代码

EROFS 文件存在于只读文件系统内
EFAULT 参数pathname指针超出可存取内存空间
ENAMETOOLONG 参数pathname太长
ENOMEM 核心内存不足
ELOOP 参数pathname 有过多符号连接问题
EIO I/O 存取错误

utime

（修改文件的存取时间和更改时间）

相关函数
utimes, stat

表头文件
#include<sys/types.h>
#include<utime.h>

定义函数
int utime(const char * filename, struct utimbuf * buf);

函数说明
utime()用来修改参数filename文件所属的inode存取时间。结构utimbuf定义如下

struct utimbuf{
    time_t actime;
    time_t modtime;
};

返回值
如果参数buf为空指针(NULL), 则该文件的存取时间和更改时间全部会设为目前时间。执行成功则返回0, 失败返回-1, 错误代码存于errno。

错误代码

EACCESS 存取文件时被拒绝, 权限不足
ENOENT 指定的文件不存在。

utimes

（修改文件的存取时间和更改时间）

相关函数
utime, stat

表头文件
#include <sys/types.h>
#include <utime.h>

定义函数
int utimes(char * filename, struct timeval *tvp);

函数说明
utimes()用来修改参数filename文件所属的inode存取时间和修改时间。结构timeval定义如下

struct timeval {
    long tv_sec;
    long tv_usec; /* 微妙*/
};

返回值
参数tvp 指向两个timeval 结构空间, 和utime()使用的utimebuf结构比较, tvp[0].tc_sec 则为utimbuf.actime, tvp]1].tv_sec 为utimbuf.modtime。执行成功则返回0。失败返回-1, 错误代码存于errno。

错误代码

EACCESS 存取文件时被拒绝, 权限不足
ENOENT 指定的文件不存在

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

12.md

12.md

文件权限控制篇

access

alphasort

chdir

chmod

chown

chroot

closedir

fchdir

fchmod

fchown

fstat

ftruncate

getcwd

link

lstat

opendir

readdir

readlink

remove

rename

rewinddir

seekdir

stat

symlink

telldir

truncate

umask

unlink

utime

utimes

Files

12.md

Latest commit

History

12.md

File metadata and controls

文件权限控制篇

access

alphasort

chdir

chmod

chown

chroot

closedir

fchdir

fchmod

fchown

fstat

ftruncate

getcwd

link

lstat

opendir

readdir

readlink

remove

rename

rewinddir

seekdir

stat

symlink

telldir

truncate

umask

unlink

utime

utimes