Namespaces
Variants

std::filesystem:: perms

From cppreference.net
定义于头文件 <filesystem>
enum class perms ;
(C++17 起)

此类型表示文件访问权限。

perms 满足 BitmaskType 的要求(这意味着位运算符 operator & operator | operator ^ operator~ operator & = operator | = operator ^ = 已为此类型定义)。 none 表示空位掩码;其他每个枚举项均表示一个独立的位掩码元素。

访问权限模型 POSIX权限位 ,以及任何独立文件权限(通过 filesystem::status 报告)均由以下部分位组合而成:

目录

成员常量

成员常量 值(八进制) POSIX 等效值 含义
none 0 未设置任何权限位
owner_read 0400 S_IRUSR 文件所有者具有读取权限
owner_write 0200 S_IWUSR 文件所有者具有写入权限
owner_exec 0100 S_IXUSR 文件所有者具有执行/搜索权限
owner_all 0700 S_IRWXU 文件所有者具有读取、写入和执行/搜索权限

等效于 owner_read | owner_write | owner_exec

group_read 040 S_IRGRP 文件的用户组具有读取权限
group_write 020 S_IWGRP 文件的用户组具有写入权限
group_exec 010 S_IXGRP 文件的用户组具有执行/搜索权限
group_all 070 S_IRWXG 文件的用户组具有读取、写入和执行/搜索权限

等效于 group_read | group_write | group_exec

others_read 04 S_IROTH 其他用户具有读取权限
others_write 02 S_IWOTH 其他用户具有写入权限
others_exec 01 S_IXOTH 其他用户具有执行/搜索权限
others_all 07 S_IRWXO 其他用户具有读取、写入和执行/搜索权限

等效于 others_read | others_write | others_exec

all 0777 所有用户具有读取、写入和执行/搜索权限

等效于 owner_all | group_all | others_all

set_uid 04000 S_ISUID 执行时将用户ID设置为文件所有者用户ID
set_gid 02000 S_ISGID 执行时将组ID设置为文件的用户组ID
sticky_bit 01000 S_ISVTX 实现定义的含义,但POSIX XSI规定当在目录上设置时,即使目录对其他用户可写,也只有文件所有者可以删除文件(用于 / tmp
mask 07777 所有有效权限位

等效于 all | set_uid | set_gid | sticky_bit

此外,还定义了此类型的以下常量,它们不代表权限:

成员常量 值(十六进制) 含义
unknown 0xFFFF 未知权限(例如当 filesystem::file_status 在未指定权限的情况下被创建时)

注释

权限在实现上未必采用位表示,但在概念层面通常按位处理。

某些系统可能会忽略某些权限位,并且更改某些位可能会自动更改其他位(例如在没有所有者/组/全体区分的平台上,设置三个写入位中的任意一个会同时设置所有三个)。

示例

#include <filesystem>
#include <fstream>
#include <iostream>
void demo_perms(std::filesystem::perms p)
{
    using std::filesystem::perms;
    auto show = [=](char op, perms perm)
    {
        std::cout << (perms::none == (perm & p) ? '-' : op);
    };
    show('r', perms::owner_read);
    show('w', perms::owner_write);
    show('x', perms::owner_exec);
    show('r', perms::group_read);
    show('w', perms::group_write);
    show('x', perms::group_exec);
    show('r', perms::others_read);
    show('w', perms::others_write);
    show('x', perms::others_exec);
    std::cout << '\n';
}
int main()
{
    std::ofstream("test.txt"); // 创建文件
    std::cout << "Created file with permissions: ";
    demo_perms(std::filesystem::status("test.txt").permissions());
    std::filesystem::permissions(
        "test.txt",
        std::filesystem::perms::owner_all | std::filesystem::perms::group_all,
        std::filesystem::perm_options::add
    );
    std::cout << "After adding u+rwx and g+rwx:  ";
    demo_perms(std::filesystem::status("test.txt").permissions());
    std::filesystem::remove("test.txt");
}

可能的输出:

Created file with permissions: rw-r--r--
After adding u+rwx and g+wrx:  rwxrwxr--

参见

(C++17) (C++17)
确定文件属性
确定文件属性,检查符号链接目标
(函数)
修改文件访问权限
(函数)