.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_readclock" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_readclock \- دریافت اطلاعات زمانی از TPM .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_readclock\f[R] [\f[I]OPTIONS\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_readclock\f[R](1) ساختار فعلی TPMS_TIME_INFO را از TPM می‌خواند. این ساختار شامل تنظیمات کنونی Time، Clock، resetCount و restartCount است. این ساختار به صورت YAML در خروجی استاندارد (stdout) نمایش داده می‌شود. خروجی YAML به این صورت تعریف شده است: .IP .EX time\f[B]:\f[R] 13673142\f[I] # 64 bit value of time TPM has been powered on in ms.\f[R] clock_info\f[B]:\f[R] clock\f[B]:\f[R] 13673142\f[I] # 64 bit value of time TPM has been powered on since last TPM2_Clear in ms.\f[R] reset_count\f[B]:\f[R] 0\f[I] # 32 bit value of the number of TPM Resets since the last\f[R] \f[I] # TPM2_Clear.\f[R] restart_count\f[B]:\f[R] 0\f[I] # 32 bit value of the number of times that TPM2_Shutdown or\f[R] \f[I] # _TPM_Hash_Start have occurred since the last TPM Reset or\f[R] \f[I] # TPM2_Clear.\f[R] safe\f[B]:\f[R] yes\f[I] # boolean yes|no value that no value of Clock greater than\f[R] \f[I] # the current value of Clock has been previously reported by\f[R] \f[I] # the TPM.\f[R] .EE .PP این ابزار هیچ آرگومان و گزینهٔ خاصی دریافت نمی‌کند. .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] مشخص شود، یا صفحه‌بند راهنما با شکست مواجه گردد، گزینه‌های کوتاه در 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 برای احراز هویت. یک گذرواژهٔ متن‌آشکار (clear text) برای مجاز کردن عملیات به TPM ارسال می‌شود. این گزینه می‌تواند برای جلوگیری از مشکلات هنگام استفاده از نشست‌های بدون سالت (unsalted) در حالت OpenSSL FIPS استفاده شود. اگر مقادیر احراز هویت استفاده می‌شوند، باید از یک نشست سالت‌دار (salted) برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیهٔ خودکار (autoflush) برای اشیاء موقت (transient objects) ایجادشده توسط دستور. اگر یک شیء والد از یک فایل زمینه (context file) بارگذاری شود، شیء والد موقت نیز تخلیه خواهد شد. تخلیهٔ خودکار همچنین می‌تواند با تنظیم متغیر محیطی TPM2TOOLS_AUTOFLUSH روی yes یا true فعال شود. اطلاعاتی که ممکن است بسیاری از کاربران انتظار داشته باشند. .SH "پیکربندی TCTI (TCTI CONFIGURATION)" مفهوم TCTI یا \[lq]رابط انتقال\[rq] (Transmission Interface)، سازوکار ارتباطی با 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 مقداردهی اولیه نمی‌کند. برخی ابزارها گزینه‌های 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 و شماره درگاه (port) مورد استفاده توسط شبیه‌ساز را مشخص کرد. مقادیر پیش‌فرض 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، قالب رشتهٔ پیکربندی مجموعه‌ای از جفت‌های سادهٔ کلید\-مقدار است که با نویسهٔ \(aq,\(aq از یکدیگر جدا شده‌اند. هر رشتهٔ کلید و مقدار با نویسهٔ \(aq=\(aq از هم جدا می‌شوند. .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 "مثال‌ها (EXAMPLES)" .SS "خواندن ساعت" .IP .EX tpm2_readclock time: 13673142 clock_info: clock: 13673142 reset_count: 0 restart_count: 0 safe: yes .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 \- طرح‌وارهٔ (scheme) پشتیبانی‌نشده. قابل اعمال بر روی 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 "کپی‌رایت و تکثیر (COPYRIGHT)" این اثر تحت \c .UR https://creativecommons.org/licenses/by/4.0 مجوز بین‌المللی کریتیو کامنز ارجاع ۴.۰ (CC BY 4.0) .UE \c منتشر شده است.