ZIPTOOL(1) General Commands Manual ZIPTOOL(1) نام (NAME) ziptool – ابزار ویرایش و دستکاری مستقیم آرشیوهای فشرده ZIP با استفاده از libzip خلاصه دستور (SYNOPSIS) ziptool [-ceghnrst] [-l length] [-o offset] zip-archive command [command-args ...] [command [command-args ...] ...] توضیحات (DESCRIPTION) ziptool آرشیو زیپ zip-archive را بر اساس دستورات داده‌شده ویرایش و دستکاری می‌کند. گزینه‌های پشتیبانی‌شده: -c بررسی یکپارچگی و صحت آرشیو زیپ هنگام باز کردن آن. -e در صورتی که آرشیو از قبل وجود داشته باشد خطا می‌دهد (فقط همراه با -n کاربرد دارد). -g حدس زدن کدگذاری نام فایل (برای دستور stat ). -h نمایش راهنما. -l length فقط خواندن length بایت از آرشیو. همچنین ببینید: -o. -n ایجاد آرشیو در صورتی که از قبل وجود نداشته باشد. همچنین ببینید: -e. -o offset شروع خواندن آرشیو ورودی از موقعیت بایت offset. همچنین ببینید: -l. -r چاپ کدگذاری خام نام فایل بدون تبدیل (برای دستور stat ). -s پیروی دقیق از قرارداد نام‌گذاری فایل (برای دستور stat ). -t نادیده گرفتن محتوای فعلی فایل (در صورت وجود). نکته: از این گزینه با احتیاط استفاده کنید؛ هنگام ویرایش آرشیو، تمام محتوای موجود فایل‌ها را پاک می‌کند. دستورات (Commands) در تمام دستورات زیر، شاخص‌ها بر پایه صفر (zero-based) هستند. به عبارت دیگر، اولین مدخل در آرشیو زیپ دارای شاخص ۰ است. دستورات و آرگومان‌های پشتیبانی‌شده عبارتند از: add name content افزودن فایلی با نام name با استفاده از رشته متنی content از خط فرمان به عنوان داده ورودی. add_dir name افزودن دایرکتوری با نام name. add_file name file_to_add offset len افزودن فایل name به آرشیو، با استفاده از len بایت از فایل file_to_add به عنوان داده ورودی، از موقعیت offset. add_from_zip name archivename index offset len افزودن فایلی با نام name به آرشیو با استفاده از داده‌های یک آرشیو زیپ دیگر به نام archivename از طریق مدخل با شاخص index و خواندن len بایت از موقعیت offset. cat index ارسال محتوای فایل مربوط به مدخل با شاخص index به خروجی استاندارد (stdout). count_extra index flags چاپ تعداد فیلدهای اضافی برای مدخل با شاخص index در آرشیو با استفاده از flags. count_extra_by_id index extra_id flags چاپ تعداد فیلدهای اضافی از نوع extra_id برای مدخل با شاخص index در آرشیو با استفاده از flags. delete index حذف مدخل با شاخص index از آرشیو زیپ. delete_extra index extra_idx flags حذف فیلد اضافی شماره extra_idx از مدخل با شاخص index در آرشیو با استفاده از flags. delete_extra_by_id index extra_id extra_index flags حذف فیلد اضافی شماره extra_index از نوع extra_id از مدخل با شاخص index در آرشیو با استفاده از flags. get_archive_comment چاپ توضیح آرشیو. get_archive_flag flag چاپ وضعیت فلگ آرشیو flag. get_extra index extra_index flags چاپ فیلد اضافی extra_index برای مدخل با شاخص index در آرشیو با استفاده از flags. get_extra_by_id index extra_id extra_index flags چاپ فیلد اضافی extra_index از نوع extra_id برای مدخل با شاخص index در آرشیو با استفاده از flags. get_file_comment index دریافت توضیح فایل برای مدخل با شاخص index در آرشیو. get_num_entries flags چاپ تعداد مدخل‌های موجود در آرشیو با استفاده از flags. name_locate name flags یافتن مدخل در آرشیو با نام فایل name با استفاده از flags و چاپ شاخص آن. rename index name تغییر نام مدخل با شاخص index در آرشیو به name. replace_file_contents index data جایگزین کردن محتوای فایل برای مدخل با شاخص index در آرشیو با رشته متنی data. set_archive_comment comment تنظیم توضیح آرشیو به comment. set_archive_flag flag value تنظیم فلگ آرشیو flag به مقدار value. set_extra index extra_id extra_index flags value تنظیم فیلد اضافی شماره extra_index از نوع extra_id برای مدخل با شاخص index در آرشیو با استفاده از flags به مقدار value. set_file_comment index comment تنظیم توضیح فایل برای مدخل با شاخص index در آرشیو به رشته متنی comment. set_file_compression index method compression_flags تنظیم روش فشرده‌سازی فایل برای مدخل با شاخص index در آرشیو به method با استفاده از compression_flags. نکته: در حال حاضر، compression_flags نادیده گرفته می‌شوند. set_file_encryption index method password تنظیم روش رمزگذاری فایل برای مدخل با شاخص index در آرشیو به method همراه با گذرواژه password. set_file_mtime index timestamp تنظیم زمان آخرین تغییر فایل (mtime) برای مدخل با شاخص index در آرشیو به برچسب زمان یونیکس timestamp. set_file_mtime_all timestamp تنظیم زمان آخرین تغییر (mtime) برای تمام مدخل‌های آرشیو به برچسب زمان یونیکس timestamp. set_password password تنظیم گذرواژه پیش‌فرض برای رمزگذاری/رمزگشایی به password. stat index چاپ اطلاعات مربوط به مدخل با شاخص index در آرشیو. فلگ‌ها (Flags) برخی دستورات آرگومان‌هایی از نوع فلگ دریافت می‌کنند. هر کاراکتر در آرگومان، فلگ متناظر را فعال می‌کند. برای عدم استفاده از فلگ‌ها از 0 یا یک رشته خالی استفاده کنید. فلگ‌های پشتیبانی‌شده عبارتند از: 4 ZIP_FL_ENC_CP437 8 ZIP_FL_ENC_UTF_8 C ZIP_FL_NOCASE c ZIP_FL_CENTRAL d ZIP_FL_NODIR l ZIP_FL_LOCAL r ZIP_FL_ENC_RAW s ZIP_FL_ENC_STRICT u ZIP_FL_UNCHANGED فلگ‌های آرشیو (Archive flags) دستورات get_archive_flag و set_archive_flag روی فلگ‌های زیر کار می‌کنند: • create-or-keep-empty-file-for-archive • is-torrentzip • rdonly • want-torrentzip روش‌های فشرده‌سازی (Compression Methods) برخی دستورات آرگومان‌های مربوط به روش فشرده‌سازی دریافت می‌کنند. روش‌های پشتیبانی‌شده عبارتند از: • default • deflate • store روش‌های رمزگذاری (Encryption Methods) برخی دستورات آرگومان‌های مربوط به روش رمزگذاری دریافت می‌کنند. روش‌های پشتیبانی‌شده عبارتند از: • none • AES-128 • AES-192 • AES-256 وضعیت خروج (EXIT STATUS) The ziptool utility exits 0 on success, and >0 if an error occurs. مثال‌ها (EXAMPLES) افزودن فایلی با نام teststring.txt به آرشیو زیپ testbuffer.zip با داده متنی “This is a test.\n” که در آن “\n” با نویسه خط جدید جایگزین می‌شود: ziptool testbuffer.zip add teststring.txt حذف اولین فایل از آرشیو زیپ testfile.zip: ziptool testfile.zip delete 0 همچنین ببینید (SEE ALSO) zipcmp(1), zipmerge(1), libzip(3) تاریخچه (HISTORY) ziptool در libzip 1.1 افزوده شد. نویسندگان (AUTHORS) Dieter Baron و Thomas Klausner Linux 6.12.107+deb13-amd64 January 23, 2023 Linux 6.12.107+deb13-amd64