'\" t
.\"     Title: pam_umask
.\"    Author: [بخش "نویسنده" را ببینید]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 01/26/2026
.\"    Manual: راهنمای Linux-PAM
.\"    Source: Linux-PAM
.\"  Language: Persian
.\"
.TH "PAM_UMASK" "8" "01/26/2026" "Linux\-PAM" "راهنمای Linux\-PAM"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" غیرفعال‌سازی خط‌تیره‌گذاری (hyphenation)
.nh
.\" تراز متن فقط از چپ
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pam_umask \- ماژول PAM برای تنظیم ماسک ایجاد فایل برای جلسه ورود
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_umask\&.so\fR\ 'u
\fBpam_umask\&.so\fR [debug] [silent] [usergroups] [nousergroups] [umask=\fImask\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول pam_umask یک ماژول PAM برای تنظیم ماسک حالت ایجاد فایل (umask) در محیط فعلی است\&. مقدار umask بر روی دسترسی‌های پیش‌فرضی که به فایل‌های تازه ایجادشده اختصاص می‌یابد، تأثیر می‌گذارد\&.
.PP
این ماژول PAM تلاش می‌کند مقدار umask را به ترتیب از مکان‌های زیر به دست آورد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدخل umask= در فیلد GECOS کاربر (برای جزئیات بیشتر به بخش زیر مراجعه کنید)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آرگومان umask=
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدخل UMASK از مسیر /etc/login\&.defs
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مدخل UMASK= از مسیر /etc/default/login
.RE
.PP
فیلد GECOS با نویسه کاما \*(Aq,\*(Aq جدا می‌شود\&. مدخل‌ها باید در (زیر)فیلد \*(Aqother\*(Aq آن (پنجمین فیلد در فیلد GECOS) تنظیم شوند، که برای نمونه می‌توان این کار را با استفاده از
\fBchfn \-\-other\fR
انجام داد\&. علاوه بر مدخل umask=، این ماژول همچنین مدخل pri= را شناسایی می‌کند که مقدار اولویت nice را برای جلسه کاری تنظیم می‌نماید، و همچنین مدخل ulimit= که حداکثر اندازه فایل‌هایی را که فرایندهای موجود در جلسه کاری می‌توانند ایجاد کنند، مشخص می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
debug
.RS 4
چاپ اطلاعات اشکال‌زدایی (دیباگ)\&.
.RE
.PP
silent
.RS 4
پیام‌های اطلاع‌رسانی چاپ نشوند\&.
.RE
.PP
usergroups
.RS 4
اگر کاربر root نباشد و نام کاربری با نام گروه اصلی (primary group) یکسان باشد، بیت‌های گروه umask به صورت یکسان با بیت‌های مالک تنظیم می‌شوند (برای مثال: 022 \-> 002، 077 \-> 007)\&.
.RE
.PP
nousergroups
.RS 4
این گزینه دقیقاً برعکس گزینه usergroups توضیح‌داده‌شده در بالا است، که در مواردی کاربرد دارد که pam_umask به صورت پیش‌فرض با گزینه usergroups فعال کامپایل شده باشد و شما بخواهید آن را در زمان اجرا غیرفعال کنید\&.
.RE
.PP
umask=mask
.RS 4
ماسک حالت ایجاد فایل (umask) فرایند فراخواننده را روی
\fBmask\fR
& 0777 تنظیم می‌کند\&. این مقدار در مبنای هشت (Octal) تفسیر می‌شود\&.
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تنها نوع
\fBsession\fR
ارائه شده است\&.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
.PP
PAM_SUCCESS
.RS 4
ماسک umask جدید با موفقیت تنظیم شد\&.
.RE
.PP
PAM_BUF_ERR
.RS 4
خطای بافر حافظه\&.
.RE
.PP
PAM_CONV_ERR
.RS 4
روش گفتگو (conversation method) ارائه‌شده توسط برنامه نتوانست نام کاربری را به دست آورد\&.
.RE
.PP
PAM_INCOMPLETE
.RS 4
روش گفتگو ارائه‌شده توسط برنامه مقدار PAM_CONV_AGAIN را بازگرداند\&.
.RE
.PP
PAM_SERVICE_ERR
.RS 4
هیچ نام کاربری داده نشد\&.
.RE
.PP
PAM_USER_UNKNOWN
.RS 4
کاربر ناشناخته است\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
خط زیر را به فایل
/etc/pam\&.d/login
اضافه کنید تا umask مخصوص کاربر هنگام ورود تنظیم شود:
.sp
.if n \{\
.RS 4
.\}
.nf
        session optional pam_umask\&.so umask=0022

.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(5),
\fBpam.d\fR(5),
\fBpam\fR(8)
.SH "نویسنده (AUTHOR)"
.PP
ماژول pam_umask توسط Thorsten Kukuk <kukuk@thkukuk\&.de> نوشته شده است\&.