.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_testparms" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" \f[B]tpm2_testparms\f[R](1) \- بررسی پشتیبانی TPM از مجموعه الگوریتم مشخص‌شده .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_testparms\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_testparms\f[R](1) \- بررسی می‌کند که آیا مجموعهٔ مشخص‌شده توسط \f[I]ALG_SPEC\f[R] برای استفاده بر پایهٔ \f[I]ALGORITHM\f[R] در دسترس است یا خیر. .PP الگوریتم‌ها باید از \[lq]استانداردهای قالب‌بندی\[rq] پیروی کنند؛ بخش \[lq]Algorithm Specifiers\[rq] را ببینید. .PP همچنین، برای مشاهدهٔ فهرستی از الگوریتم‌های هش پشتیبانی‌شده، به بخش \[lq]Supported Signing Schemes\[rq] مراجعه کنید. .SH "گزینه‌ها (OPTIONS)" این ابزار هیچ گزینهٔ اختصاصی دریافت نمی‌کند. .SS "مراجع (REFERENCES)" .SH "گزینه‌های عمومی (COMMON OPTIONS)" این مجموعه از گزینه‌ها میان بسیاری از برنامه‌ها مشترک بوده و اطلاعاتی را فراهم می‌کنند که اغلب کاربران انتظار دارند. .IP \[bu] 2 \f[B]\-h\f[R]، \f[B]\-\-help=[man|no\-man]\f[R]: نمایش صفحهٔ راهنمای (manpage) ابزار. به‌طور پیش‌فرض، تلاش می‌کند صفحه‌بندی‌کنندهٔ man (manpager) را برای ابزار فراخوانی کند، اما در صورت شکست، خلاصهٔ کوتاهی از ابزار را نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینهٔ \[lq]man\[rq] مشخص شده باشد، اما اگر \[lq]man\[rq] صراحتاً درخواست شود، ابزار خطاهای man را در stderr ارائه خواهد داد. اگر گزینهٔ \[lq]no\-man\[rq] مشخص شود، یا manpager ناموفق باشد، گزینه‌های کوتاه در stdout نمایش داده خواهند شد. .RS 2 .PP برای استفادهٔ موفقیت‌آمیز از قابلیت صفحه‌های راهنما، نیاز است manpageها نصب شده یا در \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 برای احراز هویت. یک گذرواژهٔ متنی آشکار (clear text) به TPM ارسال می‌شود تا عمل را مجاز کند. این گزینه می‌تواند برای جلوگیری از بروز مشکلات در زمان استفاده از نشست‌های بدون سالت (unsalted) در حالت FIPS مربوط به OpenSSL استفاده شود. در صورت استفاده از مقادیر auth، باید از یک نشست با سالت (salted) برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient) که توسط دستور ایجاد شده‌اند. اگر یک شیء والد از یک فایل زمینه (context) بارگیری شود، شیء والد گذرا نیز تخلیه خواهد شد. همچنین اگر متغیر محیطی TPM2TOOLS_AUTOFLUSH برابر yes یا true تنظیم شود، autoflush می‌تواند فعال گردد. .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 مترادف یکدیگرند. ماژول‌های TCTI مختلف شناخته‌شده. .RE .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 مشخص می‌شوند، الگوریتم‌های متعددی برای مقداردهی در داده‌های عمومی (public data) دارند. مواردی از قبیل نوع (type)، طرح (scheme) و جزئیات نامتقارن، اندازه کلید و غیره. قالب کلی برای تعیین این داده‌ها در زیر آمده است: \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 \- منحنی بیضوی (Elliptical Curve)، پیش‌فرض 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]Symmetric\f[R] از فهرست \f[B]مشخص‌کننده‌های نوع (Type Specifiers)\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] الگوریتم‌های رمزنگاری \f[I]ALGORITHM\f[R]. .SH "مشخص‌کننده‌های قالب امضا (Signature Format Specifiers)" انتخاب قالب برای فایل خروجی امضا. گزینهٔ \f[B]tss\f[R] (پیش‌فرض) یک حباب دادهٔ دودویی (binary blob) طبق مشخصات TPM 2.0 و هرگونه فاصله‌گذاری احتمالی کامپایلر (compiler padding) خروجی می‌دهد. گزینهٔ \f[B]plain\f[R] داده‌های خام امضا را آن‌گونه که توسط الگوریتم رمزنگاری استفاده‌شده تعریف شده است خروجی می‌دهد. .SH "مثال‌ها (EXAMPLES)" .SS بررسی پشتیبانی شدن از \[lq]rsa\[rq] .IP .EX tpm2_testparms rsa .EE .SS بررسی در دسترس بودن ECDSA با استفاده از P\-256 و حالت AES\-128 CTR .IP .EX tpm2_testparms ecc256:ecdsa:aes128ctr .EE .SH "وضعیت خروج (EXIT STATUS)" ابزارها می‌توانند هر یک از کدهای زیر را بازگردانند: .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 فهرست پستی .UE \c \& مراجعه کنید. .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی انتساب کریتیو کامنز ۴.۰ (CC BY 4.0) .UE \c \& منتشر شده است.