.\" Automatically generated by Pandoc 3.6.1 .\" .TH "tpm2_stirrandom" "1" "" "tpm2\-tools" "General Commands Manual" .SH "نام (NAME)" tpm2_stirrandom \- افزودن \[lq]اطلاعات اضافی\[rq] به وضعیت TPM RNG .SH "خلاصه دستور (SYNOPSIS)" \f[B]tpm2_stirrandom\f[R] [\f[I]OPTIONS\f[R]] [\f[I]ARGUMENT\f[R]] .SH "توضیحات (DESCRIPTION)" دستور \f[B]tpm2_stirrandom\f[R](1) \[lq]اطلاعات اضافی\[rq] را در قالب بایت به مخزن انتروپی Protected Capability در TPM تزریق می‌کند. .PP \[lq]اطلاعات اضافی\[rq] می‌تواند از فایلی که به عنوان آرگومان مشخص شده استخراج شود، یا در صورت تعیین نشدن آرگومان، از \f[I]STDIN\f[R] خوانده شود. .PP حداکثر ۱۲۸ بایت می‌تواند در یک مرحله از طریق ورودی استاندارد به \f[B]tpm2_stirrandom\f[R](1) تزریق شود. .PP اگر فایل ورودی بزرگ‌تر از ۱۲۸ بایت باشد، \f[B]tpm2_stirrandom\f[R](1) با شکست مواجه خواهد شد. .PP افزودن داده از طریق \f[B]tpm2_stirrandom\f[R](1) موجب بذردهی مجدد (reseeding) در Protected Capability از نوع TPM DRBG خواهد شد. این دستور هنگام انجام هرگونه عملیات حساس روی یک مکان محافظت‌شده (shielded location) نظیر بارگذاری یک کلید ماندگار (persistent key) یا اجرای عملیات روی Protected Capability مانند به‌روزرسانی سفت‌افزار TPM استفاده می‌شود. .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 را برای ابزار فراخوانی کند، اما در صورت عدم موفقیت، خلاصه کوتاهی از ابزار را نمایش می‌دهد. این رفتار مشابه زمانی است که آرگومان گزینه \[lq]man\[rq] مشخص شده باشد؛ با این حال، اگر صراحتاً \[lq]man\[rq] درخواست شود، ابزار خطاهای man را در stderr ارائه می‌دهد. اگر گزینه \[lq]no\-man\[rq] مشخص شود، یا صفحه‌بند man ناموفق باشد، گزینه‌های کوتاه در 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 برای احراز هویت. یک گذرواژه متنی آشکار برای مجازشماری عملیات به TPM منتقل می‌شود. این گزینه می‌تواند برای جلوگیری از بروز مشکل در مواردی که نشست‌های بدون سالت (unsalted) در حالت OpenSSL FIPS استفاده می‌شوند به کار رود. اگر مقادیر احراز هویت استفاده می‌شوند، باید از یک نشست با سالت (salted) برای احراز هویت استفاده کرد. .IP \[bu] 2 \f[B]\-R\f[R]، \f[B]\-\-autoflush\f[R]: فعال‌سازی تخلیه خودکار (autoflush) برای اشیای گذرا (transient objects) ایجاد شده توسط دستور. اگر یک شیء والد از یک فایل زمینه (context file) بارگذاری شود، شیء والد گذرا نیز تخلیه خواهد شد. 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] گزینه خط فرمان همواره اولویت داشته و متغیر محیطی را بازنویسی (override) می‌کند. .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 .SH "مثال‌ها (EXAMPLES)" .SS "تزریق از stdin با استفاده از echo" .IP .EX echo \-n \[dq]myrandomdata\[dq] \f[B]|\f[R] tpm2_stirrandom .EE .SS "تزریق ۶۴ بایت از stdin با استفاده از یک فایل" .IP .EX dd if=/dev/urandom bs=1 count=64 > myrandom.bin tpm2_stirrandom < ./myrandom.bin .EE .SS "تزریق بایت‌ها از یک فایل و خواندن حداکثر تا ۱۲۸ بایت" .IP .EX dd if=/dev/urandom of=./myrandom.bin bs=1 count=42 tpm2_stirrandom ./myrandom.bin .EE .SH "نکات (NOTES)" لطفاً توجه داشته باشید که حتی اگر \[lq]اطلاعات اضافی\[rq] افزوده شده توسط \f[B]tpm2_stirrandom\f[R](1) انتروپی جمع‌آوری‌شده از سایر منابع DRBG باشد، TPM راهی برای تشخیص این که مقدار ارائه‌شده دارای انتروپی است یا خیر ندارد. در نتیجه، صرفاً به عنوان \[lq]ورودی اضافی\[rq] در نظر گرفته خواهد شد. .PP مفهوم \[lq]ورودی اضافی\[rq] مطابق با تعریف ارائه‌شده در \c .UR https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-90.pdf NIST SP800\-90A .UE \c است. .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 \- طرح‌واره پشتیبانی‌نشده (Non supported 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 لیست پستی (Mailing List) .UE \c .SH "کپی‌رایت و تکثیر (COPYRIGHT)" این اثر تحت مجوز \c .UR https://creativecommons.org/licenses/by/4.0 Creative Commons Attribution 4.0 International License (CC BY 4.0) .UE \c منتشر شده است. \&.