DBMAIL-USERS(8)   DBMAIL-USERS(8)

dbmail-users - مدیریت پایگاه‌داده کاربران DBMail

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

برنامه dbmail-users به شما امکان می‌دهد کاربران DBMail را مدیریت کنید. این برنامه به شما اجازه می‌دهد کاربران را اضافه یا حذف کرده و اطلاعات آن‌ها را تغییر دهید، همچنین اطلاعات مربوط به یک کاربر خاص را نمایش داده یا فهرستی از کاربران موجود را ارائه دهید. علاوه بر این، این ابزار قابلیت افزودن یا حذف نام‌های مستعار (aliases) جداگانه را نیز دارد.

-a, --add-user user

افزودن یک کاربر

-c, --change-user user

تغییر مشخصات یک کاربر

-d, --delete-user user

حذف یک کاربر

-e, --empty-user-mailboxes user

خالی کردن تمام صندوق‌های پستی یک کاربر

-L, --list-users

فهرست کردن اطلاعات تمام کاربران

-l, --list-user userspec

فهرست کردن اطلاعات کاربران منطبق

-x, --forward alias

ایجاد یک نشانی ارجاع (forwarding) خارجی

--enable

فعال‌سازی احراز هویت برای کاربر

--disable

غیرفعال‌سازی احراز هویت برای کاربر

-w --password

مشخص کردن گذرواژه کاربر در خط فرمان.

استفاده به همراه --change-user

-W, --pw-file file

خواندن گذرواژه کاربر از یک فایل یا درخواست ورود آن به‌صورت تعاملی.

استفاده به همراه --add-user و --change-user

-p, --pw-type type

نوع گذرواژه می‌تواند یکی از موارد زیر باشد: plaintext, crypt, md5-hash, md5-digest, crypt-raw, md5-hash-raw, md5-digest-raw, md5-base64, md5-base64-raw, whirlpool, sha512, sha256, sha1, tiger.

استفاده به همراه --add-user و --change-user

-P, --pw-shadow file

استخراج گذرواژه رمزگذاری‌شده از فایل shadow.

استفاده به همراه --add-user و --change-user

-u, --user user

نام کاربری جدید

استفاده به همراه --change-user برای تغییر نام کاربری

-g, --client cid

اختصاص کاربر به یک کلاینت.

استفاده به همراه --add-user و --change-user

-m, --max-quota max

تنظیم حداکثر سهمیه ایمیل بر حسب <bytes>B ،<kbytes>K یا <mbytes>M (پیش‌فرض بر حسب بایت است). در صورت تنظیم روی 0، هیچ محدودیتی وجود نخواهد داشت.

استفاده به همراه --add-user و --change-user

-s, --add-alias alias[,alias...]

افزودن فهرستی از نام‌های مستعار گیرنده. نام مستعار (alias) یک نشانی ایمیل است که به سیستم ایمیل DBMail تحویل داده می‌شود و باید به این کاربر تحویل داده شود.

استفاده به همراه --add-user و --change-user

-S, --delete-alias alias[,alias...]

حذف فهرستی از نام‌های مستعار گیرنده. از نویسه‌های عمومی ? و * به ترتیب برای تطبیق هر تک‌نویسه یا هر تعداد نویسه استفاده کنید.

استفاده به همراه --add-user و --change-user

-t, --add-forward forward[,forward...]

افزودن فهرستی از مقصدهای ارجاع (deliver-to forwards).

استفاده به همراه --forward

-T, --delete-forward forward[,forward...]

حذف فهرستی از مقصدهای ارجاع (deliver-to forwards). از نویسه‌های عمومی ? و * به ترتیب برای تطبیق هر تک‌نویسه یا هر تعداد نویسه استفاده کنید.

استفاده به همراه --forward

--security-password

مشخص کردن یک گذرواژه پشتیبان امنیتی جداگانه

--security-action

انتخاب مقدار اقدام امنیتی (پیش‌فرض: 0)

-f, --config configfile

مشخص کردن یک فایل پیکربندی جایگزین.

برای نمایش مسیر پیش‌فرض، از dbmail-<utility> --help استفاده کنید.

-q, --quiet

رد کردن بی‌سر و صدای اعلان‌های تعاملی و پیام‌های وضعیت کمکی که در غیر این صورت در stdout چاپ می‌شدند. برای بی‌صدا کردن خطاهایی که در غیر این صورت در stderr چاپ می‌شدند، از دو -q استفاده کنید.

-v, --verbose

اجرا در حالت پرگو (verbose). برخی از ابزارهای مجموعه DBMail می‌توانند دو بار -v را برای پرگویی بیشتر دریافت کنند. ابزارهایی که این قاعده را پشتیبانی نمی‌کنند، خطایی برای -v اضافی نمایش نخواهند داد و با پرگویی عادی خود عمل می‌کنند.

-V, --version

نمایش نسخه و حق نشر، سپس خروج.

-h, --help

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

نام‌های مستعار و ارجاع‌ها چیستند و چه تفاوتی با یکدیگر دارند؟

کاربران برای دنیای خارج از طریق نشانی ایمیلشان شناخته می‌شوند؛ برای جلوگیری از سردرگمی، DBMail از نام‌های مستعار برای نشانی‌های ایمیل ورودی و از ارجاع‌ها برای نشانی‌های خروجی (در مواردی که کاربر به سازمان دیگری منتقل شده و ایمیل‌های او باید به نشانی جدیدش هدایت شود) استفاده می‌کند.

کاربران DBMail با استفاده از یک یا چند نشانی مستعار، ایمیل دریافت می‌کنند.

هنگامی که کاربری به سازمان یا دامنه دیگری منتقل می‌شود، ایمیل‌های او می‌توانند به نشانی جدید ارجاع داده شوند.

هنگام ساخت یک حساب کاربری جدید، باید یک نام مستعار اولیه که به نام حساب تحویل داده می‌شود اضافه کنید، یا حساب را در قالب یک نشانی ایمیل کامل بسازید. برای مثال، کاربری با نام Baz به این شکل ایجاد می‌شود:

dbmail-users --add-user baz --pw-type crypt --password secret

پس از ایجاد حساب، یک نام مستعار اضافه می‌کنید:

dbmail-users --change-user baz --add-alias baz@example.com

می‌توانید با فراخوانی مکرر dbmail-users یا فراخوانی آن با فهرستی از نام‌های مستعار که با کاما از هم جدا شده‌اند، چند نام مستعار اضافه کنید:

dbmail-users --change-user baz --add-alias baz@example.com,baz@example.org

سه حالت دریافت فراگیر (catch-all) نیز برای دامنه‌ها، زیردامنه‌ها و بخش‌های محلی پشتیبانی می‌شوند:

dbmail-users --add-user baz --add-aliass @example.com
dbmail-users --add-user baz --add-alias @.allsubs.example.com
dbmail-users --add-user baz --add-alias baz@

مثال اول ایمیل‌های فرستاده‌شده به هر کاربری در @example.com را دریافت کرده و به INBOX کاربر Baz تحویل می‌دهد. مثال دوم ایمیل‌های فرستاده‌شده به هر کاربری در هر زیردامنه‌ای ذیل .allsubs.example.com را دریافت می‌کند (به جز خود allsubs.example.com!). مثال سوم ایمیل‌های فرستاده‌شده به baz@ در هر دامنه‌ای را دریافت می‌کند.

از طریق سیستم نام‌های مستعار، هیچ پشتیبانی‌ای برای تحویل ایمیل به صندوق پستی خاصی به جز INBOX وجود ندارد. لطفاً برای دسته‌بندی و تفکیک نامه‌ها به این شکل، از یک اسکریپت Sieve استفاده کنید.

پیام‌های ورودی که به نشانی‌های ایمیل مشخصی ارسال می‌شوند، می‌توانند به یک نشانی ایمیل خارجی ارجاع داده شوند، از طریق پایپ به یک دستور هدایت شوند (در صورت قرار دادن پیشوند | pipe) یا به همراه خط From با فرمت mbox به یک دستور پایپ شوند (در صورت قرار دادن پیشوند ! bang). برای مثال:

dbmail-users --forward bar@example.com --add-alias bar@another.example.net
dbmail-users --forward bar@example.com --add-alias "|/usr/sbin/superspamtrapper"
dbmail-users --forward bar@example.com --add-alias "!cat > /var/spool/mail/bar/whatever.mbox"

ارجاع‌ها را می‌توان با استفاده از همان دستور --list که برای کاربران استفاده می‌شود فهرست کرد. برای مثال، جهت مشاهده این‌که نشانی محلی bar@example.com ممکن است به کجا ارجاع داده شود، از دستور زیر استفاده کنید:

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]

ارجاع‌ها را می‌توان با استفاده از تطبیق الگوی پایه به سبک glob حذف کرد. یک علامت سؤال ? question به معنای «تطبیق صفر یا یک نویسه» و علامت ستاره * asterisk به معنای «تطبیق صفر یا چند نویسه» است. برای مثال:

dbmail-users --forward bar@example.com --delete-forward "*"

نام مستعار خارجی bar@example.com و تمامی نشانی‌های ارجاع و دستورات آن را به صورت کامل و قطعی حذف خواهد کرد.

برای مثال، کاربر Gollum قبلاً در example.com کار می‌کرد اما اکنون در example.org مشغول به کار است؛ بنابراین هر ایمیلی که به gollum@example.com ارسال شود به gollum@example.org ارجاع داده می‌شود:

dbmail-users --forward gollum@example.com --add-forward gollum@example.org

هنگامی که Gollum به example.net منتقل می‌شود، ارجاع قدیمی را حذف کرده و ارجاع جدید را اضافه می‌کنید:

dbmail-users --forward gollum@example.com \
  --delete-forward gollum@example.org \
  --add-forward gollum@example.net

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)

برای دریافت جدیدترین اطلاعیه‌ها، لطفاً در DBMail announce mailing list[1] مشترک شوید.

برای گفتگوهای عمومی، لطفاً در DBMail general mailing list[2] مشترک شوید.

اگر مشکلی در DBMail مشاهده کردید، لطفاً آن را در DBMail Bug Tracker[3] گزارش دهید. ممکن است ارائه یک لاگ اشکال‌زدایی (debug log) مفید باشد.

نرم‌افزار DBMail و اجزای آن تحت شرایط مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License Version 2) توزیع می‌شوند. حقوق نشر به صورت گوناگون متعلق به نویسندگان فهرست‌شده در زیر است.

پروژه DBMail نتیجه تلاش مشترک میان توسعه‌دهندگان اصلی فهرست‌شده در زیر و کمک فوق‌العاده آزمون‌کنندگان، اصلاح‌کنندگان و شکارچیان باگ است که نام آن‌ها در فایل‌های AUTHORS و THANKS در توزیع منبع DBMail آمده است.

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

Alan Hicks <ahicks@p-o.co.uk>

نویسنده.

1.
DBMail announce mailing list
2.
DBMail general mailing list
3.
DBMail Bug Tracker
08/28/2026