.\" 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 "GDAL-VSI-SOZIP" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vsi-sozip \- دستورهای مربوط به SOZIP (فایل ZIP بهینه‌سازی‌شده برای دسترسی تصادفی و جستجو) .sp افزوده‌شده در نسخه 3.11. .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBgdal vsi sozip\fP می‌تواند برای موارد زیر استفاده شود: .INDENT 0.0 .IP \(bu 2 ایجاد یک فایل \fI\%SOZip (Seek\-Optimized ZIP)\fP .IP \(bu 2 افزودن فایل‌ها به یک فایل ZIP/SOZip موجود .IP \(bu 2 فهرست کردن محتویات یک فایل ZIP/SOZip .IP \(bu 2 اعتبارسنجی یک فایل SOZip .IP \(bu 2 تبدیل یک فایل Zip موجود به یک فایل بهینه‌سازی‌شده SOZip .UNINDENT .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vsi sozip [OPTIONS] where is one of: \- create: Create a Seek\-optimized ZIP (SOZIP) file. \- list: List content of a ZIP file, with SOZIP related information. \- optimize: Create a Seek\-optimized ZIP (SOZIP) file from a regular ZIP file. \- validate: Validate a ZIP file, possibly using SOZIP optimization. Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] .EE .UNINDENT .UNINDENT .SH "GDAL VSI SOZIP CREATE" .SS "توضیحات (Description)" .sp یک یا چند فایل را به یک فایل zip جدید یا موجود اضافه می‌کند. .SS "خلاصه دستور (Synopsis)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vsi sozip create [OPTIONS] Create a Seek\-optimized ZIP (SOZIP) file. Positional arguments: \-i, \-\-input Input filenames [may be repeated] [required] \-o, \-\-output Output ZIP filename [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-\-overwrite Whether overwriting existing output dataset is allowed \-r, \-\-recursive Travels the directory structure of the specified directories recursively \-j, \-\-junk\-paths, \-\-no\-paths Store just the name of a saved file, and do not store directory names \-\-enable\-sozip Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE\-SOZIP=auto|yes|no (default: auto) \-\-sozip\-chunk\-size Chunk size for a seek\-optimized file (default: 32768) \-\-sozip\-min\-file\-size Minimum file size to decide if a file should be seek\-optimized (default: 1 MB) \-\-content\-type Store the Content\-Type of the file being added. .EE .UNINDENT .UNINDENT .SS "گزینه‌ها (Options)" .INDENT 0.0 .TP .B \-i, \-\-input نام فایل‌های ورودی. اجباری است. چندین نام فایل یا نام دایرکتوری پذیرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-output نام فایل ZIP خروجی. اجباری است. باید دارای پسوند \fB\&.zip\fP باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite آیا بازنویسی روی خروجی موجود مجاز است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-r, \-\-recursive ساختار دایرکتوری‌های مشخص‌شده را به صورت بازگشتی پیمایش می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-j, \-\-junk\-paths, \-\-no\-paths فقط نام فایل ذخیره‌شده را نگهداری می‌کند (مسیرها را نادیده می‌گیرد) و نام دایرکتوری‌ها را ذخیره نمی‌کند. به طور پیش‌فرض، sozip مسیر کامل (نسبت به دایرکتوری جاری) را ذخیره خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-sozip auto|yes|no در حالت \fBauto\fP، یک فایل فقط زمانی برای جستجو بهینه‌سازی (seek\-optimized) می‌شود که اندازه آن بیشتر از مقدار \fI\%\-\-sozip\-min\-file\-size\fP باشد. در حالت \fByes\fP، تمام فایل‌های ورودی برای جستجو بهینه‌سازی خواهند شد. در حالت \fBno\fP، هیچ‌کدام از فایل‌های ورودی برای جستجو بهینه‌سازی نخواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-sozip\-chunk\-size اندازه تکه (Chunk size) برای یک فایل بهینه‌سازی‌شده برای جستجو. مقدار پیش‌فرض 32768 بایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای \fBK\fP و \fBM\fP (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-sozip\-min\-file\-size حداقل اندازه فایل برای تصمیم‌گیری درباره این که آیا یک فایل باید برای جستجو بهینه‌سازی شود یا خیر، در حالت \-\-enable\-sozip=auto. مقدار پیش‌فرض 1 مگابایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای \fBK\fP، \fBM\fP یا \fBG\fP (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-content\-type نوع محتوا (Content\-Type) فایل در حال افزودن را به عنوان یک جفت کلید\-مقدار در پسوند فیلد اضافی \(aqKV\(aq (0x564b) که به ذخیره فراداده‌های کلید\-مقدار اختصاص دارد، ذخیره می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند). .UNINDENT .SS "چندریسمانی (Multithreading)" .sp گزینه پیکربندی \fI\%GDAL_NUM_THREADS\fP می‌تواند روی \fBALL_CPUS\fP یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. پیش‌فرض \fBALL_CPUS\fP است. .SS "مثال‌ها (Examples)" .SS "مثال ۱: ایجاد یک فایل ZIP، با پتانسیل بهینه‌سازی جستجو، با محتوای my.gpkg" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vsi sozip create my.gpkg my.gpkg.zip .EE .UNINDENT .UNINDENT .SS "مثال ۲: ایجاد یک فایل ZIP، با پتانسیل بهینه‌سازی جستجو، از محتوای یک دایرکتوری مبدا:" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vsi sozip create \-r source_dir/ my.gpkg.zip .EE .UNINDENT .UNINDENT .SH "GDAL VSI SOZIP OPTIMIZE" .SS "توضیحات (Description)" .sp ایجاد یک فایل zip جدید از محتوای یک فایل موجود، و در صورت لزوم اعمال بهینه‌سازی SOZip. .SS "خلاصه دستور (Synopsis)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vsi sozip optimize [OPTIONS] Create a Seek\-optimized ZIP (SOZIP) file from a regular ZIP file. Positional arguments: \-i, \-\-input Input ZIP filename [required] \-o, \-\-output Output ZIP filename [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-\-overwrite Whether overwriting existing output dataset is allowed \-\-enable\-sozip Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE\-SOZIP=auto|yes|no (default: auto) \-\-sozip\-chunk\-size Chunk size for a seek\-optimized file (default: 32768) \-\-sozip\-min\-file\-size Minimum file size to decide if a file should be seek\-optimized (default: 1 MB) .EE .UNINDENT .UNINDENT .SS "گزینه‌ها (Options)" .INDENT 0.0 .TP .B \-i, \-\-input نام فایل ZIP ورودی. اجباری است. .UNINDENT .INDENT 0.0 .TP .B \-o, \-\-output نام فایل ZIP خروجی. اجباری است. باید دارای پسوند \fB\&.zip\fP باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite آیا بازنویسی روی خروجی موجود مجاز است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-sozip auto|yes|no در حالت \fBauto\fP، یک فایل فقط در صورتی برای جستجو بهینه‌سازی (seek\-optimized) می‌شود که اندازه آن بالاتر از مقدار \fI\%\-\-sozip\-chunk\-size\fP باشد. در حالت \fByes\fP، تمام فایل‌های ورودی برای جستجو بهینه‌سازی خواهند شد. در حالت \fBno\fP، هیچ‌کدام از فایل‌های ورودی برای جستجو بهینه‌سازی نخواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-sozip\-chunk\-size اندازه تکه (Chunk size) برای یک فایل بهینه‌سازی‌شده برای جستجو. مقدار پیش‌فرض 32768 بایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K و M برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-sozip\-min\-file\-size حداقل اندازه فایل برای تصمیم‌گیری درباره این که آیا یک فایل باید برای جستجو بهینه‌سازی شود یا خیر، در حالت \-\-enable\-sozip=auto. مقدار پیش‌فرض 1 مگابایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K، M یا G برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند). .UNINDENT .SS "چندریسمانی (Multithreading)" .sp گزینه پیکربندی \fI\%GDAL_NUM_THREADS\fP می‌تواند روی \fBALL_CPUS\fP یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. پیش‌فرض \fBALL_CPUS\fP است. .SS "مثال‌ها (Examples)" .SS "مثال ۳: ایجاد یک فایل ZIP با پتانسیل بهینه‌سازی جستجو به نام sozip_optimized.zip از یک فایل ZIP موجود به نام in.zip." .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vsi sozip optimize in.zip sozip_optimized.zip .EE .UNINDENT .UNINDENT .SH "GDAL VSI SOZIP LIST" .SS "توضیحات (Description)" .sp فهرست کردن فایل‌های موجود در فایل zip با خروجی‌ای مشابه با ابزار Info\-ZIP \fBunzip\fP، همراه با افزودن یک ستون که نشان می‌دهد آیا هر فایل برای جستجو بهینه‌سازی شده است یا خیر. .SS "خلاصه دستور (Synopsis)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vsi sozip list [OPTIONS] List content of a ZIP file, with SOZIP related information. Positional arguments: \-i, \-\-input Input ZIP filename [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] .EE .UNINDENT .UNINDENT .SS "گزینه‌ها (Options)" .INDENT 0.0 .TP .B \-i, \-\-input نام فایل ZIP ورودی. اجباری است. .UNINDENT .SS "مثال‌ها (Examples)" .SS "مثال ۴: فهرست کردن محتویات my.zip." .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vsi sozip list my.zip .EE .UNINDENT .UNINDENT .SH "GDAL VSI SOZIP VALIDATE" .SS "توضیحات (Description)" .sp یک فایل SOZip را اعتبارسنجی می‌کند. اعتبارسنجی پایه ZIP به شکل سبک انجام می‌شود، و محدود به پیمایش رکوردهای ZIP با استفاده از خواننده ZIP مبتنی بر InfoZIP است که در GDAL استفاده می‌شود. اما اعتبارسنجی جنبه‌های اختصاصی SOZip به طور دقیق‌تر و کامل‌تری انجام می‌گیرد. .SS "خلاصه دستور (Synopsis)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vsi sozip list [OPTIONS] List content of a ZIP file, with SOZIP related information. Positional arguments: \-i, \-\-input Input ZIP filename [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] .EE .UNINDENT .UNINDENT .SS "گزینه‌ها (Options)" .INDENT 0.0 .TP .B \-i, \-\-input نام فایل ZIP ورودی. اجباری است. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند). .UNINDENT .INDENT 0.0 .TP .B \-v, \-\-verbose فعال‌سازی حالت پرگویی (verbose). .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SS "مثال‌ها (Examples)" .SS "مثال ۵: اعتبارسنجی my.zip." .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vsi sozip validate my.zip .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .