نام (NAME)

doveadm-sieve - دستورهای مربوط به مدیریت اسکریپت‌های Sieve

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

doveadm [GLOBAL OPTIONS] sieve_cmd [options] [arguments]

توضیحات (DESCRIPTION)

دستورهای doveadm sieve بخشی از Pigeonhole (pigeonhole(7)) هستند که پشتیبانی از Sieve (RFC 5228) و ManageSieve (RFC 5804) را به Dovecot (dovecot(1)) اضافه می‌کند.

دستورهای doveadm sieve می‌توانند برای مدیریت فیلترکردن Sieve استفاده شوند.

گزینه‌های عمومی (GLOBAL OPTIONS)

گزینه‌های عمومی doveadm(1) (options):

-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

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

table

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

گزینه‌ها (OPTIONS)

-A

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

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

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

-F file

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

--no-userdb-lookup

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

-S socket_path

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

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

-u user/mask

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

آرگومان‌ها (ARGUMENTS)

scriptname

نام یک اسکریپت Sieve است، همان‌طور که برای کلاینت‌های ManageSieve قابل مشاهده است.

برای اسکریپت‌های Sieve که روی دیسک ذخیره می‌شوند، این نام فایل بدون پسوند «.sieve» است.

دستورها (COMMANDS)

sieve put

doveadm [GLOBAL OPTIONS] sieve put [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-a] scriptname

این دستور یک اسکریپت Sieve جدید را در فضای ذخیره‌سازی اسکریپت قرار می‌دهد. اسکریپت از ورودی استاندارد خوانده می‌شود. اگر اسکریپت با موفقیت کامپایل شود، تحت scriptname ارائه‌شده ذخیره می‌شود. اگر گزینهٔ -a موجود باشد، اسکریپت Sieve متعاقباً به عنوان اسکریپت فعال برای اجرا هنگام تحویل علامت‌گذاری می‌شود.

sieve get

doveadm [GLOBAL OPTIONS] sieve get [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] scriptname

این دستور اسکریپت Sieve با نام scriptname را بازیابی می‌کند.

sieve delete

doveadm [GLOBAL OPTIONS] sieve delete [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] [-a] scriptname ...

این دستور یک یا چند اسکریپت Sieve را حذف می‌کند. اسکریپت حذف‌شده نمی‌تواند اسکریپت فعال باشد، مگر اینکه گزینهٔ -a موجود باشد.

sieve list

doveadm [GLOBAL OPTIONS] sieve list [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path]

اسکریپت‌های Sieve موجود و وضعیت فعال بودن آن‌ها را فهرست می‌کند.

sieve rename

doveadm [GLOBAL OPTIONS] sieve rename [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] old_name new_name

دستور sieve rename برای تغییر نام اسکریپت Sieve از old_name به new_name استفاده می‌شود.

sieve activate

doveadm [GLOBAL OPTIONS] sieve activate [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] scriptname

این دستور اسکریپت Sieve با نام scriptname را به عنوان اسکریپت فعال برای اجرا هنگام تحویل علامت‌گذاری می‌کند.

sieve deactivate

doveadm [GLOBAL OPTIONS] sieve deactivate [-A | -u user | -F file | --no-userdb-lookup] [-S socket_path] scriptname

این دستور پردازش Sieve را غیرفعال می‌کند.

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

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

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

doveadm(1), dovecot-lda(1), pigeonhole(7)