文件及目录函数(37)
chdir, chmod, chown, chroot
fchdir, fchmod, fchown, ftruncate
lchown, truncate,
get_current_dir_name, getcwd, getwd
opendir, closedir, readir, scandir, seekdir, rewinddir, telldir
(mkdir, rmdir)
fstat, lstat, stat
ftw, nftw
link, readlink, symlink, unlink
access, alphasort, realpath, remove, rename, umask
utime, utimes
access: 判断是否有存取文件的权限
头文件: 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()只作权限的核查, 并不理会文件形态或文件内容, 因此, 如果一目录表示为"可写入", 表示可以在该目录中建立新文件等操作, 而非意味此目录可以被当做文件处理. 若所有欲查核的权限都通过了检查则返回0值, 表示成功, 只要有一权限被禁止则返回-1.
错误代码:
EACCESS 参数pathname所指定的文件不符合所要求测试的权限
EROFS 欲测试写入权限的文件存在于只读文件系统内
EFAULT 参数pathname指针超出可存取内存空间
EINVAL 参数mode不正确
ENAMETOOLONG 参数pathname太长
ENOTDIR 参数pathname为一目录
ENOMEM 核心内存不足
ELOOP 参数pathname有过多符号连接问题
EIO I/O存取错误
附加说明: 使用access()作用户认证方面的判断要特别小心, 例如在access()后再做open()的空文件可能会造成系统安全上的问题.
应用举例:
#include
#include
int main(void)
{
if(access("/etc/passwd", R_OK) == 0)
{
printf("/etc/passwd can be read\n");
}
return 0;
}
运行结果:
/etc/passwd can be read
alphasort: 依字母顺序排序目录结构
头文件: dirent.h
定义函数: int alphasort(const struct dirent **a, const struct dirent **b);
说明: alphasort()为scandir()最后调用的函数, 详细说明请参考scandir().
应用举例:
/* 读取/目录下的目录结构, 并依字母顺寻排列 */
#include
#include
int main(void)
{
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);
}
return 0;
}
运行结果:
.
..
.autofsck
bin
boot
...
total = 24
chdir: 改变当前的工作目录
头文件: unistd.h
函数定义: int chdir(const char *path);
说明: chdir()用来将当前的工作目录该变成为参数path所指的目录. 若成功返回0, 失败返回-1, errno为错误代码.
chmod: 改变文件的权限
头文件: sys/types.h 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, 错误原因存于erron.
错误代码:
EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同, 而且也不具root权限.
EACCESS 参数path所指定的文件无法存取
EROFS 欲写入权限的文件存在于只读文件系统内
EFAULT 参数path指针超出可存取内存空间
EINVAL 参数mode不正确
ENAMETOOLONG 参数path太长
ENOENT 指定的文件不存在
ENOTDIR 参数path路径并非一目录
ENOMEM 核心内存不足
ELOOP 参数path有过多符号连接问题
EIO I/O存取错误
chown: 改变文件的所有者
头文件: sys/types.h 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().
chroot: 改变根目录
头文件: 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存取错误
应用举例:
#include
#include
int main(void)
{
/* 将根目录改为/tmp ,并将工作目录切换至/tmp */
chroot("/tmp");
chdir("/");
return 0;
}
closedir: 关闭目录
头文件: sys/types.h dirent.h
函数定义: int closedir(DIR *dir);
说明: closedir()关闭参数dir所指的目录流. 关闭成功则返回0, 失败返回-1, 错误原因存于errno中. EBADF参数dir为无效的目录流.
fchdir: 改变当前的工作目录
头文件: unistd.h
函数定义: int fchdir(int fd);
说明: fchdir()用来将当前的工作目录改变成以参数fd所指的文件描述词. 执行成功则返回0, 失败返回-1, errno为错误代码.
fchmod: 改变文件的权限
头文件: sys/types.h sys/stat.h
函数定义: int fdmod(int fildes, mode_t mode);
说明: fchmod()会依参数mode权限来更改参数fildes所指文件的权限. 参数fildes为已打开文件的文件描述词. 参数mode请参考chmod(). 权限改变成功则返回0, 失败返回-1, 错误原因存于errno.
错误代码:
EBADF 参数fildes为无效的文件描述词
EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同, 而且也不具root权限
EROFS 欲写入权限的文件存在于只读文件系统内
EIO I/O存取错误
fchown: 改变文件的所有者
头文件: sys/types.h 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存取错误
fstat: 由文件描述词取得文件状态
头文件: sys/stat.h unistd.h
函数定义: int fstat(int fildes, struct stat *buf);
说明: fstat()用来将参数fildes所指的文件状态, 复制到参数buf所指的结构中(struct stat). fstat()与stat()作用完全相同, 不同处在于传入的参数为已打开的文件描述词. 详细内容请参考stat(). 执行成功则返回0, 失败返回-1, 错误代码存于errno.
ftruncate: 改变文件大小
头文件: unistd.h
函数定义: int ftruncate(int fd, off_t length);
说明: ftruncate()会将参数fd指定的文件大小改为参数length指定的大小. 参数fd为已打开的文件描述词, 而且必须是以写入模式打开的文件. 如果原来的文件大小比参数length大, 则超过的部分会被删去. 执行成功则返回0, 失败返回-1, 错误原因存于errno.
错误代码:
EBADF 参数fd文件描述词为无效的或该文件已关闭
EINVAL 参数fd为一socket并非文件, 或是该文件并非以写入模式打开
ftw: 遍历目录树
头文件: ftw.h
函数定义: int ftw(const char *dir, int (*fn)(const char *file, const struct stat *sb, int flag), int depth);
说明: ftw()会从参数dir指定的目录开始, 往下一层层地递归式遍历子目录. 每进入一个目录, 便会调用参数*fn定义的函数来处理. ftw()会传三个参数给fn(), 第一个参数*file指向当时所在的目录路径, 第二个参数是*sb, 为stat结构指针(该结构的定义请参考stat()), 第三个参数为旗标, 有下面几种可能值:
FTW_F 一般文件
FTW_D 目录
FTW_DNR 不可读取的目录. 此目录以下将不被遍历
FTW_SL 符号连接
FTW_NS 无法取得stat结构数据, 有可能是权限问题
最后一个参数depth代表ftw()在进行遍历目录时可同时打开的文件数. ftw()在遍历时每一层目录至少需要一个文件描述词, 如果遍历时用完了depth所给予的限制数目, 整个遍历将因不断地关闭文件和打开文件操作而显得缓慢. 如果要结束ftw()的遍历, fn()只需返回一非零值即可, 此值同时也会是ftw()的返回值, 否则ftw()会试着走完所有的目录, 然后返回0. 遍历中断则返回fn()函数的返回值, 全部遍历完则返回0. 如有错误发生则返回-1.
附加说明: 由于ftw()会动态配置内存使用, 请使用正常方式(fn函数返回非0值)来中断遍历, 不要在fn函数中使用longjmp().
应用举例:
/* 列出/etc/X11目录下的子目录 */
#include
#include
#include
#include
int fn(const char *file, const struct stat* sb, int flag)
{
if(flag == FTW_D)
{
printf("%s -- directory\n", file);
}
return 0;
}
int main(void)
{
ftw("/etc/X11", fn, 500);
return 0;
}
运行结果:
/etc/X11 -- directory
/etc/X11/xinit -- directory
/etc/X11/xinit/xinitrc.d -- directory
/etc/X11/xinit/Xclients.d -- directory
/etc/X11/xinit/xinput.d -- directory
/etc/X11/xdm -- directory
/etc/X11/applnk -- directory
/etc/X11/twm -- directory
get_current_dir_name: 取得当前的工作目录
头文件: unistd.h
函数定义: char *get_current_dir_name(void);
说明: 此函数会返回一字符串指针, 指向目前的工作目录绝对路径字符串. 执行成功返回字符串指针, 失败返回NULL, 错误代码存于errno.
getcwd: 取得当前的工作目录
头文件: 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.
getwd: 取得当前的工作目录
头文件: unistd.h
函数定义: char *getwd(char *buf);
说明: getwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间, 然后将此路径字符串指针返回. 执行成功则将结果复制到参数buf所指的内存空间, 失败返回NULL, 错误代码存于errno.
应用举例:
#include
#include
int main(void)
{
char *ptr1, *ptr2;
char buf[80];
ptr1 = get_current_dir_name();
printf("%s\n", ptr1);
getcwd(buf, sizeof(buf));
printf("%s\n", buf);
ptr2 = getcwd(NULL, 0);
printf("%s\n", ptr2);
free(ptr2);
getwd(buf);
printf("%s\n", buf);
return 0;
}
运行结果:
/root/c-function
/root/c-function
/root/c-function
/root/c-function
lchown: 改变文件的所有者
头文件: sys/types.h unistd.h
函数定义: int lchown(const char *path, uid_t ownwer, gid_t group);
说明: lchown()会将参数path指定文件的所有者变更为参数owner代表的用户, 而将该文件的组变更为参数group组. 如果参数owner或group为-1, 对应的所有者活组不会有所改变. 当root用lchown()改变文件所有者或组时, 该文件若具S_ISUID或S_ISGID权限, 则会清除此权限位. lchown()与chown不同之处在于, 如果参数path指定的文件为一符号连接(symbolic link), lchown()是改变连接本身的所有者或组, chown()则是改变连接所指向的文件所有者或组. 成功则返回0, 失败返回-1, 错误原因在于errno.
错误代码:
EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同, 而且也不具root权限, 或是参数owner/group不正确
EACCESS 参数path所指定的文件无法存取
EROFS 欲写入的文件存在于只读文件系统内
EFAULT 参数path指针超出可存取内存空间
ENAMETOOLONG 参数path太长
ENOENT 参数path指定的文件不存在
ENOTDIR 参数path路径并非一目录
ENOMEM 核心内存不足
ELOOP 参数path有过多符号连接问题
EIO I/O存取错误
