'\" t
.\"     Title: CMSUTIL
.\"    Author: [بخش "نویسندگان" را ببینید]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net>
.\"      Date: مه ۲۰۲۵
.\"    Manual: ابزارهای امنیتی NSS
.\"    Source: nss
.\"  Language: Persian
.\"
.TH "CMSUTIL" "1" "مه ۲۰۲۵" "nss" "دستورات کاربر"
.\" -----------------------------------------------------------------
.\" * 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)"
cmsutil \- ابزار پردازش و اعتبارسنجی پیامهای رمزنگاریشده CMS
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBcmsutil\fR\ 'u
\fBcmsutil\fR [\fIگزینه‌ها\fR] [[\fIآرگومان‌ها\fR]]
.SH "وضعیت (STATUS)"
.PP
این مستندات همچنان در حال تکمیل است\&. لطفاً در بازبینی اولیه در
\m[blue]\fBخطای ۸۳۶۴۷۷ موزیلا NSS\fR\m[]\&\s-2\u[1]\d\s+2
مشارکت فرمایید\&.
.SH "توضیحات (DESCRIPTION)"
دستور \fBcmsutil\fR برای رمزگذاری، رمزگشایی، امضا و اعتبارسنجی پیامهای استاندارد Cryptographic Message Syntax (CMS) استفاده میشود.
.PP
خط فرمان
\fBcmsutil\fR
از ابزار S/MIME Toolkit برای انجام عملیات پایه‌ای مانند رمزگذاری و رمزگشایی روی پیام‌های Cryptographic Message Syntax (CMS) استفاده می‌کند\&.
.PP
برای اجرای cmsutil، دستور cmsutil option [arguments] را وارد کنید که در آن option و arguments ترکیبی از گزینه‌ها و آرگومان‌های فهرست‌شده در بخش بعدی هستند\&. هر دستور یک گزینه می‌گیرد\&. هر گزینه می‌تواند صفر یا چند آرگومان داشته باشد\&. برای دیدن نحوه استفاده، دستور را بدون گزینه اجرا کنید\&.
.SH "گزینه‌ها و آرگومان‌ها (OPTIONS AND ARGUMENTS)"
.PP
.PP
\fBگزینه‌ها\fR
.PP
گزینه‌ها یک عملیات را مشخص می‌کنند\&. آرگومان‌های گزینه عملیات را اصلاح می‌کنند\&. گزینه‌ها و آرگومان‌های دستور cmsutil به شرح زیر تعریف می‌شوند:
.PP
\-C
.RS 4
رمزگذاری یک پیام\&.
.RE
.PP
\-D
.RS 4
رمزگشایی یک پیام\&.
.RE
.PP
\-E
.RS 4
پاکت‌گذاری (Envelope) یک پیام\&.
.RE
.PP
\-O
.RS 4
ایجاد یک پیام فقط شامل گواهی‌ها (certificates-only)\&.
.RE
.PP
\-S
.RS 4
امضای یک پیام\&.
.RE
.PP
\fBآرگومان‌ها\fR
.PP
آرگومان‌های گزینه عملیات را مشخص‌تر یا اصلاح می‌کنند\&.
.PP
\-b
.RS 4
رمزگشایی دسته‌ای از فایل‌های نام‌برده‌شده در infile\&.
.RE
.PP
\-c content
.RS 4
استفاده از این محتوای جداشده (detached) (فقط رمزگشایی)\&.
.RE
.PP
\-d dbdir
.RS 4
مشخص کردن دایرکتوری پایگاه‌داده کلید/گواهی (پیش‌فرض "\&." است)\&.
.RE
.PP
\-e envfile
.RS 4
مشخص کردن فایلی حاوی یک پیام پاکت‌گذاری‌شده برای مجموعه‌ای از گیرندگان که می‌خواهید پیامی رمزگذاری‌شده به آن‌ها ارسال کنید\&. اگر این اولین پیام رمزگذاری‌شده برای آن دسته از گیرندگان باشد، پیام پاکت‌گذاری‌شده جدیدی ایجاد می‌شود که می‌توانید بعداً برای پیام‌های آتی استفاده کنید (فقط رمزگذاری)\&.
.RE
.PP
\-f pwfile
.RS 4
استفاده از فایل گذرواژه برای تنظیم گذرواژه روی تمام توکن‌های PKCS#11\&.
.RE
.PP
\-G
.RS 4
گنجاندن ویژگی زمان امضا (signing time) (فقط امضا)\&.
.RE
.PP
\-H hash
.RS 4
استفاده از الگوریتم درهم‌سازی (هش) مشخص‌شده (پیش‌فرض: SHA1)\&.
.RE
.PP
\-h num
.RS 4
ایجاد هدرهای ایمیل حاوی اطلاعات پیام CMS (فقط رمزگشایی)\&.
.RE
.PP
\-i infile
.RS 4
استفاده از infile به عنوان منبع داده (پیش‌فرض stdin است)\&.
.RE
.PP
\-k
.RS 4
نگهداری گواهی‌های رمزگذاری رمزگشایی‌شده در پایگاه‌داده دائمی گواهی‌ها\&.
.RE
.PP
\-N nickname
.RS 4
مشخص کردن نام مستعار (nickname) گواهی برای امضا (فقط امضا)\&.
.RE
.PP
\-n
.RS 4
جلوگیری از چاپ محتوا در خروجی (فقط رمزگشایی)\&.
.RE
.PP
\-o outfile
.RS 4
استفاده از outfile به عنوان مقصد داده (پیش‌فرض stdout است)\&.
.RE
.PP
\-P
.RS 4
گنجاندن مشخصه قابلیت‌های S/MIME\&.
.RE
.PP
\-p password
.RS 4
استفاده از password به عنوان گذرواژه پایگاه‌داده کلید\&.
.RE
.PP
\-r recipient1,recipient2, \&.\&.\&.
.RS 4
مشخص کردن فهرستی از گیرندگان (نشانی‌های ایمیل) برای پیام رمزگذاری‌شده یا پاکت‌گذاری‌شده\&. برای پیام‌های فقط-گواهی، فهرست گواهی‌ها جهت ارسال\&.
.RE
.PP
\-T
.RS 4
حذف محتوا از پیام CMS (فقط امضا)\&.
.RE
.PP
\-u certusage
.RS 4
تنظیم نوع کاربرد گواهی (پیش‌فرض certUsageEmailSigner است)\&.
.RE
.PP
\-v
.RS 4
چاپ اطلاعات اشکال‌زدایی (دیباگ)\&.
.RE
.PP
\-Y ekprefnick
.RS 4
مشخص کردن اولویت کلید رمزگذاری از طریق نام مستعار\&.
.RE
.SH "نحوه استفاده و مثال‌ها (USAGE)"
.PP
مثال رمزگذاری
.sp
.if n \{\
.RS 4
.\}
.nf
cmsutil \-C [\-i infile] [\-o outfile] [\-d dbdir] [\-p password] \-r "recipient1,recipient2, \&. \&. \&." \-e envfile
      
.fi
.if n \{\
.RE
.\}
.PP
مثال رمزگشایی
.sp
.if n \{\
.RS 4
.\}
.nf
cmsutil \-D [\-i infile] [\-o outfile] [\-d dbdir] [\-p password] [\-c content] [\-n] [\-h num]
      
.fi
.if n \{\
.RE
.\}
.PP
مثال پاکت‌گذاری
.sp
.if n \{\
.RS 4
.\}
.nf
cmsutil \-E [\-i infile] [\-o outfile] [\-d dbdir] [\-p password] \-r "recipient1,recipient2, \&.\&.\&."
      
.fi
.if n \{\
.RE
.\}
.PP
مثال فقط-گواهی
.sp
.if n \{\
.RS 4
.\}
.nf
cmsutil \-O [\-i infile] [\-o outfile] [\-d dbdir] [\-p password] \-r "cert1,cert2, \&. \&. \&."
      
.fi
.if n \{\
.RE
.\}
.PP
مثال امضای پیام
.sp
.if n \{\
.RS 4
.\}
.nf
cmsutil \-S [\-i infile] [\-o outfile] [\-d dbdir] [\-p password] \-N nickname[\-TGP] [\-Y ekprefnick]
      
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
certutil(1)
.SH "منابع تکمیلی (ADDITIONAL RESOURCES)"
.PP
برای کسب اطلاعات درباره NSS و سایر ابزارهای مرتبط با NSS (مانند JSS)، ویکی پروژه NSS را بررسی کنید:
\m[blue]\fBhttp://www\&.mozilla\&.org/projects/security/pki/nss\fR\m[]\&. سایت NSS مستقیماً با تغییرات کد و نسخه‌های منتشرشده NSS در ارتباط است\&.
.PP
فهرست‌های پستی: https://lists\&.mozilla\&.org/listinfo/dev\-tech\-crypto
.PP
آی‌آرسی (IRC): در Freenode کانال #dogtag\-pki
.SH "نویسندگان (AUTHORS)"
.PP
ابزارهای NSS توسط توسعه‌دهندگان Netscape، Red Hat، Sun، Oracle، Mozilla و Google نوشته و نگهداری شده‌اند\&.
.PP
نویسندگان: Elio Maldonado <emaldona@redhat\&.com>، Deon Lackey <dlackey@redhat\&.com>\&.
.SH "مجوز (LICENSE)"
.PP
تحت مجوز عمومی موزیلا نسخه ۲\&.۰ (Mozilla Public License, v\&. 2\&.0)\&. اگر نسخه‌ای از MPL همراه با این فایل توزیع نشده است، می‌توانید آن را در http://mozilla\&.org/MPL/2\&.0 دریافت کنید\&.
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
خطای ۸۳۶۴۷۷ موزیلا NSS
.RS 4
\%https://bugzilla.mozilla.org/show_bug.cgi?id=836477
.RE