.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-openpgp-sign 1  "nethsm-openpgp-sign " 
.SH "نام (NAME)"
nethsm\-openpgp\-sign \- ایجاد یک امضای OpenPGP برای یک پیام
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm openpgp sign\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> <\fIMESSAGE\fR> 
.SH "توضیحات (DESCRIPTION)"
ایجاد یک امضای OpenPGP برای یک پیام.
.PP
امضا در stdout نوشته می‌شود، مگر اینکه مسیر مشخصی به یک فایل ارائه شده باشد.
.PP
کاربران سراسری سیستم (System\-wide) با نقش «Operator» تنها می‌توانند با استفاده از کلیدهای سراسری سیستم، برای یک پیام امضای OpenPGP ایجاد کنند.
کاربران دارای فضای نام (Namespaced) با نقش «Operator» تنها می‌توانند با استفاده از کلیدهای موجود در فضای نام خودشان برای یک پیام امضای OpenPGP ایجاد کنند.
.PP
نیازمند احراز هویت کاربری با نقش «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_OPENPGP_SIGNATURE_OUTPUT_FILE\fR مشخص شود.
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر یک فایل حاوی عبارت عبور (passphrase) برای احراز هویت.

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

این گزینه می‌تواند چندین بار مشخص شود، که برای دستورهایی که به‌طور همزمان به چند نقش نیاز دارند لازم است.
با مشخص کردن چندین فایل عبارت عبور، ترتیب اهمیت دارد، زیرا فایل‌ها به کاربر مربوطه‌ای که توسط گزینهٔ «\-\-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
.TP
<\fIMESSAGE\fR>
مسیر پیامی که باید برای آن امضا ایجاد شود.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_OPENPGP_SIGNATURE_MESSAGE\fR مشخص شود.
.RE