نام (NAME)

gpg-mail-tube - لوله پردازش و فیلتر ایمیل برای GnuPG

خلاصه دستور (SYNOPSIS)

gpg-mail-tube [گزینه‌ها] گیرندگان

توضیحات (DESCRIPTION)

دستور gpg-mail-tube ایمیل با فرمت RFC-822 را از ورودی استاندارد (stdin) دریافت کرده و آن را به یک ایمیل رمزگذاری‌شده با PGP/MIME تبدیل می‌کند که سپس در خروجی استاندارد (stdout) نوشته می‌شود.

گیرندگان باید آدرس‌های ساده ایمیل باشند (مانند foo@example.org) و به‌طور کلی باید نشانی‌های To و Cc موجود در ایمیل را فهرست کنند.

گزینه‌ها (OPTIONS)

دستور gpg-mail-tube این گزینه‌ها را درک می‌کند:

--verbose
-v: فعال‌سازی خروجی اطلاعاتی بیشتر.
--quiet
-q: تلاش برای تولید کمترین پیام ممکن.
--log-file file: نوشتن خروجی لاگ در file. برای ثبت گزارش در یک سوکت از ‘socket://’ استفاده کنید.
--no-stderr: تمام خروجی‌ها به stderr را مسدود می‌کند. این گزینه برای فراخوانندگانی مفید است که تفاوتی بین stdout و stderr قائل نمی‌شوند. برای دریافت پیام‌های تشخیصی می‌توان از گزینه --log-file استفاده کرد.
--header name=value: افزودن سرآیند ایمیل "name: value" به خروجی.
--setenv name=value: رشته متغیر محیطی داده‌شده را در محیط این فرآیند و gpg فراخوانی‌شده قرار می‌دهد. اگر راه دیگری برای تنظیم متغیرهای محیطی وجود نداشته باشد، این گزینه الزامی است.
--as-attach
-a: یک ایمیل PGP/MIME تولید نمی‌کند، بلکه یک بدنه ساده همراه با یک پیوست حاوی بدنه رمزگذاری‌شده ایمیل ورودی ارائه می‌دهد. اگر ورودی یک پیام متن ساده باشد، یک فایل رمزگذاری‌شده ساده پیوست می‌شود. اگر ورودی یک پیام چندبخشی MIME باشد، فایل رمزگذاری‌شده از نوع message/rfc822 خواهد بود.
--gpg gpgcmd: استفاده از دستور مشخص‌شده gpgcmd به‌جای gpg.
--vsd: استفاده از gpg ارائه‌شده توسط یک AppImage با نام GnuPG VS-Desktop®. اگر AppImage در حال اجرا نباشد راه‌اندازی خواهد شد. یک پیوند نمادین با نام ‘~/.gnupg-vsd/gnupg-vs-desktop.AppImage’ باید به AppImage واقعی مورد استفاده اشاره کند.
--version: چاپ نسخه برنامه و خروج.
--help: نمایش یک صفحه راهنمای کوتاه و خروج.

مثال‌ها (EXAMPLES)

گزینه‌های زیر می‌توانند در یک قانون انتقال محلی نرم‌افزار Exim MTA استفاده شوند، با این فرض که check_local_user در مسیریاب (router) استفاده شده باشد:

transport_filter = /usr/local/bin/gpg-mail-tube --setenv HOME=${home} \
                   --no-stderr -- $pipe_addresses

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

عیب‌یابی (DIAGNOSTICS)

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

همچنین ببینید (SEE ALSO)

gpg(1)

مستندات کامل این ابزار به عنوان یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی روی سیستم شما نصب شده باشند، اجرای دستور

info gnupg

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