'\" t
.\"     Title: dbmail-users
.\"    Author: Alan Hicks <ahicks@p-o.co.uk>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/28/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "DBMAIL\-USERS" "8" "08/28/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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)"
dbmail-users \- مدیریت پایگاه‌داده کاربران DBMail
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
dbmail\-users [MODE] [MODE OPTIONS]

dbmail\-users \-\-add\-user user [options]
dbmail\-users \-\-change\-user user [options]
dbmail\-users \-\-delete\-user user
dbmail\-users \-\-empty\-user\-mailboxes user [options]

dbmail\-users \-\-list\-users
dbmail\-users \-\-list\-user user

dbmail\-users \-\-change\-user user \-\-password password \-\-pw\-type pwtype

dbmail\-users \-\-change\-user user \-\-add\-alias address
dbmail\-users \-\-change\-user user \-\-delete\-alias address

dbmail\-users \-\-forward address \-\-add\-forward address
dbmail\-users \-\-forward address \-\-delete\-forward address
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه
.B dbmail\-users
به شما امکان می‌دهد کاربران DBMail را مدیریت کنید\&. این برنامه به شما اجازه می‌دهد کاربران را اضافه یا حذف کرده و اطلاعات آن‌ها را تغییر دهید، همچنین اطلاعات مربوط به یک کاربر خاص را نمایش داده یا فهرستی از کاربران موجود را ارائه دهید\&. علاوه بر این، این ابزار قابلیت افزودن یا حذف نام‌های مستعار (aliases) جداگانه را نیز دارد\&.
.SH "حالت‌ها (MODE)"
.PP
\-a, \-\-add\-user user
.RS 4
افزودن یک کاربر
.RE
.PP
\-c, \-\-change\-user user
.RS 4
تغییر مشخصات یک کاربر
.RE
.PP
\-d, \-\-delete\-user user
.RS 4
حذف یک کاربر
.RE
.PP
\-e, \-\-empty\-user\-mailboxes user
.RS 4
خالی کردن تمام صندوق‌های پستی یک کاربر
.RE
.PP
\-L, \-\-list\-users
.RS 4
فهرست کردن اطلاعات تمام کاربران
.RE
.PP
\-l, \-\-list\-user userspec
.RS 4
فهرست کردن اطلاعات کاربران منطبق
.RE
.PP
\-x, \-\-forward alias
.RS 4
ایجاد یک نشانی ارجاع (forwarding) خارجی
.RE
.SH "گزینه‌های حالت (MODE OPTIONS)"
.PP
\-\-enable
.RS 4
فعال‌سازی احراز هویت برای کاربر
.RE
.PP
\-\-disable
.RS 4
غیرفعال‌سازی احراز هویت برای کاربر
.RE
.PP
\-w \-\-password
.RS 4
مشخص کردن گذرواژه کاربر در خط فرمان\&.
.sp
استفاده به همراه \-\-change\-user
.RE
.PP
\-W, \-\-pw\-file file
.RS 4
خواندن گذرواژه کاربر از یک فایل یا درخواست ورود آن به‌صورت تعاملی\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-p, \-\-pw\-type type
.RS 4
نوع گذرواژه می‌تواند یکی از موارد زیر باشد:
plaintext, crypt, md5\-hash, md5\-digest, crypt\-raw, md5\-hash\-raw, md5\-digest\-raw, md5\-base64, md5\-base64\-raw, whirlpool, sha512, sha256, sha1, tiger\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-P, \-\-pw\-shadow file
.RS 4
استخراج گذرواژه رمزگذاری‌شده از فایل shadow\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-u, \-\-user user
.RS 4
نام کاربری جدید
.sp
استفاده به همراه \-\-change\-user برای تغییر نام کاربری
.RE
.PP
\-g, \-\-client cid
.RS 4
اختصاص کاربر به یک کلاینت\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-m, \-\-max\-quota max
.RS 4
تنظیم حداکثر سهمیه ایمیل بر حسب <bytes>B ،<kbytes>K یا <mbytes>M (پیش‌فرض بر حسب بایت است)\&. در صورت تنظیم روی 0، هیچ محدودیتی وجود نخواهد داشت\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-s, \-\-add\-alias alias[,alias\&...]
.RS 4
افزودن فهرستی از نام‌های مستعار گیرنده\&. نام مستعار (alias) یک نشانی ایمیل است که به سیستم ایمیل DBMail تحویل داده می‌شود و باید به این کاربر تحویل داده شود\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-S, \-\-delete\-alias alias[,alias\&...]
.RS 4
حذف فهرستی از نام‌های مستعار گیرنده\&. از نویسه‌های عمومی ? و * به ترتیب برای تطبیق هر تک‌نویسه یا هر تعداد نویسه استفاده کنید\&.
.sp
استفاده به همراه \-\-add\-user و \-\-change\-user
.RE
.PP
\-t, \-\-add\-forward forward[,forward\&...]
.RS 4
افزودن فهرستی از مقصدهای ارجاع (deliver\-to forwards)\&.
.sp
استفاده به همراه \-\-forward
.RE
.PP
\-T, \-\-delete\-forward forward[,forward\&...]
.RS 4
حذف فهرستی از مقصدهای ارجاع (deliver\-to forwards)\&. از نویسه‌های عمومی ? و * به ترتیب برای تطبیق هر تک‌نویسه یا هر تعداد نویسه استفاده کنید\&.
.sp
استفاده به همراه \-\-forward
.RE
.PP
\-\-security\-password
.RS 4
مشخص کردن یک گذرواژه پشتیبان امنیتی جداگانه
.RE
.PP
\-\-security\-action
.RS 4
انتخاب مقدار اقدام امنیتی (پیش‌فرض: 0)
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
\-f, \-\-config configfile
.RS 4
مشخص کردن یک فایل پیکربندی جایگزین\&.
.sp
برای نمایش مسیر پیش‌فرض، از dbmail\-<utility> \-\-help استفاده کنید\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
رد کردن بی‌سر و صدای اعلان‌های تعاملی و پیام‌های وضعیت کمکی که در غیر این صورت در stdout چاپ می‌شدند\&. برای بی‌صدا کردن خطاهایی که در غیر این صورت در stderr چاپ می‌شدند، از دو \-q استفاده کنید\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
اجرا در حالت پرگو (verbose)\&. برخی از ابزارهای مجموعه DBMail می‌توانند دو بار \-v را برای پرگویی بیشتر دریافت کنند\&. ابزارهایی که این قاعده را پشتیبانی نمی‌کنند، خطایی برای \-v اضافی نمایش نخواهند داد و با پرگویی عادی خود عمل می‌کنند\&.
.RE
.PP
\-V, \-\-version
.RS 4
نمایش نسخه و حق نشر، سپس خروج\&.
.RE
.PP
\-h, \-\-help
.RS 4
نمایش چکیده کوتاهی از گزینه‌ها، سپس خروج\&.
.RE
.SH "نام‌های مستعار و ارجاع‌ها (ALIASES AND FORWARDS)"
.sp
نام‌های مستعار و ارجاع‌ها چیستند و چه تفاوتی با یکدیگر دارند؟
.sp
کاربران برای دنیای خارج از طریق نشانی ایمیلشان شناخته می‌شوند؛ برای جلوگیری از سردرگمی، DBMail از نام‌های مستعار برای نشانی‌های ایمیل ورودی و از ارجاع‌ها برای نشانی‌های خروجی (در مواردی که کاربر به سازمان دیگری منتقل شده و ایمیل‌های او باید به نشانی جدیدش هدایت شود) استفاده می‌کند\&.
.sp
کاربران DBMail با استفاده از یک یا چند نشانی مستعار، ایمیل دریافت می‌کنند\&.
.sp
هنگامی که کاربری به سازمان یا دامنه دیگری منتقل می‌شود، ایمیل‌های او می‌توانند به نشانی جدید ارجاع داده شوند\&.
.SH "نام‌های مستعار (ALIASES)"
.sp
هنگام ساخت یک حساب کاربری جدید، باید یک نام مستعار اولیه که به نام حساب تحویل داده می‌شود اضافه کنید، یا حساب را در قالب یک نشانی ایمیل کامل بسازید\&. برای مثال، کاربری با نام \fIBaz\fR به این شکل ایجاد می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-add\-user baz \-\-pw\-type crypt \-\-password secret
.fi
.if n \{\
.RE
.\}
.sp
پس از ایجاد حساب، یک نام مستعار اضافه می‌کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-change\-user baz \-\-add\-alias baz@example\&.com
.fi
.if n \{\
.RE
.\}
.sp
می‌توانید با فراخوانی مکرر dbmail\-users یا فراخوانی آن با فهرستی از نام‌های مستعار که با کاما از هم جدا شده‌اند، چند نام مستعار اضافه کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-change\-user baz \-\-add\-alias baz@example\&.com,baz@example\&.org
.fi
.if n \{\
.RE
.\}
.sp
سه حالت دریافت فراگیر (catch\-all) نیز برای دامنه‌ها، زیردامنه‌ها و بخش‌های محلی پشتیبانی می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-add\-user baz \-\-add\-aliass @example\&.com
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-add\-user baz \-\-add\-alias @\&.allsubs\&.example\&.com
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-add\-user baz \-\-add\-alias baz@
.fi
.if n \{\
.RE
.\}
.sp
مثال اول ایمیل‌های فرستاده‌شده به هر کاربری در @example\&.com را دریافت کرده و به INBOX کاربر Baz تحویل می‌دهد\&. مثال دوم ایمیل‌های فرستاده‌شده به هر کاربری در هر زیردامنه‌ای ذیل \&.allsubs\&.example\&.com را دریافت می‌کند (\fBبه جز\fR خود allsubs\&.example\&.com!)\&. مثال سوم ایمیل‌های فرستاده‌شده به baz@ در هر دامنه‌ای را دریافت می‌کند\&.
.sp
از طریق سیستم نام‌های مستعار، هیچ پشتیبانی‌ای برای تحویل ایمیل به صندوق پستی خاصی به جز INBOX وجود ندارد\&. لطفاً برای دسته‌بندی و تفکیک نامه‌ها به این شکل، از یک اسکریپت Sieve استفاده کنید\&.
.SH "ارجاع‌ها (FORWARDS)"
.sp
پیام‌های ورودی که به نشانی‌های ایمیل مشخصی ارسال می‌شوند، می‌توانند به یک نشانی ایمیل خارجی ارجاع داده شوند، از طریق پایپ به یک دستور هدایت شوند (در صورت قرار دادن پیشوند | \fIpipe\fR) یا به همراه خط From با فرمت mbox به یک دستور پایپ شوند (در صورت قرار دادن پیشوند ! \fIbang\fR)\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward bar@example\&.com \-\-add\-alias bar@another\&.example\&.net
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward bar@example\&.com \-\-add\-alias "|/usr/sbin/superspamtrapper"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward bar@example\&.com \-\-add\-alias "!cat > /var/spool/mail/bar/whatever\&.mbox"
.fi
.if n \{\
.RE
.\}
.sp
ارجاع‌ها را می‌توان با استفاده از همان دستور \-\-list که برای کاربران استفاده می‌شود فهرست کرد\&. برای مثال، جهت مشاهده این‌که نشانی محلی bar@example\&.com ممکن است به کجا ارجاع داده شود، از دستور زیر استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-list\-user bar@example\&.com
  forward [bar@example\&.com] to [bar@example\&.net]
  forward [bar@example\&.com] to [|/usr/sbin/superspamtrapper]
  forward [bar@example\&.com] to [!cat > /var/spool/mail/bar/whatever\&.mbox]
.fi
.if n \{\
.RE
.\}
.sp
ارجاع‌ها را می‌توان با استفاده از تطبیق الگوی پایه به سبک glob حذف کرد\&. یک علامت سؤال ? \fIquestion\fR به معنای «تطبیق صفر یا یک نویسه» و علامت ستاره * \fIasterisk\fR به معنای «تطبیق صفر یا چند نویسه» است\&. برای مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward bar@example\&.com \-\-delete\-forward "*"
.fi
.if n \{\
.RE
.\}
.sp
نام مستعار خارجی \fIbar@example\&.com\fR و تمامی نشانی‌های ارجاع و دستورات آن را به صورت کامل و قطعی حذف خواهد کرد\&.
.sp
برای مثال، کاربر Gollum قبلاً در example\&.com کار می‌کرد اما اکنون در example\&.org مشغول به کار است؛ بنابراین هر ایمیلی که به gollum@example\&.com ارسال شود به gollum@example\&.org ارجاع داده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward gollum@example\&.com \-\-add\-forward gollum@example\&.org
.fi
.if n \{\
.RE
.\}
.sp
هنگامی که Gollum به example\&.net منتقل می‌شود، ارجاع قدیمی را حذف کرده و ارجاع جدید را اضافه می‌کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-users \-\-forward gollum@example\&.com \e
  \-\-delete\-forward gollum@example\&.org \e
  \-\-add\-forward gollum@example\&.net
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.sp
dbmail(1), dbmail\&.conf(5), dbmail\-deliver(1), dbmail\-export(8), dbmail\-httpd(8), dbmail\-imapd(8), dbmail\-lmtpd(8), dbmail\-pop3d(8), dbmail\-sieved(8), dbmail\-sievecmd(8), dbmail\-users(8), dbmail\-util(8)
.SH "اشکالات (BUGS)"
.sp
برای دریافت جدیدترین اطلاعیه‌ها، لطفاً در \m[blue]\fBDBMail announce mailing list\fR\m[]\&\s-2\u[1]\d\s+2 مشترک شوید\&.
.sp
برای گفتگوهای عمومی، لطفاً در \m[blue]\fBDBMail general mailing list\fR\m[]\&\s-2\u[2]\d\s+2 مشترک شوید\&.
.sp
اگر مشکلی در DBMail مشاهده کردید، لطفاً آن را در \m[blue]\fBDBMail Bug Tracker\fR\m[]\&\s-2\u[3]\d\s+2 گزارش دهید\&. ممکن است ارائه یک لاگ اشکال‌زدایی (debug log) مفید باشد\&.
.SH "مجوز (LICENSE)"
.sp
نرم‌افزار DBMail و اجزای آن تحت شرایط مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License Version 2) توزیع می‌شوند\&. حقوق نشر به صورت گوناگون متعلق به نویسندگان فهرست‌شده در زیر است\&.
.SH "نویسندگان (AUTHORS)"
.sp
پروژه DBMail نتیجه تلاش مشترک میان توسعه‌دهندگان اصلی فهرست‌شده در زیر و کمک فوق‌العاده آزمون‌کنندگان، اصلاح‌کنندگان و شکارچیان باگ است که نام آن‌ها در فایل‌های AUTHORS و THANKS در توزیع منبع DBMail آمده است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Alan Hicks          Persistent Objects Ltd https://p\-o\&.co\&.uk
Eelco van Beek      Aaron Stone            Paul J Stevens
Roel Rozendaal      Open Source Engineer   NFG Net Facilities Group BV
Ilja Booij          Palo Alto, CA USA      http://www\&.nfg\&.nl
IC&S                                       http://www\&.ic\-s\&.nl
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.PP
\fBAlan Hicks\fR <\&ahicks@p\-o\&.co\&.uk\&>
.RS 4
نویسنده.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
DBMail announce mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-announce
.RE
.IP " 2." 4
DBMail general mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-general
.RE
.IP " 3." 4
DBMail Bug Tracker
.RS 4
\%https://github.com/dbmail/dbmail/issues
.RE