'\" t
.\"     Title: dbmail-export
.\"    Author: Alan Hicks <ahicks@p-o.co.uk>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/28/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "DBMAIL\-EXPORT" "8" "08/28/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
dbmail-export \- برون‌بری پیام‌های ایمیل از پایگاه‌داده DBMail
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
dbmail\-export [options] \-\-user username \-\-mailbox mailbox \-\-out file
dbmail\-export [options] \-\-user username \-\-mailbox mailbox \-\-basedir directory
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه
.B dbmail\-export
به شما امکان می‌دهد تا یک صندوق پستی DBMail را در قالب یک صندوق پستی با فرمت mbox برون‌بری کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-u, \-\-user user
.RS 4
مشخص کردن مالک صندوق پستی که قصد برون‌بری آن را دارید؛ با استفاده از نویسه‌های عمومی (wildcards) ? و * به ترتیب برای تطبیق یک یا هیچ نویسه، یا یک یا چند نویسه در نام کاربری\&.
.RE
.PP
\-m, \-\-mailbox mailbox
.RS 4
مشخص کردن صندوق پستی که قصد برون‌بری آن را دارید\&.
.RE
.PP
\-o, \-\-out outfile
.RS 4
مشخص کردن فایلی که نامه‌های برون‌بری شده در آن ذخیره خواهند شد\&.
.RE
.PP
\-b, \-\-basedir basedir
.RS 4
مشخص کردن دایرکتوری پایه‌ای که صندوق‌های پستی برون‌بری شده در آن ذخیره خواهند شد\&.
.RE
.PP
\-s, \-\-search search
.RS 4
استفاده از یک رشته IMAP SEARCH برای انتخاب پیام‌ها (پیش‌فرض: 1:*)؛ به عنوان مثال، برای برون‌بری تمام پیام‌های دریافت شده در ماه مه، استفاده کنید از: "1:* SINCE 1\-May\-2007 BEFORE 1\-Jun\-2007"
.RE
.PP
\-d, \-\-set\-del\-flag
.RS 4
علامت‌گذاری پیام‌های برون‌بری شده به عنوان \e\eDeleted (برای تغییر وضعیت به حذف‌شده، از dbmail\-util استفاده کنید)\&.
.RE
.PP
\-D, \-\-set\-del\-status
.RS 4
تنظیم وضعیت پیام‌های برون‌بری شده به عنوان حذف‌شده (برای پاک‌سازی کامل، از dbmail\-util استفاده کنید)\&.
.RE
.PP
\-r, \-\-recursive
.RS 4
برون‌بری صندوق‌های پستی به صورت بازگشتی (پیش‌فرض: true مگر این‌که گزینه \-m نیز مشخص شده باشد)\&.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
\-f, \-\-config configfile
.RS 4
مشخص کردن یک فایل پیکربندی جایگزین\&.
.sp
برای نمایش مسیر پیش‌فرض، از dbmail\-<utility> \-\-help استفاده کنید\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
رد کردن بی‌سر و صدای اعلان‌های تعاملی و پیام‌های وضعیت کمکی که در غیر این صورت در stdout چاپ می‌شدند\&. برای بی‌صدا کردن خطاهایی که در غیر این صورت در stderr چاپ می‌شدند، از دو \-q استفاده کنید\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
اجرا در حالت پرگو (verbose)\&. برخی از ابزارهای مجموعه DBMail می‌توانند دو بار \-v را برای پرگویی بیشتر دریافت کنند\&. ابزارهایی که این قاعده را پشتیبانی نمی‌کنند، خطایی برای \-v اضافی نمایش نخواهند داد و با پرگویی عادی خود عمل می‌کنند\&.
.RE
.PP
\-V, \-\-version
.RS 4
نمایش نسخه و حق نشر، سپس خروج\&.
.RE
.PP
\-h, \-\-help
.RS 4
نمایش چکیده کوتاهی از گزینه‌ها، سپس خروج\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای برون‌بری و حذف تمامی پیام‌های متعلق به کاربر \fIJoe\fR در صندوق پستی \fIInbox\fR که بیش از ۳۰ روز قدمت دارند، این دستور را در لینوکس امتحان کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-export \-\-user joe \e
    \-\-mailbox inbox \e
    \-\-out joesinbox\&.mbox \e
    \-\-set\-del\-flag \e
    \-\-search "1:* BEFORE `date \*(Aq+%e\-%b\-%Y\*(Aq \-d \*(Aq30 days ago\*(Aq`"
.fi
.if n \{\
.RE
.\}
.sp
نسخه مخصوص سیستم‌های BSD:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-export \-\-user joe \e
    \-\-mailbox inbox \e
    \-\-out joesinbox\&.mbox \e
    \-\-set\-del\-flag \e
    \-\-search "1:* BEFORE `date \-v\-30d \*(Aq+%e\-%b\-%Y\*(Aq`"
.fi
.if n \{\
.RE
.\}
.sp
به نقل‌قول دقیق در bash و بک‌تیک‌ها برای فراخوانی دستور date(1) توجه کنید\&. دستور date(1) قابلیت‌های فوق‌العاده‌ای برای دریافت تاریخ‌های نسبی دارد\&. در صورت استفاده از یک پوسته دیگر، ممکن است به نقل‌قول‌های متفاوتی نیاز داشته باشید\&.
.sp
برای برون‌بری تمامی صندوق‌های پستی با نام Spam برای همه کاربران در دایرکتوری‌های مجزا طبق الگوی SpamDump/<username>/Spam، این دستور را امتحان کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
dbmail\-export \-\-user \e* \-\-mailbox Spam \-\-basedir SpamDump
.fi
.if n \{\
.RE
.\}
.sp
به بک‌اسلش برای جلوگیری از بسط * توسط پوسته توجه کنید، زیرا می‌خواهیم این * برای بسط مبتنی بر فهرست کاربران داخلی به DBMail ارسال شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
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)
.SH "اشکالات (BUGS)"
.sp
برای دریافت جدیدترین اطلاعیه‌ها، لطفاً در \m[blue]\fBDBMail announce mailing list\fR\m[]\&\s-2\u[1]\d\s+2 مشترک شوید\&.
.sp
برای گفتگوهای عمومی، لطفاً در \m[blue]\fBDBMail general mailing list\fR\m[]\&\s-2\u[2]\d\s+2 مشترک شوید\&.
.sp
اگر مشکلی در DBMail مشاهده کردید، لطفاً آن را در \m[blue]\fBDBMail Bug Tracker\fR\m[]\&\s-2\u[3]\d\s+2 گزارش دهید\&. ممکن است ارائه یک لاگ اشکال‌زدایی (debug log) مفید باشد\&.
.SH "مجوز (LICENSE)"
.sp
نرم‌افزار DBMail و اجزای آن تحت شرایط مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License Version 2) توزیع می‌شوند\&. حقوق نشر به صورت گوناگون متعلق به نویسندگان فهرست‌شده در زیر است\&.
.SH "نویسندگان (AUTHORS)"
.sp
پروژه DBMail نتیجه تلاش مشترک میان توسعه‌دهندگان اصلی فهرست‌شده در زیر و کمک فوق‌العاده آزمون‌کنندگان، اصلاح‌کنندگان و شکارچیان باگ است که نام آن‌ها در فایل‌های AUTHORS و THANKS در توزیع منبع DBMail آمده است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
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
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.PP
\fBAlan Hicks\fR <\&ahicks@p\-o\&.co\&.uk\&>
.RS 4
نویسنده.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
DBMail announce mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-announce
.RE
.IP " 2." 4
DBMail general mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-general
.RE
.IP " 3." 4
DBMail Bug Tracker
.RS 4
\%https://github.com/dbmail/dbmail/issues
.RE