.TH UMASK 2 "2024-05-02" "Linux man-pages" "فراخوان‌های سیستمی لینوکس"
.SH "نام (NAME)"
umask \- تنظیم ماسک ایجاد فایل (file mode creation mask)
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.B #include <sys/stat.h>
.PP
.BI "mode_t umask(mode_t " mask ");"
.fi
.SH "توضیحات (DESCRIPTION)"
فراخوان سیستمی \fBumask\fR ماسک ایجاد فایل پردازش فراخواننده را روی \fImask\fR & 0777 تنظیم می‌کند و مقدار قبلی ماسک را برمی‌گرداند.
.PP
ماسک ایجاد فایل توسط فراخوان‌هایی نظیر \fBopen\fR(2)، \fBmkdir\fR(2) و سایر فراخوان‌هایی که فایل ایجاد می‌کنند استفاده می‌شود تا بیت‌های مجوز فایل تازه ایجاد شده اصلاح شوند. به طور مشخص، مجوزهای مشخص‌شده در آرگومان \fImode\fR با عبارت زیر تغییر می‌یابند:
.PP
.RS
(mode & ~mask)
.RE
.PP
به این ترتیب، هر بیتی که در \fImask\fR برابر ۱ باشد، از مجوز فایل جدید حذف خواهد شد.
.PP
مقدار پیش‌فرض معمول برای ماسک 022 است که مانع از دسترسی نوشتن برای گروه و سایر کاربران می‌شود (یعنی فایل‌ها به صورت پیش‌فرض 0644 و پوشه‌ها 0755 ایجاد می‌شوند).
.SH "مقدار بازگشتی (RETURN VALUE)"
این فراخوان سیستمی همیشه موفق می‌شود و مقدار قبلی ماسک را برمی‌گرداند.
.SH "استانداردها (STANDARDS)"
POSIX.1-2008, SVr4, 4.3BSD.
.SH "همچنین ببینید (SEE ALSO)"
chmod(2), mkdir(2), open(2), stat(2)