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. Символические ссылки разыменовываются, если в opts не задано perm_options::nofollow.

Вторая сигнатура ведёт себя так, как если бы её вызвали, задав 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--

См. также