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)


2.14.0                           June 8, 2026            HWLOC-GATHER-CPUID(1)