.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "tpm2_certifyX509certutil" "1" "" "tpm2\-tools" "General Commands Manual"
.SH "نام (NAME)"
tpm2_certifyX509certutil \- ابزار کمکی گواهی‌های X.509 برای TPM2
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]tpm2_certifyX509certutil\f[R] [\f[I]گزینه‌ها\f[R]]
.SH "توضیحات (DESCRIPTION)"
دستور
\f[B]tpm2_certifyX509certutil\f[R](1)
یک گواهی جزئی تولید می‌کند که به عنوان سومین پارامتر ورودی برای دستور
\f[B]TPM2_certifyX509\f[R]
مناسب است\&.
داده‌های گواهی در یک پرونده با قالب DER نوشته می‌شوند و می‌توان آن‌ها را با استفاده از ابزار openssl asn1parse به صورت زیر بررسی کرد:
.IP
.EX
openssl asn1parse \-in partial_cert.der \-inform DER
.EE
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.IP \[bu] 2
\f[B]\-o\f[R], \f[B]\-\-outcert\f[R]=\f[I]STRING\f[R]: پرونده خروجی که گواهی در آن نوشته خواهد شد\&.
مقدار پیش‌فرض partial_cert.der است\&. پارامتر اختیاری\&.
.IP \[bu] 2
\f[B]\-d\f[R], \f[B]\-\-days\f[R]=\f[I]NUMBER\f[R]: تعداد روزهایی که گواهی از امروز معتبر خواهد بود\&.
مقدار پیش‌فرض 3560 (۱۰ سال) است\&. پارامتر اختیاری\&.
.IP \[bu] 2
\f[B]\-i\f[R], \f[B]\-\-issuer\f[R]=\f[I]STRING\f[R]: مدخل صادرکننده (ISSUER) برای گواهی در قالب زیر:
\[en]issuer=\[lq]C=US;O=org;OU=Org unit;CN=cname\[rq]
فیلدهای پشتیبانی‌شده عبارتند از:
.RS 2
.IP \[bu] 2
C \- \[lq]Country\[rq] (کشور)، حداکثر اندازه = 2
.IP \[bu] 2
O \- \[lq]Org\[rq] (سازمان)، حداکثر اندازه = 8
.IP \[bu] 2
OU \- \[lq]Org Unit\[rq] (واحد سازمانی)، حداکثر اندازه = 8
.IP \[bu] 2
CN \- \[lq]Common Name\[rq] (نام معمول)، حداکثر اندازه = 8
.RE
.IP
فیلدها باید با نقطه\-ویرگول (semicolon) از یکدیگر جدا شوند\&.
برای معتبر بودن گزینه، حداقل یک فیلد پشتیبانی‌شده الزامی است\&.
پارامتر اختیاری\&.
.IP \[bu] 2
\f[B]\-s\f[R], \f[B]\-\-subject\f[R]=\f[I]STRING\f[R]: موضوع (SUBJECT) برای گواهی در قالب زیر:
\[en]subject=\[lq]C=US;O=org;OU=Org unit;CN=cname\[rq]
فیلدهای پشتیبانی‌شده عبارتند از:
.RS 2
.IP \[bu] 2
C \- \[lq]Country\[rq] (کشور)، حداکثر اندازه = 2
.IP \[bu] 2
O \- \[lq]Org\[rq] (سازمان)، حداکثر اندازه = 8
.IP \[bu] 2
OU \- \[lq]Org Unit\[rq] (واحد سازمانی)، حداکثر اندازه = 8
.IP \[bu] 2
CN \- \[lq]Common Name\[rq] (نام معمول)، حداکثر اندازه = 8
.RE
.IP
فیلدها باید با نقطه\-ویرگول (semicolon) از یکدیگر جدا شوند\&.
برای معتبر بودن گزینه، حداقل یک فیلد پشتیبانی‌شده الزامی است\&.
پارامتر اختیاری\&.
.IP \[bu] 2
\f[B]ARGUMENT\f[R] هیچ آرگومانی نیاز نیست\&.
.SS "مراجع (References)"
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک بوده و اطلاعات مورد انتظار کاربران را فراهم می‌کنند\&.
.IP \[bu] 2
\f[B]\-h\f[R], \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنمای ابزار\&.
به‌طور پیش‌فرض، تلاش می‌کند صفحه‌خوان راهنما (manpager) را برای ابزار فراخوانی کند، با این حال در صورت شکست، خلاصه کوتاهی از ابزار را نمایش می‌دهد\&.
این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد، اما اگر صراحتاً \[lq]man\[rq] درخواست شود، ابزار خطاهای man را در خروجی خطای استاندارد (stderr) گزارش می‌کند\&.
اگر گزینه \[lq]no\-man\[rq] مشخص شود یا فراخوانی manpager شکست بخورد، گزینه‌های کوتاه در خروجی استاندارد (stdout) چاپ خواهند شد\&.
.RS 2
.PP
استفاده موفقیت‌آمیز از قابلیت صفحات راهنما نیازمند نصب بودن صفحات راهنما یا قرار داشتن آن‌ها در مسیر \f[I]MANPATH\f[R] است؛ برای جزئیات بیشتر man(1) را ببینید\&.
.RE
.IP \[bu] 2
\f[B]\-v\f[R], \f[B]\-\-version\f[R]: نمایش اطلاعات نسخه برای این ابزار، TCTIهای پشتیبانی‌شده و خروج\&.
.IP \[bu] 2
\f[B]\-V\f[R], \f[B]\-\-verbose\f[R]: افزایش اطلاعاتی که ابزار در حین اجرا در کنسول چاپ می‌کند\&.
هنگام استفاده از این گزینه، نام پرونده و شماره خط چاپ می‌شوند\&.
.IP \[bu] 2
\f[B]\-Q\f[R], \f[B]\-\-quiet\f[R]: ساکت کردن خروجی عادی ابزار به خروجی استاندارد (stdout)\&.
.IP \[bu] 2
\f[B]\-Z\f[R], \f[B]\-\-enable\-errata\f[R]: فعال‌سازی اعمال اصلاحات مربوط به اشکالات شناخته‌شده (errata fixups)\&.
زمانی مفید است که نیاز باشد یک اصلاحیه خطا روی دستورات ارسالی به TPM اعمال گردد\&.
تعریف متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این عمل است\&.
.IP \[bu] 2
\f[B]\-z\f[R], \f[B]\-\-pwd\-session\f[R]: استفاده از نشست گذرواژه به‌جای نشست HMAC برای احراز هویت\&.
یک گذرواژه متن‌آشکار به TPM ارسال می‌شود تا انجام عملیات را مجاز کند\&.
از این گزینه می‌توان برای جلوگیری از مشکلات ناشی از نشست‌های بدون سالت (unsalted) در حالت OpenSSL FIPS استفاده کرد\&.
اگر مقادیر auth به کار گرفته شوند، باید از یک نشست با سالت (salted) برای احراز هویت استفاده شود\&.
.IP \[bu] 2
\f[B]\-R\f[R], \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient) ایجادشده با این دستور\&.
اگر یک شیء والد از یک پرونده زمینه بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد\&.
تخلیه خودکار همچنین زمانی فعال می‌شود که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد\&.
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
tpm2 certifyX509certutil \-o partial_cert.der \-d 356
.EE
.SH "کدهای بازگشتی (RETURNS)"
ابزارها می‌توانند هر یک از کدهای زیر را برگردانند:
.IP \[bu] 2
0 \- موفقیت‌آمیز\&.
.IP \[bu] 2
1 \- خطای عمومی و نامشخص\&.
.IP \[bu] 2
2 \- خطای پردازش گزینه‌ها\&.
.IP \[bu] 2
3 \- خطای احراز هویت\&.
.IP \[bu] 2
4 \- خطای مرتبط با TCTI\&.
.IP \[bu] 2
5 \- طرح‌واره پشتیبانی‌نشده\&.
مربوط به tpm2_testparams\&.
.SH "اشکالات (BUGS)"
.UR https://github.com/tpm2-software/tpm2-tools/issues
اشکالات گیت‌هاب (Github Issues)
.UE
.SH "راهنما (HELP)"
نگاه کنید به \c
.UR https://lists.linuxfoundation.org/mailman/listinfo/tpm2
فهرست پستی (Mailing List)
.UE
.SH "مجوز (LICENSE)"
این اثر تحت \c
.UR https://creativecommons.org/licenses/by/4.0
مجوز بین‌المللی کریتیو کامنز ارجاع 4.0 (CC BY 4.0)
.UE
منتشر شده است\&.