НАИМЕНОВАНИЕ

       umask - устанавливает маску создания режима доступа к файлу

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <sys/stat.h>

       mode_t umask(mode_t mask);

ОПИСАНИЕ

       umask() устанавливает в вызывающем процессе значение маски (umask) создания режима доступа к файлу равным
       mask & 0777 (т.е. из mask используются только биты прав доступа к файлу) и возвращает предыдущее значение
       маски.

       Значение  umask  используется  в open(2), mkdir(2) и других системных вызовах, которые создают файлы, для
       изменения прав, назначаемых на создаваемые файлы или каталоги. В частности, права в umask исключаются  из
       аргумента mode у вызовов open(2) и mkdir(2).

       Также,  если  у  родительского каталога указан ACL по умолчанию (смотрите acl(5)), то umask игнорируется,
       выполняется наследование ACL по умолчанию, бита прав назначаются согласно  унаследованному  ACL,  а  биты
       прав,  отсутствующие  в  аргументе  mode,  выключаются. Например, следующий ACL по умолчанию эквивалентен
       umask 022:

           u::rwx,g::r-x,o::r-x

       Объединение эффекта этого ACL по умолчанию с аргументом mode 0666 (rw-rw-rw-) приводит установке прав  на
       файл 0644 (rw-r--r--).

       Константы, которые нужно использовать в mask, описаны в inode(7).

       Типичным значением umask в процессе является S_IWGRP | S_IWOTH (восьмеричное 022). Обычно, когда аргумент
       mode у open(2) задаётся как:

           S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH

       (восьмеричное 0666) при создании файла, права получившегося файла будут:

           S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH

       (так как 0666 & ~022 = 0644; i.e. rw-r--r--).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       Данный системный вызов всегда выполняется успешно и возвращает предыдущее значение маски.

СТАНДАРТЫ

       POSIX.1-2008.

ИСТОРИЯ

       POSIX.1-2001, SVr4, 4.3BSD.

ПРИМЕЧАНИЯ

       Дочерний процесс, созданный с помощью fork(2), наследует umask родителя. Значение umask не изменяется при
       вызове execve(2).

       Невозможно  использовать  umask() для получения umask процесса без её изменения. Для восстановления umask
       требуется второй вызов umask(). Неатомарность этих двух шагов приводит  к  появлению  состязательности  в
       многонитевых программах.

       Начиная с Linux 4.7 значение umask любого процесса доступно в поле Umask файла /proc/pid/status. Просмотр
       этого поля в /proc/self/status позволяет процессу узнать свою umask без её изменения.

       Настройка  umask  также  влияет  на  права,  назначаемые  IPC-объектам  POSIX  (mq_open(3),  sem_open(3),
       shm_open(3)), FIFO (mkfifo(3)) и доменным сокетам UNIX (unix(7)), создаваемых процессом.  Значение  umask
       не  влияет  на  права,  назначаемые  IPC-объектам  System V,  создаваемых процессом (с помощью msgget(2),
       semget(2), shmget(2)).

СМОТРИТЕ ТАКЖЕ

       chmod(2), mkdir(2), open(2), stat(2), acl(5)

ПЕРЕВОД

       Русский перевод этой страницы  руководства  разработал(и)  Azamat  Hackimov  <azamat.hackimov@gmail.com>,
       Dmitriy  Ovchinnikov  <dmitriyxt5@gmail.com>,  Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova
       <blackkatelv@gmail.com>, Yuri Kozlov  <yuray@komyakino.ru>,  Иван  Павлов  <pavia00@gmail.com>  и  Kirill
       Rekhov <krekhov.dev@gmail.com>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если  вы  обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику(ам)  по  его(их)  адресу(ам)  электронной  почты  или  по   адресу   списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                         umask(2)