.\" Created from Texinfo source by yat2m 1.61-unknown
.TH GPG-MAIL-TUBE 1 2025-02-19 "GnuPG 2.4.9" "GNU Privacy Guard 2.4"
.SH "نام (NAME)"
gpg\-mail\-tube \- لوله پردازش و فیلتر ایمیل برای GnuPG
.SH "خلاصه دستور (SYNOPSIS)"
.B gpg\-mail\-tube
.RI [ گزینه‌ها ]
.I گیرندگان

.SH "توضیحات (DESCRIPTION)"
دستور
\fBgpg\-mail\-tube\fP
ایمیل با فرمت RFC-822 را از ورودی استاندارد (stdin) دریافت کرده و آن را به یک ایمیل رمزگذاری‌شده با PGP/MIME تبدیل می‌کند که سپس در خروجی استاندارد (stdout) نوشته می‌شود.
.PP
گیرندگان باید آدرس‌های ساده ایمیل باشند (مانند
\fBfoo@example.org\fP)
و به‌طور کلی باید نشانی‌های To و Cc موجود در ایمیل را فهرست کنند.

.SH "گزینه‌ها (OPTIONS)"
دستور
\fBgpg\-mail\-tube\fP
این گزینه‌ها را درک می‌کند:

.TP
.B  \-\-verbose
.TQ
.B  \-v
فعال‌سازی خروجی اطلاعاتی بیشتر.

.TP
.B  \-\-quiet
.TQ
.B  \-q
تلاش برای تولید کمترین پیام ممکن.

.TP
.B  \-\-log\-file \fIfile\fP
نوشتن خروجی لاگ در \fIfile\fP. برای ثبت گزارش در یک سوکت از \(oq\fIsocket://\fP\(cq استفاده کنید.

.TP
.B  \-\-no\-stderr
تمام خروجی‌ها به stderr را مسدود می‌کند. این گزینه برای فراخوانندگانی مفید است که تفاوتی بین stdout و stderr قائل نمی‌شوند. برای دریافت پیام‌های تشخیصی می‌توان از گزینه
\fB\-\-log\-file\fP
استفاده کرد.

.TP
.B  \-\-header \fIname\fP=\fIvalue\fP
افزودن سرآیند ایمیل "\fIname\fP: \fIvalue\fP" به خروجی.

.TP
.B  \-\-setenv \fIname\fP=\fIvalue\fP
رشته متغیر محیطی داده‌شده را در محیط این فرآیند و gpg فراخوانی‌شده قرار می‌دهد. اگر راه دیگری برای تنظیم متغیرهای محیطی وجود نداشته باشد، این گزینه الزامی است.

.TP
.B  \-\-as\-attach
.TQ
.B  \-a
یک ایمیل PGP/MIME تولید نمی‌کند، بلکه یک بدنه ساده همراه با یک پیوست حاوی بدنه رمزگذاری‌شده ایمیل ورودی ارائه می‌دهد. اگر ورودی یک پیام متن ساده باشد، یک فایل رمزگذاری‌شده ساده پیوست می‌شود. اگر ورودی یک پیام چندبخشی MIME باشد، فایل رمزگذاری‌شده از نوع message/rfc822 خواهد بود.

.TP
.B  \-\-gpg \fIgpgcmd\fP
استفاده از دستور مشخص‌شده \fIgpgcmd\fP به‌جای \fBgpg\fP.

.TP
.B  \-\-vsd
استفاده از gpg ارائه‌شده توسط یک AppImage با نام \fIGnuPG VS-Desktop®\fP. اگر AppImage در حال اجرا نباشد راه‌اندازی خواهد شد. یک پیوند نمادین با نام
\(oq\fI~/.gnupg\-vsd/gnupg\-vs\-desktop.AppImage\fP\(cq
باید به AppImage واقعی مورد استفاده اشاره کند.

.TP
.B  \-\-version
چاپ نسخه برنامه و خروج.

.TP
.B  \-\-help
نمایش یک صفحه راهنمای کوتاه و خروج.

.SH "مثال‌ها (EXAMPLES)"
گزینه‌های زیر می‌توانند در یک قانون انتقال محلی نرم‌افزار Exim MTA استفاده شوند، با این فرض که \fBcheck_local_user\fP در مسیریاب (router) استفاده شده باشد:

.RS 2
.nf
transport_filter = /usr/local/bin/gpg\-mail\-tube \-\-setenv HOME=${home} \[rs]
                   \-\-no\-stderr \-\- $pipe_addresses
.fi
.RE

برای انتقال از راه دور، ممکن است استفاده از \fBsize_addition\fP و تنظیم صریح کاربر و دایرکتوری خانگی آن مورد نیاز باشد.

.SH "عیب‌یابی (DIAGNOSTICS)"
این برنامه در صورت رمزگذاری موفقیت‌آمیز مقدار 0 و در هنگام بروز خطا مقدار غیرصفر برمی‌گرداند. توجه داشته باشید که در صورت بروز خطا ممکن است مقداری خروجی از قبل در stdout نوشته شده باشد.

.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1)
.PP
مستندات کامل این ابزار به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی روی سیستم شما نصب شده باشند، اجرای دستور

.RS 2
.nf
info gnupg
.fi
.RE

باید دسترسی به راهنمای کامل را به همراه ساختار منو و نمایه در اختیار شما قرار دهد.