نام (NAME)

hwloc-patch - اعمال تفاوت توپولوژی روی یک توپولوژی XML موجود

خلاصه دستور (SYNOPSIS)

hwloc-patch [options] [<topology.xml> | refname] [<diff.xml> | -] [<output.xml> | -]

hwloc-patch [options] [<topology.xml> | refname] [<diff.xml> | -]

گزینه‌ها (OPTIONS)

-R --reverse

معکوس کردن جهت فایل تفاوت (diff).

--dry-run

بررسی اینکه آیا وصله (patch) قابل اعمال است یا خیر، بدون نوشتن واقعی نتیجه.

--version

گزارش نسخه و خروج.

-h --help

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

توضیحات (DESCRIPTION)

دستور hwloc-patch تفاوت میان دو توپولوژی را از یک فایل XML (یا از ورودی استاندارد) بارگذاری کرده و آن را روی یک توپولوژی موجود اعمال می‌کند تا توپولوژی جدید و تغییریافته‌ای تولید شود.

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

اگر <output.xml> داده شود، توپولوژی جدید و تغییریافته در آن فایل جدید ذخیره می‌شود. اگر - به عنوان خروجی مشخص شود، توپولوژی تغییریافته به stdout ارسال می‌شود. اگر هیچ خروجی‌ای داده نشود، <topology.xml> به‌صورت درجا (in-place) اصلاح می‌شود.

اگر به جای <topology.xml> مقدار refname وارد شود، نام فایل توپولوژی ورودی به‌طور خودکار با خواندن فیلد refname از فایل XML diff تشخیص داده می‌شود. به‌طور پیش‌فرض، hwloc-diff فایل‌های XML diff را با نام فایل توپولوژی مرجع مناسب (بدون هیچ‌گونه پیشوند مسیر) تولید می‌کند.

اگر به جای <diff.xml> علامت - وارد شود، تفاوت توپولوژی از ورودی استاندارد خوانده می‌شود.

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

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

مثال‌ها (EXAMPLES)

عملکرد hwloc-patch با ارائه چند مثال به بهترین شکل شرح داده می‌شود.

اعمال یک فایل تفاوت توپولوژی XML بر روی یک توپولوژی موجود:

$ hwloc-patch fourmi023.xml diff.xml fourmi023-new.xml

بررسی اینکه آیا یک فایل تفاوت توپولوژی XML بر روی یک توپولوژی موجود قابل اعمال است یا خیر، بدون اعمال آن:

$ hwloc-patch --dry-run fourmi023.xml diff.xml

اعمال یک فایل تفاوت توپولوژی XML که فیلد refname آن شامل توپولوژی ورودی صحیح است:

$ hwloc-patch refname diff.xml fourmi023-new.xml

اعمال یک توپولوژی XML از ورودی استاندارد:

$ cat diff.xml | hwloc-patch fourmi023.xml - fourmi023-new.xml

محاسبه مستقیم تفاوت بین دو توپولوژی و اعمال درجا (in-place) آن روی دیگری:

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

وضعیت خروج (EXIT STATUS)

پس از اجرای موفقیت‌آمیز، hwloc-patch توپولوژی تغییریافته را در خروجی می‌نویسد. مقدار بازگشتی 0 است.

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

همچنین ببینید (SEE ALSO)

hwloc(7), lstopo(1), hwloc-diff(1), hwloc-compress-dir(1)