نام (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)