.TH "DOVEADM-USER" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-user \- جستجوی کاربر در پایگاه‌های داده کاربر (userdb) داکوت
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBuser\fR \[lB]\fB-a\fR \fIuserdb_socket_path\fR\[rB] \[lB]\fB-e\fR \fIالگو\fR\[rB] \[lB]\fB-f\fR \fIفیلد\fR\[rB] \[lB]\fB-u\fR\[rB] \[lB]\fB-x\fR \fIاطلاعات_احراز_هویت\fR\[rB] \fIکاربر\fR...
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBuser\fR برای انجام جستجوی کاربر به کار می‌رود؛ تا نشان دهد داکوت چه اطلاعاتی دربارهٔ \fIکاربر\fR(ها) می‌بیند، یا اینکه اصلاً در \fIuserdb\fR(های) پیکربندی‌شده وجود دارد یا خیر.
.P
مقدار \fIauth_info\fR ممکن است زمانی مفید باشد که userdb به عنوان مثال یک پایگاه داده SQL است و شما از متغیرهای %مانند \fB%{protocol}\fR یا \fB%{local_ip}\fR در تنظیم \fIuserdb_sql_query\fR استفاده می‌کنید. یا زمانی که userdb را به روشی مانند این پیکربندی کرده‌اید:
.P
.RS 2
.nf
userdb passwd-file {
  passwd_file_path = /etc/%{protocol}.passwd
}
.fi
.RE
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت \fIپُرگویی\fR و پیام‌های اشکال‌زدایی را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی را نمی‌خواند، فقط از پیش‌فرض‌ها استفاده می‌کند. تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض آخرین نسخه است، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیم \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
پُرگویی را فعال می‌کند، شامل شمارندهٔ پیشرفت.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونهٔ داکوت، فایل پیکربندی را بر اساس نام این نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر، تنظیم \fBinstance_name\fR را ببینید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت کانفیگ را می‌خواند و سپس در صورت لزوم به \fI/etc/dovecot/dovecot.conf\fR بازمی‌گردد. همچنین می‌توانید این گزینه را به سوکت کانفیگ نمونه‌ای که نسخهٔ سازگار را اجرا می‌کند، ارجاع دهید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
\fIتنظیم\fR پیکربندی را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با \fIمقدار\fR داده‌شده بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینهٔ \fB-o\fR می‌تواند چندین بار مشخص شود.
.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-a\fR \fIuserdb_socket_path\fR
.RS 0
.RS 4
.P
این گزینه برای تعیین یک مسیر مطلق به یک سوکت دامنه یونیکس جایگزین استفاده می‌شود.
.P
به‌طور پیش‌فرض doveadm(1) از سوکت \fI/rundir/auth-userdb\fR استفاده خواهد کرد. اگر تنظیم پیش‌فرض \fIbase_dir\fR در \fI/etc/dovecot/dovecot.conf\fR بازنویسی شده باشد، ممکن است سوکت در دایرکتوری دیگری قرار داشته باشد.
.RE 0

.RE 0

.P
\fB-e\fR \fItemplate\fR
.RS 0
.RS 4
.P
هنگامی که این گزینه و یک رشته با متغیرهای %داده شود، doveadm(1) رشتهٔ بسط‌یافته را برای کاربر نشان می‌دهد. این گزینه را نمی‌توان همراه با گزینه‌های \fB-f\fR یا \fB-u\fR استفاده کرد.
.RE 0

.RE 0

.P
\fB-f\fR \fIfield\fR
.RS 0
.RS 4
.P
هنگامی که این گزینه و نام یک فیلد userdb داده شود، doveadm(1) تنها مقدار فیلد مشخص‌شده را نشان می‌دهد. این گزینه را نمی‌توان همراه با گزینه‌های \fB-e\fR یا \fB-u\fR استفاده کرد.
.RE 0

.RE 0

.P
\fB-u\fR
.RS 0
.RS 4
.P
هنگامی که این گزینه داده شود، doveadm(1) فقط مقادیر موجود در \fIuserdb\fR را نشان خواهد داد. بدون پارامتر \fB-u\fR، اگر هر یک از فیلدهای \fIuid\fR، \fIgid\fR، \fIhome\fR یا \fImail_path\fR موجود نباشند، مقادیر پیش‌فرض آن‌ها از فایل پیکربندی گرفته می‌شود. این گزینه را نمی‌توان همراه با گزینه‌های \fB-e\fR یا \fB-f\fR استفاده کرد.
.RE 0

.RE 0

.P
\fB-x\fR \fIauth_info\fR
.RS 0
.RS 4
.P
مقدار \fIauth_info\fR شرایط اضافی را برای دستور \fBuser\fR مشخص می‌کند. رشته گزینهٔ \fIauth_info\fR باید به صورت جفت \fIname\fR \fB=\fR \fIvalue\fR داده شود. برای چندین شرط، گزینهٔ \fB-x\fR می‌تواند چندین بار ارائه شود.
.P
نام‌های ممکن برای \fIauth_info\fR عبارتند از:
.P
\fBservice\fR
.RS 4
.P
سرویسی که جستجوی userdb باید برای آن آزمایش شود. مقدار می‌تواند نام سرویسی باشد که معمولاً با داکوت استفاده می‌شود؛ به عنوان مثال: \fBimap\fR، \fBpop3\fR یا \fBsmtp\fR.
.RE 0

.P
\fBsession\fR
.RS 4
.P
شناسهٔ نشست (Session identifier).
.RE 0

.P
\fBlip\fR
.RS 4
.P
آدرس IP محلی (سرور) برای آزمایش.
.RE 0

.P
\fBrip\fR
.RS 4
.P
آدرس IP راه دور (کلاینت) برای آزمایش.
.RE 0

.P
\fBlport\fR
.RS 4
.P
پورت محلی، مثلاً 143.
.RE 0

.P
\fBrport\fR
.RS 4
.P
پورت راه دور، مثلاً 24567.
.RE 0

.P
\fBreal_lip\fR
.RS 4
.P
آدرس IP محلی که کلاینت روی این میزبان به آن متصل شده است.
.RE 0

.P
\fBreal_rip\fR
.RS 4
.P
آدرس IP راه دور که کلاینت از آن به این میزبان متصل شده است.
.RE 0

.P
\fBreal_lport\fR
.RS 4
.P
پورت محلی که کلاینت روی این میزبان به آن متصل شده است.
.RE 0

.P
\fBreal_rport\fR
.RS 4
.P
پورت راه دور که کلاینت از آن به این میزبان متصل شده است.
.RE 0

.P
\fBforward_<field>\fR
.RS 4
.P
فیلدی که باید به صورت %{forward:field} به پردازش احراز هویت فوروارد شود.
.RE 0

.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIuser\fR
.RS 0
.RS 4
.P
نام ورود به سیستم یک \fIکاربر\fR است. بسته به پیکربندی، نام ورود ممکن است مثلاً \fBjane\fR یا \fB\fI\(lajohn@example.com\(ra\fB\fR باشد. همچنین امکان استفاده از کاراکترهای عمومی «\fB*\fR» و «\fB?\fR» وجود دارد (مانند \fB-u \[rs]*@example.org\fR).
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
انجام جستجوی کاربر برای کاربران jane و \fI\(lajohn@example.com\(ra\fR:
.P
.RS 2
.nf
doveadm user jane john@example.com
.fi
.RE
.P
.RS 2
.nf
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
.fi
.RE
.P
جستجوی کاربر با استفاده از کاراکترهای عمومی (Wildcards):
.P
.RS 2
.nf
doveadm user \[rs]*.?oe@example.net
.fi
.RE
.P
.RS 2
.nf
jane.doe@example.net
judy.roe@example.net
john.doe@example.net
.fi
.RE
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR را به فهرست پستی داکوت به آدرس \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات دربارهٔ گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)