.TH "GPGTAR" "1" "مه ۲۰۲۵" "gnupg" "دستورهای کاربری"
.SH "نام (NAME)"
gpgtar \- رمزنگاری یا امضای فایلها و پوشهها در قالب یک آرشیو
.SH "خلاصه دستور (SYNOPSIS)"
\fBgpgtar\fP [ \fIگزینهها\fP ] \fIفایلها\fP...
.SH "توضیحات (DESCRIPTION)"
دستور \fBgpgtar\fR فایلی یا دایرکتوریها را در یک فایل آرشیو بستهبندی کرده و سپس با استفاده از GnuPG آن را رمزنگاری یا امضا میکند. این ابزار در واقع یک tar مبتنی بر gpg است که از همان قالب مورد استفاده در PGP Zip برنامه PGP بهره می‌برد.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B gpgtar
گزینه‌های زیر را می‌پذیرد:
.TP
.B \-\-create
قرار دادن فایل‌ها و پوشه‌های مشخص‌شده در یک آرشیو ساده \(oq\(oqustar\(cq\(cq.
.TP
.B \-\-extract
استخراج تمام فایل‌ها از یک آرشیو ساده \(oq\(oqustar\(cq\(cq.
اگر نام فایلی داده نشود (یا برابر \(oq\-\(cq باشد)، آرشیو از ورودی استاندارد (stdin) خوانده می‌شود.
.TP
.B \-\-encrypt
.TQ
.B \-e
رمزنگاری فایل‌ها و دایرکتوری‌های مشخص‌شده در قالب یک آرشیو. این گزینه می‌تواند با گزینه
.B \-\-symmetric
برای ساخت آرشیوی که هم با کلید خصوصی و هم با گذرواژه قابل رمزگشایی باشد ترکیب شود.
.TP
.B \-\-decrypt
.TQ
.B \-d
استخراج تمام فایل‌ها از یک آرشیو رمزشده. اگر نام فایلی داده نشود (یا برابر \(oq\-\(cq باشد)، آرشیو از ورودی استاندارد (stdin) خوانده می‌شود.
.TP
.B \-\-sign
.TQ
.B \-s
ایجاد یک آرشیو امضاشده از فایل‌ها و پوشه‌های داده‌شده. این گزینه می‌تواند با گزینه
.B \-\-encrypt
ترکیب شود تا آرشیوی ابتدا امضاشده و سپس رمزنگاری‌شده تولید گردد.
.TP
.B \-\-list\-archive
.TQ
.B \-t
فهرست کردن محتویات آرشیو مشخص‌شده. اگر نام فایلی داده نشود (یا برابر \(oq\-\(cq باشد)، آرشیو از ورودی استاندارد (stdin) خوانده می‌شود.
.TP
.B \-\-symmetric
.TQ
.B \-c
رمزنگاری متقارن با استفاده از یک گذرواژه. الگوریتم رمزنگاری متقارن پیش‌فرض AES-128 است، اما می‌توان آن را با گزینه
.B \-\-cipher\-algo
در دستور
.B gpg
تغییر داد.
.TP
.B \-\-recipient \fIکاربر\fP
.TQ
.B \-r \fIکاربر\fP
رمزنگاری برای شناسه کاربری \fIکاربر\fP. برای جزئیات به
.BR gpg (1)
مراجعه کنید.
.TP
.B \-\-local\-user \fIکاربر\fP
.TQ
.B \-u \fIکاربر\fP
استفاده از کلید \fIکاربر\fP برای امضا کردن. برای جزئیات به
.BR gpg (1)
مراجعه کنید.
.TP
.B \-\-output \fIفایل\fP
.TQ
.B \-o \fIفایل\fP
نوشتن آرشیو درون فایل مشخص‌شده \fIفایل\fP.
.TP
.B \-\-verbose
.TQ
.B \-v
فعال کردن نمایش خروجی‌های اطلاعاتی بیشتر و پرگویی.
.TP
.B \-\-quiet
.TQ
.B \-q
تلاش برای عملکرد آرام و بی‌صدا تا حد ممکن.
.TP
.B \-\-skip\-crypto
صرف‌نظر کردن از تمام عملیات رمزنگاری، و ایجاد یا استخراج آرشیوهای ساده \(oq\(oqustar\(cq\(cq.
.TP
.B \-\-dry\-run
اجرای آزمایشی؛ فایل‌های استخراج‌شده را به صورت واقعی در دیسک نمی‌نویسد.
.TP
.B \-\-directory \fIپوشه\fP
.TQ
.B \-C \fIپوشه\fP
استخراج فایل‌ها درون دایرکتوری \fIپوشه\fP. حالت پیش‌فرض استخراج نام پوشه از نام فایل ورودی است. اگر نام فایل ورودی مشخص نباشد، از پوشه‌ای با نام \(oq\fIGPGARCH\fP\(cq استفاده می‌شود. برای ایجاد آرشیو (tarball)، قبل از انجام هرگونه عملیات، به پوشه \fIپوشه\fP تغییر مسیر می‌دهد.
.TP
.B \-\-files\-from \fIفایل\fP
.TQ
.B \-T \fIفایل\fP
خواندن نام فایل‌های مورد نظر برای پردازش از فایل \fIفایل\fP؛ یک فایل در هر خط.
.TP
.B \-\-null
تغییر عملکرد گزینه
.B \-\-files\-from
به طوری که از نویسه پوچ دودویی (binary nul) به جای خط جدید (linefeed) برای جداسازی نام فایل‌ها استفاده شود.
.TP
.B \-\-utf8\-strings
فرض کردن اینکه نام فایل‌های خوانده‌شده با
.B \-\-files\-from
دارای کدگذاری UTF-8 هستند. این گزینه تنها در ویندوز اثر دارد که در غیر این صورت از صفحه کد فعال سیستم استفاده می‌شود.
.TP
.B \-\-openpgp
این گزینه اثری ندارد زیرا رمزنگاری و امضای OpenPGP به طور پیش‌فرض فعال است.
.TP
.B \-\-cms
این گزینه رزرو شده است و نباید استفاده شود. در آینده برای رمزنگاری یا امضا با پروتکل CMS به کار خواهد رفت؛ اما هنوز پیاده‌سازی نشده است.
.TP
.B \-\-batch
استفاده از حالت دسته‌ای (غیرتعاملی). هرگز سؤالی نمی‌پرسد و همیشه عمل پیش‌فرض را انجام می‌دهد. این گزینه مستقیماً به
.B gpg
پاس داده می‌شود.
.TP
.B \-\-yes
پاسخ مثبت (yes) به اغلب پرسش‌ها به طور خودکار. معمولاً همراه با
.B \-\-batch
برای بازنویسی فایل‌های موجود به کار می‌رود. این گزینه مستقیماً به
.B gpg
پاس داده می‌شود.
.TP
.B \-\-no
پاسخ منفی (no) به اغلب پرسش‌ها به طور خودکار. این گزینه مستقیماً به
.B gpg
پاس داده می‌شود.
.TP
.B \-\-require\-compliance
این گزینه مستقیماً به
.B gpg
منتقل می‌شود تا الزامات انطباق بررسی شوند.
.TP
.B \-\-status\-fd \fIn\fP
نوشتن رشته‌های وضعیت ویژه در توصیف‌گر فایل \fIn\fP.
برای مشاهده فهرستی از آن‌ها، پرونده DETAILS را در مستندات ببینید.
.TP
.B \-\-with\-log
هنگام استخراج یک آرشیو رمزشده، علاوه بر استخراج، یک فایل گزارش از خروجی gpg به فایلی هم‌نام با دایرکتوری استخراج همراه با پسوند «.log» نوشته می‌شود.
.TP
.B \-\-set\-filename \fIفایل\fP
استفاده از آخرین بخش \fIفایل\fP به عنوان دایرکتوری خروجی. پیش‌فرض این است که نام پوشه از نام فایل ورودی برداشته شود. اگر نام فایل ورودی در دسترس نباشد، پوشه‌ای به نام \(oq\fIGPGARCH\fP\(cq استفاده خواهد شد. این گزینه منسوخ شده و به جای آن گزینه
.B \-\-directory
توصیه می‌شود.
.TP
.B \-\-no\-compress
این گزینه به gpg دستور می‌دهد که فشرده‌سازی را غیرفعال کند (مشابه استفاده از گزینه \-z0). این کار هنگام آرشیو کردن فایل‌های حجیمی که قبلاً فشرده شده‌اند (مانند مجموعه‌ای از فایل‌های ویدیویی) مفید است.
.TP
.B \-\-gpg \fIgpgcmd\fP
استفاده از دستور مشخص‌شده \fIgpgcmd\fP به جای
.BR gpg .
.TP
.B \-\-gpg\-args \fIشناسه‌ها\fP
ارسال گزینه‌های اضافی مشخص‌شده به
.BR gpg .
.TP
.B \-\-tar\-args \fIشناسه‌ها\fP
فرض اینکه \fIشناسه‌ها\fP گزینه‌های استاندارد دستور
.B tar
هستند و پردازش آن‌ها. تنها گزینه‌های پشتیبانی‌شده tar عبارتند از «--directory»، «--files-from» و «--null». این یک گزینه منسوخ است زیرا می‌توان آن گزینه‌های پشتیبانی‌شده را مستقیماً نیز استفاده کرد.
.TP
.B \-\-tar \fIدستور\fP
این یک گزینه ساختگی برای سازگاری با نسخه‌های گذشته است.
.TP
.B \-\-version
چاپ نسخه برنامه و خروج.
.TP
.B \-\-help
نمایش یک صفحه راهنمای کوتاه و خروج.
.SH "مثال‌ها (EXAMPLES)"
رمزنگاری محتویات پوشه \(oq\fImydocs\fP\(cq برای کاربر Bob در فایل \(oq\fItest1\fP\(cq:
.RS 2
.nf
gpgtar \-\-encrypt \-\-output test1 \-r Bob mydocs
.fi
.RE
.PP
فهرست کردن محتویات آرشیو \(oq\fItest1\fP\(cq:
.RS 2
.nf
gpgtar \-\-list\-archive test1
.fi
.RE
.SH "کدهای خروجی و عیب‌یابی (DIAGNOSTICS)"
این برنامه در صورت موفقیت کامل مقدار 0 و در غیر این صورت مقدار 1 را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1),
.BR tar (1)
.PP
مستندات کامل این ابزار در قالب یک راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی در سیستم شما نصب شده باشند، اجرای دستور
.RS 2
.nf
info gnupg
.fi
.RE
دسترسی به راهنمای کامل شامل ساختار منو و نمایه را برای شما فراهم می‌کند.