.\" -*- nroff -*-
.\" SPDX-License-Identifier: BSD-3-Clause
.\" Copyright © 2013-2021 Inria.  All rights reserved.
.\" See COPYING in top-level directory.
.TH HWLOC-COMPRESS-DIR "1" "Jun 08, 2026" "2.14.0" "hwloc"
.SH "نام (NAME)"
hwloc-compress-dir \- فشرده‌سازی یک دایرکتوری از توپولوژی‌های XML
.
.\" **************************
.\"    Synopsis Section
.\" **************************
.SH "خلاصه دستور (SYNOPSIS)"
.B hwloc-compress-dir
[\fIoptions\fR]
<inputdir>
<outputdir>
\fR
.
.\" **************************
.\"    Options Section
.\" **************************
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-R \-\-reverse\fR
از فشرده‌سازی خارج کردن دایرکتوری‌ای که پیش‌تر فشرده شده است.
.TP
\fB\-v \-\-verbose\fR
نمایش پیام‌های پرجزئیات.
.TP
\fB\-\-version\fR
گزارش نسخه و خروج.
.TP
\fB\-h\fR \fB\-\-help\fR
نمایش پیام راهنما و خروج.
.
.\" **************************
.\"    Description Section
.\" **************************
.SH "توضیحات (DESCRIPTION)"
.
دستور hwloc-compress-dir یک دایرکتوری ورودی شامل خروجی‌های XML را دریافت کرده
و با محاسبهٔ تفاوت‌های توپولوژی (diff) بین آن‌ها (با استفاده از برنامهٔ hwloc-diff)
تلاش می‌کند آن را فشرده سازد.
هر فایل در صورتی که قابل فشرده‌سازی باشد به عنوان یک diff،
و در غیر این صورت به عنوان فایل کامل و اصلی خود در دایرکتوری خروجی کپی می‌شود.
.
.PP
دستور hwloc-compress-dir ممکن است دایرکتوری‌ای را که پیش‌تر فشرده شده است،
مجدداً فشرده‌سازی کند. تمام فایل‌های ورودی که از قبل در دایرکتوری خروجی وجود دارند
(چه فشرده‌شده و چه فشرده‌نشده) نادیده گرفته می‌شوند. فایل‌های ورودیِ جدید
طبق معمول تا حد امکان فشرده می‌شوند.
.
.PP
برای هر فایل موجود در دایرکتوری، نام فایل خروجی در صورت فشرده نشدن
همان نام اصلی خواهد بود، در غیر این صورت پسوند آن به \fB.diff.xml\fR تغییر می‌یابد.
.
.PP
فایل‌های فشرده‌شده بر پایهٔ یک توپولوژی فشرده‌نشدهٔ دیگر هستند.
نام آن در ویژگی (attribute) تفاوت توپولوژیِ \fBrefname\fR ذخیره می‌شود.
.
.PP
فایل‌های diff خروجیِ تولیدشده می‌توانند دقیقاً مانند هر فایل
تولیدشده توسط hwloc-diff، به همراه hwloc-patch استفاده شوند.
.
.\" **************************
.\"    Examples Section
.\" **************************
.SH "مثال‌ها (EXAMPLES)"
.PP
برای فشرده‌سازی فایل‌های ورودی از دایرکتوری in به دایرکتوری out:

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