std::filesystem::permissions

void permissions( const std::filesystem::path& p,
                  std::filesystem::perms prms,
                  std::filesystem::perm_options opts = perm_options::replace );

void permissions( const std::filesystem::path& p,
                  std::filesystem::perms prms,
                  std::error_code& ec ) noexcept;

void permissions( const std::filesystem::path& p,
                  std::filesystem::perms prms,
                  std::filesystem::perm_options opts,
                  std::error_code& ec );

Изменяет права доступа к файлу, на который ссылается p, как если бы с помощью POSIX fchmodat. Символические ссылки отслеживаются, если perm_options::nofollow не установлено в opts.

Второй вариант ведет себя так, как будто он вызван с opts установленным на perm_options::replace.

Эффекты зависят от prms и opts следующим образом:

• Если opts равно perm_options::replace, права доступа к файлу устанавливаются точно в соответствии с prms & std::filesystem::perms::mask (то есть применяется каждый допустимый бит из prms).
• Если opts равно perm_options::add, права доступа к файлу устанавливаются точно в соответствии с status(p).permissions() | (prms & perms::mask) (то есть к правам доступа файла добавляются все допустимые биты, установленные в prms, но не установленные в текущих правах доступа файла).
• Если opts равно perm_options::remove, права доступа к файлу устанавливаются точно в соответствии с status(p).permissions() & ~(prms & perms::mask) (то есть из прав доступа файла удаляются все допустимые биты, установленные в prms, но не установленные в текущих правах доступа файла).

opts должно иметь только одно из replace, add, или remove установленным.

Не выбрасывающий исключения перегрузчик не выполняет никаких специальных действий при ошибке.

Параметры

Значение результата

(нет)

Исключения

Любой перегрузчик, не помеченный noexcept, может бросить std::bad_alloc, если выделение памяти завершится неудачно.

Примечания

Права доступа могут не обязательно реализовываться как биты, но концептуально они обрабатываются таким образом.

Некоторые биты прав доступа могут игнорироваться на некоторых системах, и изменение некоторых битов может автоматически изменить другие (например, на платформах без различия владельца/группы/все, установка любого из трёх битов записи устанавливает все три).

Пример

#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"); // create file
 
    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--

См. также