.TH "SIEVE-DUMP" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
sieve\-dump \- ابزار دامپ باینری اسکریپت Sieve در Pigeonhole
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBsieve-dump\fR \[lB]\fIگزینه‌ها\fR\[rB] \fIsieve-binary\fR \[lB]\fIout-file\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBsieve-dump\fR بخشی از پروژه Pigeonhole (رجوع کنید به pigeonhole(7)) است که پشتیبانی از Sieve (RFC 5228) و ManageSieve (RFC 5804) را به Dovecot (رجوع کنید به dovecot(1)) می‌افزاید.
.P
با استفاده از دستور \fBsieve-dump\fR، فایل‌های باینری Sieve که برای نمونه توسط sievec(1) تولید شده‌اند، می‌توانند به یک بازنمایی متنی و خوانا برای انسان تبدیل شوند. این امر بینش ارزشمندی درباره نحوه اجرای اسکریپت Sieve فراهم می‌کند. همچنین این ابزار به‌ویژه برای مشاهده باینری‌های آسیب‌دیده‌ای که ممکن است در اثر باگ‌های پیاده‌سازی Sieve به وجود آمده باشند، بسیار مفید است. این ابزار اساساً برای اهداف توسعه در نظر گرفته شده است، بنابراین مدیران سیستم و کاربران در شرایط عادی نیازی به استفاده از آن نخواهند داشت.
.P
قالب خروجی در اینجا با جزئیات شرح داده نشده است، اما درک آن باید نسبتاً آسان باشد. باینری‌های Sieve از مجموعه‌ای از بلوک‌های داده تشکیل شده‌اند که هر یک می‌توانند حاوی داده‌های دلخواه باشند. برای پیاده‌سازی زبان پایه از دو بلوک استفاده می‌شود: بلوک نخست شامل مشخصات تمام افزونه‌های زبانی مورد نیاز است و بلوک دوم حاوی برنامه اصلی Sieve می‌باشد. برنامه‌های کامپایل‌شده Sieve به‌صورت بایت‌کد مسطح نمایش داده می‌شوند و بنابراین دامپ برنامه اصلی، فهرستی از دیس‌اسمبلی عملیات مفسر است. افزونه‌ها می‌توانند عملیات جدیدی تعریف کنند و از بلوک‌های اضافی بهره ببرند. از این رو، خروجی \fBsieve-dump\fR تا حد زیادی به افزونه‌های زبانی که هنگام کامپایل باینری به کار رفته‌اند بستگی دارد.
.SH "گزینه‌ها (OPTIONS)"
.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
مسیر جایگزین برای فایل پیکربندی Dovecot.
.RE 0

.RE 0

.P
\fB-D\fR
.RS 0
.RS 4
.P
فعال‌سازی اشکال‌زدایی (دیباگ) Sieve.
.RE 0

.RE 0

.P
\fB-h\fR
.RS 0
.RS 4
.P
تولید خروجی هگز‌دامپ (hexdump) برای هر بلوک از کل باینری به جای خروجی متنی عادی و خوانا.
.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

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
اجرای \fIcommand\fR تنها برای کاربر مشخص‌شده \fIuser\fR. همچنین امکان استفاده از نویسه‌های عام '\fB*\fR' و '\fB?\fR' وجود دارد (مانند -u *@example.org).
.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 برای آن باید آزمایش شود. مقدار می‌تواند نام سرویسی باشد که معمولاً با Dovecot به کار می‌رود؛ برای نمونه: \fBimap\fR، \fBpop3\fR یا \fBsmtp\fR.
.RE 0

.P
\fBsession\fR
.RS 4
.P
شناسه نشست (Session).
.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} به فرایند احراز هویت (auth) فرستاده شود.
.RE 0

.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIsieve-binary\fR
.RS 0
.RS 4
.P
فایل باینری Sieve که باید تخلیه و استخراج (دامپ) شود را مشخص می‌کند.
.RE 0

.RE 0

.P
\fIout-file\fR
.RS 0
.RS 4
.P
محل ذخیره خروجی را تعیین می‌کند. این آرگومان اختیاری است. در صورت حذف، خروجی در \fBstdout\fR نوشته می‌شود.
.RE 0

.RE 0

.SH "وضعیت خروج (EXIT STATUS)"
.P
دستور \fBsieve-dump\fR با یکی از مقادیر زیر به کار خود پایان می‌دهد:
.P
\fB0\fR
.RS 0
.RS 4
.P
دامپ موفقیت‌آمیز بود. (EX_OK, EXIT_SUCCESS)
.RE 0

.RE 0

.P
\fB1\fR
.RS 0
.RS 4
.P
عملیات شکست خورد. این کد تقریباً برای تمام خطاها برگردانده می‌شود. (EXIT_FAILURE)
.RE 0

.RE 0

.P
\fB64\fR
.RS 0
.RS 4
.P
پارامتر نامعتبر داده شده است. (EX_USAGE)
.RE 0

.RE 0

.SH "فایل‌ها (FILES)"
.P
\fI/etc/dovecot/dovecot.conf\fR
.RS 0
.RS 4
.P
فایل پیکربندی اصلی Dovecot.
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/90-sieve.conf\fR
.RS 0
.RS 4
.P
تنظیمات مفسر Sieve (واردشده از فایل پیکربندی اصلی Dovecot).
.RE 0

.RE 0

.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR را به فهرست ایمیل Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
dovecot(1), dovecot-lda(1), sieve-filter(1), sieve-test(1), sievec(1), pigeonhole(7)