.TH QCATOOL "1" "August 2007" "qcatool 1.0.0" "Qt Cryptographic Architecture (QCA)"

.SH "نام (NAME)"
qcatool \- ابزار خط فرمان برای معماری رمزنگاری کیوت (QCA)

.SH "توضیحات (DESCRIPTION)"
برنامه qcatool یک ابزار خط فرمان برای انجام عملیات‌های مختلف رمزنگاری با استفاده از معماری رمزنگاری کیوت (QCA) است. همچنین می‌توان از qcatool برای آزمایش و اشکال‌زدایی QCA استفاده کرد.

.SH "نحوه استفاده (USAGE)"
برنامه qcatool دارای طیف وسیعی از گزینه‌ها و دستورها است. شما در هر بار فقط می‌توانید یک دستور را اجرا کنید، اما می‌توانید از چندین گزینه، یک گزینه یا هیچ گزینه‌ای استفاده کنید.

.SH "گزینه‌ها (OPTIONS)"
همان‌طور که در بالا اشاره شد، همه این موارد اختیاری هستند و می‌توانند با یکدیگر ترکیب شوند.
.PP
.TP
\fB\-\-pass\fR=PASSWORD
گذرواژه مورد استفاده را مشخص می‌کند. به جز در موارد آزمایشی، احتمالاً استفاده از این گزینه ایده بدی است، زیرا هر کسی می‌تواند آرگومان‌های ارائه‌شده به یک برنامه خط فرمان را بخواند.
.TP
\fB\-\-newpass\fR=PASSWORD
گذرواژه جدید را برای تغییر گذرواژه با دستورهای \fBkey changepass\fR و \fBkeybundle changepass\fR مشخص می‌کند. به جز در موارد آزمایشی، احتمالاً استفاده از این گزینه ایده بدی است، زیرا هر کسی می‌تواند آرگومان‌های ارائه‌شده به یک برنامه خط فرمان را بخواند.
.TP
\fB\-\-nonroots\fR=CERTIFICATES
گواهی‌های اضافی و غیرقابل‌اعتماد را مشخص می‌کند که در صورت امکان برقراری اعتماد مناسب، ممکن است در مسیر اعتماد (trust path) استفاده شوند.
.TP
\fB\-\-roots\fR=CERTIFICATES
گواهی‌های اضافی را مشخص می‌کند که می‌توانند به عنوان گواهی‌های معتمد (ریشه یا root) استفاده شوند.
.TP
\fB\-\-nosys\fR
استفاده از گواهی‌های ریشه استاندارد ارائه‌شده توسط سیستم‌عامل را غیرفعال می‌کند.
.TP
\fB\-\-noprompt\fR
درخواست تعاملی برای گذرواژه‌ها/عبارت‌های عبور را غیرفعال می‌کند. اگر عبارت عبور را در خط فرمان (با \fB\-\-pass\fR یا \fB\-\-newpass\fR) ارائه ندهید، در صورت نیاز به گذرواژه/عبارت عبور، این گزینه باعث می‌شود qcatool دستور را لغو کند.
.TP
\fB\-\-ordered\fR
هنگام نمایش فیلدهای اطلاعاتی گواهی (Distinguished Name و Subject Alternative Name)، آن‌ها را به همان ترتیبی که در گواهی وجود دارند نشان می‌دهد، نه با ترتیبی مرتب‌شده و کاربرپسند.
.TP
\fB\-\-debug\fR
خروجی‌های اضافی را برای کمک به اشکال‌زدایی فعال می‌کند.
.TP
\fB\-\-log-file=FILENAME\fR
ثبت لاگ در فایل مشخص‌شده.
.TP
\fB\-\-log-level=LEVEL\fR
ثبت لاگ در سطح مشخص‌شده. سطح لاگ می‌تواند بین 0 (هیچ) و 8 (بیشترین) باشد.
.TP
\fB\-\-nobundle\fR
هنگام امضای S/MIME، زنجیره گواهی امضاکننده را درون امضا قرار نمی‌دهد. این کار حجم خروجی امضا را کاهش می‌دهد، اما مستلزم آن است که گیرنده برای تأیید صحت آن، تمام گواهی‌های لازم را در اختیار داشته باشد.

.SH "دستورها (COMMANDS)"
.TP
\fBhelp\fR, \fB\-\-help\fR, \fB\-h\fR
نمایش اطلاعات راهنما و نحوه استفاده.
.TP
\fBversion\fR, \fB\-\-version\fR, \fB\-v\fR
نمایش اطلاعات نسخه.
.TP
\fBplugins\fR
فهرست کردن افزونه‌های موجود. از گزینه \fB\-\-debug\fR برای دریافت اطلاعات بیشتر درباره افزونه‌های یافت‌شده و مواردی که با موفقیت بارگذاری شده‌اند استفاده کنید.
.TP
\fBconfig save \fI[provider]\fR
ذخیره پیکربندی ارائه‌دهنده (provider). از این دستور برای نوشتن پیکربندی پیش‌فرض ارائه‌دهنده در حافظه پایدار استفاده کنید تا بتوانید بعداً آن را به صورت دستی ویرایش کنید.
.TP
\fBconfig edit \fI[provider]\fR
ویرایش پیکربندی ارائه‌دهنده. تغییرات در حافظه پایدار ذخیره می‌شوند.
.TP
\fBkey make rsa|dsa [bits]\fR
ایجاد یک جفت‌کلید.
.TP
\fBkey changepass [K]\fR
افزودن/تغییر/حذف عبارت عبور یک کلید.
.TP
\fBcert makereq [K]\fR
ایجاد درخواست گواهی (CSR).
.TP
\fBcert makeself [K]\fR
ایجاد گواهی خودامضا (self-signed).
.TP
\fBcert makereqadv [K]\fR
نسخه پیشرفته دستور 'makereq'.
.TP
\fBcert makeselfadv [K]\fR
نسخه پیشرفته دستور 'makeself'.
.TP
\fBcert validate [C]\fR
اعتبارسنجی گواهی.
.TP
\fBkeybundle make [K] [C]\fR
ایجاد یک دسته کلید (keybundle).
.TP
\fBkeybundle extract [X]\fR
استخراج گواهی(ها) و کلید.
.TP
\fBkeybundle changepass [X]\fR
تغییر عبارت عبور یک دسته کلید.
.TP
\fBkeystore list-stores\fR
فهرست کردن تمام مخازن کلید (keystores) موجود.
.TP
\fBkeystore list [storeName]\fR
فهرست کردن محتوای یک مخزن کلید.
.TP
\fBkeystore monitor\fR
پایش در دسترس بودن مخزن کلید.
.TP
\fBkeystore export [E]\fR
برون‌بری محتوای یک مدخل از مخزن کلید.
.TP
\fBkeystore exportref [E]\fR
برون‌بری ارجاع یک مدخل از مخزن کلید.
.TP
\fBkeystore addkb [storeName] [cert.p12]\fR
افزودن یک دسته کلید به مخزن کلید.
.TP
\fBkeystore addpgp [storeName] [key.asc]\fR
افزودن یک کلید PGP به مخزن کلید.
.TP
\fBkeystore remove [E]\fR
حذف یک شیء از مخزن کلید.
.TP
\fBshow cert [C]\fR
بررسی یک گواهی.
.TP
\fBshow req [req.pem]\fR
بررسی یک درخواست گواهی (CSR).
.TP
\fBshow crl [crl.pem]\fR
بررسی یک لیست ابطال گواهی (CRL).
.TP
\fBshow kb [X]\fR
بررسی یک دسته کلید.
.TP
\fBshow pgp [P|S]\fR
بررسی یک کلید PGP.
.TP
\fBmessage sign pgp|pgpdetach|smime [X|S]\fR
امضای یک پیام.
.TP
\fBmessage encrypt pgp|smime [C|P]\fR
رمزگذاری یک پیام.
.TP
\fBmessage signencrypt [S] [P]\fR
امضا و رمزگذاری PGP یک پیام.
.TP
\fBmessage verify pgp|smime\fR
تأیید صحت یک پیام.
.TP
\fBmessage decrypt pgp|smime ((X) ...)\fR
رمزگشایی یک پیام (S/MIME به X نیاز دارد).
.TP
\fBmessage exportcerts\fR
برون‌بری گواهی‌ها از پیام S/MIME.

.SH "آرگومان‌ها (ARGUMENTS)"
آرگومان‌های دستورها به شرح زیر هستند:
.PP
K = کلید خصوصی (private key).
.PP
C = گواهی (certificate).
.PP
X = دسته کلید (key bundle).
.PP
P = کلید عمومی PGP.
.PP
S = کلید مخفی PGP.
.PP
E = مدخل عمومی (generic entry).
.PP
این موارد باید توسط یک نام فایل یا یک ارجاع به مخزن کلید ("store:obj") مشخص شوند.

.SH "نویسنده (AUTHOR)"
برنامه qcatool توسط Justin Karneges به عنوان بخشی از QCA نوشته شده است. این صفحه راهنما توسط Brad Hards نوشته شده است.