HWLOC-DIFF(1)                        hwloc                       HWLOC-DIFF(1)

نام (NAME)
       hwloc-diff - محاسبه تفاوت‌های بین دو توپولوژی XML

خلاصه دستور (SYNOPSIS)
       hwloc-diff [options] <input1.xml> <input2.xml>

       hwloc-diff [options] <input1.xml> <input2.xml> <output.xml>

گزینه‌ها (OPTIONS)
       --refname <name>
                 استفاده از <name> به‌عنوان شناسه توپولوژی مرجع در خروجی تفاوت
                 XML.  این گزینه مشخص می‌کند که هنگام اعمال تفاوت حاصل، باید از
                 کدام توپولوژی استفاده شود.  hwloc-patch می‌تواند از این نام
                 برای بارگذاری خودکار توپولوژی مرجع XML مربوطه استفاده کند.
                 به‌طور پیش‌فرض، <input1.xml> بدون مسیر کامل آن استفاده می‌شود.

       --version نمایش نسخه و خروج.

       -h --help نمایش پیام راهنما و خروج.

توضیحات (DESCRIPTION)
       دستور hwloc-diff تفاوت بین دو توپولوژی XML را محاسبه کرده و در صورت
       تعیین، نتیجه را در <output.xml> ذخیره می‌کند، و در غیر این صورت آن را در
       stdout نمایش می‌دهد.

       تفاوت خروجی را می‌توان بعداً با hwloc-patch روی یک توپولوژی دیگر اعمال
       کرد.

       می‌توان از hwloc-compress-dir برای محاسبه تفاوت‌ها بین تمام فایل‌های XML
       موجود در یک پوشه استفاده کرد.

       نکته: اگر داده‌های کاربری ویژه برنامه‌ای (userdata) در فایل‌های XML ورودی
       وجود داشته باشد، نادیده گرفته شده و از خروجی حذف می‌شوند زیرا hwloc راهی
       برای درک و مقایسه آن‌ها ندارد.

       نکته: اکیداً توصیه می‌شود پیش از خواندن این صفحه راهنما، صفحه مرور کلی
       hwloc(7) را مطالعه کنید. بیشتر مفاهیم شرح داده شده در hwloc(7) مستقیماً
       برای ابزار hwloc-diff صدق می‌کنند.

مثال‌ها (EXAMPLES)
       عملکرد hwloc-diff را می‌توان به بهترین شکل از طریق چندین مثال شرح داد.

       محاسبه تفاوت بین دو توپولوژی 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 -


وضعیت خروج (EXIT STATUS)
       در صورت اجرای موفقیت‌آمیز، hwloc-diff تفاوت را در خروجی چاپ می‌کند.
       مقدار بازگشتی 0 است.

       اگر تفاوت برای نمایش داده شدن بیش از حد پیچیده باشد، خطا بازگردانده شده
       و خروجی تولید نمی‌شود.

       همچنین hwloc-diff در صورت بروز هرگونه خطا، مانند (اما نه محدود به)
       ناتوانی در تجزیه خط فرمان، مقداری غیرصفر برمی‌گرداند.

همچنین ببینید (SEE ALSO)
       hwloc(7), lstopo(1), hwloc-patch(1), hwloc-compress-dir(1)


2.14.0                           June 8, 2026                    HWLOC-DIFF(1)