.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SOZIP" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
sozip \- ایجاد و مدیریت فایل‌های فشرده SOZip
.sp
در نسخه 3.7 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip [\-\-help] [\-\-help\-general]
      [\-\-quiet|\-\-verbose]
      [[\-g|\-\-grow] | [\-\-overwrite]]
      [\-r|\-\-recurse\-paths]
      [\-j|\-\-junk\-paths]
      [\-l|\-\-list]
      [\-\-optimize\-from=<input.zip>]
      [\-\-validate]
      [\-\-enable\-sozip={auto|yes|no}]
      [\-\-sozip\-chunk\-size=<value>]
      [\-\-sozip\-min\-file\-size=<value>]
      [\-\-content\-type=<value>]
      <zip_filename> [<filename>]...
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار
.B sozip
می‌تواند برای موارد زیر استفاده شود:
.INDENT 0.0
.IP \(bu 2
ایجاد یک فایل \fISOZip (Seek\-Optimized ZIP)\fR
.IP \(bu 2
افزودن فایل‌ها به یک فایل ZIP/SOZip موجود
.IP \(bu 2
فهرست کردن محتویات یک فایل ZIP/SOZip
.IP \(bu 2
اعتبارسنجی یک فایل SOZip
.IP \(bu 2
تبدیل یک فایل Zip موجود به یک فایل بهینه‌شده با SOZip
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fIgdal vsi sozip\fR را ببینید.
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
ارائه یک پیام استفاده کوتاه برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-quiet
حالت بی‌صدا. هیچ پیام پیشرفتی در خروجی استاندارد ارسال نمی‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
حالت پرحرف (همراه با جزئیات).
.UNINDENT
.INDENT 0.0
.TP
.B \-g
.UNINDENT
.INDENT 0.0
.TP
.B \-\-grow
افزودن محتوای نام‌فایل(های) مشخص‌شده به یک فایل zip موجود.
این حالت پیش‌فرض ابزار است. این سوییچ برای سازگاری با ابزار
.B zip
در Info\-ZIP قرار داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
بازنویسی فایل zip مقصد در صورتی که از قبل وجود داشته باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-l
.UNINDENT
.INDENT 0.0
.TP
.B \-\-list
فهرست کردن فایل‌های موجود در فایل zip در قالبی مشابه با ابزار
.B unzip
در Info\-ZIP، اما با افزودن یک ستون که نشان می‌دهد آیا هر فایل برای جست‌وجو بهینه‌سازی شده است یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-validate
اعتبارسنجی یک فایل SOZip. اعتبارسنجی پایه ZIP به صورت سبک انجام می‌شود و محدود به توانایی پیمایش رکوردهای ZIP با خواننده ZIP مبتنی بر InfoZIP مورد استفاده در GDAL است. اما اعتبارسنجی جنبه‌های خاص SOZip با دقت و جامعیت بیشتری انجام می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-r
.UNINDENT
.INDENT 0.0
.TP
.B \-\-recurse\-paths
پیمایش بازگشتی ساختار پوشه‌های مشخص‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B \-j
.UNINDENT
.INDENT 0.0
.TP
.B \-\-junk\-paths
ذخیره فقط نام فایل ذخیره‌شده (حذف مسیر) و ذخیره نکردن نام پوشه‌ها. به طور پیش‌فرض، sozip مسیر کامل (نسبت به دایرکتوری جاری) را ذخیره می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-optimize\-from=<input.zip>
پردازش مجدد {input.zip} برای تولید یک .zip بهینه‌شده با SOZip. گزینه‌های
.IR \%\-\-enable\-sozip ,
.I \%\-\-sozip\-chunk\-size
و
.I \%\-\-sozip\-min\-file\-size
می‌توانند در این حالت استفاده شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-enable\-sozip={auto|yes|no}
در حالت
.BR auto ،
یک فایل تنها در صورتی برای جست‌وجو بهینه می‌شود که اندازه آن بیشتر از مقدار
.I \%\-\-sozip\-min\-file\-size
باشد.
در حالت
.BR yes ،
تمام فایل‌های ورودی برای جست‌وجو بهینه خواهند شد.
در حالت
.BR no ،
هیچ فایل ورودی برای جست‌وجو بهینه نخواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sozip\-chunk\-size=<value>
اندازه هر تکه (Chunk) برای یک فایل بهینه‌شده جهت جست‌وجو. مقدار پیش‌فرض 32768 بایت است. مقدار به بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K و M برای مشخص کردن مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sozip\-min\-file\-size=<value>
حداقل اندازه فایل برای تصمیم‌گیری در مورد اینکه آیا یک فایل باید در حالت
.B \-\-enable\-sozip=auto
برای جست‌وجو بهینه شود یا خیر. مقدار پیش‌فرض 1 مگابایت است. مقدار به بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K، M یا G برای مشخص کردن مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-content\-type=<value>
ذخیره نوع محتوا (Content\-Type) برای فایل در حال افزودن به عنوان یک جفت کلید-مقدار در بخش افزونه فیلد اضافی \(aqKV\(aq (0x564b) اختصاص‌یافته به ذخیره متادیتای کلید-مقدار.
.UNINDENT
.INDENT 0.0
.TP
.B <zip_filename>
نام فایل zip برای ایجاد، افزودن یا فهرست‌بندی.
.UNINDENT
.INDENT 0.0
.TP
.B <filename>
نام فایلی که باید اضافه شود.
.UNINDENT
.SH "چندریسمانی (MULTITHREADING)"
.sp
گزینه پیکربندی
.I \%GDAL_NUM_THREADS
می‌تواند روی
.B ALL_CPUS
یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. مقدار پیش‌فرض
.B ALL_CPUS
است.
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "رابط سی (C API)"
.sp
عملکرد این ابزار می‌تواند از زبان C با توابع
.I \%CPLAddFileInZip()
یا
.I \%VSICopyFile()
انجام شود.
.SH "مثال‌ها (EXAMPLES)"
.sp
ایجاد یک فایل ZIP با قابلیت بهینه‌سازی برای جست‌وجو از محتوای my.gpkg:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip my.gpkg.zip my.gpkg
.EE
.UNINDENT
.UNINDENT
.sp
ایجاد یک فایل ZIP با قابلیت بهینه‌سازی برای جست‌وجو از محتوای یک پوشه منبع:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip \-r my.gpkg.zip source_dir/
.EE
.UNINDENT
.UNINDENT
.sp
ایجاد یک فایل ZIP بهینه‌شده برای جست‌وجو از یک فایل ZIP موجود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip \-\-convert\-from=in.zip out.zip
.EE
.UNINDENT
.UNINDENT
.sp
فهرست کردن محتویات یک فایل ZIP و نمایش فایل‌هایی که برای جست‌وجو بهینه شده‌اند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip \-l my.gpkg.zip
.EE
.UNINDENT
.UNINDENT
.sp
اعتبارسنجی یک فایل SOZip:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sozip \-\-validate my.gpkg.zip
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.