'\" t
.\"     Title: pam_setquota
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 01/26/2026
.\"    Manual: Linux-PAM Manual
.\"    Source: Linux-PAM
.\"  Language: Persian
.\"
.TH "PAM_SETQUOTA" "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
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pam_setquota \- ماژول PAM برای تنظیم یا تغییر سهمیه دیسک در شروع نشست
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpam_setquota\&.so\fR\ 'u
\fBpam_setquota\&.so\fR [fs=\fI/home\fR] [overwrite=\fI0\fR] [debug=\fI0\fR] [startuid=\fI1000\fR] [enduid=\fI0\fR] [bsoftlimit=\fI19000\fR] [bhardlimit=\fI20000\fR] [isoftlimit=\fI3000\fR] [ihardlimit=\fI4000\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول pam_setquota یک ماژول PAM برای تنظیم یا تغییر سهمیه دیسک در زمان شروع نشست است\&.
.PP
این ویژگی استفاده از سهمیه‌بندی را با پایگاه‌های داده کاربری مرکزی، مانند MySQL یا LDAP، امکان‌پذیر می‌سازد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
fs=/home
.RS 4
پرونده دستگاه یا نقطه اتصالی که سیاست روی آن اعمال می‌شود\&. پیش‌فرض سیستم‌فایل حاوی دایرکتوری خانگی کاربر است\&.
.RE
.PP
overwrite=0
.RS 4
رونویسی سهمیه موجود\&. نکته: فعال کردن این گزینه توانایی مدیر برای پیکربندی دستی سهمیه‌های مختلف برای کاربران روی یک سیستم‌فایل با استفاده از
\fBedquota\fR(8)
را از بین می‌برد\&. (پیش‌فرض 0 است)
.RE
.PP
debug=0
.RS 4
فعال‌سازی اشکال‌زدایی\&. مقدار 1 سهمیه قدیم و جدید روی دستگاه را نمایش می‌دهد\&. در صورتی که
\fBfs\fR
تنظیم نشده باشد، مقدار 2 سیستم‌فایل‌های منطبق و پیداشده را نیز چاپ می‌کند\&. (پیش‌فرض 0 است)
.RE
.PP
startuid=1000
.RS 4
شروع محدوده UID که سیاست روی آن اعمال می‌شود را مشخص می‌کند\&. (پیش‌فرض مقدار UID_MIN از login\&.defs یا مقدار uidmin تعریف‌شده در زمان کامپایل است، در صورتی که UID_MIN تعریف نشده باشد\&.)
.RE
.PP
enduid=0
.RS 4
پایان محدوده UID که سیاست روی آن اعمال می‌شود را مشخص می‌کند\&. تنظیم
\fIenduid=0\fR
منجر به یک محدوده UID نامحدود می‌شود (یعنی تمام UIDهای بزرگ‌تر از
\fBstartuid\fR
شامل می‌شوند)\&. (پیش‌فرض 0 است)
.RE
.PP
bsoftlimit=19000
.RS 4
حد نرم برای بلوک‌های سهمیه دیسک، طبق تعریف
\fBquotactl\fR(2)\&.
نکته:
\fBbsoftlimit\fR
و
\fBbhardlimit\fR
\fIباید\fR
هم‌زمان تنظیم شوند!
.RE
.PP
bhardlimit=20000
.RS 4
حد سخت برای بلوک‌های سهمیه دیسک، طبق تعریف
\fBquotactl\fR(2)\&.
نکته:
\fBbsoftlimit\fR
و
\fBbhardlimit\fR
\fIباید\fR
هم‌زمان تنظیم شوند!
.RE
.PP
isoftlimit=3000
.RS 4
حد نرم برای inodeها، طبق تعریف
\fB quotactl\fR(2)\&.
نکته:
\fBisoftlimit\fR
و
\fBihardlimit\fR
\fIباید\fR
هم‌زمان تنظیم شوند!
.RE
.PP
ihardlimit=4000
.RS 4
حد سخت برای inodeها، طبق تعریف
\fB quotactl\fR(2)\&.
نکته:
\fBisoftlimit\fR
و
\fBihardlimit\fR
\fIباید\fR
هم‌زمان تنظیم شوند!
.RE
.SH "انواع ماژول ارائه‌شده (MODULE TYPES PROVIDED)"
.PP
تنها نوع ماژول
\fBsession\fR
ارائه می‌شود\&.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.PP
.PP
PAM_SUCCESS
.RS 4
سهمیه با موفقیت تنظیم شد\&.
.RE
.PP
PAM_IGNORE
.RS 4
هیچ عملی انجام نشد زیرا یا UID کاربر خارج از محدوده مشخص‌شده بود، سهمیه‌ای از قبل وجود داشت و
\fBoverwrite=1\fR
پیکربندی نشده بود یا اصلاً هیچ حدی پیکربندی نشده بود\&.
.RE
.PP
PAM_USER_UNKNOWN
.RS 4
کاربر یافت نشد\&.
.RE
.PP
PAM_PERM_DENIED
.RS 4
/proc/mounts
امکان باز شدن نداشت\&.
.sp
سیستم‌فایل یا دستگاه مشخص‌شده یافت نشد\&.
.sp
امکان دریافت محدودیت‌ها برای کاربر وجود نداشت\&. برای اطلاعات بیشتر syslog را ببینید\&.
.sp
امکان تنظیم محدودیت‌ها برای کاربر وجود نداشت\&. برای اطلاعات بیشتر syslog را ببینید\&.
.sp
یا
\fBisoftlimit\fR/\fBihardlimit\fR
یا
\fBbsoftlimit\fR/\fBbhardlimit\fR
به‌طور هم‌زمان تنظیم نشده بودند\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
یک بار فراخوانی pam_setquota یک سیاست خاص را روی یک محدوده UID اعمال می‌کند\&. اعمال سیاست‌های مختلف روی محدوده‌های خاص UID با فراخوانی بیش از یک بار pam_setquota انجام می‌شود\&. آخرین ورودی منطبق، سهمیه نهایی را تعیین می‌کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
      session  required   pam_setquota\&.so bsoftlimit=1000 bhardlimit=2000 isoftlimit=1000 ihardlimit=2000 startuid=1000 enduid=0 fs=/home
      session  required   pam_setquota\&.so bsoftlimit=19000 bhardlimit=20000 isoftlimit=3000 ihardlimit=4000 startuid=2001 enduid=3000 fs=/dev/sda1
      session  required   pam_setquota\&.so bsoftlimit=19000 bhardlimit=20000 isoftlimit=3000 ihardlimit=4000 startuid=3001 enduid=4000 fs=/dev/sda1 overwrite=1

.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpam.conf\fR(5),
\fBpam.d\fR(5),
\fBpam\fR(8)
.SH "نویسنده (AUTHOR)"
.PP
ماژول pam_setquota در ابتدا توسط Ruslan Savchenko <savrus@mexmat\&.net> نوشته شد\&.
.PP
تغییرات بعدی توسط Shane Tzen <shane@ict\&.usc\&.edu>، Sven Hartge <sven@svenhartge\&.de> و Keller Fuchs <kellerfuchs@hashbang\&.sh> انجام شد\&.