| HWLOC-GATHER-CPUID(1) | hwloc | HWLOC-GATHER-CPUID(1) |
نام (NAME)
hwloc-gather-cpuid - ذخیره و استخراج مقادیر مرتبط cpuid در معماری x86 برای استفادههای بعدی (احتمالاً آفلاین)
خلاصه دستور (SYNOPSIS)
hwloc-gather-cpuid [گزینهها] [<outdir>]
گزینهها (OPTIONS)
- -c <idx>
- فقط مقادیر cpuid را برای پردازنده منطقی که شاخص فیزیکی/سیستمعاملی آن <idx> است جمعآوری میکند.
- -q --quiet -s --silent
- پیامهای با جزئیات بیشتر را نمایش نمیدهد.
- --version
- اطلاعات نسخه را گزارش داده و خارج میشود.
- -h --help
- پیام راهنما را نمایش داده و خارج میشود.
توضیحات (DESCRIPTION)
دستور hwloc-gather-cpuid تمام مقادیر مرتبط cpuid در معماری x86 را درون زیرپوشه cpuid از دایرکتوری جاری، یا در <outdir> (در صورت تعیین) ذخیره میکند.
این فایلها را میتوان بعداً برای کاوش آفلاین توپولوژی ماشین به کار برد؛ برای نمونه با تنظیم متغیر محیطی HWLOC_CPUID_PATH به دایرکتوری حاوی تمام فایلهای خروجی و اجبار استفاده از بکاند x86 با HWLOC_COMPONENTS=x86,stop.
محتویات این دایرکتوری همچنین ممکن است برای اشکالزدایی از راه دور به توسعهدهندگان hwloc ارسال شود.
اگر از - بهعنوان <outdir> استفاده شود، خروجی در خروجی استاندارد ریخته میشود؛ اما باید با گزینه -c یک پردازنده منطقی یکتا مشخص شده باشد.
دستور hwloc-gather-cpuid یک ابزار ویژه معماری x86 است و روی سایر بسترها قابل استفاده نیست.
نکته: دستور hwloc-gather-cpuid جزئیات سختافزاری متعددی را درباره بستر سیستم جمعآوری میکند. فایلهای خروجی نباید در لیستها یا وبسایتهای عمومی منتشر شوند مگر آنکه کاملاً مشخص باشد حاوی اطلاعات حساس نیستند.
نکته: خروجی hwloc-gather-cpuid در فایل آرشیو تاربال (tarball) ذخیرهشده توسط hwloc-gather-topology روی لینوکس/x86 گنجانده میشود.
نکته: اکیداً توصیه میشود پیش از مطالعه این صفحه راهنما، صفحه مروری hwloc(7) را مطالعه کنید.
مثالها (EXAMPLES)
برای ذخیره اطلاعات cpuid تمام پردازندههای منطقی ماشین جاری:
$ hwloc-gather-cpuid Gathering in directory ./cpuid ... Gathering CPUID of PU P#0 in path ./hwloc-x86-cpuid/pu0 ... Gathering CPUID of PU P#1 in path ./hwloc-x86-cpuid/pu1 ... Gathering CPUID of PU P#2 in path ./hwloc-x86-cpuid/pu2 ... Gathering CPUID of PU P#3 in path ./hwloc-x86-cpuid/pu3 ... Summary written to ./cpuid/hwloc-cpuid-info
مقدار بازگشتی (RETURN VALUE)
در صورت اجرای موفقیتآمیز، hwloc-gather-cpuid با کد وضعیت 0 خارج میشود.
در صورت وقوع هرگونه خطا، از جمله (اما نه محدود به) ناتوانی در ایجاد فایلهای خروجی، hwloc-gather-cpuid یک وضعیت خروج غیرصفر بازمیگرداند.
همچنین ببینید (SEE ALSO)
hwloc(7), hwloc-gather-topology(1), lstopo(1)
| June 8, 2026 | 2.14.0 |