نام (NAME)

sozip - ایجاد و مدیریت فایل‌های فشرده SOZip

در نسخه 3.7 اضافه شد.

خلاصه دستور (SYNOPSIS)

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>]...

توضیحات (DESCRIPTION)

ابزار sozip می‌تواند برای موارد زیر استفاده شود:

ایجاد یک فایل SOZip (Seek-Optimized ZIP)
افزودن فایل‌ها به یک فایل ZIP/SOZip موجود
فهرست کردن محتویات یک فایل ZIP/SOZip
اعتبارسنجی یک فایل SOZip
تبدیل یک فایل Zip موجود به یک فایل بهینه‌شده با SOZip

نکته:

معادل در رابط خط فرمان جدید "gdal":

دستور gdal vsi sozip را ببینید.

گزینه‌ها (OPTIONS)

--help: نمایش این پیام راهنما و خروج.

--help-general: ارائه یک پیام استفاده کوتاه برای گزینه‌های عمومی خط فرمان GDAL و خروج.

--quiet: حالت بی‌صدا. هیچ پیام پیشرفتی در خروجی استاندارد ارسال نمی‌شود.

--verbose: حالت پرحرف (همراه با جزئیات).

-g

--grow: افزودن محتوای نام‌فایل(های) مشخص‌شده به یک فایل zip موجود. این حالت پیش‌فرض ابزار است. این سوییچ برای سازگاری با ابزار zip در Info-ZIP قرار داده شده است.

--overwrite: بازنویسی فایل zip مقصد در صورتی که از قبل وجود داشته باشد.

-l

--list: فهرست کردن فایل‌های موجود در فایل zip در قالبی مشابه با ابزار unzip در Info-ZIP، اما با افزودن یک ستون که نشان می‌دهد آیا هر فایل برای جست‌وجو بهینه‌سازی شده است یا خیر.

--validate: اعتبارسنجی یک فایل SOZip. اعتبارسنجی پایه ZIP به صورت سبک انجام می‌شود و محدود به توانایی پیمایش رکوردهای ZIP با خواننده ZIP مبتنی بر InfoZIP مورد استفاده در GDAL است. اما اعتبارسنجی جنبه‌های خاص SOZip با دقت و جامعیت بیشتری انجام می‌شود.

-r

--recurse-paths: پیمایش بازگشتی ساختار پوشه‌های مشخص‌شده.

-j

--junk-paths: ذخیره فقط نام فایل ذخیره‌شده (حذف مسیر) و ذخیره نکردن نام پوشه‌ها. به طور پیش‌فرض، sozip مسیر کامل (نسبت به دایرکتوری جاری) را ذخیره می‌کند.

--optimize-from=<input.zip>: پردازش مجدد {input.zip} برای تولید یک .zip بهینه‌شده با SOZip. گزینه‌های --enable-sozip, --sozip-chunk-size و --sozip-min-file-size می‌توانند در این حالت استفاده شوند.

--enable-sozip={auto|yes|no}: در حالت auto، یک فایل تنها در صورتی برای جست‌وجو بهینه می‌شود که اندازه آن بیشتر از مقدار --sozip-min-file-size باشد. در حالت yes، تمام فایل‌های ورودی برای جست‌وجو بهینه خواهند شد. در حالت no، هیچ فایل ورودی برای جست‌وجو بهینه نخواهد شد.

--sozip-chunk-size=<value>: اندازه هر تکه (Chunk) برای یک فایل بهینه‌شده جهت جست‌وجو. مقدار پیش‌فرض 32768 بایت است. مقدار به بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K و M برای مشخص کردن مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.

--sozip-min-file-size=<value>: حداقل اندازه فایل برای تصمیم‌گیری در مورد اینکه آیا یک فایل باید در حالت --enable-sozip=auto برای جست‌وجو بهینه شود یا خیر. مقدار پیش‌فرض 1 مگابایت است. مقدار به بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K، M یا G برای مشخص کردن مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.

--content-type=<value>: ذخیره نوع محتوا (Content-Type) برای فایل در حال افزودن به عنوان یک جفت کلید-مقدار در بخش افزونه فیلد اضافی 'KV' (0x564b) اختصاص‌یافته به ذخیره متادیتای کلید-مقدار.

<zip_filename>: نام فایل zip برای ایجاد، افزودن یا فهرست‌بندی.

<filename>: نام فایلی که باید اضافه شود.

چندریسمانی (MULTITHREADING)

گزینه پیکربندی GDAL_NUM_THREADS می‌تواند روی ALL_CPUS یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. مقدار پیش‌فرض ALL_CPUS است.

کد وضعیت خروجی (RETURN STATUS CODE)

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).