نام (NAME)

doveadm-user - جستجوی کاربر در پایگاه‌های داده کاربر (userdb) داکوت

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

doveadm [گزینه‌های سراسری] user [-a userdb_socket_path] [-e الگو] [-f فیلد] [-u] [-x اطلاعات_احراز_هویت] کاربر...

توضیحات (DESCRIPTION)

دستور user برای انجام جستجوی کاربر به کار می‌رود؛ تا نشان دهد داکوت چه اطلاعاتی دربارهٔ کاربر(ها) می‌بیند، یا اینکه اصلاً در userdb(های) پیکربندی‌شده وجود دارد یا خیر.

مقدار auth_info ممکن است زمانی مفید باشد که userdb به عنوان مثال یک پایگاه داده SQL است و شما از متغیرهای %مانند %{protocol} یا %{local_ip} در تنظیم userdb_sql_query استفاده می‌کنید. یا زمانی که userdb را به روشی مانند این پیکربندی کرده‌اید:

userdb passwd-file {
  passwd_file_path = /etc/%{protocol}.passwd
}

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

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

-D

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

-O

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

-k

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

-v

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

-i instance-name

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

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

-c config-file

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

-o setting=value

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

گزینه‌ها (OPTIONS)

-a userdb_socket_path

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

به‌طور پیش‌فرض doveadm(1) از سوکت /rundir/auth-userdb استفاده خواهد کرد. اگر تنظیم پیش‌فرض base_dir در /etc/dovecot/dovecot.conf بازنویسی شده باشد، ممکن است سوکت در دایرکتوری دیگری قرار داشته باشد.

-e template

هنگامی که این گزینه و یک رشته با متغیرهای %داده شود، doveadm(1) رشتهٔ بسط‌یافته را برای کاربر نشان می‌دهد. این گزینه را نمی‌توان همراه با گزینه‌های -f یا -u استفاده کرد.

-f field

هنگامی که این گزینه و نام یک فیلد userdb داده شود، doveadm(1) تنها مقدار فیلد مشخص‌شده را نشان می‌دهد. این گزینه را نمی‌توان همراه با گزینه‌های -e یا -u استفاده کرد.

-u

هنگامی که این گزینه داده شود، doveadm(1) فقط مقادیر موجود در userdb را نشان خواهد داد. بدون پارامتر -u، اگر هر یک از فیلدهای uid، gid، home یا mail_path موجود نباشند، مقادیر پیش‌فرض آن‌ها از فایل پیکربندی گرفته می‌شود. این گزینه را نمی‌توان همراه با گزینه‌های -e یا -f استفاده کرد.

-x auth_info

مقدار auth_info شرایط اضافی را برای دستور user مشخص می‌کند. رشته گزینهٔ auth_info باید به صورت جفت name = value داده شود. برای چندین شرط، گزینهٔ -x می‌تواند چندین بار ارائه شود.

نام‌های ممکن برای auth_info عبارتند از:

service

سرویسی که جستجوی userdb باید برای آن آزمایش شود. مقدار می‌تواند نام سرویسی باشد که معمولاً با داکوت استفاده می‌شود؛ به عنوان مثال: imap، pop3 یا smtp.

session

شناسهٔ نشست (Session identifier).

lip

آدرس IP محلی (سرور) برای آزمایش.

rip

آدرس IP راه دور (کلاینت) برای آزمایش.

lport

پورت محلی، مثلاً 143.

rport

پورت راه دور، مثلاً 24567.

real_lip

آدرس IP محلی که کلاینت روی این میزبان به آن متصل شده است.

real_rip

آدرس IP راه دور که کلاینت از آن به این میزبان متصل شده است.

real_lport

پورت محلی که کلاینت روی این میزبان به آن متصل شده است.

real_rport

پورت راه دور که کلاینت از آن به این میزبان متصل شده است.

forward_<field>

فیلدی که باید به صورت %{forward:field} به پردازش احراز هویت فوروارد شود.

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

user

نام ورود به سیستم یک کاربر است. بسته به پیکربندی، نام ورود ممکن است مثلاً jane یا ⟨john@example.com⟩ باشد. همچنین امکان استفاده از کاراکترهای عمومی «*» و «?» وجود دارد (مانند -u \*@example.org).

مثال‌ها (EXAMPLES)

انجام جستجوی کاربر برای کاربران jane و ⟨john@example.com⟩:

doveadm user jane john@example.com

userdb: jane
  uid       : 8001
  gid       : 8001
  home      : /home/jane
  mail_path : ~/sdbox
  plugins   : sieve
  quota_storage_size: 150M
userdb: john@example.com
  home      : /srv/mail/8/70312/79832
  uid       : 79832
  gid       : 70312
  mail_path : ~/mdbox

جستجوی کاربر با استفاده از کاراکترهای عمومی (Wildcards):

doveadm user \*.?oe@example.net

jane.doe@example.net
judy.roe@example.net
john.doe@example.net

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

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

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

doveadm(1)