.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2003-2007 Tim Kientzle
.\" Copyright (c) 2017 Martin Matuska
.\" All rights reserved.
.\"
.Dd April 23, 2024
.Dt TAR 1
.Os
.Sh "نام (NAME)"
.Nm tar
.Nd دستکاری و مدیریت بایگانیهای پرونده
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar bundled-flags Ao args Ac
.Op Ao Ar file Ac | Ao Ar pattern Ac ...
.Nm
.Brq Fl c
.Op Ar options
.Op Ar files | Ar directories
.Nm
.Brq Fl r | Fl u
.Fl f Ar archive-file
.Op Ar options
.Op Ar files | Ar directories
.Nm
.Brq Fl t | Fl x
.Op Ar options
.Op Ar patterns
.Sh "توضیحات (DESCRIPTION)"
.Nm
پرونده‌های بایگانی جریانی را ایجاد و دستکاری می‌کند.
این پیاده‌سازی می‌تواند از تصاویر cdrom استاندارد ISO 9660 و پرونده‌های
tar، pax، cpio، zip، jar، ar، xar، rar، rpm و 7-zip استخراج کند و می‌تواند
بایگانی‌های tar، pax، cpio، ar، zip، 7-zip و shar را بسازد.
.Pp
شکل نخست خلاصه دستور یک کلمهٔ گزینهٔ
.Dq bundled
را نشان می‌دهد.
این کاربرد برای سازگاری با پیاده‌سازی‌های قدیمی فراهم شده است.
برای جزئیات بیشتر به بخش
.Sx "سازگاری (COMPATIBILITY)"
در ادامه مراجعه کنید.
.Pp
سایر شکل‌های خلاصه دستور، کاربرد ترجیحی را نشان می‌دهند.
نخستین گزینه برای
.Nm
یک نشانگر حالت از فهرست زیر است:
.Pp
.Bl -tag -compact -width indent
.It Fl c
یک بایگانی جدید حاوی موارد مشخص‌شده ایجاد می‌کند.
شکل طولانی این گزینه
.Fl Fl create
است.
.It Fl r
مانند
.Fl c
است، اما ورودی‌های جدید به انتهای بایگانی افزوده می‌شوند.
توجه داشته باشید که این ویژگی فقط روی بایگانی‌های فشرده‌نشده ذخیره‌شده در پرونده‌های معمولی کار می‌کند.
گزینهٔ
.Fl f
الزامی است.
شکل طولانی این گزینه
.Fl Fl append
است.
.It Fl t
فهرست کردن محتویات بایگانی در stdout.
فرم طولانی این گزینه عبارت است از
.Fl Fl list .
.It Fl u
مانند
.Fl r ,
اما ورودی‌های جدید تنها در صورتی اضافه می‌شوند که تاریخ تغییر آن‌ها
جدیدتر از ورودی متناظر در بایگانی باشد.
توجه داشته باشید که این ویژگی فقط روی بایگانی‌های فشرده‌نشده ذخیره‌شده در پرونده‌های معمولی کار می‌کند.
گزینه
.Fl f
الزامی است.
فرم طولانی عبارت است از
.Fl Fl update .
.It Fl x
استخراج از بایگانی بر روی دیسک.
اگر پرونده‌ای با نام یکسان بیش از یک بار در بایگانی ظاهر شود،
هر نسخه استخراج خواهد شد و نسخه‌های بعدی بر روی نسخه‌های قبلی بازنویسی (جایگزین) می‌شوند.
فرم طولانی این گزینه عبارت است از
.Fl Fl extract .
.El
.Pp
در حالت‌های
.Fl c ,
.Fl r ,
یا
.Fl u ,
هر پرونده یا دایرکتوری مشخص‌شده، به ترتیبی که در خط فرمان تعیین شده به
بایگانی اضافه می‌شود.
به‌طور پیشفرض، محتویات هر دایرکتوری نیز بایگانی می‌شوند.
.Pp
در حالت استخراج یا فهرست، کل خط فرمان
پیش از باز شدن بایگانی خوانده و تجزیه می‌شود.
نام مسیرها یا الگوهای موجود در خط فرمان مشخص می‌کنند
که کدام موارد در بایگانی باید پردازش شوند.
الگوها، الگوهای تطبیق به سبک پوسته (globbing) هستند، همان‌طور که مستند شده در
.Xr tcsh 1 .
.Sh "گزینهها (OPTIONS)"
مگر اینکه صراحتاً خلاف آن ذکر شده باشد، گزینه‌ها در تمام
حالت‌های کاری قابل اعمال هستند.
.Bl -tag -width indent
.It Cm @ Ns Pa archive
(تنها در حالت‌های c و r)
بایگانی مشخص‌شده باز می‌شود و ورودی‌های
درون آن به بایگانی فعلی اضافه خواهند شد.
به عنوان یک مثال ساده،
.Pp
.Dl Nm Fl c Fl f Pa - Pa newfile Cm @ Ns Pa original.tar
.Pp
یک بایگانی جدید در خروجی استاندارد می‌نویسد، شامل پرونده
.Pa newfile
و تمام ورودی‌های موجود در
.Pa original.tar .
در مقابل،
.Pp
.Dl Nm Fl c Fl f Pa - Pa newfile Pa original.tar
.Pp
یک بایگانی جدید تنها با دو ورودی ایجاد می‌کند.
به همین ترتیب،
.Pp
.Dl Nm Fl czf Pa - Fl Fl format Cm pax Cm @ Ns Pa -
.Pp
یک بایگانی را از ورودی استاندارد (که قالب آن به‌طور خودکار
تعیین خواهد شد) می‌خواند و آن را به یک بایگانی با قالب pax
و فشرده‌سازی gzip در خروجی استاندارد تبدیل می‌کند.
به این ترتیب،
.Nm
می‌تواند برای تبدیل بایگانی‌ها از یک قالب به قالبی دیگر استفاده شود.
.It Fl a , Fl Fl auto-compress
(تنها در حالت c)
از پسوند بایگانی برای تعیین مجموعه قالب و
فشرده‌سازی‌ها استفاده می‌کند.
به‌عنوان یک مثال ساده،
.Pp
.Dl Nm Fl a Fl cf Pa archive.tgz source.c source.h
.Pp
یک بایگانی جدید با قالب محدودشده pax و فشرده‌سازی gzip ایجاد می‌کند،
.Pp
.Dl Nm Fl a Fl cf Pa archive.tar.bz2.uu source.c source.h
.Pp
یک بایگانی جدید با قالب محدودشده pax و فشرده‌سازی bzip2
و فشرده‌سازی uuencode ایجاد می‌کند،
.Pp
.Dl Nm Fl a Fl cf Pa archive.zip source.c source.h
.Pp
یک بایگانی جدید با قالب zip ایجاد می‌کند،
.Pp
.Dl Nm Fl a Fl jcf Pa archive.tgz source.c source.h
.Pp
گزینه
.Dq -j
را نادیده می‌گیرد و یک بایگانی جدید با قالب محدودشده pax
و فشرده‌سازی gzip ایجاد می‌کند،
.Pp
.Dl Nm Fl a Fl jcf Pa archive.xxx source.c source.h
.Pp
اگر پسوند ناشناخته باشد یا پسوندی وجود نداشته باشد، یک بایگانی جدید با
قالب محدودشده pax و فشرده‌سازی bzip2 ایجاد می‌کند.
.It Fl Fl acls
(تنها در حالت‌های c، r، u و x)
بایگانی یا استخراج ACLهای POSIX.1e یا NFSv4.
این برعکس
.Fl Fl no-acls
و رفتار پیش‌فرض در حالت‌های c، r و u (به‌جز در Mac OS X) است، یا اگر
.Nm
در حالت x به‌صورت root اجرا شود.
در Mac OS X این گزینه ACLهای گسترش‌یافته را به ACLهای NFSv4 تبدیل می‌کند.
برای ذخیره ACLهای گسترش‌یافته، گزینه
.Fl Fl mac-metadata
ترجیح داده می‌شود.
.It Fl B , Fl Fl read-full-blocks
به‌منظور سازگاری با سایر پیاده‌سازی‌های
.Xr tar 1
نادیده گرفته می‌شود.
.It Fl b Ar blocksize , Fl Fl block-size Ar blocksize
اندازه بلوک را بر حسب رکوردهای 512 بایتی، برای ورودی/خروجی درایو نوار مشخص می‌کند.
به‌عنوان یک قاعده کلی، این آرگومان تنها هنگام خواندن از یا نوشتن در
درایوهای نوار مورد نیاز است و معمولاً حتی در آن حالت نیز نیازی نیست، زیرا اندازه بلوک پیش‌فرض
20 رکورد (10240 بایت) بسیار متداول است.
.It Fl C Ar directory , Fl Fl cd Ar directory , Fl Fl directory Ar directory
در حالت‌های c و r، این گزینه پوشه را پیش از افزودن پرونده‌های بعدی تغییر می‌دهد.
در حالت x، پس از باز کردن بایگانی اما پیش از استخراج ورودی‌ها از بایگانی، پوشه را تغییر می‌دهد.
.It Fl Fl chroot
(تنها در حالت x)
.Fn chroot
به پوشهٔ جاری پس از پردازش هرگونه گزینهٔ
.Fl C
و پیش از استخراج هر پرونده‌ای.
.It Fl Fl clamp-mtime
(استفاده همراه با
.Fl Fl mtime )
زمان تغییر تنها در صورتی تنظیم می‌شود که پرونده جدیدتر باشد از تاریخ مشخص‌شده در
.Fl Fl mtime .
.It Fl Fl clear-nochange-fflags
(تنها در حالت x)
پیش از حذف اشیای سامانهٔ پرونده به منظور جایگزینی آن‌ها، صفت‌های پرونده یا پرچم‌های پروندهٔ ویژهٔ سکو را که ممکن است مانع از حذف شوند، پاک می‌کند.
.It Fl Fl exclude Ar pattern
پرونده‌ها یا پوشه‌هایی را که با الگوی مشخص‌شده مطابقت دارند، پردازش نمی‌کند.
توجه داشته باشید که استثناها بر الگوها یا نام‌های پروندهٔ مشخص‌شده در خط فرمان اولویت دارند.
.It Fl Fl exclude-vcs
پرونده‌ها یا پوشه‌هایی را که به‌طور داخلی توسط این سامانه‌های کنترل نسخه استفاده می‌شوند، پردازش نمی‌کند:
.Sq Arch ,
.Sq Bazaar ,
.Sq CVS ,
.Sq Darcs ,
.Sq Mercurial ,
.Sq RCS ,
.Sq SCCS ,
.Sq SVN
و
.Sq git .
.It Fl Fl fflags
(تنها در حالت‌های c، r، u و x)
صفت‌های پرونده یا پرچم‌های پروندهٔ ویژهٔ سکو را بایگانی یا استخراج می‌کند.
این رفتار برعکس
.Fl Fl no-fflags
بوده و رفتار پیش‌فرض در حالت‌های c، r و u است، یا اگر
.Nm
در حالت x با دسترسی root اجرا شود.
.It Fl Fl format Ar format
(تنها در حالت‌های c، r و u)
از قالب مشخص‌شده برای بایگانی ایجادشده استفاده می‌کند.
قالب‌های پشتیبانی‌شده عبارتند از:
.Dq cpio ,
.Dq pax ,
.Dq shar ,
و
.Dq ustar .
سایر قالب‌ها نیز ممکن است پشتیبانی شوند؛ برای کسب اطلاعات بیشتر دربارهٔ قالب‌های پشتیبانی‌شدهٔ کنونی به
.Xr libarchive-formats 5
مراجعه کنید.
در حالت‌های r و u، هنگام گسترش یک بایگانی موجود، قالب مشخص‌شده در اینجا باید با قالب بایگانی موجود روی دیسک سازگار باشد.
.It Fl f Ar file , Fl Fl file Ar file
خواندن بایگانی از پروندهٔ مشخص‌شده یا نوشتن در آن.
نام پرونده برای ورودی استاندارد یا خروجی استاندارد می‌تواند
.Pa -
باشد.
مقدار پیش‌فرض بسته به سیستم متفاوت است؛
در
.Fx ،
پیش‌فرض
.Pa /dev/sa0
است؛ در لینوکس، پیش‌فرض
.Pa /dev/st0
است.
.It Fl Fl gid Ar id
استفاده از شماره شناسهٔ گروه ارائه‌شده.
هنگام استخراج، این گزینه جایگزین شناسهٔ گروه در بایگانی می‌شود؛
نام گروه در بایگانی نادیده گرفته خواهد شد.
هنگام ایجاد، این گزینه جایگزین شناسهٔ گروه خوانده‌شده از دیسک می‌شود؛
اگر
.Fl Fl gname
نیز مشخص نشده باشد، نام گروه مطابق با شناسهٔ گروه تنظیم خواهد شد.
.It Fl Fl gname Ar name
استفاده از نام گروه ارائه‌شده.
هنگام استخراج، این گزینه جایگزین نام گروه در بایگانی می‌شود؛
اگر نام گروه ارائه‌شده در سیستم وجود نداشته باشد،
شناسهٔ گروه
(از بایگانی یا از گزینهٔ
.Fl Fl gid )
به‌جای آن استفاده خواهد شد.
هنگام ایجاد، این گزینه نام گروهی را که در بایگانی ذخیره خواهد شد تنظیم می‌کند؛
این نام در برابر پایگاه‌دادهٔ گروه‌های سیستم اعتبارسنجی نخواهد شد.
.It Fl Fl group Ar name Ns Op : Ns Ar gid
استفاده از گروه ارائه‌شده؛ اگر
.Ar gid
ارائه نشده باشد،
.Ar name
می‌تواند نام گروه یا شناسهٔ عددی باشد.
برای جزئیات، گزینهٔ
.Fl Fl gname
را ببینید.
.It Fl H
(فقط در حالت‌های c و r)
پیوندهای نمادین ذکرشده در خط فرمان دنبال خواهند شد؛
هدف پیوند بایگانی خواهد شد، نه خود پیوند.
.It Fl h
(فقط در حالت‌های c و r)
مترادفی برای
.Fl L .
.It Fl I
مترادفی برای
.Fl T .
.It Fl Fl help
نمایش راهنمای استفاده.
.It Fl Fl hfsCompression
(فقط در حالت x)
ویژهٔ Mac OS X (نسخهٔ 10.6 یا بالاتر). پرونده‌های عادی استخراج‌شده را با فشرده‌سازی HFS+
فشرده می‌کند.
.It Fl Fl ignore-zeros
نام مستعاری برای
.Fl Fl options Cm read_concatenated_archives
جهت سازگاری با GNU tar.
.It Fl Fl include Ar pattern
تنها پرونده‌ها یا پوشه‌هایی را پردازش می‌کند که با الگوی مشخص‌شده مطابقت دارند.
توجه داشته باشید که استثناهای مشخص‌شده با
.Fl Fl exclude
بر موارد گنجانده‌شده اولویت دارند.
اگر هیچ موردی برای گنجاندن به‌طور صریح مشخص نشده باشد، همه ورودی‌ها به‌طور
پیش‌فرض پردازش می‌شوند.
گزینهٔ
.Fl Fl include
به‌ویژه هنگام فیلتر کردن بایگانی‌ها مفید است.
برای مثال، دستور
.Pp
.Dl Nm Fl c Fl f Pa new.tar Fl Fl include='*foo*' Cm @ Ns Pa old.tgz
.Pp
یک بایگانی جدید
.Pa new.tar
ایجاد می‌کند که تنها شامل ورودی‌هایی از
.Pa old.tgz
است، حاوی رشتهٔ
.Sq foo .
.It Fl J , Fl Fl xz
(تنها در حالت c)
فشرده‌سازی بایگانی حاصل با
.Xr xz 1 .
در حالت‌های استخراج یا فهرست، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی
.Nm tar
فشرده‌سازی XZ را هنگام خواندن بایگانی‌ها به‌طور خودکار تشخیص می‌دهد.
.It Fl j , Fl Fl bzip , Fl Fl bzip2 , Fl Fl bunzip2
(تنها در حالت c)
فشرده‌سازی بایگانی حاصل با
.Xr bzip2 1 .
در حالت‌های استخراج یا فهرست، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی
.Nm tar
فشرده‌سازی bzip2 را هنگام خواندن بایگانی‌ها به‌طور خودکار
تشخیص می‌دهد.
.It Fl k , Fl Fl keep-old-files
(تنها در حالت x)
پرونده‌های موجود را بازنویسی نمی‌کند.
به‌ویژه، اگر یک پرونده بیش از یک بار در یک بایگانی ظاهر شود،
نسخه‌های بعدی بر روی نسخه‌های قبلی بازنویسی نخواهند شد.
.It Fl Fl keep-newer-files
(تنها در حالت x)
پرونده‌های موجودی را که جدیدتر از نسخه‌های موجود در
بایگانی در حال استخراج هستند، بازنویسی نمی‌کند.
.It Fl L , Fl Fl dereference
(تنها در حالت‌های c و r)
همه پیوندهای نمادین دنبال خواهند شد.
به‌طور معمول، پیوندهای نمادین همان‌گونه که هستند بایگانی می‌شوند.
با این گزینه، در عوض مقصد پیوند بایگانی خواهد شد.
.It Fl l , Fl Fl check-links
(تنها در حالت‌های c و r)
یک پیام هشدار صادر می‌کند مگر اینکه همه پیوندها به هر پرونده بایگانی شده باشند.
.It Fl Fl lrzip
(تنها در حالت c)
فشرده‌سازی بایگانی حاصل با
.Xr lrzip 1 .
در حالت‌های استخراج یا فهرست، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی
.Nm tar
فشرده‌سازی lrzip را هنگام خواندن بایگانی‌ها به‌طور خودکار
تشخیص می‌دهد.
.It Fl Fl lz4
(تنها در حالت c)
بایگانی را پیش از نوشتن، با فشرده‌سازی سازگار با lz4 فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
فشرده‌سازی lz4 را هنگام خواندن بایگانی‌ها به صورت خودکار تشخیص می‌دهد.
.It Fl Fl zstd
(تنها در حالت c)
بایگانی را پیش از نوشتن، با فشرده‌سازی سازگار با zstd فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
فشرده‌سازی zstd را هنگام خواندن بایگانی‌ها به صورت خودکار تشخیص می‌دهد.
.It Fl Fl lzma
(تنها در حالت c) بایگانی حاصل را با الگوریتم اصلی LZMA فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
استفاده از این گزینه توصیه نمی‌شود و بایگانی‌های جدید باید در عوض با
.Fl Fl xz
ایجاد شوند.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
فشرده‌سازی LZMA را هنگام خواندن بایگانی‌ها به صورت خودکار تشخیص می‌دهد.
.It Fl Fl lzop
(تنها در حالت c)
بایگانی حاصل را با
.Xr lzop 1
فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
فشرده‌سازی LZO را هنگام خواندن بایگانی‌ها به صورت خودکار تشخیص می‌دهد.
.It Fl m , Fl Fl modification-time
(تنها در حالت x)
زمان ویرایش را استخراج نمی‌کند.
به صورت پیش‌فرض، زمان ویرایش روی زمان ذخیره‌شده در بایگانی تنظیم می‌شود.
.It Fl Fl mac-metadata
(تنها در حالت‌های c، r، u و x)
ویژهٔ Mac OS X.
بایگانی یا استخراج ACLهای گسترش‌یافته و ویژگی‌های گسترش‌یافتهٔ پرونده با استفاده از
.Xr copyfile 3
در قالب AppleDouble.
این رفتار معکوس
.Fl Fl no-mac-metadata .
و رفتار پیش‌فرض در حالت‌های c، r و u است، یا اگر
.Nm
در حالت x توسط کاربر root اجرا شود.
در حال حاضر تنها برای قالب‌های pax پشتیبانی می‌شود
.Po شامل "pax restricted،" قالب پیش‌فرض tar برای
.Nm bsdtar Pc
.It Fl Fl mtime Ar date
(تنها در حالت‌های c، r و u)
زمان ویرایش پرونده‌های اضافه‌شده را روی تاریخ مشخص‌شده تنظیم می‌کند.
.It Fl n , Fl Fl norecurse , Fl Fl no-recursion
به صورت بازگشتی روی محتوای پوشه‌ها عمل نمی‌کند.
.It Fl Fl newer Ar date
(تنها در حالت‌های c، r و u)
تنها پرونده‌ها و پوشه‌های جدیدتر از تاریخ مشخص‌شده را شامل می‌شود.
این گزینه مدخل‌های ctime را مقایسه می‌کند.
.It Fl Fl newer-mtime Ar date
(تنها در حالت‌های c، r و u)
مانند
.Fl Fl newer ,
با این تفاوت که به جای مدخل‌های ctime، مدخل‌های mtime را مقایسه می‌کند.
.It Fl Fl newer-than Pa file
(تنها در حالت‌های c، r و u)
تنها پرونده‌ها و پوشه‌هایی را شامل می‌شود که از پروندهٔ مشخص‌شده جدیدتر باشند.
این گزینه ورودی‌های ctime را مقایسه می‌کند.
.It Fl Fl newer-mtime-than Pa file
(تنها در حالت‌های c، r و u)
مشابه
.Fl Fl newer-than ,
با این تفاوت که به جای ورودی‌های ctime، ورودی‌های mtime را مقایسه می‌کند.
.It Fl Fl nodump
(تنها در حالت‌های c و r)
با صرف‌نظر کردن از این پرونده، پرچم پروندهٔ nodump را رعایت می‌کند.
.It Fl Fl nopreserveHFSCompression
(تنها در حالت x)
مخصوص Mac OS X (نسخهٔ v10.6 یا جدیدتر). پرونده‌های عادی استخراج‌شده‌ای را که پیش از بایگانی با فشرده‌سازی HFS+ فشرده شده بودند، فشرده نمی‌کند.
به‌صورت پیش‌فرض، پرونده‌های عادی مجدداً با فشرده‌سازی HFS+ فشرده می‌شوند.
.It Fl Fl null
(استفاده همراه با
.Fl I
یا
.Fl T )
نام‌های پرونده یا الگوها به جای خط‌های جدید، با نویسه‌های null از یکدیگر جدا می‌شوند.
این ویژگی اغلب برای خواندن نام‌های پرونده استفاده می‌شود؛ نظیر خروجی گزینهٔ
.Fl print0
در
.Xr find 1 .
.It Fl Fl no-acls
(تنها در حالت‌های c، r، u و x)
ACLهای POSIX.1e یا NFSv4 را بایگانی یا استخراج نمی‌کند.
این گزینه معکوسِ
.Fl Fl acls
است و رفتار پیش‌فرض خواهد بود اگر
.Nm
توسط کاربر غیر root در حالت x اجرا شود (در Mac OS X برای هر کاربری در حالت‌های c، r، u و x).
.It Fl Fl no-fflags
(تنها در حالت‌های c، r، u و x)
ویژگی‌های پرونده یا پرچم‌های پرونده را بایگانی یا استخراج نمی‌کند.
این گزینه معکوسِ
.Fl Fl fflags
است و رفتار پیش‌فرض خواهد بود اگر
.Nm
توسط کاربر غیر root در حالت x اجرا شود.
.It Fl Fl no-mac-metadata
(تنها در حالت‌های c، r، u و x)
مخصوص Mac OS X.
ACLها و ویژگی‌های گسترش‌یافتهٔ پرونده را با استفاده از
.Xr copyfile 3
در قالب AppleDouble بایگانی یا استخراج نمی‌کند.
این گزینه معکوسِ
.Fl Fl mac-metadata .
است و رفتار پیش‌فرض خواهد بود اگر
.Nm
توسط کاربر غیر root در حالت x اجرا شود.
.It Fl Fl no-read-sparse
(تنها در حالت‌های c، r و u)
اطلاعات پرونده‌های پراکنده (sparse) را از دیسک نمی‌خواند.
این گزینه رفتاری معکوس دارد در مقایسه با
.Fl Fl read-sparse .
.It Fl Fl no-safe-writes
(فقط در حالت x)
پرونده‌های موقت ایجاد نکند و از
.Xr rename 2
برای جایگزینی پرونده‌های اصلی استفاده نکند.
این برعکسِ
.Fl Fl safe-writes
است.
.It Fl Fl no-same-owner
(فقط در حالت x)
شناسه‌های مالک و گروه را استخراج نکند.
این برعکسِ
.Fl Fl same-owner
و رفتار پیش‌فرض است اگر
.Nm
به‌عنوان کاربری غیر از root اجرا شود.
.It Fl Fl no-same-permissions
(فقط در حالت x)
مجوزهای کامل (SGID، SUID، بیت چسبنده (sticky bit)،
ویژگی‌های پرونده یا پرچم‌های پرونده، ویژگی‌های گسترش‌یافتهٔ پرونده و ACLها) را استخراج نکند.
این برعکسِ
.Fl p
و رفتار پیش‌فرض است اگر
.Nm
به‌عنوان کاربری غیر از root اجرا شود.
.It Fl Fl no-xattrs
(فقط در حالت‌های c، r، u و x)
ویژگی‌های گسترش‌یافتهٔ پرونده را بایگانی یا استخراج نکند.
این برعکسِ
.Fl Fl xattrs
و رفتار پیش‌فرض است اگر
.Nm
به‌عنوان کاربری غیر از root در حالت x اجرا شود.
.It Fl Fl numeric-owner
این معادل است با
.Fl Fl uname
.Qq
.Fl Fl gname
.Qq .
در هنگام استخراج، باعث می‌شود نام‌های کاربر و گروه در بایگانی
به نفع شناسه‌های عددی کاربر و گروه نادیده گرفته شوند.
در هنگام ایجاد، باعث می‌شود نام‌های کاربر و گروه
در بایگانی ذخیره نشوند.
.It Fl O , Fl Fl to-stdout
(فقط در حالت‌های x و t)
در حالت استخراج (-x)، پرونده‌ها به جای استخراج روی دیسک،
در خروجی استاندارد نوشته خواهند شد.
در حالت فهرست (-t)، فهرست پرونده‌ها به جای خروجی استانداردِ معمول،
در stderr نوشته خواهد شد.
.It Fl o
(حالت x)
به جای کاربر و گروه مشخص‌شده در بایگانی، از کاربر و گروه
کاربری که برنامه را اجرا می‌کند استفاده شود.
توجه داشته باشید که این گزینه هیچ تأثیری ندارد مگر اینکه
.Fl p
مشخص شده باشد و برنامه توسط کاربر root اجرا شود.
در این حالت، حالت‌ها و پرچم‌های پرونده از بایگانی
بازیابی خواهند شد، اما ACLها یا اطلاعات مالک در بایگانی
نادیده گرفته می‌شوند.
.It Fl o
(حالت‌های c، r و u)
مترادفی برای
.Fl Fl format Ar ustar
.It Fl Fl older Ar date
(فقط در حالت‌های c، r و u)
تنها پرونده‌ها و دایرکتوری‌های قدیمی‌تر از تاریخ مشخص‌شده را شامل می‌شود.
این گزینه ورودی‌های ctime را مقایسه می‌کند.
.It Fl Fl older-mtime Ar date
(فقط در حالت‌های c، r و u)
مشابه
.Fl Fl older ,
با این تفاوت که به‌جای ورودی‌های ctime، ورودی‌های mtime را مقایسه می‌کند.
.It Fl Fl older-than Pa file
(فقط در حالت‌های c، r و u)
تنها پرونده‌ها و دایرکتوری‌های قدیمی‌تر از پرونده مشخص‌شده را شامل می‌شود.
این گزینه ورودی‌های ctime را مقایسه می‌کند.
.It Fl Fl older-mtime-than Pa file
(فقط در حالت‌های c، r و u)
مشابه
.Fl Fl older-than ,
با این تفاوت که به‌جای ورودی‌های ctime، ورودی‌های mtime را مقایسه می‌کند.
.It Fl Fl one-file-system
(حالت‌های c، r و u)
از نقاط اتصال عبور نمی‌کند.
.It Fl Fl options Ar options
انتخاب رفتارهای اختیاری برای ماژول‌های خاص.
آرگومان یک رشته متنی شامل کلیدواژه‌ها و مقادیر
جداشده با کاما است.
این موارد به ماژول‌هایی که قالب‌های خاص را مدیریت می‌کنند منتقل می‌شوند
تا نحوه رفتار آن قالب‌ها را کنترل کنند.
هر گزینه یکی از شکل‌های زیر را دارد:
.Pp
.Bl -tag -compact -width indent
.It Ar key=value
کلید در تمام ماژول‌هایی که از آن پشتیبانی می‌کنند روی مقدار مشخص‌شده تنظیم خواهد شد.
ماژول‌هایی که از این کلید پشتیبانی نمی‌کنند، آن را نادیده می‌گیرند.
.It Ar key
کلید در تمام ماژول‌هایی که از آن پشتیبانی می‌کنند فعال خواهد شد.
این معادل است با
.Ar key Ns Cm =1 .
.It Ar !key
کلید در تمام ماژول‌هایی که از آن پشتیبانی می‌کنند غیرفعال خواهد شد.
.It Ar module:key=value , Ar module:key , Ar module:!key
مانند بالا، اما کلید و مقدار متناظر تنها در اختیار ماژول‌هایی قرار می‌گیرد
که نام آن‌ها مطابقت دارد با
.Ar module .
.El
.Pp
فهرست کامل ماژول‌ها و کلیدهای پشتیبانی‌شده
برای حالت‌های ایجاد و الحاق موجود است در
.Xr archive_write_set_options 3
و برای حالت‌های استخراج و فهرست‌گیری در
.Xr archive_read_set_options 3 .
.Pp
نمونه‌هایی از گزینه‌های پشتیبانی‌شده:
.Pp
.Bl -tag -compact -width indent
.It Cm iso9660:joliet
پشتیبانی از افزونه‌های Joliet.
این گزینه به‌صورت پیشفرض فعال است، از
.Cm !joliet
یا
.Cm iso9660:!joliet
برای غیرفعال کردن استفاده کنید.
.It Cm iso9660:rockridge
پشتیبانی از پسوندهای Rock Ridge.
این ویژگی به طور پیش‌فرض فعال است، برای غیرفعال کردن از
.Cm !rockridge
یا
.Cm iso9660:!rockridge
استفاده کنید.
.It Cm gzip:compression-level
یک عدد صحیح ده‌دهی از 1 تا 9 که سطح فشرده‌سازی gzip را مشخص می‌کند.
.It Cm gzip:timestamp
ذخیره برچسب زمان.
این ویژگی به طور پیش‌فرض فعال است، برای غیرفعال کردن از
.Cm !timestamp
یا
.Cm gzip:!timestamp
استفاده کنید.
.It Cm lrzip:compression Ns = Ns Ar type
استفاده از
.Ar type
به عنوان روش فشرده‌سازی.
مقادیر پشتیبانی‌شده عبارتند از bzip2، gzip، lzo (بسیار سریع)،
و zpaq (بهترین، بسیار کند).
.It Cm lrzip:compression-level
یک عدد صحیح ده‌دهی از 1 تا 9 که سطح فشرده‌سازی lrzip را مشخص می‌کند.
.It Cm lz4:compression-level
یک عدد صحیح ده‌دهی از 1 تا 9 که سطح فشرده‌سازی lzop را مشخص می‌کند.
.It Cm lz4:stream-checksum
فعال‌سازی مجموع مقابله‌ای جریان.
این گزینه به طور پیش‌فرض فعال است، برای غیرفعال کردن از
.Cm lz4:!stream-checksum
استفاده کنید.
.It Cm lz4:block-checksum
فعال‌سازی مجموع مقابله‌ای بلوک (به طور پیش‌فرض غیرفعال است).
.It Cm lz4:block-size
یک عدد صحیح ده‌دهی از 4 تا 7 که اندازه بلوک فشرده‌سازی lz4 را مشخص می‌کند
(به طور پیش‌فرض روی 7 تنظیم شده است).
.It Cm lz4:block-dependence
استفاده از بلوک پیشینِ بلوک در حال فشرده‌سازی به عنوان
واژه‌نامه فشرده‌سازی جهت بهبود نسبت فشرده‌سازی.
.It Cm zstd:compression-level Ns = Ns Ar N
یک عدد صحیح ده‌دهی که سطح فشرده‌سازی zstd را مشخص می‌کند.
مقادیر پشتیبانی‌شده به نسخه کتابخانه بستگی دارند،
مقادیر متداول از 1 تا 22 هستند.
.It Cm zstd:threads Ns = Ns Ar N
مشخص کردن تعداد ریسه‌های کاری مورد استفاده، یا 0 برای استفاده از
همان تعداد ریسه به اندازه هسته‌های CPU موجود در سیستم.
.It Cm zstd:frame-per-file
شروع یک فریم فشرده‌سازی جدید در ابتدای هر پرونده در
بایگانی.
.It Cm zstd:min-frame-in Ns = Ns Ar N
در ترکیب با
.Cm zstd:frame-per-file ,
فریم فشرده‌سازی جدیدی آغاز نمی‌شود مگر اینکه اندازه فشرده‌نشده
فریم فعلی حداقل
.Ar N
بایت باشد.
می‌توان پس از عدد از
.Li k / Li kB ,
.Li M / Li MB ,
یا
.Li G / Li GB
برای نشان دادن به ترتیب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
.It Cm zstd:min-frame-out Ns = Ns Ar N , Cm zstd:min-frame-size Ns = Ns Ar N
در ترکیب با
.Cm zstd:frame-per-file ,
فریم فشرده‌سازی جدیدی را آغاز نمی‌کند مگر اینکه اندازه فشرده‌شدهٔ فریم فعلی حداقل
.Ar N
بایت باشد.
این عدد می‌تواند با
.Li k / Li kB ,
.Li M / Li MB ,
یا
.Li G / Li GB
دنبال شود تا به ترتیب نشان‌دهنده کیلوبایت، مگابایت یا گیگابایت باشد.
.It Cm zstd:max-frame-in Ns = Ns Ar N , Cm zstd:max-frame-size Ns = Ns Ar N
در سریع‌ترین زمان ممکن پس از اینکه اندازه فشرده‌نشدهٔ فریم فعلی از
.Ar N
بایت بیشتر شد، فریم فشرده‌سازی جدیدی را آغاز می‌کند.
این عدد می‌تواند با
.Li k / Li kB ,
.Li M / Li MB ,
یا
.Li G / Li GB
دنبال شود تا به ترتیب نشان‌دهنده کیلوبایت، مگابایت یا گیگابایت باشد.
مقادیر کمتر از 1,024 رد خواهند شد.
.It Cm zstd:max-frame-out Ns = Ns Ar N
در سریع‌ترین زمان ممکن پس از اینکه اندازه فشرده‌شدهٔ فریم فعلی از
.Ar N
بایت بیشتر شد، فریم فشرده‌سازی جدیدی را آغاز می‌کند.
این عدد می‌تواند با
.Li k / Li kB ,
.Li M / Li MB ,
یا
.Li G / Li GB
دنبال شود تا به ترتیب نشان‌دهنده کیلوبایت، مگابایت یا گیگابایت باشد.
مقادیر کمتر از 1,024 رد خواهند شد.
.It Cm lzop:compression-level
یک عدد صحیح ده‌دهی از 1 تا 9 که سطح فشرده‌سازی lzop را مشخص می‌کند.
.It Cm xz:compression-level
یک عدد صحیح ده‌دهی از 0 تا 9 که سطح فشرده‌سازی xz را مشخص می‌کند.
.It Cm xz:threads
تعداد ریسه‌های کاری مورد استفاده را مشخص می‌کند.
تنظیم threads روی مقدار ویژه 0 باعث می‌شود
.Xr xz 1
به تعداد هسته‌های CPU موجود در سیستم از ریسه استفاده کند.
.It Cm mtree: Ns Ar keyword
ماژول نویسنده mtree به شما امکان می‌دهد مشخص کنید کدام کلیدواژه‌های mtree در خروجی گنجانده شوند.
کلیدواژه‌های پشتیبانی‌شده عبارتند از:
.Cm cksum , Cm device , Cm flags , Cm gid , Cm gname , Cm indent ,
.Cm link , Cm md5 , Cm mode , Cm nlink , Cm rmd160 , Cm sha1 , Cm sha256 ,
.Cm sha384 , Cm sha512 , Cm size , Cm time , Cm uid , Cm uname .
پیشفرض معادل است با:
.Dq device, flags, gid, gname, link, mode, nlink, size, time, type, uid, uname .
.It Cm mtree:all
تمام کلیدواژه‌های بالا را فعال می‌کند.
همچنین می‌توانید از
.Cm mtree:!all
برای غیرفعال کردن تمام کلیدواژه‌ها استفاده کنید.
.It Cm mtree:use-set
فعال‌سازی تولید خطوط
.Cm /set
در خروجی.
.It Cm mtree:indent
تولید خروجی خوانا برای انسان با ایجاد تورفتگی در گزینه‌ها و شکستن خطوط
جهت جا شدن در 80 ستون.
.It Cm zip:compression Ns = Ns Ar type
استفاده از
.Ar type
به‌عنوان روش فشرده‌سازی.
مقادیر پشتیبانی‌شده عبارتند از store (فشرده‌نشده) و deflate (الگوریتم gzip).
.It Cm zip:encryption
فعال‌سازی رمزنگاری با استفاده از رمزنگاری سنتی zip.
.It Cm zip:encryption Ns = Ns Ar type
استفاده از
.Ar type
به‌عنوان نوع رمزنگاری.
مقادیر پشتیبانی‌شده عبارتند از zipcrypt (رمزنگاری سنتی zip)،
aes128 (رمزنگاری WinZip AES-128) و aes256 (رمزنگاری WinZip AES-256).
.It Cm read_concatenated_archives
نادیده گرفتن بلوک‌های صفرشده در بایگانی، که هنگام متصل کردن چندین بایگانی tar
به یکدیگر رخ می‌دهد.
بدون این گزینه، تنها محتویات
نخستین بایگانی متصل‌شده خوانده خواهد شد.
این گزینه مشابه گزینهٔ
.Fl i , Fl Fl ignore-zeros
در GNU tar است.
.El
.Pp
اگر گزینهٔ ارائه‌شده توسط هیچ ماژولی پشتیبانی نشود،
یک خطای مهلک خواهد بود.
.It Fl P , Fl Fl absolute-paths
حفظ نام مسیرها.
به‌طور پیش‌فرض، در نام مسیرهای مطلق (مسیرهایی که با نویسهٔ /
آغاز می‌شوند)، اسلش ابتدایی هم هنگام ایجاد بایگانی‌ها
و هم هنگام استخراج از آن‌ها حذف می‌شود.
همچنین،
.Nm
از استخراج ورودی‌های بایگانی که نام مسیر آن‌ها حاوی
.Pa ..
است یا دایرکتوری مقصد آن‌ها توسط یک پیوند نمادین تغییر می‌یابد، خودداری خواهد کرد.
این گزینه مانع از بروز این رفتارها می‌شود.
.It Fl p , Fl Fl insecure , Fl Fl preserve-permissions
(فقط در حالت x)
حفظ دسترسی‌های پرونده.
تلاش برای بازیابی دسترسی‌های کامل، شامل حالت‌های پرونده، ویژگی‌های پرونده
یا پرچم‌های پرونده، ویژگی‌های گسترش‌یافتهٔ پرونده و ACLها، در صورت وجود، برای هر مورد
استخراج‌شده از بایگانی.
این معکوسِ
.Fl Fl no-same-permissions
است و در صورتی که
.Nm
به‌عنوان root اجرا شود، حالت پیش‌فرض است.
همچنین می‌توان با مشخص کردن موارد زیر آن را تا حدی لغو کرد:
.Fl Fl no-acls ,
.Fl Fl no-fflags ,
.Fl Fl no-mac-metadata
یا
.Fl Fl no-xattrs .
.It Fl Fl passphrase Ar passphrase
از
.Pa passphrase
برای استخراج یا ایجاد یک بایگانی رمزگذاری‌شده استفاده می‌شود.
در حال حاضر، zip تنها قالب پشتیبانی‌شده‌ای است که از رمزگذاری پشتیبانی می‌کند.
نباید از این گزینه استفاده کنید مگر اینکه بدانید استفاده از این گزینه تا چه حد ناامن است.
.It Fl Fl posix
(فقط در حالت‌های c، r و u)
مترادفی برای
.Fl Fl format Ar pax
.It Fl q , Fl Fl fast-read
(فقط در حالت‌های x و t)
تنها اولین مدخل بایگانی را که با هر الگو یا عملوند نام پرونده مطابقت دارد، استخراج یا فهرست می‌کند.
به محض اینکه هر الگو یا نام پرونده مشخص‌شده مطابقت یافت، خارج می‌شود.
به‌طور پیش‌فرض، بایگانی همیشه تا انتها خوانده می‌شود، چرا که ممکن است چندین مدخل با نام یکسان وجود داشته باشد و طبق قرارداد، مدخل‌های بعدی مدخل‌های قبلی را بازنویسی می‌کنند.
این گزینه برای بهینه‌سازی کارایی ارائه شده است.
.It Fl Fl read-sparse
(فقط در حالت‌های c، r و u)
اطلاعات پرونده‌های پراکنده را از دیسک می‌خواند.
این معکوسِ
.Fl Fl no-read-sparse
و رفتار پیش‌فرض است.
.It Fl S
(فقط در حالت x)
پرونده‌ها را به عنوان پرونده‌های پراکنده استخراج می‌کند.
برای هر بلوک روی دیسک، ابتدا بررسی می‌کند که آیا فقط شامل بایت‌های NULL است و در غیر این صورت از روی آن عبور می‌کند (seek انجام می‌دهد).
این عملکرد مشابه گزینه conv=sparse در dd است.
.It Fl s Ar pattern
نام پرونده یا اعضای بایگانی را مطابق با
.Pa pattern
تغییر می‌دهد.
الگو دارای قالب
.Ar /old/new/ Ns Op bghHprRsS
است که در آن
.Ar old
یک عبارت باقاعده پایه،
.Ar new
رشته جایگزین بخش مطابقت‌یافته،
و حروف اختیاری انتهایی اصلاح‌کننده نحوه انجام جایگزینی هستند.
اگر
.Ar old
مطابقت نیابد، الگو نادیده گرفته می‌شود.
درون
.Ar new ,
~ با بخش مطابقت‌یافته، و \e1 تا \e9 با محتوای گروه ثبت‌شده متناظر جایگزین می‌شود.
حرف اختیاری انتهایی g مشخص می‌کند که تطبیق باید پس از بخش مطابقت‌یافته ادامه یابد و با اولین الگوی تطبیق‌نیافته متوقف شود.
حرف اختیاری انتهایی s مشخص می‌کند که الگو برای مقدار پیوندهای نمادین اعمال می‌شود.
حرف اختیاری انتهایی p مشخص می‌کند که پس از یک جایگزینی موفق، نام مسیر اصلی و نام مسیر جدید باید در خطای استاندارد چاپ شوند.
حرف اختیاری انتهایی b مشخص می‌کند که جایگزینی باید از ابتدای رشته تطبیق داده شود، نه دقیقاً پس از موقعیتی که جایگزینی منطبق قبلی به پایان رسیده است.
نویسه‌های اختیاری انتهایی H، R یا S به‌ترتیب جایگزینی‌ها را برای هدف‌های پیوند سخت، نام پرونده‌های عادی یا هدف‌های پیوند نمادین غیرفعال می‌کنند.
نویسه‌های اختیاری انتهایی h، r یا s به‌ترتیب جایگزینی‌ها را برای هدف‌های پیوند سخت، نام پرونده‌های عادی یا هدف‌های پیوند نمادین فعال می‌کنند.
حالت پیش‌فرض
.Ar hrs
است که جایگزینی‌ها را برای همه نام‌ها اعمال می‌کند.
به‌ویژه، مشخص کردن h، r یا s هرگز ضروری نیست.
.It Fl Fl safe-writes
(فقط در حالت x)
استخراج پرونده‌ها به‌صورت اتمیک.
به‌طور پیش‌فرض
.Nm
پروندهٔ اصلی هم‌نام با پروندهٔ استخراج‌شده را (در صورت وجود) پیوندزدایی (unlink) می‌کند، و سپس بلافاصله آن را با همان نام ایجاد کرده و در آن می‌نویسد.
برای مدت زمان کوتاهی، برنامه‌هایی که تلاش می‌کنند به پرونده دسترسی پیدا کنند ممکن است آن را پیدا نکنند، یا نتایج ناقصی مشاهده کنند.
اگر
.Fl Fl safe-writes
فعال باشد،
.Nm
ابتدا یک پروندهٔ موقت یکتا ایجاد می‌کند، سپس محتویات جدید را در پروندهٔ موقت می‌نویسد، و در نهایت با استفاده از
.Xr rename 2
نام پروندهٔ موقت را به‌صورت اتمیک به نام نهایی آن تغییر می‌دهد.
این کار تضمین می‌کند برنامه‌ای که به پرونده دسترسی پیدا می‌کند، در همه حال یا محتویات قدیمی را مشاهده کند یا محتویات جدید را.
.It Fl Fl same-owner
(فقط در حالت x)
استخراج شناسه‌های مالک و گروه.
این برعکس
.Fl Fl no-same-owner
است و اگر
.Nm
به‌عنوان root اجرا شود، رفتار پیش‌فرض است.
.It Fl Fl strip-components Ar count
حذف تعداد مشخص‌شده از مؤلفه‌های ابتدایی مسیر.
نام‌های مسیر با مؤلفه‌های کمتر، بدون هشدار نادیده گرفته می‌شوند.
توجه داشته باشید که نام مسیر پس از بررسی الگوهای شمول/عدم‌شمول، اما پیش از بررسی‌های امنیتی ویرایش می‌شود.
.It Fl T Ar filename , Fl Fl files-from Ar filename
در حالت x یا t،
.Nm
فهرست نام‌های مورد نظر برای استخراج را از
.Pa filename
می‌خواند.
در حالت c،
.Nm
نام‌های مورد نظر برای بایگانی را از
.Pa filename
می‌خواند.
نام ویژهٔ
.Dq -C
به‌تنهایی در یک سطر، باعث تغییر دایرکتوری جاری به دایرکتوری مشخص‌شده در سطر بعدی خواهد شد.
نام‌ها با خط جدید خاتمه می‌یابند مگر اینکه
.Fl Fl null
مشخص شده باشد.
توجه داشته باشید که
.Fl Fl null
همچنین رفتار ویژهٔ سطرهای حاوی
.Dq -C
را غیرفعال می‌کند.
نکته: اگر در حال ایجاد فهرست پرونده‌ها با استفاده از
.Xr find 1
هستید، احتمالاً مایل خواهید بود از
.Fl n
نیز استفاده کنید.
.It Fl Fl totals
(فقط در حالت‌های c، r و u)
پس از بایگانی کردن همهٔ پرونده‌ها، خلاصه‌ای را در stderr چاپ می‌کند.
.It Fl U , Fl Fl unlink , Fl Fl unlink-first
(تنها در حالت x)
پیش از ایجاد پرونده‌ها، پیوند آن‌ها را حذف (unlink) می‌کند.
اگر بیشتر پرونده‌ها از قبل وجود داشته باشند، این می‌تواند یک بهینه‌سازی جزئی در عملکرد باشد، اما اگر بیشتر پرونده‌ها از قبل وجود نداشته باشند، می‌تواند کار را کندتر کند.
این پرچم همچنین باعث می‌شود
.Nm
به‌جای گزارش خطا، پیوندهای نمادین دایرکتوری‌های میانی را حذف کند.
برای جزئیات بیشتر، بخش
.Sx SECURITY
در زیر را ببینید.
.It Fl Fl uid Ar id
از شماره شناسه کاربر ارائه‌شده استفاده کرده و نام کاربر را از بایگانی نادیده می‌گیرد.
در هنگام ایجاد، اگر
.Fl Fl uname
نیز مشخص نشده باشد، نام کاربر به‌گونه‌ای تنظیم می‌شود که با شناسه کاربر مطابقت داشته باشد.
.It Fl Fl uname Ar name
از نام کاربر ارائه‌شده استفاده می‌کند.
در هنگام استخراج، این گزینه جایگزین نام کاربر در بایگانی می‌شود؛
اگر نام کاربر ارائه‌شده روی سیستم وجود نداشته باشد،
نادیده گرفته شده و در عوض از شناسه کاربر
(از بایگانی یا از گزینه
.Fl Fl uid
)
استفاده خواهد شد.
در هنگام ایجاد، این گزینه نام کاربری را که در بایگانی ذخیره خواهد شد تنظیم می‌کند؛
این نام در پایگاه‌داده کاربران سیستم اعتبارسنجی نمی‌شود.
.It Fl Fl use-compress-program Ar program
ورودی (در حالت x یا t) یا خروجی (در حالت c) را به‌جای استفاده از پشتیبانی فشرده‌سازی توکار، از طریق
.Pa program
هدایت (pipe) می‌کند.
.It Fl Fl owner Ar name Ns Op : Ns Ar uid
از کاربر ارائه‌شده استفاده می‌کند؛ اگر
.Ar uid
ارائه نشده باشد،
.Ar name
می‌تواند یک نام کاربری یا شناسه عددی باشد.
برای جزئیات، گزینه
.Fl Fl uname
را ببینید.
.It Fl v , Fl Fl verbose
خروجی با جزئیات کامل (verbose) تولید می‌کند.
در حالت‌های ایجاد و استخراج،
.Nm
نام هر پرونده را هنگام خواندن از بایگانی یا نوشتن در آن فهرست می‌کند.
در حالت فهرست،
.Nm
خروجی مشابه دستور
.Xr ls 1
تولید می‌کند.
یک گزینه
.Fl v
اضافی نیز جزئیاتی شبیه به ls را در حالت ایجاد و استخراج ارائه می‌دهد.
.It Fl Fl version
نسخه
.Nm
و
.Nm libarchive
را چاپ کرده و خارج می‌شود.
.It Fl w , Fl Fl confirmation , Fl Fl interactive
برای هر عملیات درخواست تأیید می‌کند.
.It Fl X Ar filename , Fl Fl exclude-from Ar filename
فهرستی از الگوهای مستثنی‌سازی را از پروندهٔ مشخص‌شده می‌خواند.
برای اطلاعات بیشتر درباره نحوه مدیریت موارد مستثنی،
.Fl Fl exclude
را ببینید.
.It Fl Fl xattrs
(تنها در حالت‌های c، r، u، x)
ویژگی‌های گسترش‌یافتهٔ پرونده را بایگانی یا استخراج می‌کند.
این گزینه معکوسِ
.Fl Fl no-xattrs
است و رفتار پیش‌فرض در حالت‌های c، r و u محسوب می‌شود، یا در صورتی که
.Nm
در حالت x به عنوان root اجرا شود.
.It Fl y
(تنها در حالت c)
بایگانی حاصل را با
.Xr bzip2 1
فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
هنگام خواندن بایگانی‌ها، فشرده‌سازی bzip2 را به صورت خودکار شناسایی می‌کند.
.It Fl Z , Fl Fl compress , Fl Fl uncompress
(تنها در حالت c)
بایگانی حاصل را با
.Xr compress 1
فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
هنگام خواندن بایگانی‌ها، فشرده‌سازی compress را به صورت خودکار شناسایی می‌کند.
.It Fl z , Fl Fl gunzip , Fl Fl gzip
(تنها در حالت c)
بایگانی حاصل را با
.Xr gzip 1
فشرده می‌کند.
در حالت‌های استخراج یا فهرست‌گیری، این گزینه نادیده گرفته می‌شود.
توجه داشته باشید که این پیاده‌سازی از
.Nm tar
هنگام خواندن بایگانی‌ها، فشرده‌سازی gzip را به صورت خودکار شناسایی می‌کند.
.El
.Sh "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر بر اجرای
.Nm
تأثیر می‌گذارند:
.Bl -tag -width indent
.It Ev TAR_READER_OPTIONS
گزینه‌های پیش‌فرض برای خواننده‌های قالب و خواننده‌های فشرده‌سازی.
گزینهٔ
.Fl Fl options
این تنظیم را بازنویسی می‌کند.
.It Ev TAR_WRITER_OPTIONS
گزینه‌های پیش‌فرض برای نویسنده‌های قالب و نویسنده‌های فشرده‌سازی.
گزینهٔ
.Fl Fl options
این تنظیم را بازنویسی می‌کند.
.It Ev LANG
تنظیمات محلی (locale) مورد استفاده.
برای اطلاعات بیشتر،
.Xr environ 7
را ببینید.
.It Ev TAPE
دستگاه پیشفرض.
گزینه
.Fl f
جایگزین این مورد میشود.
لطفاً برای جزئیات بیشتر، توضیحات گزینه
.Fl f
در بالا را ببینید.
.It Ev TZ
منطقه زمانی مورد استفاده هنگام نمایش تاریخها.
برای اطلاعات بیشتر،
.Xr environ 7
را ببینید.
.El
.Sh "کدهای خروج (EXIT STATUS)"
.Ex -std
.Sh "مثالها (EXAMPLES)"
دستور زیر یک بایگانی جدید به نام
.Ar file.tar.gz
ایجاد میکند که شامل دو پرونده
.Ar source.c
و
.Ar source.h
است:
.Pp
.Dl Nm Fl czf Pa file.tar.gz Pa source.c Pa source.h
.Pp
برای مشاهده فهرست تفصیلی محتویات این بایگانی:
.Pp
.Dl Nm Fl tvf Pa file.tar.gz
.Pp
برای استخراج تمام مدخلها از بایگانی در درایو نوار پیشفرض:
.Pp
.Dl Nm Fl x
.Pp
برای بررسی محتویات یک تصویر ISO 9660 cdrom:
.Pp
.Dl Nm Fl tf Pa image.iso
.Pp
برای انتقال سلسله‌مراتب پرونده‌ها،
.Nm
را به این صورت اجرا کنید:
.Pp
.Dl Nm Fl cf Pa - Fl C Pa srcdir \&. | Nm Fl xpf Pa - Fl C Pa destdir
.Pp
یا به شیوه سنتی‌تر:
.Pp
.Dl cd srcdir \&; Nm Fl cf Pa - \&. | ( cd destdir \&; Nm Fl xpf Pa - )
.Pp
در حالت ایجاد، فهرست پرونده‌ها و دایرکتوری‌هایی که باید بایگانی شوند
میتواند شامل دستورالعمل‌های تغییر دایرکتوری به شکل
.Cm -C Ns Pa foo/baz
و گنجاندن بایگانی به شکل
.Cm @ Ns Pa archive-file
نیز باشد.
برای مثال، خط فرمان
.Pp
.Dl Nm Fl c Fl f Pa new.tar Pa foo1 Cm @ Ns Pa old.tgz Cm -C Ns Pa /tmp Pa foo2
.Pp
یک بایگانی جدید به نام
.Pa new.tar
ایجاد خواهد کرد.
.Nm
پرونده
.Pa foo1
را از دایرکتوری جاری خوانده و آن را به بایگانی خروجی اضافه میکند.
سپس هر مدخل را از
.Pa old.tgz
خوانده و آن مدخلها را به بایگانی خروجی می‌افزاید.
در نهایت، به دایرکتوری
.Pa /tmp
رفته و
.Pa foo2
را به بایگانی خروجی اضافه میکند.
.Pp
یک پرونده ورودی در قالب
.Xr mtree 5
می‌تواند برای ایجاد یک بایگانی خروجی با مالکیت، دسترسی‌ها یا نام‌های دلخواهی که با داده‌های موجود روی دیسک تفاوت دارند، استفاده شود:
.Bd -literal -offset indent
$ cat input.mtree
#mtree
usr/bin uid=0 gid=0 mode=0755 type=dir
usr/bin/ls uid=0 gid=0 mode=0755 type=file content=myls
$ tar -cvf output.tar @input.mtree
.Ed
.Pp
گزینه‌های
.Fl Fl newer
و
.Fl Fl newer-mtime
انواع مختلفی از مشخصات رایج تاریخ و زمان را می‌پذیرند، از جمله
.Dq 12 Mar 2005 7:14:29pm ,
.Dq 2005-03-12 19:14 ,
.Dq 5 minutes ago ,
و
.Dq 19:14 PST May 1 .
.Pp
آرگومان
.Fl Fl options
می‌تواند برای کنترل جزئیات گوناگون ساخت یا خواندن بایگانی استفاده شود.
برای مثال، می‌توانید خروجی mtree تولید کنید که تنها شامل کلیدواژه‌های
.Cm type , Cm time ,
و
.Cm uid
باشد:
.Pp
.Dl Nm Fl cf Pa file.tar Fl Fl format=mtree Fl Fl options='!all,type,time,uid' Pa dir
.Pp
یا می‌توانید سطح فشرده‌سازی مورد استفاده در فشرده‌سازی gzip یا xz را تعیین کنید:
.Pp
.Dl Nm Fl czf Pa file.tar Fl Fl options='compression-level=9' .
.Pp
برای جزئیات بیشتر، به توضیحات فراخوانی‌های API
.Fn archive_read_set_options
و
.Fn archive_write_set_options
که در
.Xr archive_read 3
و
.Xr archive_write 3
شرح داده شده‌اند مراجعه کنید.
.Sh "سازگاری (COMPATIBILITY)"
قالب آرگومان‌های تجمیع‌شده برای سازگاری
با پیاده‌سازی‌های پیشین پشتیبانی می‌شود.
این قالب شامل یک کلمه ابتدایی (بدون نویسه - در ابتدا) است که در آن
هر نویسه نشان‌دهنده یک گزینه است.
آرگومان‌ها به صورت کلمات جداگانه در ادامه می‌آیند.
ترتیب آرگومان‌ها باید با ترتیب نویسه‌های متناظر
در کلمه دستوری تجمیع‌شده مطابقت داشته باشد.
برای مثال،
.Pp
.Dl Nm Cm tbf 32 Pa file.tar
.Pp
سه گزینه
.Cm t ,
.Cm b ,
و
.Cm f
را مشخص می‌کند.
هر دو گزینه
.Cm b
و
.Cm f
به آرگومان نیاز دارند،
بنابراین باید دو مورد اضافی
در خط فرمان وجود داشته باشد.
مقدار
.Ar 32
آرگومان مربوط به گزینه
.Cm b
است، و
.Ar file.tar
آرگومان مربوط به گزینه
.Cm f
می‌باشد.
.Pp
گزینه‌های حالت c، r، t، u و x و گزینه‌های
b، f، l، m، o، v و w با SUSv2 سازگار هستند.
.Pp
برای بیشترین قابلیت‌حمل، اسکریپت‌هایی که
.Nm tar
را فراخوانی می‌کنند باید از قالب آرگومان‌های ادغام‌شدهٔ بالا استفاده کنند، و خود را به حالت‌های
.Cm c ,
.Cm t ,
و
.Cm x
و گزینه‌های
.Cm b ,
.Cm f ,
.Cm m ,
.Cm v ,
و
.Cm w
محدود نمایند.
.Pp
گزینه‌های طولانی بیشتری برای بهبود سازگاری با سایر پیاده‌سازی‌های
tar
ارائه شده‌اند.
.Sh "امنیت (SECURITY)"
برخی مسائل امنیتی در میان بسیاری از برنامه‌های بایگانی، از جمله
.Nm
مشترک هستند.
به‌ویژه، بایگانی‌های دست‌کاری‌شده می‌توانند درخواست کنند که
.Nm
پرونده‌ها را در مکان‌هایی بیرون از دایرکتوری مقصد استخراج کند.
این موضوع می‌تواند به‌طور بالقوه برای وادار کردن کاربران ناآگاه به بازنویسی
پرونده‌هایی که قصد بازنویسی آن‌ها را نداشتند، استفاده شود.
اگر بایگانی توسط superuser استخراج شود، هر پرونده‌ای
در سیستم می‌تواند به‌طور بالقوه بازنویسی شود.
این اتفاق به سه روش می‌تواند رخ دهد.
اگرچه
.Nm
سازوکارهایی برای محافظت در برابر هر یک از آن‌ها دارد،
کاربران آگاه باید از پیامدهای آن مطلع باشند:
.Bl -bullet -width indent
.It
مدخل‌های بایگانی می‌توانند دارای نام‌مسیرهای مطلق باشند.
به‌طور پیش‌فرض،
.Nm
برای محافظت در برابر این مشکل، نویسهٔ ابتدایی
.Pa /
را پیش از بازیابی، از نام پرونده‌ها حذف می‌کند.
.It
مدخل‌های بایگانی می‌توانند دارای نام‌مسیرهایی شامل مؤلفه‌های
.Pa ..
باشند.
به‌طور پیش‌فرض،
.Nm
پرونده‌هایی را که در نام‌مسیر خود دارای مؤلفه‌های
.Pa ..
باشند، استخراج نخواهد کرد.
.It
مدخل‌های بایگانی می‌توانند از پیوندهای نمادین برای بازیابی
پرونده‌ها در دایرکتوری‌های دیگر سوءاستفاده کنند.
یک بایگانی می‌تواند یک پیوند نمادین را به دایرکتوری دیگری بازیابی کند،
سپس از آن پیوند برای بازیابی یک پرونده در آن دایرکتوری بهره ببرد.
برای محافظت در برابر این موضوع،
.Nm
هر مسیر استخراج‌شده را از نظر وجود پیوندهای نمادین بررسی می‌کند.
اگر آخرین مؤلفهٔ مسیر یک پیوند نمادین باشد، حذف شده
و با مدخل بایگانی جایگزین می‌شود.
اگر
.Fl U
مشخص شده باشد، هر پیوند نمادین میانی نیز بدون قید و شرط حذف خواهد شد.
اگر نه
.Fl U
و نه
.Fl P
مشخص شده باشند،
.Nm
از استخراج آن مدخل خودداری خواهد کرد.
.El
.Pp
برای محافظت از خود، باید نسبت به هر بایگانی که
از منابع غیرقابل‌اعتماد می‌آید محتاط باشید.
باید محتویات یک بایگانی را با
.Pp
.Dl Nm Fl tf Pa filename
.Pp
پیش از استخراج بررسی کنید.
باید از گزینهٔ
.Fl k
برای اطمینان از این‌که
.Nm
هیچ پروندهٔ موجودی را بازنویسی نخواهد کرد، یا از گزینهٔ
.Fl U
برای حذف پرونده‌های از پیش موجود استفاده کنید.
به‌طور کلی نباید هنگام اجرا با دسترسی‌های کاربر ارشد (super-user)،
بایگانی‌ها را استخراج کنید.
توجه داشته باشید که گزینهٔ
.Fl P
در
.Nm
بررسی‌های امنیتی بالا را غیرفعال کرده و به شما امکان می‌دهد
یک بایگانی را ضمن حفظ هرگونه نام مسیر مطلق، مؤلفه‌های
.Pa ..
یا پیوندهای نمادین به سایر پوشه‌ها استخراج کنید.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr bzip2 1 ,
.Xr compress 1 ,
.Xr cpio 1 ,
.Xr gzip 1 ,
.Xr mt 1 ,
.Xr pax 1 ,
.Xr shar 1 ,
.Xr xz 1 ,
.Xr libarchive 3 ,
.Xr libarchive-formats 5 ,
.Xr tar 5
.Sh "استانداردها (STANDARDS)"
در حال حاضر هیچ استاندارد POSIX برای دستور tar وجود ندارد؛ این دستور در
.St -p1003.1-96
ظاهر شد، اما کنار گذاشته شد از
.St -p1003.1-2001 .
گزینه‌های پشتیبانی‌شده توسط این پیاده‌سازی، با بررسی چندین پیاده‌سازی
موجود از tar و همچنین مشخصات قدیمی POSIX برای tar
و مشخصات فعلی POSIX برای pax توسعه یافته‌اند.
.Pp
قالب‌های پروندهٔ تبادل ustar و pax توسط
.St -p1003.1-2001
برای دستور pax تعریف شده‌اند.
.Sh "تاریخچه (HISTORY)"
دستور
.Nm tar
در Seventh Edition Unix که در ژانویهٔ ۱۹۷۹ منتشر شد، پدیدار گردید.
پیاده‌سازی‌های متعدد دیگری نیز وجود داشته‌اند که
بسیاری از آن‌ها قالب پرونده را گسترش دادند.
پیاده‌سازی مالکیت عمومی
.Sy pdtar
جان گیلمور (حدود نوامبر ۱۹۸۷)
بسیار تأثیرگذار بود و پایه و اساس GNU tar را تشکیل داد.
GNU tar به‌عنوان tar استاندارد سیستم در
.Fx
گنجانده شد، با شروع از
.Fx 1.0 .
.Pp
این یک بازپیاده‌سازی کامل بر پایه کتابخانه
.Xr libarchive 3
است.
نخستین بار با
.Fx 5.4
در مه ۲۰۰۵ منتشر شد.
.Sh "اشکالات (BUGS)"
این برنامه برای تعریف گزینه
.Fl l
از
.St -p1003.1-96
پیروی می‌کند.
توجه داشته باشید که GNU tar پیش از نسخه 1.15، گزینه
.Fl l
را به‌عنوان مترادفی برای گزینه
.Fl Fl one-file-system
در نظر می‌گرفت.
.Pp
گزینه
.Fl C Pa dir
ممکن است با پیاده‌سازی‌های تاریخی تفاوت داشته باشد.
.Pp
تمام خروجی بایگانی در بلوک‌هایی با اندازه مناسب نوشته می‌شود، حتی
اگر خروجی در حال فشرده‌سازی باشد.
اینکه آیا آخرین بلوک خروجی به اندازه یک بلوک کامل پر (pad) می‌شود
یا خیر، بسته به قالب و دستگاه خروجی متفاوت است.
برای قالب‌های tar و cpio، در صورتی که خروجی در خروجی استاندارد یا
در یک دستگاه نویسه‌ای یا بلوکی مانند درایو نوار نوشته شود، آخرین بلوک خروجی
به اندازه یک بلوک کامل پر می‌شود.
اگر خروجی در یک پرونده معمولی نوشته شود، آخرین بلوک پر نخواهد شد.
بسیاری از فشرده‌سازها، از جمله
.Xr gzip 1
و
.Xr bzip2 1 ,
هنگام از حالت فشرده خارج کردن بایگانی ایجادشده توسط
.Nm ,
از پرکننده‌های تهی (null padding) شکایت می‌کنند،
اگرچه همچنان آن را به‌درستی استخراج می‌کنند.
.Pp
فشرده‌سازی و بازگشایی به‌صورت داخلی پیاده‌سازی شده است، بنابراین
ممکن است تفاوت‌های ناچیزی وجود داشته باشد میان خروجی فشرده تولیدشده توسط
.Pp
.Dl Nm Fl czf Pa - file
.Pp
و خروجی تولیدشده توسط
.Pp
.Dl Nm Fl cf Pa - file | Nm gzip
.Pp
پیش‌فرض باید خواندن و نوشتن بایگانی‌ها در مسیرهای ورودی/خروجی استاندارد باشد،
اما سنت (و POSIX) خلاف این را دیکته می‌کند.
.Pp
حالت‌های
.Cm r
و
.Cm u
نیازمند آن هستند که بایگانی غیرفشرده بوده
و در یک پرونده معمولی روی دیسک قرار داشته باشد.
سایر بایگانی‌ها را می‌توان با استفاده از حالت
.Cm c
همراه با پسوند
.Pa @archive-file
تغییر داد.
.Pp
برای بایگانی کردن پرونده‌ای به نام
.Pa @foo
یا
.Pa -foo
باید آن را به‌ترتیب به‌صورت
.Pa ./@foo
یا
.Pa ./-foo
مشخص کنید.
.Pp
در حالت ایجاد، یک
.Pa ./
ابتدایی همیشه حذف می‌شود.
یک
.Pa /
ابتدایی نیز حذف می‌شود مگر اینکه گزینه
.Fl P
مشخص شده باشد.
.Pp
باید پشتیبانی بهتری برای انتخاب پرونده در هر دو حالت ایجاد و استخراج وجود داشته باشد.
.Pp
هنوز هیچ پشتیبانی برای بایگانی‌های چندجلدی وجود ندارد.
.Pp
تبدیل میان قالب‌های بایگانی ناهمسان (مانند tar و cpio) با استفاده از قرارداد
.Cm @ Ns Pa -
می‌تواند باعث از بین رفتن اطلاعات پیوند سخت شود.
این امر ناشی از روش‌های ناسازگاری است که قالب‌های مختلف بایگانی برای ذخیره‌سازی اطلاعات پیوند سخت به کار می‌برند.