.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-public-key 1  "nethsm-key-public-key " 
.SH "نام (NAME)"
nethsm\-key\-public\-key \- دریافت کلید عمومی برای یک کلید
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key public\-key\fR [\fB\-f\fR|\fB\-\-force\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-a\fR|\fB\-\-auth\-passphrase\-file\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-l\fR|\fB\-\-label\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIKEY_ID\fR> 
.SH "توضیحات (DESCRIPTION)"
کلید عمومی را برای یک کلید دریافت می‌کند.
.PP
کلید عمومی در قالب گواهی کلید عمومی X.509 با فرمت Privacy\-enhanced Electronic Mail (PEM) بازگردانده می‌شود.
اگر فایل خروجی خاصی انتخاب نشود، کلید عمومی در خروجی استاندارد (stdout) منتشر می‌شود.
.PP
نکته: کلیدهایی از نوع «Generic» فاقد کلید عمومی هستند و این دستور برای آن‌ها با خطا مواجه می‌شود!
.PP
کاربران سراسری سیستم (System\-wide) در نقش «Administrator» یا «Operator» تنها می‌توانند کلید عمومی کلیدهای سراسری سیستم را دریافت کنند.
کاربران دارای فضای نام (Namespaced) در نقش «Administrator» یا «Operator» تنها می‌توانند کلید عمومی کلیدهای موجود در فضای نام اختصاصی خود را دریافت نمایند.
.PP
نیازمند احراز هویت کاربری در نقش «Administrator» یا «Operator» است (با دسترسی به کلید \- به «nethsm key tag» و «nethsm user tag» مراجعه کنید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-force\fR
نوشتن در فایل خروجی حتی در صورتی که از قبل وجود داشته باشد
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_FORCE\fR مشخص شود.
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
مسیر اختیاری برای یک فایل خروجی مشخص
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_PUBKEY_OUTPUT_FILE\fR مشخص شود.
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر فایلی شامل عبارت عبور برای احراز هویت

عبارت عبور ارائه‌شده در فایل باید متعلق به کاربری باشد که برای اجرای دستور انتخاب شده است.

این گزینه می‌تواند چندین بار مشخص شود که برای دستورهایی که به‌طور همزمان به چند نقش نیاز دارند کاربرد دارد.
هنگام استفاده از چند فایل عبارت عبور، ترتیب آن‌ها اهمیت دارد؛ زیرا فایل‌ها به کاربر متناظر مشخص‌شده توسط گزینهٔ «\-\-user» تخصیص می‌یابند.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_AUTH_PASSPHRASE_FILE\fR مشخص شود.
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر یک فایل پیکربندی سفارشی

در صورت تعیین، فایل پیکربندی سفارشی به‌جای مکان پیش‌فرض فایل پیکربندی استفاده می‌شود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_CONFIG\fR مشخص شود.
.RE
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
یک برچسب که دستگاه را به‌طور یکتا در فایل پیکربندی مشخص می‌کند

در صورتی که بیش از یک دستگاه در فایل پیکربندی تنظیم شده باشد، مشخص کردن آن الزامی است.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_LABEL\fR مشخص شود.
.RE
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
نام کاربری مورد استفاده برای اجرای دستور

اگر نام کاربری در فایل پیکربندی برای دستگاهی تنظیم نشده باشد، می‌تواند ارائه شود.
در صورتی که چندین نام کاربری با همان نقش هدف در فایل پیکربندی برای یک دستگاه تنظیم شده باشند، باید مشخص شود.

این گزینه می‌تواند چندین بار ارائه شود، که برای دستورهای نیازمند چندین نقش به‌طور همزمان، لازم است.

.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_USER\fR مشخص شود.
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
<\fIKEY_ID\fR>
شناسه کلیدی که کلید عمومی آن دریافت می‌شود
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBNETHSM_KEY_ID\fR مشخص شود.
.RE