نام (NAME)

doveadm-quota - مقداردهی اولیه/محاسبه مجدد یا نمایش میزان سهمیه (quota) مصرفی فعلی

خلاصه دستور (SYNOPSIS)

doveadm [GLOBAL OPTIONS] [-f formatter] quota [-S socket_path] command -A

doveadm [GLOBAL OPTIONS] [-f formatter] quota [-S socket_path] command -F file

doveadm [GLOBAL OPTIONS] [-f formatter] quota [-S socket_path] command --no-userdb-lookup

doveadm [GLOBAL OPTIONS] [-f formatter] quota [-S socket_path] command -u user

توضیحات (DESCRIPTION)

در حالت نخست، دستور برای همه کاربران اجرا خواهد شد.

در حالت دوم، دستور برای همه کاربران فهرست‌شده در file مشخص‌شده اجرا خواهد شد.

در حالت سوم، دستور برای کاربری که در متغیر محیطی USER قرار دارد اجرا خواهد شد.

در حالت آخر، دستور تنها بر کاربر(های) منطبق اثر خواهد گذاشت.

•: دستورهای quota get و quota recalc تنها زمانی در دسترس هستند که تنظیمات سراسری mail_plugins شامل افزونه quota باشد.

گزینه‌های سراسری (GLOBAL OPTIONS)

گزینه‌های سراسری doveadm(1):

-D

پرگویی (verbosity) و پیام‌های اشکال‌زدایی را فعال می‌کند.

-O

هیچ فایل پیکربندی‌ای را نمی‌خواند و تنها از مقادیر پیش‌فرض استفاده می‌کند. تنظیم dovecot_storage_version به‌طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با -o بازنویسی کرد.

-k

تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیمات import_environment را.

-v

پرگویی را فعال می‌کند، از جمله شمارنده پیشرفت.

-i instance-name

در صورت استفاده از چندین نمونه Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.

برای اطلاعات بیشتر تنظیم instance_name را ببینید.

-c config-file

پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و در صورت عدم موفقیت به /etc/dovecot/dovecot.conf رجوع می‌کند. همچنین می‌توانید این را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.

-o setting=value

تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb با value داده‌شده بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینه -o می‌تواند چندین بار مشخص شود.

-f formatter

قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:

flow

هر خط را با جفت‌های key=value چاپ می‌کند.

json

یک آرایه JSON از اشیاء JSON چاپ می‌کند.

pager

هر جفت key: value را در خط مخصوص به خود چاپ کرده و رکوردها را با نویسه خط‌بر (^L) جدا می‌کند.

tab

یک سربرگ جدول و به دنبال آن خطوط مقادیر جدا شده با تب (tab) را چاپ می‌کند.

table

یک سربرگ جدول و به دنبال آن خطوط مقادیر تنظیم‌شده را چاپ می‌کند.

گزینه‌ها (OPTIONS)

-A

اگر گزینه -A وجود داشته باشد، command برای همه کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

هنگام استفاده از ماژول userdb مبتنی بر SQL، اطمینان حاصل کنید که تنظیم userdb_sql_iterate_query با ساختار پایگاه‌داده شما مطابقت دارد.

هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات userdb_fields و userdb_ldap_iterate_fields با طرحواره LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر به پیمایش روی همه کاربران نخواهد بود.

-F file

دستور command را برای تمام کاربران موجود در file اجرا می‌کند. این گزینه مشابه -A است، اما به جای دریافت فهرست کاربران از userdb، آنها از file مشخص‌شده خوانده می‌شوند. این file شامل یک نام کاربری در هر خط است.

--no-userdb-lookup

جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی USER برای تعیین نام کاربری استفاده می‌کند.

-S socket_path

آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی UNIX domain است، یا یک نام میزبان و درگاه (hostname:port) به منظور اتصال به یک میزبان راه دور از طریق سوکت TCP.

این قابلیت به مدیر سیستم اجازه می‌دهد دستورهای ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.

-u user/mask

دستور command را تنها برای user داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عمومی '*' و '?' نیز وجود دارد (مانند: -u *@example.org).

دستورها (COMMANDS)

quota get

doveadm [GLOBAL OPTIONS] quota get [-A | -u user | -F file]

دستور quota get برای نمایش میزان سهمیه مصرفی فعلی استفاده می‌شود. مقادیر فضای ذخیره‌سازی بر حسب کیلوبایت گزارش می‌شوند.

این دستور به‌طور پیش‌فرض از قالب‌بند خروجی table استفاده می‌کند.

quota recalc

doveadm [GLOBAL OPTIONS] quota recalc [-A | -u user | -F file]

دستور quota recalc برای محاسبه مجدد میزان سهمیه مصرفی فعلی به کار می‌رود.

فایل‌ها (FILES)

/etc/dovecot/dovecot.conf

فایل پیکربندی اصلی Dovecot، شامل بخش dict.

/etc/dovecot/conf.d/10-mail.conf

مکان‌های صندوق پستی و فضاهای نام.

/etc/dovecot/conf.d/90-quota.conf

پیکربندی سهمیه (Quota).

مثال‌ها (EXAMPLES)

دریافت میزان سهمیه مصرفی فعلی کاربر jane:

doveadm quota get -u jane

Quota name                        Type    Value  Limit  %
user                              STORAGE 90099 102400 87
user                              MESSAGE 20548  30000 68

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها، شامل خروجی doveconf -n، را به فهرست پستی Dovecot به نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات درباره گزارش باگ‌ها در نشانی زیر موجود است: ⟨https://dovecot.org/bugreport.html⟩

همچنین ببینید (SEE ALSO)

doveadm(1)