.\" -*- nroff -*-
.\" SPDX-License-Identifier: BSD-3-Clause
.\" Copyright © 2015-2023 Inria.  All rights reserved.
.\" See COPYING in top-level directory.
.TH HWLOC-GATHER-CPUID "1" "Jun 08, 2026" "2.14.0" "hwloc"
.SH "نام (NAME)"
hwloc-gather-cpuid \- ذخیره و استخراج مقادیر مرتبط cpuid در معماری x86 برای استفاده‌های بعدی (احتمالاً آفلاین)
.
.\" **************************
.\"    Synopsis Section
.\" **************************
.SH "خلاصه دستور (SYNOPSIS)"
.
.B hwloc-gather-cpuid
[\fIگزینه‌ها\fR] [\fI<outdir>\fR]
.
.\" **************************
.\"    Options Section
.\" **************************
.SH "گزینه‌ها (OPTIONS)"
.
.TP
\fB\-c <idx>\fR
فقط مقادیر cpuid را برای پردازنده منطقی که شاخص فیزیکی/سیستم‌عاملی آن
.I <idx>
است جمع‌آوری می‌کند.
.TP
\fB\-q\fR \fB\-\-quiet\fR \fB\-s\fR \fB\-\-silent\fR
پیام‌های با جزئیات بیشتر را نمایش نمی‌دهد.
.TP
\fB\-\-version\fR
اطلاعات نسخه را گزارش داده و خارج می‌شود.
.TP
\fB\-h\fR \fB\-\-help\fR
پیام راهنما را نمایش داده و خارج می‌شود.
.
.\" **************************
.\"    Description Section
.\" **************************
.SH "توضیحات (DESCRIPTION)"
.
دستور
.B hwloc-gather-cpuid
تمام مقادیر مرتبط cpuid در معماری x86 را درون زیرپوشه
.I cpuid
از دایرکتوری جاری، یا در
.B <outdir>
(در صورت تعیین) ذخیره می‌کند.
.
.PP
این فایل‌ها را می‌توان بعداً برای کاوش آفلاین توپولوژی ماشین به کار برد؛ برای نمونه با تنظیم متغیر محیطی
.I HWLOC_CPUID_PATH
به دایرکتوری حاوی تمام فایل‌های خروجی و اجبار استفاده از بک‌اند x86 با
.IR HWLOC_COMPONENTS=x86,stop .
.
.PP
محتویات این دایرکتوری همچنین ممکن است برای اشکال‌زدایی از راه دور به توسعه‌دهندگان hwloc ارسال شود.
.
.PP
اگر از
.B \-
به‌عنوان
.I <outdir>
استفاده شود، خروجی در خروجی استاندارد ریخته می‌شود؛ اما باید با گزینه
.B \-c
یک پردازنده منطقی یکتا مشخص شده باشد.
.
.PP
دستور
.B hwloc-gather-cpuid
یک ابزار ویژه معماری x86 است و روی سایر بسترها قابل استفاده نیست.
.
.PP
.B "نکته:"
دستور
.B hwloc-gather-cpuid
جزئیات سخت‌افزاری متعددی را درباره بستر سیستم جمع‌آوری می‌کند. فایل‌های خروجی نباید در لیست‌ها یا وب‌سایت‌های عمومی منتشر شوند مگر آنکه کاملاً مشخص باشد حاوی اطلاعات حساس نیستند.
.
.PP
.B "نکته:"
خروجی
.B hwloc-gather-cpuid
در فایل آرشیو تاربال (tarball) ذخیره‌شده توسط
.B hwloc-gather-topology
روی لینوکس/x86 گنجانده می‌شود.
.
.PP
.B "نکته:"
اکیداً توصیه می‌شود پیش از مطالعه این صفحه راهنما، صفحه مروری
.BR hwloc (7)
را مطالعه کنید.
.
.\" **************************
.\"    Examples Section
.\" **************************
.SH "مثال‌ها (EXAMPLES)"
.PP
برای ذخیره اطلاعات cpuid تمام پردازنده‌های منطقی ماشین جاری:
.PP
.nf
        $ 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
.fi
.
.\" **************************
.\"    Return value section
.\" **************************
.SH "مقدار بازگشتی (RETURN VALUE)"
در صورت اجرای موفقیت‌آمیز،
.B hwloc-gather-cpuid
با کد وضعیت 0 خارج می‌شود.
.
.PP
در صورت وقوع هرگونه خطا، از جمله (اما نه محدود به) ناتوانی در ایجاد فایل‌های خروجی،
.B hwloc-gather-cpuid
یک وضعیت خروج غیرصفر بازمی‌گرداند.
.
.\" **************************
.\"    See also section
.\" **************************
.SH "همچنین ببینید (SEE ALSO)"
.
.ft R
hwloc(7), hwloc-gather-topology(1), lstopo(1)
.sp