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              GDAL-VSI-SOZIP(1)