fchmodat() - Unix，Linux系统调用

名称

fchmodat - 更改相对于目录文件描述符的文件权限

#include <sys/stat.h> 

int fchmodat(int dirfd, const char *path, mode_t  
mode ", int " flags );

fchmodat() 系统调用与 chmod(2) 的操作方式完全相同，除了本手册页中描述的差异。

如果path中给出的路径名是相对路径，则它相对于文件描述符dirfd所引用的目录进行解释（而不是相对于调用进程的当前工作目录，chmod(2) 对相对路径名就是这样做的）。

如果path中给出的路径名是相对路径，并且dirfd是特殊值AT_FDCWD，则path相对于调用进程的当前工作目录进行解释（如同chmod(2)）。

如果path中给出的路径名是绝对路径，则忽略dirfd。

flags可以是0，也可以包含以下标志

标签	描述
AT_SYMLINK_NOFOLLOW	如果path是一个符号链接，则不要取消其引用：而是在链接本身进行操作。此标志目前未实现。

成功时，fchmodat() 返回 0。出错时，返回 -1 并设置errno以指示错误。

chmod(2) 中发生的错误也可能发生在 fchmodat() 中。fchmodat() 可能会发生以下附加错误：

标签	描述
EBADF	dirfd不是有效的文件描述符。
EINVAL	flags中指定的标志无效。
ENOTDIR	path是相对路径，并且dirfd是引用非目录文件的的文件描述符。
ENOTSUP	flags指定了AT_SYMLINK_NOFOLLOW，这是不支持的。

有关fchmodat()的需求说明，请参阅openat(2)。

此系统调用是非标准的，但建议将其包含在 POSIX.1 的未来修订版中。

fchmodat() 在 Linux 内核 2.6.16 中添加。

打印页面