.\" -*- nroff -*-
.\" SPDX-License-Identifier: BSD-3-Clause
.\" Copyright © 2015-2021 Inria.  All rights reserved.
.\" See COPYING in top-level directory.
.TH HWLOC-DUMP-HWDATA "1" "Jun 08, 2026" "2.14.0" "hwloc"
.SH "نام (NAME)"
hwloc-dump-hwdata \- استخراج اطلاعات توپولوژی و محلی‌سازی از جدول‌های سخت‌افزاری
.
.\" **************************
.\"    Synopsis Section
.\" **************************
.SH "خلاصه دستور (SYNOPSIS)"
.
.B hwloc-dump-hwdata
[\fIگزینه‌ها\fR]
.
.\" **************************
.\"    Options Section
.\" **************************
.SH "گزینه‌ها (OPTIONS)"
.
.TP 10
\fB\-o <dir>\fR
ذخیره پرونده‌های خروجی در پوشه <dir> به جای مسیر پیش‌فرض
\fI/usr/var/run/hwloc/\fR
که در زمان پیکربندی (configure) مشخص شده است.

همچنین ممکن است مایل باشید متغیر محیطی HWLOC_DUMPED_HWDATA_DIR را نیز تنظیم کنید تا کتابخانه hwloc پرونده‌های استخراج‌شده را در همان دایرکتوری جستجو کند.
.TP
\fB\-\-version\fR
گزارش نسخه و خروج.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.
.\" **************************
.\"    Description Section
.\" **************************
.SH "توضیحات (DESCRIPTION)"
.
کتابخانه hwloc ممکن است از برخی اطلاعات محلی‌سازی و توپولوژی برگرفته از جدول‌های SMBIOS یا ACPI بهره‌مند شود.
این اطلاعات در لینوکس از پرونده‌های خام سخت‌افزاری در دایرکتوری‌هایی مانند
/sys/firmware/dmi/
یا
/sys/firmware/acpi/
قابل دسترسی هستند.
این پرونده‌ها معمولاً فقط برای کاربر root قابل دسترسی هستند و تنها زمانی وجود دارند که پشتیبانی از \fIdmi-sysfs\fR در هسته لینوکس فعال باشد.
.
.PP
ابزار hwloc-dump-hwdata محتوای مفید این پرونده‌ها را در قالب پرونده‌های خوانا برای انسان و با دسترسی همگانی استخراج می‌کند. هدف این است که این ابزار یک بار در زمان راه‌اندازی سیستم (boot) اجرا شود تا کتابخانه اصلی hwloc (بدون نیاز به مجوزهای ویژه) بتواند اطلاعات را از این پرونده‌های خوانا گردآوری کند.
.
.PP
\fBابزار hwloc-dump-hwdata در حال حاضر تنها برای پردازنده‌های Intel Xeon Phi مفید است\fR
(Knights Landing و Knights Mill).
.
.PP
فهرست فعلی اطلاعات استخراج‌شده عبارتند از:
.
.TP 5
\fBپیکربندی حافظه، حافظه نهان (کش) و خوشه‌بندی پردازنده‌های Intel Xeon Phi\fR
که از مدخل‌های خاص SMBIOS مانند
\fI/sys/firmware/dmi/entries/14-*\fR
و
\fI/sys/firmware/dmi/entries/160-*\fR
گردآوری شده و در پرونده \fIknl_memoryside_cache\fR ذخیره می‌شود.
.
.\" **************************
.\"    See also section
.\" **************************
.SH "همچنین ببینید (SEE ALSO)"
.
.ft R
hwloc(7), lstopo(1)
.sp