| GDAL-VSI-SOZIP(1) | GDAL | GDAL-VSI-SOZIP(1) |
نام (NAME)
gdal-vsi-sozip - دستورهای مربوط به SOZIP (فایل ZIP بهینهسازیشده برای دسترسی تصادفی و جستجو)
افزودهشده در نسخه 3.11.
توضیحات (DESCRIPTION)
ابزار gdal vsi sozip میتواند برای موارد زیر استفاده شود:
- ایجاد یک فایل SOZip (Seek-Optimized ZIP)
- افزودن فایلها به یک فایل ZIP/SOZip موجود
- فهرست کردن محتویات یک فایل ZIP/SOZip
- اعتبارسنجی یک فایل SOZip
- تبدیل یک فایل Zip موجود به یک فایل بهینهسازیشده SOZip
خلاصه دستور (SYNOPSIS)
Usage: gdal vsi sozip <SUBCOMMAND> [OPTIONS] where <SUBCOMMAND> 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 <KEY>=<VALUE> Configuration option [may be repeated]
GDAL VSI SOZIP CREATE
توضیحات (Description)
یک یا چند فایل را به یک فایل zip جدید یا موجود اضافه میکند.
خلاصه دستور (Synopsis)
Usage: gdal vsi sozip create [OPTIONS] <INPUT> <OUTPUT> Create a Seek-optimized ZIP (SOZIP) file. Positional arguments: -i, --input <INPUT> Input filenames [may be repeated] [required] -o, --output <OUTPUT> Output ZIP filename [required] Common Options: -h, --help Display help message and exit --json-usage Display usage as JSON document and exit --config <KEY>=<VALUE> 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 <ENABLE-SOZIP> Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE-SOZIP=auto|yes|no (default: auto) --sozip-chunk-size <value in bytes or with K/M suffix> Chunk size for a seek-optimized file (default: 32768) --sozip-min-file-size <value in bytes or with K/M/G suffix> Minimum file size to decide if a file should be seek-optimized (default: 1 MB) --content-type <CONTENT-TYPE> Store the Content-Type of the file being added.
گزینهها (Options)
- -i, --input <INPUT>
- نام فایلهای ورودی. اجباری است. چندین نام فایل یا نام دایرکتوری پذیرفته میشود.
- -o, --output <OUTPUT>
- نام فایل ZIP خروجی. اجباری است. باید دارای پسوند .zip باشد.
- --overwrite
- آیا بازنویسی روی خروجی موجود مجاز است یا خیر.
- -r, --recursive
- ساختار دایرکتوریهای مشخصشده را به صورت بازگشتی پیمایش میکند.
- -j, --junk-paths, --no-paths
- فقط نام فایل ذخیرهشده را نگهداری میکند (مسیرها را نادیده میگیرد) و نام دایرکتوریها را ذخیره نمیکند. به طور پیشفرض، sozip مسیر کامل (نسبت به دایرکتوری جاری) را ذخیره خواهد کرد.
- --enable-sozip auto|yes|no
- در حالت auto، یک فایل فقط زمانی برای جستجو بهینهسازی (seek-optimized) میشود که اندازه آن بیشتر از مقدار --sozip-min-file-size باشد. در حالت yes، تمام فایلهای ورودی برای جستجو بهینهسازی خواهند شد. در حالت no، هیچکدام از فایلهای ورودی برای جستجو بهینهسازی نخواهند شد.
- --sozip-chunk-size <value>
- اندازه تکه (Chunk size) برای یک فایل بهینهسازیشده برای جستجو. مقدار پیشفرض 32768 بایت است. مقدار بر حسب بایت مشخص میشود، یا میتوان به ترتیب از پسوندهای K و M (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.
- --sozip-min-file-size <value>
- حداقل اندازه فایل برای تصمیمگیری درباره این که آیا یک فایل باید برای جستجو بهینهسازی شود یا خیر، در حالت --enable-sozip=auto. مقدار پیشفرض 1 مگابایت است. مقدار بر حسب بایت مشخص میشود، یا میتوان به ترتیب از پسوندهای K، M یا G (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
- --content-type <value>
- نوع محتوا (Content-Type) فایل در حال افزودن را به عنوان یک جفت کلید-مقدار در پسوند فیلد اضافی 'KV' (0x564b) که به ذخیره فرادادههای کلید-مقدار اختصاص دارد، ذخیره میکند.
- -q, --quiet
- هیچ پیام اطلاعرسانی چاپ نشود (تنها خطاها چاپ میشوند).
چندریسمانی (Multithreading)
گزینه پیکربندی GDAL_NUM_THREADS میتواند روی ALL_CPUS یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمانهای مورد استفاده برای فایلهای فشردهشده با SOZip را مشخص کند. پیشفرض ALL_CPUS است.
مثالها (Examples)
مثال ۱: ایجاد یک فایل ZIP، با پتانسیل بهینهسازی جستجو، با محتوای my.gpkg
gdal vsi sozip create my.gpkg my.gpkg.zip
مثال ۲: ایجاد یک فایل ZIP، با پتانسیل بهینهسازی جستجو، از محتوای یک دایرکتوری مبدا:
gdal vsi sozip create -r source_dir/ my.gpkg.zip
GDAL VSI SOZIP OPTIMIZE
توضیحات (Description)
ایجاد یک فایل zip جدید از محتوای یک فایل موجود، و در صورت لزوم اعمال بهینهسازی SOZip.
خلاصه دستور (Synopsis)
Usage: gdal vsi sozip optimize [OPTIONS] <INPUT> <OUTPUT> Create a Seek-optimized ZIP (SOZIP) file from a regular ZIP file. Positional arguments: -i, --input <INPUT> Input ZIP filename [required] -o, --output <OUTPUT> Output ZIP filename [required] Common Options: -h, --help Display help message and exit --json-usage Display usage as JSON document and exit --config <KEY>=<VALUE> 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 <ENABLE-SOZIP> Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE-SOZIP=auto|yes|no (default: auto) --sozip-chunk-size <value in bytes or with K/M suffix> Chunk size for a seek-optimized file (default: 32768) --sozip-min-file-size <value in bytes or with K/M/G suffix> Minimum file size to decide if a file should be seek-optimized (default: 1 MB)
گزینهها (Options)
- -i, --input <INPUT>
- نام فایل ZIP ورودی. اجباری است.
- -o, --output <OUTPUT>
- نام فایل ZIP خروجی. اجباری است. باید دارای پسوند .zip باشد.
- --overwrite
- آیا بازنویسی روی خروجی موجود مجاز است یا خیر.
- --enable-sozip auto|yes|no
- در حالت auto، یک فایل فقط در صورتی برای جستجو بهینهسازی (seek-optimized) میشود که اندازه آن بالاتر از مقدار --sozip-chunk-size باشد. در حالت yes، تمام فایلهای ورودی برای جستجو بهینهسازی خواهند شد. در حالت no، هیچکدام از فایلهای ورودی برای جستجو بهینهسازی نخواهند شد.
- --sozip-chunk-size <value>
- اندازه تکه (Chunk size) برای یک فایل بهینهسازیشده برای جستجو. مقدار پیشفرض 32768 بایت است. مقدار بر حسب بایت مشخص میشود، یا میتوان به ترتیب از پسوندهای K و M برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.
- --sozip-min-file-size <value>
- حداقل اندازه فایل برای تصمیمگیری درباره این که آیا یک فایل باید برای جستجو بهینهسازی شود یا خیر، در حالت --enable-sozip=auto. مقدار پیشفرض 1 مگابایت است. مقدار بر حسب بایت مشخص میشود، یا میتوان به ترتیب از پسوندهای K، M یا G برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
- -q, --quiet
- هیچ پیام اطلاعرسانی چاپ نشود (تنها خطاها چاپ میشوند).
چندریسمانی (Multithreading)
گزینه پیکربندی GDAL_NUM_THREADS میتواند روی ALL_CPUS یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمانهای مورد استفاده برای فایلهای فشردهشده با SOZip را مشخص کند. پیشفرض ALL_CPUS است.
مثالها (Examples)
مثال ۳: ایجاد یک فایل ZIP با پتانسیل بهینهسازی جستجو به نام sozip_optimized.zip از یک فایل ZIP موجود به نام in.zip.
gdal vsi sozip optimize in.zip sozip_optimized.zip
GDAL VSI SOZIP LIST
توضیحات (Description)
فهرست کردن فایلهای موجود در فایل zip با خروجیای مشابه با ابزار Info-ZIP unzip، همراه با افزودن یک ستون که نشان میدهد آیا هر فایل برای جستجو بهینهسازی شده است یا خیر.
خلاصه دستور (Synopsis)
Usage: gdal vsi sozip list [OPTIONS] <INPUT> List content of a ZIP file, with SOZIP related information. Positional arguments: -i, --input <INPUT> Input ZIP filename [required] Common Options: -h, --help Display help message and exit --json-usage Display usage as JSON document and exit --config <KEY>=<VALUE> Configuration option [may be repeated]
گزینهها (Options)
- -i, --input <INPUT>
- نام فایل ZIP ورودی. اجباری است.
مثالها (Examples)
مثال ۴: فهرست کردن محتویات my.zip.
gdal vsi sozip list my.zip
GDAL VSI SOZIP VALIDATE
توضیحات (Description)
یک فایل SOZip را اعتبارسنجی میکند. اعتبارسنجی پایه ZIP به شکل سبک انجام میشود، و محدود به پیمایش رکوردهای ZIP با استفاده از خواننده ZIP مبتنی بر InfoZIP است که در GDAL استفاده میشود. اما اعتبارسنجی جنبههای اختصاصی SOZip به طور دقیقتر و کاملتری انجام میگیرد.
خلاصه دستور (Synopsis)
Usage: gdal vsi sozip list [OPTIONS] <INPUT> List content of a ZIP file, with SOZIP related information. Positional arguments: -i, --input <INPUT> Input ZIP filename [required] Common Options: -h, --help Display help message and exit --json-usage Display usage as JSON document and exit --config <KEY>=<VALUE> Configuration option [may be repeated]
گزینهها (Options)
- -i, --input <INPUT>
- نام فایل ZIP ورودی. اجباری است.
- -q, --quiet
- هیچ پیام اطلاعرسانی چاپ نشود (تنها خطاها چاپ میشوند).
- -v, --verbose
- فعالسازی حالت پرگویی (verbose).
کد وضعیت خروجی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند، به عنوان اجرای موفق در نظر گرفته میشوند).
مثالها (Examples)
مثال ۵: اعتبارسنجی my.zip.
gdal vsi sozip validate my.zip
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |