'\" t .\" Title: p11-kit .\" Author: Stef Walter .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/06/2026 .\" Manual: دستورات سیستمی .\" Source: p11-kit .\" Language: Persian .\" .TH "P11\-KIT" "8" "" "p11-kit" "دستورات سیستمی" .\" ----------------------------------------------------------------- .\" * 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)" p11-kit \- ابزار مدیریت ماژولهای PKCS#11 .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBp11\-kit\ list\-modules\fR\ 'u \fBp11\-kit list\-modules\fR .HP \w'\fBp11\-kit\ list\-tokens\ \&.\&.\&.\fR\ 'u \fBp11\-kit list\-tokens \&.\&.\&.\fR .HP \w'\fBp11\-kit\ list\-objects\ \&.\&.\&.\fR\ 'u \fBp11\-kit list\-objects \&.\&.\&.\fR .HP \w'\fBp11\-kit\ import\-object\ \&.\&.\&.\fR\ 'u \fBp11\-kit import\-object \&.\&.\&.\fR .HP \w'\fBp11\-kit\ export\-object\ \&.\&.\&.\fR\ 'u \fBp11\-kit export\-object \&.\&.\&.\fR .HP \w'\fBp11\-kit\ delete\-object\ \&.\&.\&.\fR\ 'u \fBp11\-kit delete\-object \&.\&.\&.\fR .HP \w'\fBp11\-kit\ generate\-keypair\ \&.\&.\&.\fR\ 'u \fBp11\-kit generate\-keypair \&.\&.\&.\fR .HP \w'\fBp11\-kit\ list\-profiles\ \&.\&.\&.\fR\ 'u \fBp11\-kit list\-profiles \&.\&.\&.\fR .HP \w'\fBp11\-kit\ add\-profile\ \&.\&.\&.\fR\ 'u \fBp11\-kit add\-profile \&.\&.\&.\fR .HP \w'\fBp11\-kit\ delete\-profile\ \&.\&.\&.\fR\ 'u \fBp11\-kit delete\-profile \&.\&.\&.\fR .HP \w'\fBp11\-kit\ list\-mechanisms\ \&.\&.\&.\fR\ 'u \fBp11\-kit list\-mechanisms \&.\&.\&.\fR .HP \w'\fBp11\-kit\ print\-config\fR\ 'u \fBp11\-kit print\-config\fR .HP \w'\fBp11\-kit\ extract\ \&.\&.\&.\fR\ 'u \fBp11\-kit extract \&.\&.\&.\fR .HP \w'\fBp11\-kit\ server\ \&.\&.\&.\fR\ 'u \fBp11\-kit server \&.\&.\&.\fR .SH "توضیحات (DESCRIPTION)" .PP دستور \fBp11\-kit\fR یک ابزار خط فرمان است که می‌توان از آن برای انجام عملیات روی ماژول‌های PKCS#11 پیکربندی‌شده روی سیستم استفاده کرد\&. .PP زیردستورهای گوناگون در ادامه آورده شده‌اند\&. گزینه‌های عمومی زیر را می‌توان به کار برد: .PP \fB\-v, \-\-verbose\fR .RS 4 اجرا در حالت پرگو همراه با خروجی رفع اشکال (debug)\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 اجرا در حالت ساکت بدون پیام‌های هشدار یا خطا\&. .RE .SH "فهرست ماژول‌ها (LIST MODULES)" .PP فهرست کردن ماژول‌های PKCS#11 پیکربندی‌شده روی سیستم\&. .sp .if n \{\ .RS 4 .\} .nf $ p11\-kit list\-modules .fi .if n \{\ .RE .\} .PP ماژول‌ها، اطلاعات مربوط به آن‌ها و توکن‌های موجود در ماژول‌های PKCS#11 نمایش داده خواهند شد\&. .SH "فهرست توکن‌ها (LIST TOKENS)" .PP فهرست کردن تمام توکن‌های موجود در ماژول‌های PKCS#11 پیکربندی‌شده روی سیستم\&. .sp .if n \{\ .RS 4 .\} .nf $ p11\-kit list\-tokens pkcs11:token .fi .if n \{\ .RE .\} .PP این دستور تمام توکن‌ها را بازیابی کرده و برخی از ویژگی‌های مشترک آن‌ها را نمایش می‌دهد\&. .PP این زیردستور گزینه‌های زیر را می‌پذیرد: .PP \fB\-\-only\-uris\fR .RS 4 تنها چاپ کردن URIهای توکن منطبق\&. .RE .PP \fB\-\-provider=\fR .RS 4 بارگذاری تنها ماژول PKCS#11 داده‌شده به جای برشمردن ماژول‌های نصب‌شده روی سیستم\&. اگر \fImodule_path\fR یک مسیر نسبی باشد، ماژول از مسیر پیش‌فرض ماژول‌ها بارگذاری می‌شود\&. این مسیر را می‌توان با اجرای دستور زیر مشخص کرد: .sp .if n \{\ .RS 4 .\} .nf $ \fBpkg\-config p11\-kit\-1 \-\-variable p11_module_path\fR /usr/lib64/pkcs11 .fi .if n \{\ .RE .\} .RE .SH "فهرست اشیاء (LIST OBJECTS)" .PP فهرست کردن اشیاء منطبق با PKCS#11 URI داده‌شده\&. .sp .if n \{\ .RS 4 .\} .nf $ p11\-kit list\-objects pkcs11:object_on_token .fi .if n \{\ .RE .\} .PP این دستور تمام اشیایی را که با PKCS#11 URI داده‌شده تطابق دارند بازیابی کرده و برخی از ویژگی‌های مشترک آن‌ها را نمایش می‌دهد\&. اشیاء ذخیره‌سازی نیز PKCS#11 URI آن‌ها نمایش داده می‌شود\&. .PP این زیردستور گزینه‌های زیر را می‌پذیرد: .PP \fB\-\-login\fR .RS 4 احراز هویت در توکن پیش از برشمردن اشیاء\&. مقدار PIN از مشخصه pin\-value در URI یا از ترمینال خوانده می‌شود\&. .RE .PP \fB\-\-provider=\fR .RS 4 بارگذاری تنها ماژول PKCS#11 داده‌شده به جای برشمردن ماژول‌های نصب‌شده روی سیستم\&. اگر \fImodule_path\fR یک مسیر نسبی باشد، ماژول از مسیر پیش‌فرض ماژول‌ها بارگذاری می‌شود\&. این مسیر را می‌توان با اجرای دستور زیر مشخص کرد: .sp .if n \{\ .RS 4 .\} .nf $ \fBpkg\-config p11\-kit\-1 \-\-variable p11_module_path\fR /usr/lib64/pkcs11 .fi .if n \{\ .RE .\} .RE .SH "وارد کردن شیء (IMPORT OBJECT)" .PP وارد کردن شیء به توکن PKCS#11\&. .sp .if n \{\ .RS 4 .\} .nf $ p11\-kit import\-object \-\-file=file\&.pem [\-\-label=label] [\-\-id=object_id] pkcs11:token .fi .if n \{\ .RE .\} .PP یک گواهی X\&.509 یا یک کلید عمومی را در قالب یک فایل PEM دریافت کرده و آن را به نخستین توکن منطبق با PKCS#11 URI داده‌شده وارد می‌کند\&. .PP گزینه‌های زیر الزامی هستند: .PP \fB\-\-file=\fR .RS 4 فایل حاوی یک گواهی X\&.509 یا یک کلید عمومی در قالب PEM\&. .RE .PP این زیردستور همچنین گزینه‌های زیر را می‌پذیرد: .PP \fB\-\-label=