'\" t
.\"     Title: piv-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 "PIV\-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)"
piv\-tool \- ابزار کارت هوشمند برای کارت‌های PIV استاندارد HSPD\-12
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpiv\-tool\fR\ 'u
\fBpiv\-tool\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBpiv\-tool\fR
می‌تواند از طریق خط فرمان برای انجام عملیات گوناگون کارت هوشمند روی یک کارت هوشمند HSPD\-12 PIV مطابق با تعریف NIST 800\-73\-3 استفاده شود\&. این ابزار تنها برای استفاده با کارت‌های آزمایشی در نظر گرفته شده است\&. از آن می‌توان برای بارگذاری شیءها، تولید جفت‌کلیدها، و همچنین ارسال دستورهای APDU دلخواه به یک کارت، پس از احراز هویت با کارت با استفاده از کلید ارائه‌شده توسط سازندهٔ کارت، استفاده کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-\-serial\fR
.RS 4
چاپ شماره سریال کارت به‌دست‌آمده از شیء CHUID، در صورت وجود\&. خروجی در قالب بایت‌های هگزادسیمال است\&.
.RE
.PP
\fB\-\-name\fR, \fB\-n\fR
.RS 4
چاپ نام کارت واردشده (درایور)
.RE
.PP
\fB\-\-admin\fR \fIآرگومان\fR, \fB\-A\fR \fIآرگومان\fR
.RS 4
احراز هویت در کارت با استفاده از یک کلید 2DES، 3DES یا AES\&.
\fIآرگومان\fR
به صورت:
.sp
.if n \{\
.RS 4
.\}
.nf
 {A|M}:\fIref\fR:\fIalg\fR
.fi
.if n \{\
.RE
.\}
.sp
الزامی است، که در آن
A
از «EXTERNAL AUTHENTICATION» و
M
از «MUTUAL AUTHENTICATION» استفاده می‌کند\&.
\fIref\fR
معمولاً
9B
است، و
\fIalg\fR
برای 3DES برابر
03،
برای 2DES برابر
01،
برای AES\-128 برابر
08،
برای AES\-192 برابر
0A
یا برای AES\-256 برابر
0C
است\&. کلید توسط سازنده کارت ارائه می‌شود\&. متغیر محیطی
\fIPIV_EXT_AUTH_KEY\fR
باید یا به یک فایل دودویی مطابق با طول کلید یا به یک فایل متنی حاوی کلید با قالب زیر اشاره کند:
XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX
.RE
.PP
\fB\-\-genkey\fR \fIآرگومان\fR, \fB\-G\fR \fIآرگومان\fR
.RS 4
تولید یک جفت‌کلید روی کارت و ارائه کلید عمومی در خروجی\&.
\fIآرگومان\fR
به صورت:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIref\fR:\fIalg\fR
.fi
.if n \{\
.RE
.\}
.sp
الزامی است، که در آن
\fIref\fR
برابر
9A،
9C،
9D
یا
9E
بوده و
\fIalg\fR
به‌ترتیب برای RSA 1024، RSA 2048، ECC 256 یا ECC 384 برابر
06،
07،
11
یا
14
است\&.
.RE
.PP
\fB\-\-object\fR \fIContainerID\fR, \fB\-O\fR \fIContainerID\fR
.RS 4
بارگذاری یک شیء روی کارت\&.
\fIContainerID\fR
مطابق با تعریف NIST 800\-73\-n بدون
0x
آغازین است\&. مثال: شیء CHUID برابر 3000 است\&.
.RE
.PP
\fB\-\-cert\fR \fIref\fR, \fB\-C\fR \fIref\fR
.RS 4
بارگذاری یک گواهی روی کارت\&.
\fIref\fR
برابر
9A،
9C،
9D
یا
9E
است\&.
.RE
.PP
\fB\-\-compresscert\fR \fIref\fR, \fB\-Z\fR \fIref\fR
.RS 4
بارگذاری یک گواهی فشرده‌شده با gzip روی کارت\&.
\fIref\fR
برابر
9A،
9C،
9D
یا
9E
است\&.
.RE
.PP
\fB\-\-out\fR \fIفایل\fR, \fB\-o\fR \fIفایل\fR
.RS 4
فایل خروجی برای هر عملیاتی که خروجی تولید می‌کند\&.
.RE
.PP
\fB\-\-in\fR \fIفایل\fR, \fB\-i\fR \fIفایل\fR
.RS 4
فایل ورودی برای هر عملیاتی که به یک فایل ورودی نیاز دارد\&.
.RE
.PP
\fB\-\-key\-slots\-discovery\fR \fIفایل\fR
.RS 4
چاپ ویژگی‌های اسلات‌های کلید\&. به احراز هویت \*(Aqadmin\*(Aq نیاز دارد\&.
.RE
.PP
\fB\-\-send\-apdu\fR \fIapdu\fR, \fB\-s\fR \fIapdu\fR
.RS 4
ارسال یک APDU دلخواه به کارت در قالب
AA:BB:CC:DD:EE:FF\&.\&.\&.\&.
این گزینه می‌تواند تکرار شود\&.
.RE
.PP
\fB\-\-reader\fR \fIآرگومان\fR, \fB\-r\fR \fIآرگومان\fR
.RS 4
شمارهٔ کارت‌خوان مورد استفاده\&. به‌طور پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود\&. اگر
\fIآرگومان\fR
یک ATR باشد، کارت‌خوان دارای کارت منطبق انتخاب خواهد شد\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
انتظار برای وارد شدن کارت
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
باعث پرگویی بیشتر
\fBpiv\-tool\fR
می‌شود\&. برای فعال‌سازی خروجی اشکال‌زدایی در کتابخانه opensc، این پرچم را چندین بار مشخص کنید\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBopensc-tool\fR(1)
.SH "نویسندگان (AUTHORS)"
.PP
\fBpiv\-tool\fR
توسط Douglas E\&. Engert
<deengert@gmail\&.com>
نوشته شده است\&.