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

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