.TH "DOVEADM-QUOTA" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-quota \- مقداردهی اولیه/محاسبه مجدد یا نمایش میزان سهمیه (quota) مصرفی فعلی
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBquota\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIcommand\fR \fB-A\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBquota\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIcommand\fR \fB-F\fR \fIfile\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBquota\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIcommand\fR \fB--no-userdb-lookup\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBquota\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIcommand\fR \fB-u\fR \fIuser\fR
.SH "توضیحات (DESCRIPTION)"
.P
در حالت نخست، دستور برای همه کاربران اجرا خواهد شد.
.P
در حالت دوم، دستور برای همه کاربران فهرست‌شده در \fIfile\fR مشخص‌شده اجرا خواهد شد.
.P
در حالت سوم، دستور برای کاربری که در متغیر محیطی \fIUSER\fR قرار دارد اجرا خواهد شد.
.P
در حالت آخر، دستور تنها بر کاربر(های) منطبق اثر خواهد گذاشت.
.RS 0
.IP \(bu 4
دستورهای \fBquota get\fR و \fBquota recalc\fR تنها زمانی در دسترس هستند که تنظیمات سراسری \fImail_plugins\fR شامل افزونه \fBquota\fR باشد.
.RE 0

.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پرگویی (\fIverbosity\fR) و پیام‌های اشکال‌زدایی را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای را نمی‌خواند و تنها از مقادیر پیش‌فرض استفاده می‌کند. تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیمات \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
پرگویی را فعال می‌کند، از جمله شمارنده پیشرفت.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونه Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر تنظیم \fBinstance_name\fR را ببینید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و در صورت عدم موفقیت به \fI/etc/dovecot/dovecot.conf\fR رجوع می‌کند. همچنین می‌توانید این را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی \fIsetting\fR را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با \fIvalue\fR داده‌شده بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینه \fB-o\fR می‌تواند چندین بار مشخص شود.
.RE 0

.RE 0

.P
\fB-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بند (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
یک آرایه JSON از اشیاء JSON چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت \fIkey\fR: \fIvalue\fR را در خط مخصوص به خود چاپ کرده و رکوردها را با نویسه خط‌بر (\fB^L\fR) جدا می‌کند.
.RE 0

.P
\fBtab\fR
.RS 4
.P
یک سربرگ جدول و به دنبال آن خطوط مقادیر جدا شده با تب (tab) را چاپ می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
یک سربرگ جدول و به دنبال آن خطوط مقادیر تنظیم‌شده را چاپ می‌کند.
.RE 0

.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینه \fB-A\fR وجود داشته باشد، \fIcommand\fR برای همه کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگام استفاده از ماژول userdb مبتنی بر SQL، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه‌داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحواره LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر به پیمایش روی همه کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
دستور \fIcommand\fR را برای تمام کاربران موجود در \fIfile\fR اجرا می‌کند. این گزینه مشابه \fB-A\fR است، اما به جای دریافت فهرست کاربران از userdb، آنها از \fIfile\fR مشخص‌شده خوانده می‌شوند. این \fIfile\fR شامل یک نام کاربری در هر خط است.
.RE 0

.RE 0

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی \fBUSER\fR برای تعیین نام کاربری استفاده می‌کند.
.RE 0

.RE 0

.P
\fB-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی UNIX domain است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) به منظور اتصال به یک میزبان راه دور از طریق سوکت TCP.
.P
این قابلیت به مدیر سیستم اجازه می‌دهد دستورهای ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور \fIcommand\fR را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عمومی '\fB*\fR' و '\fB?\fR' نیز وجود دارد (مانند: -u *@example.org).
.RE 0

.RE 0

.SH "دستورها (COMMANDS)"
.SS "quota get"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBquota get\fR \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB]
.P
دستور \fBquota get\fR برای نمایش میزان سهمیه مصرفی فعلی استفاده می‌شود. مقادیر فضای ذخیره‌سازی بر حسب کیلوبایت گزارش می‌شوند.
.P
این دستور به‌طور پیش‌فرض از قالب‌بند خروجی \fBtable\fR استفاده می‌کند.
.SS "quota recalc"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] quota recalc \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB]
.P
دستور \fBquota recalc\fR برای محاسبه مجدد میزان سهمیه مصرفی فعلی به کار می‌رود.
.SH "فایل‌ها (FILES)"
.P
\fI/etc/dovecot/dovecot.conf\fR
.RS 0
.RS 4
.P
فایل پیکربندی اصلی Dovecot، شامل بخش \fIdict\fR.
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/10-mail.conf\fR
.RS 0
.RS 4
.P
مکان‌های صندوق پستی و فضاهای نام.
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/90-quota.conf\fR
.RS 0
.RS 4
.P
پیکربندی سهمیه (Quota).
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
دریافت میزان سهمیه مصرفی فعلی کاربر jane:
.P
.RS 2
.nf
doveadm quota get -u jane
.fi
.RE
.P
.RS 2
.nf
Quota name                        Type    Value  Limit  %
user                              STORAGE 90099 102400 87
user                              MESSAGE 20548  30000 68
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR، را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره گزارش باگ‌ها در نشانی زیر موجود است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)