DOVEADM-USER(1)                     Dovecot                    DOVEADM-USER(1)

نام (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)

e5ac02a                            May 2026                    DOVEADM-USER(1)