.TH PIUS\-KEYRING\-MGR 1 "DECEMBER 2016"
.SH "نام (NAME)"
pius\-keyring\-mgr \- مدیر دسته‌کلید PIUS (امضاکننده مستقل شناسه کاربری PGP)
.SH "خلاصه دستور (SYNOPSIS)"
.B pius\-keyring\-mgr
.RI < mode >
.RI [ options ]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pius\-keyring\-mgr
دارای چندین حالت برای مدیریت دسته‌کلیدها (keyrings) است. این ابزار برای مهمانی‌های امضای کلید طراحی شده است، اما برای هر دسته‌کلید PGP دیگری نیز قابل استفاده است.
\fImode\fP
باید اولین آرگومان باشد و گزینه‌ها همان‌طور که در زیر توضیح داده شده‌اند، مشخص شوند.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-d\fP, \fB\-\-debug\fP"
فعال‌سازی خروجی اشکال‌زدایی (debugging).
.IP "\fB\-g\fP \fIPATH\fP, \fB\-\-gpg\-path=\fP\fIPATH\fP"
مسیر فایل اجرایی gpg. [پیش‌فرض: \fI/usr/bin/gpg2\fP]
.IP "\fB\-r\fP \fIKEYRING\fP, \fB\-\-keyring=\fP\fIKEYRING\fP"
استفاده از این دسته‌کلید.
.IP "\fB\-v\fP, \fB\-\-verbose\fP"
چاپ خلاصه‌ها و اطلاعات دقیق‌تر.
.SH "حالت‌ها (MODES)"
حالت \fBbuild\fP در اغلب مواقع استفاده می‌شود. این حالت می‌تواند یک فایل CSV را تجزیه کند، به‌طور خودکار به‌دنبال کلیدها بگردد و به هر فردی که کلیدش پیدا نشده ایمیل بفرستد. این حالت همچنین می‌تواند کلیدها را از یک فایل mbox وارد کند. گزینه‌ها عبارتند از:
.IP "\fB\-b\fP \fIMBOX\-FILE\fP, \fB\-\-mbox\-file=\fP\fIMBOX\-FILE\fP"
تجزیه \fIMBOX\-FILE\fP و بررسی هر پیام برای یافتن اثرانگشت‌های PGP یا کلیدهای زره‌دار اسکی (ascii-armored). در صورت نیاز پیام‌ها را رمزگشایی می‌کند.
.IP "\fB\-c\fP \fICSV\-FILE\fP, \fB\-\-csv\-file=\fP\fICSV\-FILE\fP"
تجزیه \fICSV\-FILE\fP و وارد کردن کلیدها. تقریباً به‌طور قطع به \-D، \-E، \-F و \-N نیز احتیاج خواهید داشت.
.IP "\fB\-D\fP \fIDELIMITER\fP, \fB\-\-delimiter=\fP\fIDELIMITER\fP"
جداکننده فیلد برای استفاده هنگام تجزیه فایل CSV. تنها همراه با \-c معنا دارد.
[پیش‌فرض: ',']
.IP "\fB\-E\fP \fIEMAIL\-COLUMN\fP, \fB\-\-email\-field=\fP\fIEMAIL\-COLUMN\fP"
شماره ستون حاوی آدرس ایمیل در فایل CSV. تنها همراه با \-c معنا دارد.
[پیش‌فرض: 3]
.IP "\fB\-F\fP \fIFINGERPRINT\-COLUMN\fP, \fB\-\-fp\-field=\fP\fIFINGERPRINT\-COLUMN\fP"
شماره ستون حاوی اثرانگشت GPG در فایل CSV. تنها همراه با \-c معنا دارد.
[پیش‌فرض: 4]
.IP "\fB\-m\fP \fIFROM\-EMAIL\fP, \fB\-\-mail=\fP\fIFROM\-EMAIL\fP"
ارسال ایمیل به افرادی که کلیدهایشان پیدا نشده است، با استفاده از \fIFROM\-EMAIL\fP به‌عنوان فرستنده.
.IP "\fB\-M\fP \fIFILE\fP, \fB\-\-mail\-text=\fP\fIFILE\fP"
استفاده از متن درون FILE به‌عنوان متن اصلی ایمیل هنگام ارسال، به‌جای متن پیش‌فرض. برای مشاهده متن پیش‌فرض از \-\-print\-default\-email استفاده کنید. نیازمند \-m است.
.IP "\fB\-N\fP \fINAME\-COLUMN\fP, \fB\-\-name\-field=\fP\fINAME\-COLUMN\fP"
شماره ستون حاوی نام در فایل CSV.
تنها همراه با \-c معنا دارد. [پیش‌فرض: 2]
.IP "\fB\-n\fP \fITO\-EMAIL\fP, \fB\-\-override\-email=\fP\fITO\-EMAIL\fP"
ارسال به این آدرس به‌جای ارسال به کاربر. عمدتاً برای اشکال‌زدایی کاربرد دارد.
.IP "\fB\-p\fP \fIPARTY-NAME\fP, \fB\-\-party=\fP\fIPARTY-NAME\fP"
نام مهمانی. در ایمیل ارسالی درج خواهد شد.
تنها همراه با \-m مفید است.
.IP "\fB\-s\fP \fIKEY\-SERVER\fP, \fB\-\-keyservers=\fP\fIKEY\-SERVER\fP"
آزمودن این سرور کلید. برای هر سرور یک بار مشخص کنید (\-s foo \-s bar).
[پیش‌فرض: pool.sks-keyservers.net, pgp.mit.edu, keys.gnupg.net]
.IP "\fB\-t\fP \fITEMP\-DIR\fP, \fB\-\-tmp\-dir=\fP\fITEMP\-DIR\fP"
دایرکتوری برای قرار دادن داده‌های موقت. [پیش‌فرض: \fI/tmp/pius_keyring_mgr_tmp\fP]
.IP "\fB\-T\fP, \fB\-\-print\-default\-email\fP"
چاپ متن ایمیل پیش‌فرض.
.IP "\fB\-\-ignore-emails=\fP\fIIGNORE\-EMAILS\fP"
فهرست جداشده با کاما از ایمیل‌هایی که باید نادیده گرفته شوند (بدون فاصله).
.IP "\fB\-\-ignore-fingerprints=\fP\fIIGNORE-FINGERPRINTS\fP"
فهرست جداشده با کاما از اثرانگشت‌های PGP که باید نادیده گرفته شوند (بدون فاصله).
.PP
حالت \fBprune\fP یک دسته‌کلید را باز کرده و برای هر کلید، حذف آن را جویا می‌شود. این حالت پس از یک مهمانی برای پالایش دسته‌کلید از افرادی که نیامده‌اند و پیش از توزیع دسته‌کلید میان حاضران کاربرد دارد. این حالت هیچ گزینه‌ای ندارد.
.PP
حالت \fBraw\fP گزینه‌ها را مستقیماً به gpg ارسال می‌کند. هنگام افزودن دستی کلیدها کاربرد دارد. گزینه‌های شما به گزینه‌های ضروری برای کار ایمن بر روی دسته‌کلید مهمانی اضافه می‌شوند. (دسته‌کلید شخصی شما را بارگیری نمی‌کند.) گزینه‌های شما باید پس از \(aq\-\-\(aq ارسال شوند تا از تفسیر شدن آن‌ها توسط pius\-keyring\-manager به‌عنوان گزینه‌های خودش جلوگیری شود.
.SH "مثال‌ها (EXAMPLES)"
پویش یک فایل CSV و یک فایل MBOX برای ایمیل‌ها و ارسال پیام به هر فردی که کلیدش پیدا نشد، با استفاده از you@company.com به‌عنوان فرستنده:
.PP
.nf
/usr/bin/pius\-keyring\-mgr build \-\-csv\-file /tmp/report \-\-mbox\-file
/tmp/mbox \-\-mail you@company.com
.fi
.PP
دانلود یک کلید و افزودن آن به دسته‌کلید مهمانی:
.PP
.nf
pius\-keyring\-mgr raw \-r path/to/keyring.gpg \-\- \-\-recv\-key <keyid>
.fi
.SH "نویسندگان (AUTHORS)"
ابزار PIUS توسط Phil Dibowitz <phil@ipom.com> نوشته شده است.
.PP
این صفحه راهنما توسط Felix Lechner <felix.lechner@gmail.com> برای پروژه دبیان نوشته شده است، اما ممکن است توسط دیگران نیز استفاده شود.