'\" t
.\"     Title: westcos-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 "WESTCOS\-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)"
westcos\-tool \- ابزاری برای دستکاری ساختارهای داده روی کارت‌های هوشمند westcos
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBwestcos\-tool\fR\ 'u
\fBwestcos\-tool\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBwestcos\-tool\fR
برای دستکاری ساختارهای داده westcos روی کارت‌های هوشمند / توکن‌های 2 Ko استفاده می‌شود\&. کاربران می‌توانند PINها، کلیدها و گواهی‌های ذخیره‌شده روی کارت / توکن را ایجاد کنند\&. احراز هویت PIN کاربر برای عملیاتی که به آن نیاز دارند انجام می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-\-change\-pin\fR, \fB\-n\fR
.RS 4
یک PIN ذخیره‌شده روی کارت را تغییر می‌دهد\&. احراز هویت کاربر برای این عملیات لازم است\&.
.RE
.PP
\fB\-\-certificate\fR \fIfile\fR, \fB\-t\fR \fIfile\fR
.RS 4
فایل گواهی
\fIfile\fR
را در قالب PEM روی کارت می‌نویسد\&. احراز هویت کاربر برای این عملیات لازم است\&.
.RE
.PP
\fB\-\-finalize\fR, \fB\-f\fR
.RS 4
کارت را نهایی می‌کند\&. پس از نهایی‌سازی، کلید پیش‌فرض باطل می‌شود؛ بنابراین PIN و PUK دیگر بدون احراز هویت کاربر قابل تغییر نخواهند بود\&.
.sp
هشدار: کارت‌های نهایی‌نشده ناامن هستند، چرا که PIN می‌تواند بدون احراز هویت کاربر تغییر کند (دانستن کلید پیش‌فرض کافی است)\&.
.RE
.PP
\fB\-\-generate\-key\fR, \fB\-g\fR
.RS 4
یک کلید خصوصی روی کارت تولید می‌کند\&. کارت نباید نهایی شده باشد و باید یک PIN نصب شده باشد (یعنی فایل مربوط به PIN باید ایجاد شده باشد، گزینه
\fB\-i\fR
را ببینید)\&. به‌طور پیش‌فرض، طول کلید ۲۰۴۸ بیت است\&. احراز هویت کاربر برای این عملیات لازم است\&.
.RE
.PP
\fB\-\-help\fR, \fB\-h\fR
.RS 4
پیام راهنما را روی صفحه نمایش می‌دهد\&.
.RE
.PP
\fB\-\-install\-pin\fR, \fB\-i\fR
.RS 4
فایل PIN را روی کارت نصب می‌کند\&. باید مقدار PIN را با
\fB\-x\fR
مشخص کنید\&.
.RE
.PP
\fB\-\-key\-length\fR \fIlength\fR, \fB\-l\fR \fIlength\fR
.RS 4
طول کلید خصوصی را تغییر می‌دهد\&. همراه با
\fB\-g\fR
استفاده شود\&.
.RE
.PP
\fB\-\-overwrite\-key\fR, \fB\-o\fR
.RS 4
اگر از قبل کلیدی روی کارت وجود داشته باشد، آن را رونویسی می‌کند\&.
.RE
.PP
\fB\-\-pin\-value\fR \fIpin\fR, \fB\-x\fR \fIpin\fR \fB\-\-puk\-value\fR \fIpuk\fR, \fB\-y\fR \fIpuk\fR
.RS 4
این گزینه‌ها می‌توانند برای تعیین مقادیر PIN/PUK در خط فرمان استفاده شوند\&. اگر مقدار روی
env:\fIVARIABLE\fR
تنظیم شود، مقدار متغیر محیطیِ مشخص‌شده استفاده می‌شود\&. به‌طور پیش‌فرض، در صورت نیاز مقدار کد در خط فرمان از کاربر درخواست می‌شود\&.
.sp
توجه داشته باشید که در اکثر سیستم‌عامل‌ها، هر کاربری می‌تواند خط فرمان هر فرآیندی را در سیستم با استفاده از ابزارهایی مانند
\fBps(1)\fR
مشاهده کند\&. بنابراین، در سامانه‌های ناامن بهتر است کدها را از طریق یک متغیر محیطی منتقل کنید\&.
.RE
.PP
\fB\-\-read\-file\fR \fIfilename\fR, \fB\-j\fR \fIfilename\fR
.RS 4
فایل
\fIfilename\fR
را از کارت می‌خواند\&. این فایل با نام
\fIfilename\fR
روی دیسک نوشته می‌شود\&. احراز هویت کاربر برای این عملیات لازم است\&.
.RE
.PP
\fB\-\-reader\fR \fIarg\fR, \fB\-r\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
باعث نمایش جزئیات بیشتر توسط
\fBwestcos\-tool\fR
می‌شود\&. این پرچم را چندین بار مشخص کنید تا خروجی اشکال‌زدایی در کتابخانه OpenSC فعال شود\&.
.RE
.PP
\fB\-\-wait\fR, \fB\-w\fR
.RS 4
منتظر وارد شدن کارت می‌ماند\&.
.RE
.PP
\fB\-\-write\-file\fR \fIfilename\fR, \fB\-k\fR \fIfilename\fR
.RS 4
فایل با نام
\fIfilename\fR
را از دیسک روی کارت قرار می‌دهد\&. روی کارت، این فایل در
\fIfilename\fR
نوشته می‌شود\&. احراز هویت کاربر برای این عملیات لازم است\&.
.RE
.SH "نویسندگان (AUTHORS)"
.PP
\fBwestcos\-tool\fR
توسط Francois Leblanc
<francois\&.leblanc@cev\-sa\&.com>
نوشته شده است\&.