.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_setcommandauditstatus" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_setcommandauditstatus \- افزودن یا حذف دستورات TPM2 از فهرست دستورات مورد حسابرسی .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_setcommandauditstatus\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" \f[B]tpm2_setcommandauditstatus\f[R](1) \- دستورات TPM2 را به فهرست دستورات حسابرسی‌شده (audited) اضافه یا از آن حذف می‌کند. .PP این دستور به عنوان یک آرگومان، دستور مورد نظر را در قالب یک عدد صحیح یا مقدار رشته‌ای کاربرپسند دریافت می‌کند. نگاشت رشته کاربرپسند به COMMAND CODE را می‌توان در بخش \f[I]COMMAND CODE MAPPINGS\f[R] یافت. .SH "گزینه‌ها (OPTIONS)" .IP \[bu] 2 \f[B]\-C\f[R], \f[B]\-\-hierarchy\f[R]=\f[I]OBJECT\f[R]: .RS 2 .PP سلسله‌مراتب مالک (owner) یا پلتفرم (platform) را مشخص می‌کند. در صورتی که هیچ مقداری مشخص نشده باشد، مقدار پیش‌فرض \f[B]TPM_RH_OWNER\f[R] است. گزینه‌های پشتیبانی‌شده عبارتند از: .IP \[bu] 2 \f[B]o\f[R] برای \f[B]TPM_RH_OWNER\f[R] .IP \[bu] 2 \f[B]p\f[R] برای \f[B]TPM_RH_PLATFORM\f[R] .RE .IP \[bu] 2 \f[B]\-P\f[R], \f[B]\-\-hierarchy\-auth\f[R]=\f[I]AUTH\f[R]: مقدار احراز هویت (authorization) را برای سلسله‌مراتب مشخص می‌کند. مقادیر احراز هویت باید از \[lq]استانداردهای قالب‌بندی مجوز\[rq] پیروی کنند، بخش \[lq]Authorization Formatting\[rq] را ببینید. .IP \[bu] 2 \f[B]\-c\f[R], \f[B]\-\-clear\-list\f[R]: مشخص می‌کند که دستور TPM تعیین‌شده باید از فهرست حسابرسی برداشته شود. در صورت عدم تعیین، رفتار پیش‌فرض افزودن دستور TPM به فهرست حسابرسی است. .IP \[bu] 2 \f[B]\-g\f[R], \f[B]\-\-hash\-algorithm\f[R]=\f[I]ALGORITHM\f[R]: .RS 2 .PP الگوریتم درهم‌سازی را برای خلاصه حسابرسی (audit digest) تنظیم می‌کند. در صورت عدم تعیین، الگوریتم پیش‌فرض خلاصه حسابرسی بر روی SHA256 تنظیم می‌شود. .RE .IP \[bu] 2 \f[B]ARGUMENT\f[R] آرگومان خط فرمان، کد دستور TPM2 را مشخص می‌کند. .SS "مراجع (REFERENCES)" .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] مشخص شده باشد، یا فراخوانی 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، باید از یک نشست دارای سالت برای احراز هویت استفاده شود. .IP \[bu] 2 \f[B]\-R\f[R], \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیاء گذرا (transient) ایجاد شده توسط دستور. اگر یک شیء والد از فایل زمینه (context) بارگیری شود، شیء والد گذرا نیز تخلیه خواهد شد. تخلیه خودکار همچنین در صورتی که متغیر محیطی TPM2TOOLS_AUTOFLUSH بر روی yes یا true تنظیم شده باشد فعال می‌شود. اطلاعاتی که ممکن است بسیاری از کاربران انتظار آن را داشته باشند. .SH "پیکربندی TCTI (TCTI CONFIGURATION)" رابط TCTI یا \[lq]رابط انتقال\[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]: برای device TCTI، می‌توان فایل دستگاه نویسه‌ای TPM را برای استفاده توسط device 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]: برای mssim TCTI، می‌توان نام دامنه یا نشانی 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]: برای abrmd TCTI، قالب رشته پیکربندی مجموعه‌ای از جفت‌های کلید\-مقدار ساده است که با نویسه `,' از یکدیگر تفکیک شده‌اند. هر رشته کلید و مقدار با نویسه `=' از هم جدا می‌شوند. .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 تعیین نام tabrmd tcti و رشته پیکربندی \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 .PP مجموعه گزینه‌های الگوریتم درهم‌سازی برای تعیین الگوریتم درهم‌سازی. .SH "نگاشت‌های کدهای دستور (COMMAND CODE MAPPINGS)" رشته‌های کاربرپسند زیر می‌توانند به جای مقادیر عدد صحیح خام استفاده شوند. .PP \-TPM2_CC_AC_GetCapability: 0x194 \-TPM2_CC_AC_Send: 0x195 \-TPM2_CC_ActivateCredential: 0x147 \-TPM2_CC_Certify: 0x148 \-TPM2_CC_CertifyCreation: 0x14a \-TPM2_CC_ChangeEPS: 0x124 \-TPM2_CC_ChangePPS: 0x125 \-TPM2_CC_Clear: 0x126 \-TPM2_CC_ClearControl: 0x127 \-TPM2_CC_ClockRateAdjust: 0x130 \-TPM2_CC_ClockSet: 0x128 \-TPM2_CC_Commit: 0x18b \-TPM2_CC_ContextLoad: 0x161 \-TPM2_CC_ContextSave: 0x162 \-TPM2_CC_Create: 0x153 \-TPM2_CC_CreateLoaded: 0x191 \-TPM2_CC_CreatePrimary: 0x131 \-TPM2_CC_DictionaryAttackLockReset: 0x139 \-TPM2_CC_DictionaryAttackParameters: 0x13a \-TPM2_CC_Duplicate: 0x14b \-TPM2_CC_ECC_Parameters: 0x178 \-TPM2_CC_ECDH_KeyGen: 0x163 \-TPM2_CC_ECDH_ZGen: 0x154 \-TPM2_CC_EC_Ephemeral: 0x18e \-TPM2_CC_EncryptDecrypt: 0x164 \-TPM2_CC_EncryptDecrypt2: 0x193 \-TPM2_CC_EventSequenceComplete: 0x185 \-TPM2_CC_EvictControl: 0x120 \-TPM2_CC_FieldUpgradeData: 0x141 \-TPM2_CC_FieldUpgradeStart: 0x12f \-TPM2_CC_FirmwareRead: 0x179 \-TPM2_CC_FlushContext: 0x165 \-TPM2_CC_GetCapability: 0x17a \-TPM2_CC_GetCommandAuditDigest: 0x133 \-TPM2_CC_GetRandom: 0x17b \-TPM2_CC_GetSessionAuditDigest: 0x14d \-TPM2_CC_GetTestResult: 0x17c \-TPM2_CC_GetTime: 0x14c \-TPM2_CC_Hash: 0x17d \-TPM2_CC_HashSequenceStart: 0x186 \-TPM2_CC_HierarchyChangeAuth: 0x129 \-TPM2_CC_HierarchyControl: 0x121 \-TPM2_CC_HMAC: 0x155 \-TPM2_CC_HMAC_Start: 0x15b \-TPM2_CC_Import: 0x156 \-TPM2_CC_IncrementalSelfTest: 0x142 \-TPM2_CC_Load: 0x157 \-TPM2_CC_LoadExternal: 0x167 \-TPM2_CC_MakeCredential: 0x168 \-TPM2_CC_NV_Certify: 0x184 \-TPM2_CC_NV_ChangeAuth: 0x13b \-TPM2_CC_NV_DefineSpace: 0x12a \-TPM2_CC_NV_Extend: 0x136 \-TPM2_CC_NV_GlobalWriteLock: 0x132 \-TPM2_CC_NV_Increment: 0x134 \-TPM2_CC_NV_Read: 0x14e \-TPM2_CC_NV_ReadLock: 0x14f \-TPM2_CC_NV_ReadPublic: 0x169 \-TPM2_CC_NV_SetBits: 0x135 \-TPM2_CC_NV_UndefineSpace: 0x122 \-TPM2_CC_NV_UndefineSpaceSpecial: 0x11f \-TPM2_CC_NV_Write: 0x137 \-TPM2_CC_NV_WriteLock: 0x138 \-TPM2_CC_ObjectChangeAuth: 0x150 \-TPM2_CC_PCR_Allocate: 0x12b \-TPM2_CC_PCR_Event: 0x13c \-TPM2_CC_PCR_Extend: 0x182 \-TPM2_CC_PCR_Read: 0x17e \-TPM2_CC_PCR_Reset: 0x13d \-TPM2_CC_PCR_SetAuthPolicy: 0x12c \-TPM2_CC_PCR_SetAuthValue: 0x183 \-TPM2_CC_Policy_AC_SendSelect: 0x196 \-TPM2_CC_PolicyAuthorize: 0x16a \-TPM2_CC_PolicyAuthorizeNV: 0x192 \-TPM2_CC_PolicyAuthValue: 0x16b \-TPM2_CC_PolicyCommandCode: 0x16c \-TPM2_CC_PolicyCounterTimer: 0x16d \-TPM2_CC_PolicyCpHash: 0x16e \-TPM2_CC_PolicyDuplicationSelect: 0x188 \-TPM2_CC_PolicyGetDigest: 0x189 \-TPM2_CC_PolicyLocality: 0x16f \-TPM2_CC_PolicyNameHash: 0x170 \-TPM2_CC_PolicyNV: 0x149 \-TPM2_CC_PolicyNvWritten: 0x18f \-TPM2_CC_PolicyOR: 0x171 \-TPM2_CC_PolicyPassword: 0x18c \-TPM2_CC_PolicyPCR: 0x17f \-TPM2_CC_PolicyPhysicalPresence: 0x187 \-TPM2_CC_PolicyRestart: 0x180 \-TPM2_CC_PolicySecret: 0x151 \-TPM2_CC_PolicySigned: 0x160 \-TPM2_CC_PolicyTemplate: 0x190 \-TPM2_CC_PolicyTicket: 0x172 \-TPM2_CC_PP_Commands: 0x12d \-TPM2_CC_Quote: 0x158 \-TPM2_CC_ReadClock: 0x181 \-TPM2_CC_ReadPublic: 0x173 \-TPM2_CC_Rewrap: 0x152 \-TPM2_CC_RSA_Decrypt: 0x159 \-TPM2_CC_RSA_Encrypt: 0x174 \-TPM2_CC_SelfTest: 0x143 \-TPM2_CC_SequenceComplete: 0x13e \-TPM2_CC_SequenceUpdate: 0x15c \-TPM2_CC_SetAlgorithmSet: 0x13f \-TPM2_CC_SetCommandCodeAuditStatus: 0x140 \-TPM2_CC_SetPrimaryPolicy: 0x12e \-TPM2_CC_Shutdown: 0x145 \-TPM2_CC_Sign: 0x15d \-TPM2_CC_StartAuthSession: 0x176 \-TPM2_CC_Startup: 0x144 \-TPM2_CC_StirRandom: 0x146 \-TPM2_CC_TestParms: 0x18a \-TPM2_CC_Unseal: 0x15e \-TPM2_CC_Vendor_TCG_Test: 0x20000000 \-TPM2_CC_VerifySignature: 0x177 \-TPM2_CC_ZGen_2Phase: 0x18d .SH "مثال‌ها (EXAMPLES)" افزودن TPM2_CC_Unseal به فهرست دستورات حسابرسی‌شده. .IP .EX tpm2_setcommandauditstatus TPM2_CC_Unseal .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 "محدودیت‌ها (LIMITATIONS)" این ابزار انتظار دارد که نشستی از پیش از طریق \f[B]tpm2_startauthsession\f[R](1) برقرار شده باشد و نیازمند یکی از موارد زیر است: .IP \[bu] 2 دسترسی مستقیم به دستگاه .IP \[bu] 2 پشتیبانی گسترده از نشست با \f[B]tpm2\-abrmd\f[R]. .PP بدون آن، اکثر مدیران منابع وضعیت نشست را بین فراخوانی‌های دستور ذخیره \f[B]نخواهند کرد\f[R]. .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 \c \& دارای پروانه انتشار است.