.\" Copyright (c) 2014-2018 Dovecot authors, see the included COPYING file
.TH DOVEADM\-ACL 1 "2015-05-09" "Dovecot v2.3" "Dovecot"
.SH "نام (NAME)"
doveadm\-acl \- مدیریت فهرست‌های کنترل دسترسی (ACL)
.\"------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.BR doveadm " [" \-Dv ]
[\fB\-f\fP \fIformatter\fP]
.BI acl \ command
.RI [ OPTIONS ]\ [ ARGUMENTS ]
.\"------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
از دستورات
.B doveadm acl
می‌توان برای اجرای اقدامات گوناگون مرتبط با فهرست‌های کنترل دسترسی (ACL) استفاده کرد.
.\"------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های عمومی
.BR doveadm (1):
.TP
.B \-D
پیام‌های اشکال‌زدایی (debug) و پرگویی را فعال می‌کند.
.TP
.BI \-f\  formatter
قالب‌بند (\fIformatter\fP) را برای قالب‌بندی خروجی مشخص می‌کند.
قالب‌بندهای پشتیبانی‌شده عبارتند از:
.RS
.TP
.B flow
هر سطر را با جفت‌های
.IB key = value
چاپ می‌کند.
.TP
.B pager
هر جفت
.IR key :\  value
را در یک سطر جداگانه چاپ کرده و رکوردها را با نویسهٔ فرم‌فید
.RB ( ^L )
از هم جدا می‌کند.
.TP
.B tab
یک سربرگ جدول و به دنبال آن سطرهای حاوی مقادیر جداشده با تب (tab) را چاپ می‌کند.
.TP
.B table
یک سربرگ جدول و به دنبال آن سطرهایی با مقادیر تراز‌شده چاپ می‌کند.
.RE
.TP
.BI \-o\  setting = value
تنظیم پیکربندی
.I setting
را از
.I /etc/dovecot/dovecot.conf
و از userdb با مقدار داده‌شدهٔ
.IR value
بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینهٔ
.B \-o
را چندین بار مشخص کرد.
.TP
.B \-v
پرگویی، شامل شمارندهٔ پیشرفت را فعال می‌کند.
.\" --- command specific options --- "/.
.PP
این دستور به‌طور پیش‌فرض از قالب‌بند خروجی
.B table
استفاده می‌کند.
.PP
گزینه‌های ویژهٔ این دستور:
.\"-------------------------------------
.TP
.B \-A
اگر گزینهٔ
.B \-A
مشخص شود، دستور برای همهٔ کاربران اجرا خواهد شد.
استفاده از این گزینه همراه با کاربران سیستمیِ
.B userdb { driver = passwd }
توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم
.I first_valid_uid
نیز می‌شود.
.sp
هنگامی که از ماژول SQL userdb استفاده می‌شود، اطمینان حاصل کنید که تنظیم
.I iterate_query
در
.I /etc/dovecot/dovecot\-sql.conf.ext
با ساختار پایگاه داده شما مطابقت دارد.
هنگام استفاده از ماژول LDAP userdb، اطمینان حاصل کنید که تنظیمات
.IR iterate_attrs " و " iterate_filter
در
.I /etc/dovecot/dovecot-ldap.conf.ext
با طرحوارهٔ (schema) LDAP شما مطابقت دارند؛
در غیر این صورت
.BR doveadm (1)
قادر به پیمایش روی تمام کاربران نخواهد بود.
.\"-------------------------------------
.TP
.BI \-F\  file
دستور را برای تمام کاربران موجود در
.IR file
اجرا می‌کند. این مشابه گزینهٔ
.B \-A
است،
اما به‌جای دریافت فهرست کاربران از userdb،
آن‌ها از
.IR file
داده‌شده خوانده می‌شوند. این
.I file
در هر سطر شامل یک نام کاربری است.
.\"-------------------------------------
.TP
.BI \-S\  socket_path
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس است، یا یک نام میزبان و درگاه
.RI ( hostname : port )،
جهت اتصال به یک میزبان دوردست از طریق سوکت TCP.
.sp
این گزینه به مدیر سیستم اجازه می‌دهد دستورات ایمیل
.BR doveadm (1)
را از طریق سوکت داده‌شده اجرا کند.
.\"-------------------------------------
.TP
.BI \-u\  user/mask
دستور را تنها برای کاربر (\fIuser\fP) داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام
.RB \(aq * \(aq
و
.RB \(aq ? \(aq
وجود دارد (مانند \-u *@example.org).
.br
چنانچه هیچ‌کدام از گزینه‌های
.BR \-A ،
.BI \-F\  file
یا
.BI \-u\  user
مشخص نشوند، دستور با محیط کاربریِ کاربری که در حال حاضر وارد سیستم شده است اجرا خواهد شد.
.\"----------------------------------------.SH "آرگومان‌ها (ARGUMENTS)"
.TP
.I id
شناسه (id) یکی از موارد زیر است:
.RS
.RS
.TP 4
*
.BR group\-override =\c
.I group_name
.\"-----------------
.TP
*
.BR user =\c
.I user_name
.\"-----------------
.TP
*
.B owner
.\"-----------------
.TP
*
.BR group =\c
.I group_name
.\"-----------------
.TP
*
.B authenticated
.\"-----------------
.TP
*
.BR anyone " (یا " anonymous " که نام مستعاری برای anyone است)"
.\"-----------------
.RE
.PP
مجوزهای ACL به ترتیبی که در بالا ذکر شده اولویت‌بندی و پردازش می‌شوند؛ بنابراین برای مثال اگر به یک گروه دسترسی خواندن داده باشید، همچنان می‌توانید آن دسترسی را برای کاربران خاصی درون آن گروه لغو کنید.
.br
شناسهٔ group\-override به شما امکان می‌دهد ACLهای کاربران را بازنویسی (override) کنید. احتمالاً مفیدترین کاربرد آن، غیرفعال کردن موقت دسترسی برای برخی کاربران است. برای مثال:
.PP
.nf
user=timo rw
group\-override=tempdisabled
.fi
.PP
اکنون اگر timo عضوی از گروه tempdisabled باشد، هیچ دسترسی به صندوق پستی نخواهد داشت. این امر با یک شناسهٔ معمولی group امکان‌پذیر نبود، زیرا
.B user=timo
بر آن اولویت پیدا می‌کرد.
.RE
.\"-------------------------------------
.TP
.I mailbox
نام صندوق پستی که عملیات ACL باید روی آن انجام شود.
همچنین امکان استفاده از نویسه‌های عام
.RB \(dq * \(dq " و/یا " \(dq ? \(dq
در نام صندوق پستی وجود دارد.
.\"-------------------------------------
.TP
.I right
نام حق دسترسی ACL در Dovecot. این نام با حروف مجوزهای ACL در IMAP یکسان نیست، چرا که در حال حاضر حروف IMAP پشتیبانی نمی‌شوند.
در اینجا جدول تطبیق حروف ACL در IMAP با نام‌های مجوز ACL در Dovecot آورده شده است:
.RS
.RS
.TP 4
.B l \(-> lookup
صندوق پستی (\fIMailbox\fP) در فهرست صندوق‌های پستی قابل مشاهده است. امکان اشتراک (subscribe) در صندوق پستی وجود دارد.
.\"-----------------
.TP
.B r \(-> read
صندوق پستی را می‌توان برای خواندن باز کرد.
.\"-----------------
.TP
.B w \(-> write
پرچم‌ها (flags) و کلیدواژه‌های پیام قابل تغییر هستند، به جز
.BR \(rsSeen " و " \(rsDeleted .
.\"-----------------
.TP
.B s \(-> write\-seen
پرچم
.B \(rsSeen
قابل تغییر است.
.\"-----------------
.TP
.B t \(-> write\-deleted
پرچم
.B \(rsDeleted
قابل تغییر است.
.\"-----------------
.TP
.B i \(-> insert
پیام‌ها را می‌توان در
.IR mailbox
نوشت یا در آن کپی کرد.
.\"-----------------
.TP
.B p \(-> post
پیام‌ها می‌توانند توسط
.B dovecot\-lda
(برای مثال از طریق اسکریپت‌های Sieve) به
.I mailbox
ارسال شوند.
.\"-----------------
.TP
.B e \(-> expunge
پیام‌ها را می‌توان پاکسازی (expunge) کرد.
.\"-----------------
.TP
.B k \(-> create
صندوق‌های پستی را می‌توان مستقیماً در زیر این
.I mailbox
ایجاد کرد یا تغییر نام داد (اما لزوماً نه در زیر زیرمجموعه‌های آن، بخش
.I ACL Inheritance
را در ویکی ببینید).
.br
نکته: تغییر نام به حق دسترسی delete نیز نیاز دارد.
.\"-----------------
.TP
.B x \(-> delete
صندوق پستی (\fIMailbox\fP) قابل حذف است.
.\"-----------------
.TP
.B a \(-> admin
حقوق مدیریت بر روی
.I mailbox
(در حال حاضر: قابلیت تغییر ACLها برای
.IR mailbox ).
.RE
.RE
.\"------------------------------------------------------------------------.SH "دستورها (COMMANDS)"
.SS acl add
.B doveadm acl add
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox id right
.RI [ right " ...]"
.PP
حقوق دسترسی ACL را به
.IR mailbox / id
اضافه می‌کند. اگر
.I id
از قبل وجود داشته باشد، حقوق دسترسی قبلی حفظ می‌شوند.
.\"-------------------------------------
.SS acl debug
.B doveadm acl debug
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox
.PP
این دستور می‌تواند برای اشکال‌زدایی دلیل عدم دسترسی کاربر به یک صندوق پستی به‌اشتراک‌گذاشته‌شده استفاده شود.
این دستور دقیقاً مشکل موجود را فهرست می‌کند.
.\"-------------------------------------
.SS acl delete
.B doveadm acl delete
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox id
.PP
کل مدخل ACL را برای
.IR mailbox / id
حذف می‌کند.
.\"-------------------------------------
.SS acl get
.B doveadm acl get
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.RB [ \-m ]
.I mailbox
.PP
تمام ACLهای مربوط به
.IR mailbox
را نمایش می‌دهد.
.\"-------------------------------------
.SS acl recalc
.B doveadm acl recalc
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.PP
اطمینان حاصل می‌کند که صندوق‌های پستیِ به‌اشتراک‌گذاشته‌شدهٔ کاربر (\fIuser\fP) به‌درستی در
.I acl_shared_dict
وجود دارند.
.\"-------------------------------------
.SS acl remove
.B doveadm acl remove
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox id right
.RI [ right " ...]"
.PP
حقوق دسترسیِ ACL مشخص‌شده را از
.IR mailbox / id
حذف می‌کند. اگر تمام حقوق دسترسی حذف شوند، مدخل همچنان بدون هیچ مجوزی باقی می‌ماند.
.\"-------------------------------------
.SS acl rights
.B doveadm acl rights
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox
.PP
حقوق دسترسی فعلی ACL کاربر (\fIuser\fP) را برای
.I mailbox
نمایش می‌دهد.
.\"-------------------------------------
.SS acl set
.B doveadm acl set
[\fB\-u\fP \fIuser\fP|\fB\-A\fP|\fB\-F\fP \fIfile\fP]
[\fB\-S\fP \fIsocket_path\fP]
.I mailbox id right
.RI [ right " ...]"
.PP
حقوق دسترسی ACL را برای
.IR mailbox / id
تنظیم می‌کند. اگر
.I id
از قبل وجود داشته باشد، حقوق دسترسی موجود جایگزین می‌شوند.
.\"------------------------------------------------------------------------.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها، شامل خروجی
.I doveconf \-n
را به فهرست پستی Dovecot به نشانی <dovecot@dovecot.org> ارسال کنید.
اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است:
http://dovecot.org/bugreport.html
.\"------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.BR doveadm (1),
.BR dovecot\-lda (1)
.\"-------------------------------------
.PP
منابع تکمیلی:
.IP "توارث ACL (ACL Inheritance)"
http://wiki2.dovecot.org/ACL#ACL_Inheritance