.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-key-list 1  "nethsm-key-list"
.SH "نام (NAME)"
nethsm\-key\-list \- نمایش فهرست شناسه‌ها و برچسب‌های کلیدهای موجود در NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm key list\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] [\fIFILTER\fR]
.SH "توضیحات (DESCRIPTION)"
نمایش فهرست همهٔ شناسه‌های کلیدها.
.PP
فیلتر کردن اختیاری فهرست شناسه‌های کلیدها با استفاده از یک کلیدواژه.
.PP
کاربران سراسری سیستم با نقش «مدیر» (Administrator) یا «اپراتور» (Operator) صرفاً می‌توانند کلیدهای سراسری را فهرست کنند.
کاربران دارای فضای نام (Namespaced) با نقش «مدیر» یا «اپراتور» صرفاً مجاز به فهرست کردن کلیدهای فضای نام خود هستند.
.PP
نیازمند احراز هویت کاربری با نقش «Administrator» یا «Operator» است (با دسترسی به کلید \- به «nethsm key tag» و «nethsm user tag» مراجعه کنید).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر پرونده حاوی عبارت عبور جهت احراز هویت.
.PP
عبارت عبور ارائه‌شده در پرونده باید متعلق به کاربری باشد که برای اجرای دستور انتخاب شده است.
.PP
این گزینه را می‌توان چندین بار مشخص کرد، که برای دستورهایی که به چند نقش همزمان نیاز دارند لازم است.
در صورت استفاده از چندین پرونده عبارت عبور، ترتیب قرارگیری آن‌ها اهمیت دارد؛ زیرا پرونده‌ها به کاربر متناظر ارائه‌شده توسط گزینهٔ «\-\-user» اختصاص می‌یابند.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_AUTH_PASSPHRASE_FILE\fR قابل تنظیم است.
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر پرونده پیکربندی سفارشی.
.PP
در صورت مشخص شدن، پرونده پیکربندی سفارشی به‌جای مسیر پیش‌فرض پرونده پیکربندی استفاده می‌شود.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_CONFIG\fR قابل تنظیم است.
.RE
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
برچسب یکتا برای شناسایی دستگاه در پرونده پیکربندی.
.PP
اگر بیش از یک دستگاه در پرونده پیکربندی تنظیم شده باشد، ارائهٔ این گزینه الزامی است.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_LABEL\fR قابل تنظیم است.
.RE
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
نام کاربری مورد استفاده جهت اجرای دستور.
.PP
اگر هیچ نام کاربری در پرونده پیکربندی برای دستگاه تنظیم نشده باشد، می‌توان این گزینه را ارائه داد.
اگر چندین نام کاربری با همان نقش هدف در پرونده پیکربندی برای دستگاه تنظیم شده باشد، ارائهٔ این گزینه الزامی است.
.PP
این گزینه را می‌توان چندین بار مشخص کرد، که برای دستورهایی که به چند نقش همزمان نیاز دارند لازم است.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_USER\fR قابل تنظیم است.
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما (مشاهدهٔ خلاصه با \*(Aq\-h\*(Aq).
.TP
[\fIFILTER\fR]
فیلتری برای اعمال بر فهرست شناسه‌های کلیدها.
.RS
همچنین از طریق متغیر محیطی \fBNETHSM_KEY_ID_FILTER\fR قابل تنظیم است.
.RE