.\" -*- nroff -*-
.\" SPDX-License-Identifier: BSD-3-Clause
.\" Copyright © 2013-2018 Inria.  All rights reserved.
.\" See COPYING in top-level directory.
.TH HWLOC-DIFF "1" "Jun 08, 2026" "2.14.0" "hwloc"
.SH "نام (NAME)"
hwloc-diff \- محاسبه تفاوت‌های بین دو توپولوژی XML
.
.\" **************************
.\"    Synopsis Section
.\" **************************
.SH "خلاصه دستور (SYNOPSIS)"
.
.PP
.B hwloc-diff
[\fIoptions\fR]
\fI<input1.xml>\fR
\fI<input2.xml>\fR
.PP
.B hwloc-diff
[\fIoptions\fR]
\fI<input1.xml>\fR
\fI<input2.xml>\fR
\fI<output.xml>\fR
.
.\" **************************
.\"    Options Section
.\" **************************
.SH "گزینه‌ها (OPTIONS)"
.
.TP 10
\fB\-\-refname\fR <name>
استفاده از <name> به‌عنوان شناسه توپولوژی مرجع در خروجی تفاوت XML.
این گزینه مشخص می‌کند که هنگام اعمال تفاوت حاصل، باید از کدام توپولوژی استفاده شود.
hwloc-patch می‌تواند از این نام برای بارگذاری خودکار توپولوژی مرجع XML مربوطه استفاده کند.
به‌طور پیش‌فرض، <input1.xml> بدون مسیر کامل آن استفاده می‌شود.
.TP
\fB\-\-version\fR
نمایش نسخه و خروج.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.
.\" **************************
.\"    Description Section
.\" **************************
.SH "توضیحات (DESCRIPTION)"
.
دستور hwloc-diff تفاوت بین دو توپولوژی XML را محاسبه کرده و در صورت تعیین، نتیجه را در <output.xml> ذخیره می‌کند، و در غیر این صورت آن را در stdout نمایش می‌دهد.
.
.PP
تفاوت خروجی را می‌توان بعداً با hwloc-patch روی یک توپولوژی دیگر اعمال کرد.
.
.PP
می‌توان از hwloc-compress-dir برای محاسبه تفاوت‌ها بین تمام فایل‌های XML موجود در یک پوشه استفاده کرد.
.
.PP
.B نکته:
اگر داده‌های کاربری ویژه برنامه‌ای (userdata) در فایل‌های XML ورودی وجود داشته باشد، نادیده گرفته شده و از خروجی حذف می‌شوند زیرا hwloc راهی برای درک و مقایسه آن‌ها ندارد.
.
.PP
.B نکته:
اکیداً توصیه می‌شود پیش از خواندن این صفحه راهنما، صفحه مرور کلی hwloc(7) را مطالعه کنید. بیشتر مفاهیم شرح داده شده در hwloc(7) مستقیماً برای ابزار hwloc-diff صدق می‌کنند.
.
.\" **************************
.\"    Examples Section
.\" **************************
.SH "مثال‌ها (EXAMPLES)"
.PP
عملکرد hwloc-diff را می‌توان به بهترین شکل از طریق چندین مثال شرح داد.
.
.PP
محاسبه تفاوت بین دو توپولوژی XML و ارسال خروجی آن به stdout:

    $ hwloc-diff fourmi023.xml fourmi024.xml
    Found 11 differences, exporting to stdout
    <?xml version="1.0" encoding="UTF-8"?>
    ...

ارسال تفاوت به فایل diff.xml به‌جای آن:

    $ hwloc-diff fourmi023.xml fourmi024.xml diff.xml
    Found 11 differences, exporting to diff.xml

هنگامی که تفاوت برای نمایش بیش از حد پیچیده باشد:

    $ hwloc-diff fourmi023.xml avakas-frontend1.xml
    Found 1 differences, including 1 too complex ones.
    Cannot export differences to stdout

محاسبه مستقیم تفاوت بین دو توپولوژی و اعمال آن به توپولوژی دیگر:

    $ hwloc-diff fourmi023.xml fourmi024.xml | hwloc-patch fourmi025.xml -

.
.\" **************************
.\" Return value section
.\" **************************
.SH "وضعیت خروج (EXIT STATUS)"
در صورت اجرای موفقیت‌آمیز، hwloc-diff تفاوت را در خروجی چاپ می‌کند.
مقدار بازگشتی 0 است.
.
.PP
اگر تفاوت برای نمایش داده شدن بیش از حد پیچیده باشد، خطا بازگردانده شده و خروجی تولید نمی‌شود.
.
.PP
همچنین hwloc-diff در صورت بروز هرگونه خطا، مانند (اما نه محدود به) ناتوانی در تجزیه خط فرمان، مقداری غیرصفر برمی‌گرداند.
.
.\" **************************
.\"    See also section
.\" **************************
.SH "همچنین ببینید (SEE ALSO)"
.
.ft R
hwloc(7), lstopo(1), hwloc-patch(1), hwloc-compress-dir(1)
.sp