.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_getcap" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_getcap \- نمایش قابلیت‌های TPM در قالبی خوانا برای انسان .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_getcap\f[R] [\f[I]گزینه‌ها\f[R]] [\f[I]CAPABILITY\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_getcap\f[R](1) قابلیت‌ها / ویژگی‌های TPM را استعلام کرده و آن‌ها را در کنسول چاپ می‌کند\&. این ابزار یک فرم رشته‌ای از قابلیت مورد استعلام را به عنوان آرگومان دریافت می‌کند\&. گروه‌های قابلیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از: .IP \[bu] 2 \f[B]algorithms\f[R]: نمایش داده‌های مربوط به الگوریتم‌های پشتیبانی‌شده\&. .IP \[bu] 2 \f[B]commands\f[R]: نمایش داده‌های مربوط به دستورات پشتیبانی‌شده\&. .IP \[bu] 2 \f[B]pcrs\f[R]: نمایش PCRهای تخصیص‌یافتهٔ فعلی\&. .IP \[bu] 2 \f[B]properties\-fixed\f[R]: نمایش ویژگی‌های ثابت TPM\&. .IP \[bu] 2 \f[B]properties\-variable\f[R]: نمایش ویژگی‌های متغیر TPM\&. .IP \[bu] 2 \f[B]ecc\-curves\f[R]: نمایش داده‌های مربوط به منحنی‌های بیضوی (Elliptic Curves)\&. .IP \[bu] 2 \f[B]handles\-transient\f[R]: نمایش دستگیره‌های (handles) مربوط به اشیاء گذرا\&. .IP \[bu] 2 \f[B]handles\-persistent\f[R]: نمایش دستگیره‌های مربوط به اشیاء پایدار\&. .IP \[bu] 2 \f[B]handles\-permanent\f[R]: نمایش دستگیره‌های مربوط به اشیاء دائمی\&. .IP \[bu] 2 \f[B]handles\-pcr\f[R]: نمایش دستگیره‌های مربوط به PCRها\&. .IP \[bu] 2 \f[B]handles\-nv\-index\f[R]: نمایش دستگیره‌های مربوط به شاخص‌های NV (حافظه غیرفرار)\&. .IP \[bu] 2 \f[B]handles\-loaded\-session\f[R]: نمایش دستگیره‌های مربوط به هر دو نوع نشست‌های بارگذاری‌شدهٔ HMAC و خط‌مشی (policy)\&. .IP \[bu] 2 \f[B]handles\-saved\-session\f[R]: نمایش دستگیره‌های مربوط به نشست‌های ذخیره‌شده\&. .IP \[bu] 2 \f[B]vendor[:num]\f[R]: نمایش ویژگی‌های سازنده به عنوان خروجی بافر هگزادسیمال\&. رشتهٔ \[lq]vendor\[rq] می‌تواند با یک دونقطه و به دنبال آن عددی که توسط strtoul(3) در مبنای ۰ تفسیر می‌شود پایان یابد\&. این مقدار به عنوان مقدار ویژگی در دستور TPM2_GetCapability استفاده می‌شود و پیش‌فرض آن ۱ است\&. نمونه‌ای برای فراخوانی آن با مقدار ویژگی ۲: tpm2_getcap vendor:2 .RS 2 .PP \f[B]نکته:\f[R] اگر درخواست‌های vendor متوقف شدند، گزینهٔ \[lq]\-i\[rq] را امتحان کنید تا فیلد moreData نادیده گرفته شده و فقط یک بار خوانده شود\&. .RE .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-l\f[R]، \f[B]\-\-list\f[R]: .RS 2 .PP فهرست کردن نام قابلیت‌های پشتیبانی‌شده و شناخته‌شده\&. این نام‌ها می‌توانند به عنوان آرگومان به \f[B]tpm2_getcap\f[R](1) ارسال شوند\&. خروجی به صورت یک فهرست سازگار با YAML در خروجی استاندارد (stdout) نمایش داده می‌شود\&. .PP برای مثال: .IP .EX \- algorithms \- commands \- properties\-fixed ... .EE .RE .IP \[bu] 2 \f[B]\-\-ignore\-moredata\f[R] .PP نادیده گرفتن فیلد moreData هنگام کار با پاسخ‌های دارای اشکال TPM\&. .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)، فایل دستگاه نویسه‌ای (character 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 .SH "مثال‌ها (EXAMPLES)" .SS "برای فهرست کردن ویژگی‌های ثابت TPM" .IP .EX tpm2_getcap properties\-fixed .EE .SS "برای فهرست کردن گروه‌های قابلیت‌های پشتیبانی‌شده" .IP .EX tpm2_getcap \-l .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)" \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 "همچنین ببینید (SEE ALSO)" \f[B]tpm2\f[R](1) .SH "مجوز (LICENSE)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی Creative Commons Attribution 4.0 (CC BY 4.0) .UE منتشر شده است\&.