.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH GPGDIR 1 "May, 2007" Linux
.SH "نام (NAME)"
gpgdir \- رمزگذاری و رمزگشایی بازگشتی دایرکتوری‌ها با GnuPG
.SH "خلاصه دستور (SYNOPSIS)"
.B gpgdir \-e|\-d <دایرکتوری>
[\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.B gpgdir
یک اسکریپت پرل (perl) است که از ماژول پرل CPAN GnuPG::Interface برای رمزگذاری و رمزگشایی بازگشتی دایرکتوری‌ها با استفاده از gpg بهره می‌برد.
.B gpgdir
به‌صورت بازگشتی در ساختار دایرکتوری پیمایش می‌کند تا مطمئن شود تمامی فایل‌های موجود در دایرکتوری و تمام زیردایرکتوری‌های آن رمزگذاری یا رمزگشایی می‌شوند. به‌طور پیش‌فرض، مقادیر mtime و atime تمامی فایل‌ها پس از رمزگذاری و رمزگشایی حفظ خواهند شد (این رفتار را می‌توان با گزینه
.B \-\-no-preserve-times
غیرفعال کرد). توجه داشته باشید که در حالت
.BR \-\-encrypt ،
دستور gpgdir فایل‌های اصلی را که با موفقیت رمزگذاری شده‌اند حذف می‌کند (مگر اینکه گزینه
.B \-\-no-delete
مشخص شده باشد). با این حال، هنگام راه‌اندازی، gpgdir ابتدا رمز عبور رمزگشایی را درخواست می‌کند تا مطمئن شود یک فایل آزمایشی با موفقیت رمزگذاری و رمزگشایی می‌شود. این آزمایش اولیه را می‌توان با گزینه
.B \-\-skip-test
غیرفعال کرد تا بتوان یک دایرکتوری را بدون نیاز به مشخص کردن رمز عبور رمزگذاری کرد (این رفتار با نحوه عملکرد
.B gpg
سازگار است). همچنین، توجه داشته باشید که gpgdir مراقب است فایل‌ها و دایرکتوری‌های مخفی را رمزگذاری نکند. به هر حال، احتمالاً نمی‌خواهید دایرکتوری ~/.gnupg یا فایل ~/.bashrc شما رمزگذاری شوند. کلیدی که
.B gpgdir
برای رمزگذاری/رمزگشایی دایرکتوری استفاده می‌کند در فایل ~/.gpgdirrc مشخص می‌شود.

در نهایت،
.B gpgdir
می‌تواند از برنامه
.B wipe
همراه با گزینه خط فرمان
.B \-\-Wipe
برای حذف امن فایل‌های اصلی رمزگذاری‌نشده پس از رمزگذاری موفقیت‌آمیز آن‌ها استفاده کند. این کار سطح امنیت gpgdir را ارتقا می‌دهد، زیرا بازیابی داده‌های رمزگذاری‌نشده مرتبط با فایل‌ها از سیستم‌فایل پس از رمزگذاری بسیار دشوارتر خواهد بود (دستور ()unlink حتی پس از حذف فایل، بلوک‌های داده را پاک نمی‌کند).

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-e ", " \-\^\-encrypt\ <دایرکتوری>
رمزگذاری بازگشتی تمامی فایل‌های موجود در دایرکتوری مشخص‌شده در خط فرمان. تمامی فایل‌های اصلی حذف خواهند شد (ابتدا یک بررسی رمز عبور انجام می‌شود تا اطمینان حاصل شود که رمز عبور صحیح برای باز کردن قفل کلید خصوصی GnuPG توسط کاربر مشخص است).
.TP
.BR \-d ", " \-\^\-decrypt\ <دایرکتوری>
رمزگشایی بازگشتی تمامی فایل‌های موجود در دایرکتوری مشخص‌شده در خط فرمان. نسخه رمزگذاری‌شده .gpg هر فایل حذف خواهد شد.
.TP
.BR \-\^\-sign\ <دایرکتوری>
امضای بازگشتی تمامی فایل‌های موجود در دایرکتوری مشخص‌شده در خط فرمان. برای هر فایل، یک امضای مجزای .asc ایجاد خواهد شد.
.TP
.BR \-\^\-verify\ <دایرکتوری>
اعتبارسنجی بازگشتی تمامی امضاهای .asc برای فایل‌های موجود در دایرکتوری مشخص‌شده در خط فرمان.
.TP
.BR \-g ", " \-\^\-gnupg-dir\ <دایرکتوری>
مشخص کردن اینکه کدام دایرکتوری .gnupg برای یافتن کلیدهای GnuPG استفاده شود. در صورت عدم استفاده از این گزینه، مقدار پیش‌فرض ~/.gnupg است. این گزینه اجازه می‌دهد gpgdir به عنوان یک کاربر اجرا شود اما از کلیدهای کاربر دیگری استفاده کند (با فرض اینکه دسترسی‌ها به‌درستی تنظیم شده باشند و غیره).
.TP
.BR \-p ", " \-\^\-pw-file\ <فایل-رمز>
خواندن رمز عبور رمزگشایی از
.B فایل-رمز
به‌جای تایپ کردن آن در خط فرمان.
.TP
.BR \-t ", " \-\^\-test-mode
اجرای یک آزمایش رمزگذاری و رمزگشایی روی یک فایل ساختگی و خروج. این آزمایش همیشه به‌طور پیش‌فرض در هر دو حالت
.B \-\-encrypt
و
.B \-\-decrypt
اجرا می‌شود.
.TP
.BR \-S ", " \-\^\-Symmetric
دستور دادن به
.B gpgdir
برای رمزگذاری و رمزگشایی فایل‌ها با استفاده از یک الگوریتم رمزنگاری متقارن پشتیبانی‌شده توسط GnuPG (الگوریتم CAST5 معمولاً استفاده می‌شود). این کار منجر به افزایش چشمگیر سرعت فرآیند رمزگذاری/رمزگشایی می‌شود.
.TP
.BR \-T ", " \-\^\-Trial-run
نمایش اقدامات رمزگذاری/رمزگشایی که انجام خواهند شد بدون اجرای واقعی آن‌ها. در این حالت سیستم‌فایل به هیچ وجه تغییر نمی‌کند.
.TP
.BR \-I ", " \-\^\-Interactive
درخواست تایید از کاربر قبل از رمزگذاری یا رمزگشایی واقعی هر فایل. این گزینه برای داشتن کنترل دقیق بر عملیات
.B gpgdir
هنگام پیمایش در ساختار دایرکتوری مفید است.
.TP
.BR \-F ", " \-\^\-Force
دستور دادن به
.B gpgdir
برای نادیده گرفتن شرایط خطای غیربحرانی، مانند عدم توانایی در رمزگذاری یا رمزگشایی فایل‌های خاص به دلیل خطاهای دسترسی.
.TP
.BR \-\^\-Exclude\ <الگو>
دستور دادن به gpgdir برای رد کردن تمامی فایل‌هایی که با
.B الگو
به‌صورت یک تطابق رجکس در نام فایل همخوانی دارند. این مشابه گزینه
.B \-\-exclude
در دستور استاندارد GNU tar است.
.TP
.BR \-\^\-Exclude-from\ <فایل>
دستور دادن به gpgdir برای مستثنی کردن تمامی فایل‌هایی که با الگوهای فهرست‌شده در
.B فایل
تطابق دارند. این مشابه گزینه
.B \-\-exclude-from
در دستور GNU tar است.
.TP
.BR \-\^\-Include\ <الگو>
دستور دادن به gpgdir برای اینکه فقط فایل‌هایی را شامل شود که با
.B الگو
به‌صورت یک تطابق رجکس در نام فایل همخوانی دارند.
.TP
.BR \-\^\-Include-from\ <فایل>
دستور دادن به gpgdir برای اینکه فقط فایل‌های منطبق با الگوهای فهرست‌شده در
.B فایل
را شامل شود.
.TP
.BR \-W ", " \-\^\-Wipe
استفاده از برنامه
.B wipe
برای حذف امن فایل‌ها پس از رمزگذاری موفقیت‌آمیز آن‌ها.
.TP
.BR \-O ", " \-\^\-Obfuscate-filename
دستور دادن به
.B gpgdir
برای مبهم‌سازی نام فایل‌هایی که رمزگذاری می‌کند (در حالت \-e). نام هر فایل درون فایل .gpgdir_map_file برای هر زیردایرکتوری ذخیره می‌شود و این فایل خودش رمزگذاری می‌گردد. در حالت رمزگشایی (\-d)، آرگومان \-O فرآیند را معکوس می‌کند تا فایل‌های اصلی بازیابی شوند.
.TP
.BR \-\^\-overwrite-encrypted
بازنویسی فایل‌های رمزگذاری‌شده حتی اگر یک فایل <file>.gpg قبلی از قبل وجود داشته باشد.
.TP
.BR \-\^\-overwrite-decrypted
بازنویسی فایل‌های رمزگشایی‌شده حتی اگر فایل رمزگذاری‌نشده قبلی از قبل وجود داشته باشد.
.TP
.BR \-K ", " \-\^\-Key-id\ <شناسه>
مشخص کردن دستی شناسه کلید GnuPG از خط فرمان. از آنجا که GnuPG از تطبیق کلیدها با یک رشته پشتیبانی می‌کند،
.B شناسه
الزاماً نباید یک شناسه کلید عددی باشد؛ می‌تواند رشته‌ای باشد که به‌طور یکتا با یک کلید در جاکلیدی (keyring) GnuPG مطابقت دارد.
.TP
.BR \-D ", " \-\^\-Default-key
استفاده از کلیدی که GnuPG به عنوان پیش‌فرض تعریف کرده است، یعنی کلیدی که توسط متغیر
.B default-key
در ~/.gnupg/options مشخص شده است. اگر متغیر default-key درون ~/.gnupg/options تعریف نشده باشد، GnuPG تلاش می‌کند از اولین کلید مناسب در جاکلیدی خود استفاده کند (آزمایش اولیه رمزگذاری/رمزگشایی مطمئن می‌شود که کاربر رمز عبور متناظر با کلید را می‌داند).
.TP
.BR \-a ", " \-\^\-agent
دستور دادن به
.B gpgdir
برای دریافت رمز عبور کلید gpg از یک نمونه در حال اجرای
.BR gpg-agent .
.TP
.BR \-A ", " \-\^\-Agent-info\ <اطلاعات\ اتصال>
مشخص کردن مقدار متغیر محیطی GPG_AGENT_INFO همان‌طور که توسط دستور
.B gpg-agent \-\-daemon
برگردانده می‌شود. اگر آرگومان خط فرمان
.B gpgdir \-\-agent
به‌جای
.B \-\-Agent-info
استفاده شود، gpgdir فرض می‌کند که متغیر محیطی GPG_AGENT_INFO از قبل در پوسته فعلی تنظیم شده است.
.TP
.BR \-s ", " \-\^\-skip-test
صرف‌نظر کردن از آزمایش رمزگذاری و رمزگشایی. این کار اجازه می‌دهد
.B gpgdir
برای رمزگذاری یک دایرکتوری بدون مشخص کردن رمز عبور استفاده شود (که معمولاً در حالت رمزگذاری برای آزمایش و اطمینان از عملکرد صحیح رمزگشایی روی یک فایل ساختگی استفاده می‌شود).
.TP
.BR \-q ", " \-\^\-quiet
چاپ کمترین مقدار ممکن روی صفحه هنگام رمزگذاری یا رمزگشایی یک دایرکتوری.
.TP
.BR \-\^\-no-recurse
دستور دادن به gpgdir برای عدم پیمایش بازگشتی در زیردایرکتوری‌های دایرکتوری در حال رمزگذاری یا رمزگشایی.
.TP
.BR \-\^\-no-password
دستور دادن به gpgdir برای درخواست نکردن رمز عبور از کاربر. این گزینه فقط زمانی مفید است که کلید gpg واقعاً هیچ رمز عبور مرتبطی نداشته باشد (که معمول نیست).
.TP
.BR \-\^\-no-delete
دستور دادن به gpgdir برای عدم حذف فایل‌های اصلی در زمان رمزگذاری.
.TP
.BR \-\^\-no-preserve-times
دستور دادن به gpgdir برای عدم حفظ مقادیر mtime و atime فایل اصلی پس از رمزگذاری یا رمزگشایی.
.TP
.BR \-l ", " \-\^\-locale\ <لوکال>
ارائه یک تنظیم لوکال غیر از لوکال پیش‌فرض "C".
.TP
.BR \-\^\-no-locale
تنظیم نکردن لوکال به طور کلی تا لوکال پیش‌فرض سیستم اعمال شود.
.TP
.BR \-v ", " \-\^\-verbose
اجرا در حالت پرگو (verbose).
.TP
.BR \-V ", " \-\^\-Version
چاپ شماره نسخه و خروج.
.TP
.BR \-h ", " \-\^\-help
چاپ اطلاعات نحوه استفاده و خروج.
.SH "فایل‌ها (FILES)"
.B ~/.gpgdirrc
.RS
شامل شناسه کلید مربوط به کلید gpg کاربر است که برای رمزگذاری یا رمزگشایی فایل‌های درون یک دایرکتوری استفاده خواهد شد.
.RE
.PP
.SH "محیط (ENVIRONMENT)"
.TP 13
.I HOME
تنظیم دایرکتوری خانه پیش‌فرض.
.TP 13
.I GNUPGBIN
تنظیم فایل اجرایی gpg. پیش‌فرض: "gpg".
.TP 13
.I GNUPGHOME
تنظیم دایرکتوری کاری پیش‌فرض برای gpg. پیش‌فرض: "~/.gnupg".
.SH "مثال‌ها (EXAMPLES)"
مثال‌های زیر آرگومان‌های خط فرمانی را نشان می‌دهند که می‌توان در موقعیت‌های مختلف به gpgdir ارائه داد:
.PP
برای رمزگذاری یک دایرکتوری:
.PP
.B $ gpgdir \-e /some/dir
.PP
برای رمزگذاری یک دایرکتوری و استفاده از دستور wipe برای حذف امن فایل‌های رمزگذاری‌نشده اصلی:
.PP
.B $ gpgdir \-W \-e /some/dir
.PP
برای رمزگذاری یک دایرکتوری با کلید پیش‌فرض GnuPG تعریف‌شده در ~/.gnupg/options:
.PP
.B $ gpgdir \-e /some/dir \-\-Default-key
.PP
برای رمزگشایی یک دایرکتوری با کلید مشخص‌شده در ~/.gpgdirrc:
.PP
.B $ gpgdir \-d /some/dir
.PP
برای رمزگذاری یک دایرکتوری اما صرف‌نظر کردن از تمام نام فایل‌هایی که شامل رشته "host" هستند:
.PP
.B $ gpgdir \-e /some/dir \-\-Exclude host
.PP
برای رمزگذاری یک دایرکتوری اما فقط رمزگذاری فایل‌هایی که شامل رشته "passwd" هستند:
.PP
.B $ gpgdir \-e /some/dir \-\-Include passwd
.PP
برای دریافت رمز عبور کلید GnuPG از یک دیمن gpg-agent در حال اجرا به منظور رمزگشایی یک دایرکتوری (این کار نیازمند آن است که gpg-agent رمز عبور را داشته باشد):
.PP
.B $ gpgdir \-A /tmp/gpg-H4DBhc/S.gpg-agent:7046:1 \-d /some/dir
.PP
برای رمزگذاری یک دایرکتوری اما رد کردن آزمایش رمزگذاری/رمزگشایی (به این ترتیب رمز عبور رمزگشایی از شما خواسته نمی‌شود):
.PP
.B $ gpgdir \-e /some/dir \-s
.PP
برای رمزگذاری یک دایرکتوری بدون زیردایرکتوری‌های آن:
.PP
.B $ gpgdir \-e /some/dir \-\-no-recurse
.PP
برای رمزگذاری دایرکتوری خانه ریشه (root)، اما استفاده از کلیدهای GnuPG مرتبط با کاربر "bob":
.PP
.B # gpgdir \-e /root \-g /home/bob/.gnupg
.PP
.SH "وابستگی‌ها (DEPENDENCIES)"
.B gpgdir
نیازمند نصب بودن gpg، یعنی Gnu Privacy Guard
.RB ( http://www.gnupg.org )
است.
.B gpgdir
همچنین به ماژول پرل GnuPG::Interface از CPAN نیاز دارد، اما این ماژول همراه با
.B gpgdir
عرضه شده و در زمان نصب در مسیر /usr/lib/gpgdir نصب می‌شود تا درخت کتابخانه پرل سیستم آلوده نشود.

.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1)

.SH "نویسنده (AUTHOR)"
Michael Rash <mbr@cipherdyne.org>

.SH "مشارکت‌کنندگان (CONTRIBUTORS)"
افراد بسیاری که در جامعه متن‌باز فعال هستند در gpgdir مشارکت داشته‌اند؛ فایل
.B CREDITS
را در سورس‌های gpgdir ببینید.

.SH "گزارش اشکالات (BUGS)"
گزارش‌های اشکال را به mbr@cipherdyne.org ارسال کنید. پیشنهادات و/یا نظرات نیز همیشه مورد استقبال است.

.SH "توزیع (DISTRIBUTION)"
.B gpgdir
تحت مجوز عمومی گنو (GPL) توزیع شده است و آخرین نسخه ممکن است از نشانی زیر بارگیری شود:
.B http://www.cipherdyne.org