HWLOC-GATHER-CPUID(1) hwloc HWLOC-GATHER-CPUID(1)

hwloc-gather-cpuid - ذخیره و استخراج مقادیر مرتبط cpuid در معماری x86 برای استفاده‌های بعدی (احتمالاً آفلاین)

hwloc-gather-cpuid [گزینه‌ها] [<outdir>]

فقط مقادیر cpuid را برای پردازنده منطقی که شاخص فیزیکی/سیستم‌عاملی آن <idx> است جمع‌آوری می‌کند.
پیام‌های با جزئیات بیشتر را نمایش نمی‌دهد.
اطلاعات نسخه را گزارش داده و خارج می‌شود.
پیام راهنما را نمایش داده و خارج می‌شود.

دستور 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) را مطالعه کنید.

برای ذخیره اطلاعات 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

در صورت اجرای موفقیت‌آمیز، hwloc-gather-cpuid با کد وضعیت 0 خارج می‌شود.

در صورت وقوع هرگونه خطا، از جمله (اما نه محدود به) ناتوانی در ایجاد فایل‌های خروجی، hwloc-gather-cpuid یک وضعیت خروج غیرصفر بازمی‌گرداند.

hwloc(7), hwloc-gather-topology(1), lstopo(1)

June 8, 2026 2.14.0