'\" t
.\"     Title: pkcs15-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 "PKCS15\-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)"
pkcs15-tool \- ابزاری برای دستکاری ساختارهای داده PKCS #15 بر روی کارت‌های هوشمند و توکن‌های امنیتی مشابه
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpkcs15\-tool\fR\ 'u
\fBpkcs15\-tool\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBpkcs15\-tool\fR
برای دستکاری ساختارهای داده PKCS #15 بر روی کارت‌های هوشمند و توکن‌های امنیتی مشابه استفاده می‌شود\&. کاربران می‌توانند PINها، کلیدها و گواهی‌های ذخیره‌شده بر روی توکن را فهرست کرده و بخوانند\&. احراز هویت با PIN کاربر برای آن دسته از عملیات‌هایی که به آن نیاز دارند انجام می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-\-version\fR
.RS 4
چاپ نسخه انتشار بسته OpenSC\&.
.RE
.PP
\fB\-\-aid\fR \fIaid\fR
.RS 4
مشخص کردن شناسه AID برنامه PKCS#15 روی کارت در قالب هگزادسیمال جهت اتصال به آن\&.
.RE
.PP
\fB\-\-auth\-id\fR \fIid\fR, \fB\-a\fR \fIid\fR
.RS 4
مشخص کردن شناسه احراز هویت (auth id) مربوط به PIN مورد استفاده برای عملیات\&. این گزینه همراه با عملیات \-\-change\-pin سودمند است\&.
.RE
.PP
\fB\-\-change\-pin\fR
.RS 4
تغییر دادن یک PIN یا PUK ذخیره‌شده روی توکن\&. برای این عملیات احراز هویت کاربر الزامی است\&.
.RE
.PP
\fB\-\-dump\fR, \fB\-D\fR
.RS 4
فهرست کردن تمام اشیاء کارت\&.
.RE
.PP
\fB\-\-list\-info\fR
.RS 4
فهرست کردن اطلاعات اشیاء کارت\&.
.RE
.PP
\fB\-\-list\-applications\fR
.RS 4
فهرست کردن برنامه‌های کاربردی PKCS#15 روی کارت\&.
.RE
.PP
\fB\-\-list\-certificates\fR, \fB\-c\fR
.RS 4
فهرست کردن تمام گواهی‌های ذخیره‌شده روی توکن\&.
.RE
.PP
\fB\-\-list\-data\-objects\fR, \fB\-C\fR
.RS 4
فهرست کردن تمام اشیاء داده ذخیره‌شده روی توکن\&. برای برخی کارت‌ها، ویژگی‌های PKCS#15 اشیاء داده خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند\&. در چنین حالتی باید از گزینه
\fB\-\-verify\-pin\fR
استفاده شود\&.
.RE
.PP
\fB\-\-list\-keys\fR, \fB\-k\fR
.RS 4
فهرست کردن تمام کلیدهای خصوصی ذخیره‌شده روی توکن\&. اطلاعات عمومی درباره هر کلید خصوصی فهرست می‌شود (مانند نام کلید، شناسه و الگوریتم)\&. مقادیر واقعی کلید خصوصی نمایش داده نمی‌شوند\&. برای برخی از کارت‌ها، ویژگی‌های PKCS#15 کلیدهای خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند\&. در چنین حالتی باید از گزینه
\fB\-\-verify\-pin\fR
استفاده شود\&.
.RE
.PP
\fB\-\-list\-secret\-keys\fR
.RS 4
فهرست کردن تمام کلیدهای محرمانه (متقارن) ذخیره‌شده روی توکن\&. اطلاعات عمومی درباره هر کلید محرمانه فهرست می‌شود (مانند نام کلید، شناسه و الگوریتم)\&. مقادیر واقعی کلیدهای محرمانه نمایش داده نمی‌شوند\&. برای برخی از کارت‌ها، ویژگی‌های PKCS#15 کلیدهای خصوصی برای خواندن محافظت شده‌اند و نیاز به احراز هویت با PIN کاربر دارند\&. در چنین حالتی باید از گزینه
\fB\-\-verify\-pin\fR
استفاده شود\&.
.RE
.PP
\fB\-\-list\-pins\fR
.RS 4
فهرست کردن تمام PINهای ذخیره‌شده روی توکن\&. اطلاعات عمومی درباره هر PIN فهرست می‌شود (مانند نام PIN)\&. مقادیر واقعی PIN نمایش داده نمی‌شوند\&.
.RE
.PP
\fB\-\-list\-public\-keys\fR
.RS 4
فهرست کردن تمام کلیدهای عمومی ذخیره‌شده روی توکن، شامل اطلاعات نام کلید، شناسه، الگوریتم و طول کلید\&.
.RE
.PP
\fB\-\-short\fR, \fB\-s\fR
.RS 4
خروجی فهرست‌ها در قالب فشرده\&.
.RE
.PP
\fB\-\-no\-cache\fR
.RS 4
غیرفعال کردن حافظه موقت (cache) داده‌های توکن\&.
.RE
.PP
\fB\-\-clear\-cache\fR
.RS 4
حذف دایرکتوری حافظه موقت کاربر\&. در ویندوز، این گزینه علاوه بر این دایرکتوری حافظه موقت سیستم را نیز حذف می‌کند (نیازمند مجوزهای مدیر سیستم است)\&.
.RE
.PP
\fB\-\-output\fR \fIfilename\fR, \fB\-o\fR \fIfilename\fR
.RS 4
مشخص کردن محل نوشتن خروجی کلید\&. اگر
\fIfilename\fR
از قبل وجود داشته باشد، رونویسی خواهد شد\&. اگر این گزینه ارائه نشود، کلیدها در خروجی استاندارد چاپ خواهند شد\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
تغییر نحوه چاپ محتوا در خروجی استاندارد توسط
\fB\-\-read\-data\-object\fR\&.
به‌طور پیش‌فرض، هنگامی که
\fB\-\-raw\fR
مشخص نشده باشد، محتوا در نمادگذاری هگز چاپ می‌شود\&. اگر
\fB\-\-raw\fR
تنظیم شود، داده‌های باینری را مستقیماً چاپ می‌کند\&. این بر خروجی نوشته‌شده در فایل مشخص‌شده توسط گزینه
\fB\-\-output\fR
تأثیری ندارد؛ داده‌های نوشته‌شده در فایل همیشه باینری خام خواهند بود\&.
.RE
.PP
\fB\-\-read\-certificate\fR \fIcert\fR
.RS 4
خواندن گواهی با شناسه داده‌شده\&.
.RE
.PP
\fB\-\-read\-data\-object\fR \fIdata\fR, \fB\-R\fR \fIdata\fR
.RS 4
خواندن شیء داده با OID، applicationName یا برچسب (label)\&. محتوا در خروجی استاندارد با نمادگذاری هگز چاپ می‌شود، مگر اینکه گزینه
\fB\-\-raw\fR
مشخص شده باشد\&. اگر یک فایل خروجی با گزینه
\fB\-\-output\fR
تعیین شده باشد، محتوا علاوه بر این در آن فایل نیز نوشته می‌شود\&. خروجی به فایل همیشه در حالت باینری خام نوشته می‌شود؛ گزینه
\fB\-\-raw\fR
تنها بر رفتار خروجی استاندارد تأثیر می‌گذارد\&.
.RE
.PP
\fB\-\-read\-public\-key\fR \fIid\fR
.RS 4
خواندن کلید عمومی با شناسه
\fIid\fR،
که به کاربر اجازه استخراج و ذخیره یا استفاده از کلید عمومی را می‌دهد\&.
.RE
.PP
\fB\-\-read\-ssh\-key\fR \fIid\fR
.RS 4
خواندن کلید عمومی با شناسه
\fIid\fR،
و نوشتن خروجی در قالبی مناسب برای
$HOME/\&.ssh/authorized_keys\&.
.sp
برچسب کلید (در صورت وجود) در فیلد \*(AqComment\*(Aq نمایش داده خواهد شد\&.
.PP
\fB\-\-rfc4716\fR
.RS 4
هنگامی که همراه با گزینه
\fB\-\-read\-ssh\-key\fR
استفاده شود، قالب خروجی کلید عمومی از rfc4716 پیروی می‌کند\&.
.RE
.sp
قالب خروجی پیش‌فرض تک‌خطی (openssh) است\&.
.RE
.PP
\fB\-\-test\-update\fR, \fB\-T\fR
.RS 4
بررسی اینکه آیا کارت نیاز به به‌روزرسانی امنیتی دارد یا خیر
.RE
.PP
\fB\-\-update\fR, \fB\-U\fR
.RS 4
به‌روزرسانی کارت با یک به‌روزرسانی امنیتی
.RE
.PP
\fB\-\-reader\fR \fIarg\fR
.RS 4
شماره کارت‌خوان مورد استفاده\&. به‌طور پیش‌فرض، نخستین کارت‌خوان حاوی کارت استفاده می‌شود\&. اگر
\fIarg\fR
یک ATR باشد، کارت‌خوان با کارت منطبق انتخاب خواهد شد\&.
.RE
.PP
\fB\-\-unblock\-pin\fR, \fB\-u\fR
.RS 4
رفع مسدودی یک PIN ذخیره‌شده روی توکن\&. برای این عملیات اطلاع داشتن از کلید رفع مسدودی پین (PUK) الزامی است\&.
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
موجب افزایش جزئیات خروجی
\fBpkcs15\-tool\fR
می‌شود\&. این فلگ را چندین بار مشخص کنید تا خروجی اشکال‌زدایی در کتابخانه OpenSC فعال گردد\&.
.RE
.PP
\fB\-\-pin\fR \fIpin\fR, \fB\-\-new\-pin\fR \fInewpin\fR, \fB\-\-puk\fR \fIpuk\fR
.RS 4
این گزینه‌ها می‌توانند برای مشخص کردن مقادیر PIN/PUK در خط فرمان استفاده شوند\&. اگر مقدار روی
env:\fIVARIABLE\fR
تنظیم شود، مقدار متغیر محیطی مشخص‌شده استفاده می‌شود\&. به‌طور پیش‌فرض، در صورت نیاز کد در خط فرمان درخواست می‌شود\&.
.sp
توجه داشته باشید که در بیشتر سیستم‌عامل‌ها، هر کاربری می‌تواند با استفاده از ابزارهایی مانند
\fBps(1)\fR
خط فرمان هر فرآیندی را در سیستم مشاهده کند\&. بنابراین در یک سیستم ناامن، باید ارسال کدها را از طریق متغیر محیطی ترجیح دهید\&.
.RE
.PP
\fB\-\-new\-pin\fR \fIpin\fR
.RS 4
مشخص کردن PIN جدید (هنگام تغییر یا رفع مسدودی)
.RE
.PP
\fB\-\-verify\-pin\fR
.RS 4
اعتبارسنجی PIN پس از اتصال به کارت و پیش از صدور هر فرمانی (بدون \*(Aqauth\-id\*(Aq، نخستین PIN غیر SO و غیر Unblock بررسی خواهد شد)
.RE
.PP
\fB\-\-test\-session\-pin\fR
.RS 4
معادل با
\fB\-\-verify\-pin\fR
همراه با تولید نشست PIN اضافی
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
موجب می‌شود
\fBpkcs15\-tool\fR
برای وارد شدن یک کارت منتظر بماند\&.
.RE
.PP
\fB\-\-use\-pinpad\fR
.RS 4
از کاربر سوال نشود؛ اگر PIN ارائه نشده باشد، از pinpad استفاده خواهد شد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBpkcs15-init\fR(1),
\fBpkcs15-crypt\fR(1)
.SH "نویسندگان (AUTHORS)"
.PP
\fBpkcs15\-tool\fR
توسط Juha Yrjölä
<juha\&.yrjola@iki\&.fi>
نوشته شده است\&.