ИМЯ¶

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

LIBRARY¶

Standard C library (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

(because 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>

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

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