'\" t
.\"     Title: openpgp-tool
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/02/2026
.\"    Manual: OpenSC Tools
.\"    Source: opensc
.\"  Language: English
.\"
.TH "OPENPGP\-TOOL" "1" "06/02/2026" "opensc" "OpenSC Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
openpgp-tool \- ابزاری برای دسترسی به داده‌های قابل مشاهده کارت‌های هوشمند OpenPGP و توکن‌های سازگار
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBopenpgp\-tool\fR\ 'u
\fBopenpgp\-tool\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBopenpgp\-tool\fR
برای دسترسی به داده‌های کارت‌های هوشمند OpenPGP v1\&.1 و v2\&.0 و توکن‌های سازگار مانند GPF CryptoStick v1\&.x به کار می‌رود؛ داده‌هایی که ممکن است در اشیای PKCS#15 وجود نداشته باشند اما در فایل‌های سفارشی روی کارت در دسترس باشند\&. این داده‌ها را می‌توان روی صفحه نمایش چاپ کرد یا از طریق متغیرهای محیطی توسط سایر برنامه‌ها استفاده نمود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-\-card\-info\fR, \fB\-C\fR
.RS 4
نمایش اطلاعات کارت\&.
.RE
.PP
\fB\-\-del\-key\fR \fIarg\fR
.RS 4
حذف کلید مشخص‌شده توسط
\fIarg\fR\&.
مقدار
\fIarg\fR
می‌تواند
1،
2،
3
یا
all
باشد\&.
.RE
.PP
\fB\-\-do\fR \fIarg\fR, \fB\-d\fR \fIarg\fR
.RS 4
تخلیهٔ شیء دادهٔ خصوصی (DO) مشخص‌شده توسط
\fIarg\fR\&.
برای دسترسی به
DO 010\fIx\fR،
مقدار
\fIarg\fR
می‌تواند به شکل
\fIx\fR،
10\fIx\fR
یا
010\fIx\fR
باشد، که در آن
\fIx\fR
برابر با
1،
2،
3
یا
4
است\&.
.RE
.PP
\fB\-\-erase\fR, \fB\-E\fR
.RS 4
پاک‌سازی (یعنی بازنشانی) کارت\&.
.RE
.PP
\fB\-\-exec\fR \fIprog\fR, \fB\-x\fR \fIprog\fR
.RS 4
اجرای برنامهٔ داده‌شده همراه با داده‌ها در متغیرهای محیطی\&.
.RE
.PP
\fB\-\-gen\-key\fR \fIarg\fR, \fB\-G\fR \fIarg\fR
.RS 4
تولید کلید با شناسهٔ ارائه‌شده در
\fIarg\fR\&.
مقدار
\fIarg\fR
می‌تواند یکی از مقادیر
1،
2
یا
3
باشد\&.
.RE
.PP
\fB\-\-help\fR, \fB\-h\fR
.RS 4
چاپ پیام راهنما روی صفحه نمایش\&.
.RE
.PP
\fB\-\-key\-info\fR, \fB\-K\fR
.RS 4
نمایش اطلاعات کلیدهای موجود روی کارت\&.
.RE
.PP
\fB\-\-key\-type\fR \fIkeytype\fR, \fB\-t\fR \fIkeytype\fR
.RS 4
مشخص کردن نوع کلید برای تولید\&. مقادیر پشتیبانی‌شده برای
\fIkeytype\fR
عبارت‌اند از:
rsa
برای RSA با ۲۰۴۸ بیت،
rsa\fILENGTH\fR
برای RSA با طول بیتیِ
\fILENGTH\fR\&.
در صورت مشخص نشدن، مقدار پیش‌فرض آن
rsa2048
است\&.
.RE
.PP
\fB\-\-pin\fR \fIpin\fR
.RS 4
از این گزینه می‌توان برای مشخص کردن مقدار PIN در خط فرمان استفاده کرد\&. اگر مقدار روی
env:\fIVARIABLE\fR
تنظیم شود، از مقدار متغیر محیطیِ مشخص‌شده استفاده می‌شود\&. به‌طور پیش‌فرض، در صورت نیاز کد در خط فرمان درخواست می‌شود\&.
.sp
توجه داشته باشید که در بیشتر سیستم‌عامل‌ها، هر کاربری می‌تواند با استفاده از ابزارهایی مانند
\fBps(1)\fR
خط فرمانِ هر فرایندی را روی سیستم مشاهده کند\&. بنابراین در یک سیستم ناامن، بهتر است کدها را از طریق یک متغیر محیطی ارسال کنید\&.
.RE
.PP
\fB\-\-pretty\fR
.RS 4
چاپ مقادیر در قالبی آراسته و خوانا\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
چاپ مقادیر در قالب خام، به همان شکلی که روی کارت ذخیره شده‌اند\&.
.RE
.PP
\fB\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR
.RS 4
شمارهٔ کارت‌خوان مورد استفاده\&. به‌طور پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود\&. اگر
\fIarg\fR
یک ATR باشد، کارت‌خوان دارای کارت منطبق انتخاب خواهد شد\&.
.RE
.PP
\fB\-\-user\-info\fR, \fB\-U\fR
.RS 4
نمایش اطلاعات دارندهٔ کارت\&.
.RE
.PP
\fB\-\-verify\fR \fIpintype\fR
.RS 4
اعتبارسنجی PIN (CHV1، CHV2 یا CHV3)\&.
.RE
.PP
\fB\-\-version\fR, \fB\-V\fR
.RS 4
چاپ نسخهٔ ابزار و خروج\&.
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
عملیات پرگو (همراه با جزئیات بیشتر)\&. برای فعال‌سازی خروجی اشکال‌زدایی (دیباگ) چندین بار استفاده کنید\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
انتظار برای وارد شدن کارت\&.
.RE
.SH "نویسندگان (AUTHORS)"
.PP
ابزار
\fBopenpgp\-tool\fR
توسط Peter Marschall
<peter@adpm\&.de>
نوشته شده است\&.