.TH "DOVEADM-SAVE" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm\-save \- ذخیره کردن ایمیل در صندوق پستی یک کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB\]\fIGLOBAL OPTIONS\fR\[rB\] \fBsave\fR \[lB\]\fB-S\fR \fIsocket_path\fR\[rB\] \fB-A\fR \[lB\]\fI-m\fR \fImailbox\fR\[rB\] \[lB\]\fI-U\fR \fIuid\fR\[rB\] \[lB\]\fI-g\fR \fIguid\fR\[rB\] \[lB\]\fI-r\fR \fIreceived-date\fR\[rB\] \[lB\]\fImail-file\fR\[rB\]
.P
\fBdoveadm\fR \[lB\]\fIGLOBAL OPTIONS\fR\[rB\] \fBsave\fR \[lB\]\fB-S\fR \fIsocket_path\fR\[rB\] \fB-F\fR \fIfile\fR \[lB\]\fI-m\fR \fImailbox\fR\[rB\] \[lB\]\fI-U\fR \fIuid\fR\[rB\] \[lB\]\fI-g\fR \fIguid\fR\[rB\] \[lB\]\fI-r\fR \fIreceived-date\fR\[rB\] \[lB\]\fImail-file\fR\[rB\]
.P
\fBdoveadm\fR \[lB\]\fIGLOBAL OPTIONS\fR\[rB\] \fBsave\fR \[lB\]\fB-S\fR \fIsocket_path\fR\[rB\] \fB--no-userdb-lookup\fR \[lB\]\fI-m\fR \fImailbox\fR\[rB\] \[lB\]\fI-U\fR \fIuid\fR\[rB\] \[lB\]\fI-g\fR \fIguid\fR\[rB\] \[lB\]\fI-r\fR \fIreceived-date\fR\[rB\] \[lB\]\fImail-file\fR\[rB\]
.P
\fBdoveadm\fR \[lB\]\fIGLOBAL OPTIONS\fR\[rB\] \fBsave\fR \[lB\]\fB-S\fR \fIsocket_path\fR\[rB\] \fB-u\fR \fIuser\fR \[lB\]\fI-m\fR \fImailbox\fR\[rB\] \[lB\]\fI-U\fR \fIuid\fR\[rB\] \[lB\]\fI-g\fR \fIguid\fR\[rB\] \[lB\]\fI-r\fR \fIreceived-date\fR\[rB\] \[lB\]\fImail-file\fR\[rB\]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBdoveadm save\fR می‌تواند برای ذخیره کردن پیام‌ها استفاده شود. این قابلیت برای اسکریپت‌ها و اشکال‌زدایی مفید است. فیلتر Sieve برای پیام‌های ذخیره‌شده فراخوانی نمی‌شود، اما محدودیت سهمیه (quota) اعمال می‌گردد.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های اشکال‌زدایی (debug) و پرگویی (\fIverbosity\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
پرگویی (verbosity)، از جمله شمارندهٔ پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونه (instance) از Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.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
تنظیم پیکربندی \fIsetting\fR را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با مقدار داده‌شدهٔ \fIvalue\fR بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینهٔ \fB-o\fR را چندین بار مشخص کرد.
.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR مشخص شود، دستور (\fIcommand\fR) برای همه کاربران انجام خواهد شد. استفاده از این گزینه همراه با کاربران سیستمیِ \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگامی که از ماژول SQL userdb استفاده می‌شود، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول LDAP userdb، اطمینان حاصل کنید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ (schema) LDAP شما مطابقت دارند؛ در غیر این صورت doveadm(1) قادر به پیمایش روی تمام کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را برای تمام کاربران موجود در \fIfile\fR اجرا می‌کند. این مشابه گزینهٔ \fB-A\fR است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. این \fIfile\fR در هر سطر شامل یک نام کاربری است.
.RE 0

.RE 0

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی \fBUSER\fR برای مشخص کردن نام کاربری استفاده می‌کند.
.RE 0

.RE 0

.P
\fB-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) برای اتصال به یک میزبان دوردست از طریق سوکت TCP.
.P
این به مدیر سیستم اجازه می‌دهد دستورات ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '\fB*\fR' و '\fB?\fR' وجود دارد (مانند -u *@example.org).
.RE 0

.RE 0

.P
\fB-m\fR \fImailbox\fR
.RS 0
.RS 4
.P
ایمیل را به جای INBOX در صندوق پستی مشخص‌شده ذخیره می‌کند.
.RE 0

.RE 0

.P
\fB-U\fR \fIuid\fR
.RS 0
.RS 4
.P
در صورت امکان، ایمیل را با استفاده از UID داده‌شده ذخیره می‌کند.
.RE 0

.RE 0

.P
\fB-g\fR \fIguid\fR
.RS 0
.RS 4
.P
ایمیل را با استفاده از GUID داده‌شده ذخیره می‌کند.
.RE 0

.RE 0

.P
\fB-r\fR \fIreceived-date\fR
.RS 0
.RS 4
.P
ایمیل را با استفاده از برچسب زمان دریافت (received-date) داده‌شده ذخیره می‌کند. این مقدار در قالب «برچسب زمان خوانا برای انسان» (human timestamp) است که در doveadm-search-query(7) شرح داده شده است.
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fImail-file\fR
.RS 0
.RS 4
.P
داده‌های پیام برای ذخیره‌سازی.
.RS 4
.IP \(bu 4
اگر \fImail-file\fR برابر با \fB-\fR باشد، پیام از ورودی استاندارد (stdin) خوانده می‌شود (پیش‌فرض).
.IP \(bu 4
در غیر این صورت، \fImail-file\fR به عنوان مسیر یک فایل تفسیر می‌شود.
.RE 0

.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
.RS 2
.nf
echo "hello, world" | doveadm save -u testuser@testdomain
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)