.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_pcrread" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_pcrread \- خواندن مقادیر ثبات‌های پیکربندی پلتفرم TPM2 (PCR) .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_pcrread\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]PCR_LIST_OR_ALG\f[R] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_pcrread\f[R](1) مقادیر PCR را نمایش می‌دهد\&. بدون هیچ آرگومانی، \f[B]tpm2_pcrread\f[R](1) تمام ثبات‌های PCR و بانک‌های درهم‌سازی (هش) آن‌ها را خروجی می‌دهد\&. می‌توان الگوریتم هش یا فهرستی از PCRها را به عنوان یک آرگومان برای پالایش خروجی مشخص کرد\&. .PP برای اینکه فقط بانک‌های PCR دارای یک الگوریتم معین خروجی داده شوند، الگوریتم درهم‌سازی را به عنوان آرگومان مشخص کنید\&. الگوریتم‌ها باید از \[lq]استانداردهای قالب‌بندی\[rq] پیروی کنند؛ بخش \[lq]مشخص‌کننده‌های الگوریتم (Algorithm Specifiers)\[rq] را ببینید\&. همچنین، برای مشاهده فهرستی از الگوریتم‌های هش پشتیبانی‌شده، به بخش \[lq]الگوریتم‌های هش پشتیبانی‌شده (Supported Hash Algorithms)\[rq] مراجعه کنید\&. .PP برای خروجی دادن فهرستی از بانک‌های PCR (مانند sha1، sha256 و غیره) و شناسه‌ها (0، 1، 2 و غیره)، یک فهرست انتخاب PCR را به عنوان آرگومان مطابق با بخش \[lq]مشخص‌کننده‌های بانک PCR (PCR Bank Specifiers)\[rq] مشخص کنید\&. .PP همچنین بخش \f[B]نکات (NOTES)\f[R] در زیر را مطالعه کنید\&. .PP خروجی در قالب YAML به خروجی استاندارد (stdout) نوشته می‌شود که در آن هر الگوریتم به دنبال یک اندیس PCR و مقدار آن می‌آید\&. به عنوان یک مثال ساده، فرض کنید تنها از sha1 و sha256 پشتیبانی می‌شود و فقط ۱ ثبات PCR وجود دارد\&. خروجی به صورت زیر خواهد بود: .IP .EX $ tpm2_pcrread sha1:0+sha256:0 sha1 : 0 : 0000000000000000000000000000000000000003 sha256 : 0 : 0000000000000000000000000000000000000000000000000000000000000003 .EE .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-o\f[R]، \f[B]\-\-output\f[R]=\f[I]FILE\f[R]: .RS 2 .PP فایل خروجی برای نوشتن مقادیر PCR در قالب باینری (دودویی)، اختیاری است\&. .RE .IP \[bu] 2 \f[B]\-\-cphash\f[R]=\f[I]FILE\f[R] .RS 2 .PP مسیر فایل برای ثبت هش پارامترهای دستور\&. این مورد معمولاً cpHash نامیده می‌شود\&. \f[B]نکته:\f[R] هنگامی که این گزینه انتخاب شود، ابزار در واقع دستور را اجرا نمی‌کند، بلکه صرفاً یک cpHash بازمی‌گرداند\&. .RE .IP \[bu] 2 \f[B]\-S\f[R]، \f[B]\-\-session\f[R]=\f[I]FILE\f[R]: .RS 2 .PP نشست‌های کمکی را برای دستور مشخص می‌کند\&. .RE .IP \[bu] 2 \f[B]\-F\f[R]، \f[B]\-\-pcrs_format\f[R]=\f[I]FORMAT\f[R]: .RS 2 .PP انتخاب قالب برای داده باینری (blob) در فایل خروجی PCR\&. مقدار `values' دادهٔ باینری مقادیر PCR را خروجی می‌دهد\&. مقدار `serialized' یک داده باینری از مقادیر PCR را در قالب ساختار دادهٔ سریال‌شده با ترتیب بایت کم‌ارزش (little endian) می‌نویسد یا می‌خواند\&. مقدار `marshaled' یک داده باینری را در قالب باینری استفاده‌شده توسط توابع تبدیل (marshaling) و بازگردانی (unmarshaling) کتابخانه TSS2 می‌خواند یا می‌نویسد\&. اگر marshaled استفاده شود، داده‌ها به ترتیب زیر سریال‌سازی می‌شوند: TPML_PCR_SELECTION، مقدار UINT32 (تعداد عناصر متعاقب TPML_DIGEST) و سپس TPML_DIGEST [به تعداد عناصر TPML_DIGEST]\&. اختیاری\&. پیش‌فرض `values' است\&. .RE .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک هستند و اطلاعاتی را ارائه می‌دهند که بسیاری از کاربران انتظار دارند\&. .IP \[bu] 2 \f[B]\-h\f[R]، \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحه راهنمای (manpage) ابزار\&. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بند راهنما (manpager) را برای ابزار فراخوانی کند؛ اما در صورت عدم موفقیت، خلاصه‌ای کوتاه از ابزار را خروجی می‌دهد\&. این رفتار مشابه زمانی است که آرگومان گزینهٔ \[lq]man\[rq] مشخص شود، اما در صورتی که به‌طور صریح \[lq]man\[rq] درخواست شود، ابزار خطاهای man را در stderr ارائه می‌دهد\&. اگر گزینهٔ \[lq]no\-man\[rq] مشخص شود یا صفحه‌بند راهنما شکست بخورد، گزینه‌های کوتاه به 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)\&. زمانی مفید است که نیاز باشد اصلاحات errata به دستورات ارسالی به TPM اعمال شوند\&. تعریف متغیر محیطی TPM2TOOLS_ENABLE_ERRATA نیز معادل این گزینه است\&. .IP \[bu] 2 \f[B]\-z\f[R]، \f[B]\-\-pwd\-session\f[R]: استفاده از نشست گذرواژه‌ای به‌جای نشست HMAC برای احراز اصالت\&. یک گذرواژه متن‌آشکار (clear text) به TPM ارسال می‌شود تا عملیات را مجاز کند\&. این گزینه می‌تواند برای جلوگیری از مشکلات هنگام استفاده از نشست‌های بدون نمک (unsalted) در حالت OpenSSL FIPS استفاده شود\&. اگر مقادیر auth استفاده شوند، باید از یک نشست نمک‌دار (salted) برای احراز اصالت استفاده شود\&. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرای ایجادشده توسط دستور\&. اگر یک شیء والد از یک فایل بافتار بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد\&. تخلیه خودکار همچنین می‌تواند در صورتی که متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true تنظیم شده باشد، فعال گردد\&. .SH "پیکربندی TCTI (TCTI Configuration)" رابط انتقال یا TCTI مخفف \[lq]Transmission Interface\[rq]، سازوکار ارتباطی با TPM است\&. می‌توان TCTIها را برای ارتباط با TPM از طریق بسترهای مختلف تغییر داد\&. .PP برای کنترل TCTI، ابزارها موارد زیر را رعایت می‌کنند: .IP "1." 3 گزینه خط فرمان \f[B]\-T\f[R] یا \f[B]\-\-tcti\f[R] .IP "2." 3 متغیر محیطی: \f[I]TPM2TOOLS_TCTI\f[R]\&. .PP \f[B]نکته:\f[R] گزینه خط فرمان همیشه بر متغیر محیطی اولویت دارد\&. .PP TCTIهای شناخته‌شده کنونی عبارتند از: .IP \[bu] 2 tabrmd \- مدیر منابع، موسوم به \c .UR https://github.com/tpm2-software/tpm2-abrmd tabrmd .UE \c \&. توجه داشته باشید که tabrmd و abrmd به عنوان نام tcti مترادف هستند\&. .IP \[bu] 2 mssim \- معمولاً برای ارتباط با شبیه‌ساز نرم‌افزاری TPM استفاده می‌شود\&. .IP \[bu] 2 device \- هنگام برقراری ارتباط مستقیم با فایل دستگاه TPM استفاده می‌شود\&. .IP \[bu] 2 none \- هیچ اتصالی با TPM برقرار نمی‌کند\&. برخی ابزارها امکان استفاده از گزینه‌های خارج از TPM (off\-tpm) را می‌دهند و بنابراین از عدم استفاده از TCTI پشتیبانی می‌کنند\&. ابزارهایی که از آن پشتیبانی نمی‌کنند، در صورت تلاش برای استفاده بدون اتصال TCTI خطا می‌دهند\&. از \f[I]هیچ\f[R] گزینه‌ای پشتیبانی نمی‌کند و \f[I]باید حتماً\f[R] دقیقاً به صورت متن \[lq]none\[rq] ارائه شود\&. .PP آرگومان‌های ارسال‌شده به گزینه خط فرمان یا متغیر محیطی به شکل زیر هستند: .PP \f[CR]:\f[R] .PP مشخص کردن یک رشته خالی برای هر یک از \f[CR]\f[R] یا \f[CR]\f[R] باعث می‌شود که مقدار پیش‌فرض به ترتیب برای آن بخش استفاده شود\&. .SS "پیش‌فرض‌های TCTI (TCTI Defaults)" هنگامی که یک TCTI مشخص نشده باشد، TCTI پیش‌فرض با استفاده از معناشناسی \f[I]dlopen(3)\f[R] جستجو می‌شود\&. ابزارها به دنبال TCTIهای \f[I]tabrmd\f[R]، \f[I]device\f[R] و \f[I]mssim\f[R] \f[B]به همان ترتیب\f[R] می‌گردند و \f[B]از اولین موردی که یافت شد استفاده می‌کنند\f[R]\&. می‌توانید با استفاده از گزینهٔ \f[B]\-v\f[R] برای چاپ اطلاعات نسخه، بررسی کنید که کدام TCTI به عنوان پیش‌فرض انتخاب خواهد شد\&. جفت کلید\-مقدار \[lq]default\-tcti\[rq] نشان می‌دهد که کدام یک از TCTIهای یادشده پیش‌فرض است\&. .SS "TCTIهای سفارشی (Custom TCTIs)" هر TCTI که رابط پویای TCTI را پیاده‌سازی کند می‌تواند بارگذاری شود\&. ابزارها در داخل از \f[I]dlopen(3)\f[R] استفاده می‌کنند و مقدار خام \f[I]tcti\-name\f[R] برای جستجو استفاده می‌شود\&. بنابراین، این مقدار می‌تواند مسیری به کتابخانه مشترک یا نام کتابخانه‌ای باشد که بر اساس معناشناسی \f[I]dlopen(3)\f[R] قابل فهم است\&. .SH "گزینه‌های TCTI (TCTI OPTIONS)" این مجموعه از گزینه‌ها برای پیکربندی ماژول‌های مختلف TCTI شناخته‌شدهٔ موجود استفاده می‌شوند: .IP \[bu] 2 \f[B]device\f[R]: برای TCTI دستگاه (device)، فایل دستگاه نویسه‌ای TPM جهت استفاده توسط TCTI دستگاه می‌تواند مشخص شود\&. پیش‌فرض \f[I]/dev/tpm0\f[R] است\&. .RS 2 .PP مثال: \f[B]\-T device:/dev/tpm0\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]device:/dev/tpm0\[rq]\f[R] .RE .IP \[bu] 2 \f[B]mssim\f[R]: برای TCTI شبیه‌ساز mssim، نام دامنه یا آدرس IP و شماره درگاه (پورت) استفاده‌شده توسط شبیه‌ساز می‌تواند مشخص شود\&. مقادیر پیش‌فرض 127.0.0.1 و 2321 هستند\&. .RS 2 .PP مثال: \f[B]\-T mssim:host=localhost,port=2321\f[R] یا \f[B]export \f[BI]TPM2TOOLS_TCTI\f[B]=\[lq]mssim:host=localhost,port=2321\[rq]\f[R] .RE .IP \[bu] 2 \f[B]abrmd\f[R]: برای TCTI abrmd، قالب رشته پیکربندی شامل مجموعه‌ای از جفت‌های کلید\-مقدار ساده است که با نویسه `,' از هم جدا شده‌اند\&. رشته‌های هر کلید و مقدار با نویسه `=' از یکدیگر تفکیک می‌شوند\&. .RS 2 .IP \[bu] 2 ماژول TCTI abrmd از دو کلید پشتیبانی می‌کند: .RS 2 .IP "1." 3 `bus_name' : نام سرویس tabrmd روی گذرگاه (یک رشته)\&. .IP "2." 3 `bus_type' : نوع نمونه dbus (یک رشته) محدود به `session' و `system'\&. .RE .PP مشخص کردن نام tcti معادل tabrmd و رشته پیکربندی \f[CR]bus_name=com.example.FooBar\f[R]: .IP .EX \[rs]\-\-tcti=tabrmd:bus_name=com.example.FooBar .EE .PP مشخص کردن tcti پیش‌فرض (abrmd) و رشته پیکربندی \f[CR]bus_type=session\f[R]: .IP .EX \[rs]\-\-tcti:bus_type=session .EE .PP \f[B]نکته\f[R]: abrmd و tabrmd مترادف یکدیگرند\&. .RE .PP مشخص‌کننده‌های بانک PCR (PCR bank specifiers) .SH "الگوریتم‌های هش پشتیبانی‌شده (Supported Hash Algorithms)" الگوریتم‌های درهم‌سازی پشتیبانی‌شده عبارتند از: .IP \[bu] 2 \f[B]0x4\f[R] یا \f[B]sha1\f[R] برای \f[B]TPM_ALG_SHA1\f[R] .IP \[bu] 2 \f[B]0xB\f[R] یا \f[B]sha256\f[R] برای \f[B]TPM_ALG_SHA256\f[R] \f[B](پیش‌فرض)\f[R] .IP \[bu] 2 \f[B]0xC\f[R] یا \f[B]sha384\f[R] برای \f[B]TPM_ALG_SHA384\f[R] .IP \[bu] 2 \f[B]0xD\f[R] یا \f[B]sha512\f[R] برای \f[B]TPM_ALG_SHA512\f[R] .IP \[bu] 2 \f[B]0x12\f[R] یا \f[B]sm3_256\f[R] برای \f[B]TPM_ALG_SM3_256\f[R] .PP \f[B]نکته:\f[R] ممکن است TPM شما از همه الگوریتم‌ها پشتیبانی نکند\&. .SH "مشخص‌کننده‌های الگوریتم (Algorithm Specifiers)" گزینه‌هایی که الگوریتم دریافت می‌کنند از \[lq]نام‌های مناسب (nice\-names)\[rq] پشتیبانی می‌کنند\&. .PP دو رده اصلی از رشته‌های مشخص‌کننده الگوریتم وجود دارد: ساده و پیچیده\&. تنها الگوریتم‌های خاصی بر اساس کاربرد و شرایط توسط TPM پذیرفته می‌شوند\&. .SS "مشخص‌کننده‌های ساده (Simple specifiers)" این‌ها رشته‌هایی بدون داده‌های مشخص‌کننده اضافی هستند\&. هنگام ایجاد اشیاء، بخش‌های نامشخص شیء به مقادیر پیش‌فرض ارجاع داده می‌شوند\&. می‌توانید فهرست \[lq]مشخص‌کننده‌های ساده\[rq] شناخته‌شده را در زیر بیابید\&. .SS "نامتقارن (Asymmetric)" .IP \[bu] 2 rsa .IP \[bu] 2 ecc .SS "متقارن (Symmetric)" .IP \[bu] 2 aes .IP \[bu] 2 camellia .IP \[bu] 2 sm4 .SS "الگوریتم‌های درهم‌سازی (Hashing Algorithms)" .IP \[bu] 2 sha1 .IP \[bu] 2 sha256 .IP \[bu] 2 sha384 .IP \[bu] 2 sha512 .IP \[bu] 2 sm3_256 .IP \[bu] 2 sha3_256 .IP \[bu] 2 sha3_384 .IP \[bu] 2 sha3_512 .SS "درهم‌سازی کلیددار (Keyed Hash)" .IP \[bu] 2 hmac .IP \[bu] 2 xor .SS "طرح‌های امضا (Signing Schemes)" .IP \[bu] 2 rsassa .IP \[bu] 2 rsapss .IP \[bu] 2 ecdsa .IP \[bu] 2 ecdaa .IP \[bu] 2 ecschnorr .IP \[bu] 2 sm2 .SS "طرح‌های رمزنگاری نامتقارن (Asymmetric Encryption Schemes)" .IP \[bu] 2 oaep .IP \[bu] 2 rsaes .IP \[bu] 2 ecdh .SS "حالت‌ها (Modes)" .IP \[bu] 2 ctr .IP \[bu] 2 ofb .IP \[bu] 2 cbc .IP \[bu] 2 cfb .IP \[bu] 2 ecb .SS "متفرقه (Misc)" .IP \[bu] 2 null .SS "مشخص‌کننده‌های پیچیده (Complex Specifiers)" اشیاء هنگام تعیین برای ایجاد توسط TPM، دارای الگوریتم‌های متعددی هستند که باید در داده‌های عمومی مقداردهی شوند؛ مواردی مانند نوع، طرح و جزئیات نامتقارن، اندازه کلید و غیره\&. در زیر قالب کلی برای مشخص کردن این داده‌ها آمده است: \f[CR]::\f[R] .SS "مشخص‌کننده‌های نوع (Type Specifiers)" این بخش از مشخص‌کننده الگوریتم پیچیده الزامی است\&. طرح و جزئیات متقارن باقی‌مانده بر اساس نوع مشخص‌شده و نوع شیء در حال ایجاد پیش‌فرض‌گذاری می‌شوند\&. .IP \[bu] 2 aes \- مقدار پیش‌فرض AES: aes128\&. .IP \[bu] 2 aes128\f[CR]\f[R] \- الگوریتم AES با طول ۱۲۸ بیت و حالت اختیاری (\f[I]ctr\f[R]|\f[I]ofb\f[R]|\f[I]cbc\f[R]|\f[I]cfb\f[R]|\f[I]ecb\f[R])\&. اگر حالت مشخص نشود، پیش‌فرض \f[I]null\f[R] خواهد بود\&. .IP \[bu] 2 aes192\f[CR]\f[R] \- مشابه aes128\f[CR]\f[R]، به‌جز اندازه کلید ۱۹۲ بیتی\&. .IP \[bu] 2 aes256\f[CR]\f[R] \- مشابه aes128\f[CR]\f[R]، به‌جز اندازه کلید ۲۵۶ بیتی\&. .IP \[bu] 2 sm4 \- مقدار پیش‌فرض SM4: sm4128\&. .IP \[bu] 2 sm4128 یا sm4_128 \f[CR]\f[R] \- الگوریتم SM4 با طول ۱۲۸ بیت و حالت اختیاری (\f[I]ctr\f[R]|\f[I]ofb\f[R]|\f[I]cbc\f[R]|\f[I]cfb\f[R]|\f[I]ecb\f[R])\&. اگر حالت مشخص نشود، پیش‌فرض \f[I]null\f[R] خواهد بود\&. .IP \[bu] 2 ecc \- خم بیضوی، پیش‌فرض ecc256\&. .IP \[bu] 2 ecc192 یا ecc_nist_p192 \- خم بیضوی ۱۹۲ بیتی NIST ECC\&. .IP \[bu] 2 ecc224 یا ecc_nist_p224 \- خم بیضوی ۲۲۴ بیتی NIST ECC\&. .IP \[bu] 2 ecc256 یا ecc_nist_p256 \- خم بیضوی ۲۵۶ بیتی NIST ECC\&. .IP \[bu] 2 ecc384 یا ecc_nist_p384 \- خم بیضوی ۳۸۴ بیتی NIST ECC\&. .IP \[bu] 2 ecc521 یا ecc_nist_p521 \- خم بیضوی ۵۲۱ بیتی NIST ECC\&. .IP \[bu] 2 ecc_sm2 یا ecc_sm2_p256 \- خم بیضوی ۲۵۶ بیتی SM2\&. .IP \[bu] 2 rsa \- مقدار پیش‌فرض RSA: rsa2048\&. .IP \[bu] 2 rsa1024 \- الگوریتم RSA با اندازه کلید ۱۰۲۴ بیت\&. .IP \[bu] 2 rsa2048 \- الگوریتم RSA با اندازه کلید ۲۰۴۸ بیت\&. .IP \[bu] 2 rsa3072 \- الگوریتم RSA با اندازه کلید ۳۰۷۲ بیت\&. .IP \[bu] 2 rsa4096 \- الگوریتم RSA با اندازه کلید ۴۰۹۶ بیت\&. .SS "مشخص‌کننده‌های طرح (Scheme Specifiers)" فیلد بعدی اختیاری است و می‌توان از آن صرف‌نظر کرد\&. .PP طرح‌ها معمولاً \f[B]طرح‌های امضا (Signing Schemes)\f[R] یا \f[B]طرح‌های رمزنگاری نامتقارن (Asymmetric Encryption Schemes)\f[R] هستند\&. بیشتر طرح‌های امضا بلافاصله پس از طرح امضا یک الگوریتم درهم‌سازی دریافت می‌کنند\&. اگر الگوریتم درهم‌سازی ذکر نشود، پیش‌فرض \f[I]sha256\f[R] خواهد بود\&. برخی هیچ آرگومانی نمی‌پذیرند و برخی چندین آرگومان دریافت می‌کنند\&. .SS "مشخص‌کننده‌های طرح با درهم‌سازی اختیاری (Hash Optional Scheme Specifiers)" پس از این مشخص‌کننده‌های طرح، یک خط تیره و یک الگوریتم درهم‌سازی معتبر قرار می‌گیرد، برای مثال: \f[CR]oaep\-sha256\f[R]\&. .IP \[bu] 2 oaep .IP \[bu] 2 ecdh .IP \[bu] 2 rsassa .IP \[bu] 2 rsapss .IP \[bu] 2 ecdsa .IP \[bu] 2 ecschnorr .IP \[bu] 2 sm2 .SS "مشخص‌کننده‌های طرح چندگزینه‌ای (Multiple Option Scheme Specifiers)" پس از این مشخص‌کننده طرح، یک شمارنده (حداکثر اندازه UINT16) و سپس یک خط تیره (\-) و یک الگوریتم درهم‌سازی معتبر قرار می‌گیرد\&. * ecdaa برای مثال، ecdaa4\-sha256\&. اگر شمارنده‌ای مشخص نشود، پیش‌فرض ۴ خواهد بود\&. .SS "مشخص‌کننده‌های طرح بدون گزینه (No Option Scheme Specifiers)" این مشخص‌کننده طرح هیچ آرگومانی دریافت نمی‌کند\&. * rsaes .SS "مشخص‌کننده‌های جزئیات متقارن (Symmetric Details Specifiers)" این فیلد اختیاری است و بر اساس \f[I]نوع (type)\f[R] شیء در حال ایجاد و ویژگی‌های آن پیش‌فرض‌گذاری می‌شود\&. به‌طور کلی، هر مشخص‌کننده معتبر \f[B]متقارن\f[R] از فهرست \f[B]مشخص‌کننده‌های نوع\f[R] باید کار کند\&. اگر مشخص نشود، جزئیات متقارن یک شیء نامتقارن به‌طور پیش‌فرض به \f[I]aes128cfb\f[R] تنظیم می‌شود\&. .SS "مثال‌ها (Examples)" .SS "ایجاد یک کلید rsa2048 با طرح رمزنگاری نامتقارن rsaes" \f[CR]tpm2_create \-C parent.ctx \-G rsa2048:rsaes \-u key.pub \-r key.priv\f[R] .SS "ایجاد یک کلید ecc256 با طرح امضای ecdaa با شمارنده ۴ و درهم‌سازی sha384" \f[CR]/tpm2_create \-C parent.ctx \-G ecc256:ecdaa4\-sha384 \-u key.pub \-r key.priv\f[R] .SH "مثال‌ها (EXAMPLES)" .SS "نمایش تمام مقادیر PCR" .IP .EX tpm2_pcrread .EE .SS "نمایش مقادیر PCR با یک بانک مشخص" .IP .EX tpm2_pcrread sha1 .EE .SS "نمایش مقادیر PCR با بانک‌های مشخص‌شده و ذخیره در یک فایل" .IP .EX tpm2_pcrread \-o pcrs sha1:16,17,18+sha256:16,17,18 .EE .SS "نمایش الگوریتم‌های پشتیبانی‌شدهٔ بانک PCR و خروج" .IP .EX tpm2_pcrread .EE .SH "نکات (NOTES)" حداکثر تعداد ثبات‌های PCR که می‌توان در یک نوبت تخلیه (dump) کرد با حداکثر طول یک بانک در ارتباط است\&. .PP در بیشتر تراشه‌های TPM، این بدان معناست که این ابزار می‌تواند تا ۲۴ ثبات PCR را در یک نوبت تخلیه کند\&. .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)" \c .UR https://github.com/tpm2-software/tpm2-tools/issues مسائل گیت‌هاب (Github Issues) .UE \c .SH "راهنما (HELP)" مشاهدهٔ \c .UR https://lists.linuxfoundation.org/mailman/listinfo/tpm2 فهرست پستی (Mailing List) .UE \c .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی کریتیو کامنز ارجاع ۴.۰ (CC BY 4.0) .UE منتشر شده است\&.