'\" t
.\"     Title: netkey-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: Persian
.\"
.TH "NETKEY\-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)"
netkey-tool \- ابزار مدیریتی برای کارت‌های Netkey E4
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnetkey\-tool\fR\ 'u
\fBnetkey\-tool\fR [\fIOPTIONS\fR] [\fICOMMAND\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
از ابزار
\fBnetkey\-tool\fR
می‌توان در خط فرمان برای انجام برخی عملیات‌های کارت هوشمند با کارت‌های NetKey E4 استفاده کرد که با دیگر ابزارهای OpenSC به‌سادگی امکان‌پذیر نیستند؛ از جمله تغییر PINهای محلی، ذخیره گواهی‌ها در فایل‌های گواهی خالی NetKey E4 یا نمایش مقدار اولیه PUK\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-\-help\fR, \fB\-h\fR
.RS 4
پیام راهنمای کوتاهی را نمایش می‌دهد\&.
.RE
.PP
\fB\-\-pin\fR \fIpin\fR, \fB\-p\fR \fIpin\fR
.RS 4
مقدار کنونی PIN سراسری (global PIN) را مشخص می‌کند\&.
.RE
.PP
\fB\-\-puk\fR \fIpin\fR, \fB\-u\fR \fIpin\fR
.RS 4
مقدار کنونی PUK سراسری (global PUK) را مشخص می‌کند\&.
.RE
.PP
\fB\-\-pin0\fR \fIpin\fR, \fB\-0\fR \fIpin\fR
.RS 4
مقدار کنونی PIN0 محلی (معروف به PIN محلی) را مشخص می‌کند\&.
.RE
.PP
\fB\-\-pin1\fR \fIpin\fR, \fB\-1\fR \fIpin\fR
.RS 4
مقدار کنونی PIN1 محلی (معروف به PUK محلی) را مشخص می‌کند\&.
.RE
.PP
\fB\-\-reader\fR \fIarg\fR, \fB\-r\fR \fIarg\fR
.RS 4
شماره کارت‌خوان مورد استفاده\&. به‌طور پیش‌فرض، نخستین کارت‌خوانی که کارتی در آن قرار دارد استفاده می‌شود\&. اگر
\fIarg\fR
یک ATR باشد، کارت‌خوانی با کارت منطبق انتخاب خواهد شد\&.
.RE
.PP
\fB\-v\fR
.RS 4
موجب افزایش جزئیات خروجی
\fBnetkey\-tool\fR
می‌شود\&. این گزینه می‌تواند چندین بار تکرار شود تا سطح پرگویی بالاتر برود\&.
.RE
.SH "قالب PIN (PIN FORMAT)"
.PP
با گزینه‌های
\fB\-p\fR،
\fB\-u\fR،
\fB\-0\fR
یا
\fB\-1\fR
می‌توان یکی از pinهای کارت را مشخص کرد\&. می‌توانید از رشته‌های متنی اسکی (ascii) ساده (مانند 123456) یا رشته‌های هگزادسیمال (مانند 31:32:33:34:35:36) استفاده کنید\&. یک رشته هگزادسیمال باید دقیقاً از n عدد هگز ۲ رقمی تشکیل شده باشد که با n\-1 دونقطه از یکدیگر جدا شده‌اند\&. در غیر این صورت به عنوان یک رشته ascii تفسیر خواهد شد\&. برای نمونه :12:34: و 1:2:3:4 هر دو pinهایی با طول ۷ هستند، در حالی که 12:34 و 01:02:03:04 pinهایی به طول ۲ و ۴ می‌باشند\&.
.SH "دستورها (COMMANDS)"
.PP
هنگامی که
\fBnetkey\-tool\fR
بدون هیچ گزینه یا دستوری به کار رود، اطلاعاتی در مورد pinها و گواهی‌های کارت هوشمند نمایش می‌دهد\&. این کار هیچ تغییری در وضعیت کارت شما ایجاد نخواهد کرد (به فرض اینکه نقصی در
\fBnetkey\-tool\fR
وجود نداشته باشد)\&. به‌ویژه شمارنده‌های تلاش‌های باقیمانده pinها بدون انجام اعتبارسنجی واقعی بررسی می‌شوند\&.
.PP
اگر PIN سراسری را با گزینه
\fB\-\-pin\fR
مشخص کنید،
\fBnetkey\-tool\fR
مقدار اولیه PUK سراسری کارت را نیز نمایش خواهد داد\&. اگر PUK سراسری شما تغییر کرده باشد،
\fBnetkey\-tool\fR
همچنان مقدار اولیه آن را نمایش می‌دهد\&. هیچ راهی برای بازیابی یک PUK سراسری گم‌شده پس از تغییر آن وجود ندارد\&. همچنین هیچ راهی برای نمایش مقدار اولیه PUK سراسری بدون دانستن مقدار کنونی PIN سراسری وجود نخواهد داشت\&.
.PP
برای بیشتر دستورهایی که
\fBnetkey\-tool\fR
می‌تواند اجرا کند، باید یک pin را مشخص کنید\&. یک استثنای قابل توجه دستور
\fBnullpin\fR
است، اما این دستور فقط یک بار در طول عمر کارت NetKey E4 قابل اجراست\&.
.PP
.PP
\fBcert\fR \fInumber\fR \fIfilename\fR
.RS 4
این دستور یکی از گواهی‌های کارت شما را (همان‌طور که توسط
\fInumber\fR
مشخص شده) می‌خواند و آن را در قالب PEM در فایل
\fIfilename\fR
ذخیره می‌کند\&. گواهی‌های روی کارت NetKey E4 بدون نیاز به pin خواندنی هستند، بنابراین نیازی به مشخص کردن pin ندارید\&.
.RE
.PP
\fBcert\fR \fIfilename\fR \fInumber\fR
.RS 4
این دستور نخستین گواهی کدگذاری‌شده با PEM را از فایل
\fIfilename\fR
می‌خواند و آن را در فایل گواهی
\fInumber\fR
کارت هوشمند شما ذخیره می‌کند\&. برخی از فایل‌های گواهی کارت هوشمند شما ممکن است فقط‌خواندنی باشند، بنابراین این عمل با تمام مقادیر
\fInumber\fR
کار نخواهد کرد\&. اگر یک فایل گواهی قابل نوشتن باشد، برای تغییر آن باید یک pin مشخص کنید\&. اگر سعی کنید بدون مشخص کردن pin از این دستور استفاده کنید،
\fBnetkey\-tool\fR
به شما خواهد گفت که به کدام pin نیاز است\&.
.RE
.PP
\fBchange\fR {pin | puk | pin0 | pin1} \fInew\-pin\fR
.RS 4
این دستور مقدار pin مشخص‌شده را به مقدار جدید داده‌شده تغییر می‌دهد\&. برای انجام این کار باید یا مقدار کنونی همان pin یا pin دیگری را مشخص کنید، و اگر pin درست را تعیین نکنید،
\fBnetkey\-tool\fR
اعلام خواهد کرد که کدام مورد نیاز است\&.
.RE
.PP
\fBnullpin\fR \fIinitial\-pin\fR
.RS 4
این دستور تنها در صورتی قابل اجرا است که PIN سراسری کارت شما در وضعیت nullpin باشد\&. پس از آنکه PIN سراسری خود را تغییر دادید، هیچ راهی برای بازگشت به وضعیت nullpin وجود ندارد\&. برای اجرای دستور nullpin نیازی به pin ندارید\&. پس از اجرای موفقیت‌آمیز دستور nullpin، ابزار
\fBnetkey\-tool\fR
مقدار اولیه PUK کارت شما را نمایش خواهد داد\&.
.RE
.PP
\fBunblock\fR {pin | pin0 | pin1}
.RS 4
این دستور قفل pin مشخص‌شده را باز می‌کند\&. برای این کار باید pin دیگری را مشخص کنید و در صورتی که مورد درستی را تعیین نکنید،
\fBnetkey\-tool\fR
به شما اعلام می‌کند که کدام pin مورد نیاز است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBopensc-explorer\fR(1)
.SH "نویسندگان (AUTHORS)"
.PP
\fBnetkey\-tool\fR
توسط Peter Koch
<pk_opensc@web\&.de>
نوشته شده است\&.