.\" This file is part of GNU tar. -*- nroff -*-
.\" Copyright 2013-2021 Free Software Foundation, Inc.
.\"
.\" GNU tar is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" GNU tar is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses>.
.TH TAR 1 "July 13, 2020" "TAR" "GNU TAR Manual"
.SH "نام (NAME)"
tar \- ابزار آرشیو و بایگانی فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.SS Traditional usage
\fBtar\fR {\fBA\fR|\fBc\fR|\fBd\fR|\fBr\fR|\fBt\fR|\fBu\fR|\fBx\fR}\
[\fBGnSkUWOmpsMBiajJzZhPlRvwo\fR] [\fIARG\fR...]
.SS UNIX-style usage
.sp
\fBtar\fR \fB\-A\fR [\fIOPTIONS\fR] \fIARCHIVE\fR \fIARCHIVE\fR
.sp
\fBtar\fR \fB\-c\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-d\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-t\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIMEMBER\fR...]
.sp
\fBtar\fR \fB\-r\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-u\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-x\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIMEMBER\fR...]
.SS GNU-style usage
.sp
\fBtar\fR {\fB\-\-catenate\fR|\fB\-\-concatenate\fR} [\fIOPTIONS\fR] \fIARCHIVE\fR \fIARCHIVE\fR
.sp
\fBtar\fR \fB\-\-create\fR [\fB\-\-file\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR {\fB\-\-diff\fR|\fB\-\-compare\fR} [\fB\-\-file\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-\-delete\fR [\fB\-\-file\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIMEMBER\fR...]
.sp
\fBtar\fR \fB\-\-append\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-\-list\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIMEMBER\fR...]
.sp
\fBtar\fR \fB\-\-test\-label\fR [\fB\-\-file\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fILABEL\fR...]
.sp
\fBtar\fR \fB\-\-update\fR [\fB\-\-file\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR \fB\-\-update\fR [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIFILE\fR...]
.sp
\fBtar\fR {\fB\-\-extract\fR|\fB\-\-get\fR} [\fB\-f\fR \fIARCHIVE\fR] [\fIOPTIONS\fR] [\fIMEMBER\fR...]
.SH "نکته (NOTE)"
این صفحه راهنما توصیفی کوتاه از GNU \fBtar\fR است. برای توضیحات دقیق‌تر، شامل مثال‌ها و توصیه‌های کاربردی، به \fBراهنمای گنو تار (GNU Tar Manual)\fR که در قالب texinfo موجود است مراجعه کنید. اگر نمایش‌دهنده \fBinfo\fR و مستندات tar به درستی روی سامانه شما نصب شده باشند، دستور
.PP
.RS +4
.B info tar
.RE
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.
.PP
همچنین می‌توانید این راهنما را با استفاده از حالت info در
.BR emacs (1)
مشاهده کنید، یا آن را در قالب‌های گوناگون به‌صورت برخط در نشانی زیر بیابید:
.PP
.RS +4
.B http://www.gnu.org/software/tar/manual
.RE
.PP
در صورت وجود هرگونه مغایرت میان این صفحه راهنما و \fBراهنمای گنو تار\fR، مرجع دوم به عنوان منبع معتبر و نهایی در نظر گرفته می‌شود.
.SH "توضیحات (DESCRIPTION)"
برنامه GNU
.B tar
یک ابزار بایگانی است که برای ذخیره‌سازی چندین فایل در قالب یک فایل واحد (یک \fBآرشیو\fR) و مدیریت چنین آرشیوهایی طراحی شده است. آرشیو می‌تواند یک فایل معمولی یا یک دستگاه (برای نمونه درایو نوار مغناطیسی، که نام برنامه نیز برگرفته از آن است: \fBt\fRape \fBar\fRchiver) باشد، و می‌تواند روی سامانه محلی یا یک ماشین دوردست قرار داشته باشد.
.PP

.SS Option styles
گزینه‌های GNU \fBtar\fR را می‌توان به سه سبک مختلف مشخص کرد.
در
.BR "سبک سنتی (traditional style)" ،
اولین آرگومان خوشه‌ای از حروف گزینه‌ها است و تمام آرگومان‌های بعدی مقادیر لازم را برای گزینه‌هایی که نیاز به مقدار دارند فراهم می‌کنند. آرگومان‌ها با همان ترتیبی که حروف گزینه‌ها آمده‌اند خوانده می‌شوند. هر واژه دیگری در خط فرمان که پس از پردازش گزینه‌ها باقی بماند به عنوان آرگومان غیراختیاری در نظر گرفته می‌شود: نام فایل‌ها یا اعضای آرشیو.
.PP
برای نمونه، گزینه \fBc\fR نیاز به ایجاد آرشیو دارد، گزینه \fBv\fR عملیات پرگویی (verbose) را درخواست می‌کند، و گزینه \fBf\fR آرگومانی می‌گیرد که نام آرشیو مورد پردازش را تعیین می‌کند. دستور زیر که به سبک سنتی نوشته شده است، به tar دستور می‌دهد همه فایل‌های موجود در دایرکتوری
.B /etc
را در فایل آرشیو
.B etc.tar
ذخیره کرده و فهرست فایل‌های در حال آرشیو شدن را با جزئیات نمایش دهد:
.PP
.EX
tar cfv etc.tar /etc
.EE
.PP
در
.BR "سبک یونیکس یا گزینه‌های کوتاه (UNIX or short-option style)" ،
پیش از هر حرف گزینه یک خط تیره قرار می‌گیرد، همان‌طور که در سایر ابزارهای خط فرمان مرسوم است. اگر گزینه‌ای نیاز به آرگومان داشته باشد، آن آرگومان بلافاصله پس از آن می‌آید، خواه به صورت واژه‌ای جداگانه در خط فرمان باشد یا چسبیده به خود گزینه. با این حال، اگر گزینه یک آرگومان \fBاختیاری\fR بپذیرد، آرگومان باید بدون هیچ فاصله خالی به حرف گزینه متصل شود، مانند \fB\-g/tmp/snar.db\fR.
.PP
هر تعداد گزینه که آرگومان دریافت نمی‌کنند را می‌توان پس از یک خط تیره واحد خوشه‌بندی کرد، مانند \fB\-vkp\fR. گزینه‌هایی که آرگومان دریافت می‌کنند (خواه اجباری یا اختیاری)، می‌توانند در انتهای چنین خوشه‌ای قرار گیرند، مانند \fB\-vkpf a.tar\fR.
.PP
دستور مثال بالا که به
.B سبک گزینه‌های کوتاه
نوشته شود می‌تواند به این صورت باشد:
.PP
.EX
tar -cvf etc.tar /etc
.EE
یا
.EX
tar -c -v -f etc.tar /etc
.EE
.PP
در
.BR "سبک گنو یا گزینه‌های بلند (GNU or long-option style)" ،
هر گزینه با دو خط تیره آغاز می‌شود و دارای نامی معنادار است که از حروف کوچک و خط تیره تشکیل شده است. در صورت استفاده، گزینه بلند را می‌توان تا حروف آغازین آن خلاصه کرد، مشروط بر اینکه باعث ابهام نشود. آرگومان‌های گزینه‌های بلند یا به صورت واژه‌ای جداگانه در خط فرمان و بلافاصله پس از گزینه، یا با علامت مساوی بدون هیچ فاصله میانجی به گزینه متصل می‌شوند. آرگومان‌های اختیاری همیشه باید از روش دوم استفاده کنند.
.PP
چند روش برای نوشتن دستور مثال به این سبک:
.PP
.EX
tar --create --file etc.tar --verbose /etc
.EE
یا (با خلاصه کردن برخی گزینه‌ها):
.EX
tar --cre --file=etc.tar --verb /etc
.EE
.PP
گزینه‌ها در هر سه سبک را می‌توان ترکیب کرد، اگرچه ترکیب کردن با گزینه‌های قدیمی توصیه نمی‌شود.
.SS Operation mode
گزینه‌های فهرست‌شده در جدول زیر به GNU \fBtar\fR مشخص می‌کنند چه عملیاتی را باید انجام دهد. دقیقاً یکی از آن‌ها باید مشخص شود. معنای آرگومان‌های غیراختیاری به حالت عملیات درخواست‌شده بستگی دارد.
.TP
\fB\-A\fR, \fB\-\-catenate\fR, \fB\-\-concatenate\fR
پیوست کردن یک آرشیو به انتهای آرشیوی دیگر. آرگومان‌ها به عنوان نام‌های آرشیوهایی که باید پیوست شوند در نظر گرفته می‌شوند. تمام آرشیوها باید فرمتی یکسان با آرشیوی که به آن پیوست می‌شوند داشته باشند، در غیر این صورت ممکن است آرشیو حاصل با پیاده‌سازی‌های غیر گنو از \fBtar\fR غیرقابل استفاده باشد. همچنین توجه داشته باشید که هنگامی که بیش از یک آرشیو داده می‌شود، اعضای آرشیوهای غیر از اولین آرشیو تنها در صورتی در آرشیو نهایی قابل دسترسی خواهند بود که از گزینه \fB\-i\fR (\fB\-\-ignore\-zeros\fR) استفاده شود.

آرشیوهای فشرده‌شده را نمی‌توان به هم متصل کرد.
.TP
\fB\-c\fR, \fB\-\-create\fR
ایجاد یک آرشیو جدید. آرگومان‌ها نام فایل‌هایی را که باید آرشیو شوند مشخص می‌کنند. دایرکتوری‌ها به صورت بازگشتی آرشیو می‌شوند، مگر اینکه گزینه \fB\-\-no\-recursion\fR مشخص شده باشد.
.TP
\fB\-d\fR, \fB\-\-diff\fR, \fB\-\-compare\fR
یافتن تفاوت‌ها میان آرشیو و سامانه فایل. آرگومان‌ها اختیاری هستند و اعضای آرشیو را برای مقایسه مشخص می‌کنند. در صورت عدم ارائه، دایرکتوری کاری فعلی در نظر گرفته می‌شود.
.TP
\fB\-\-delete\fR
حذف از درون آرشیو. آرگومان‌ها نام اعضای آرشیو را که باید حذف شوند مشخص می‌کنند. حداقل باید یک آرگومان ارائه شود.

این گزینه روی آرشیوهای فشرده‌شده کار نمی‌کند. معادل گزینه کوتاه برای این مورد وجود ندارد.
.TP
\fB\-r\fR, \fB\-\-append\fR
پیوست کردن فایل‌ها به انتهای آرشیو. آرگومان‌ها معنایی مشابه با \fB\-c\fR (\fB\-\-create\fR) دارند.
.TP
\fB\-t\fR, \fB\-\-list\fR
فهرست کردن محتویات یک آرشیو. آرگومان‌ها اختیاری هستند. در صورت ارائه، نام اعضایی را که باید فهرست شوند مشخص می‌کنند.
.TP
\fB\-\-test\-label\fR
آزمودن برچسب حجم (volume label) آرشیو و خروج. اگر بدون آرگومان استفاده شود، برچسب حجم (در صورت وجود) را چاپ کرده و با وضعیت \fB0\fR خارج می‌شود. هنگامی که یک یا چند آرگومان خط فرمان داده شود،
.B tar
برچسب حجم را با هر یک از آرگومان‌ها مقایسه می‌کند. در صورت یافتن تطابق با کد \fB0\fR و در غیر این صورت با کد \fB1\fR خارج می‌شود. هیچ خروجی نمایش داده نمی‌شود، مگر اینکه همراه با گزینه \fB\-v\fR (\fB\-\-verbose\fR) استفاده شود.

برای این گزینه معادل کوتاهی وجود ندارد.
.TP
\fB\-u\fR, \fB\-\-update\fR
پیوست کردن فایل‌هایی که از نسخه متناظر خود در آرشیو جدیدتر هستند. آرگومان‌ها همان معنای گزینه‌های \fB\-c\fR و \fB\-r\fR را دارند. توجه داشته باشید که فایل‌های جدیدتر جایگزین رونوشت‌های قدیمی خود در آرشیو نمی‌شوند، بلکه به انتهای آرشیو پیوست می‌گردند. بنابراین آرشیو حاصل می‌تواند شامل چندین عضو با نام یکسان باشد که مربوط به نسخه‌های گوناگون همان فایل هستند.
.TP
\fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR
استخراج فایل‌ها از یک آرشیو. آرگومان‌ها اختیاری هستند. در صورت ارائه، نام اعضای آرشیو را برای استخراج مشخص می‌کنند.
.TP
\fB\-\-show\-defaults\fR
نمایش مقادیر پیش‌فرض توکار برای گزینه‌های مختلف \fBtar\fR و خروج. هیچ آرگومانی مجاز نیست.
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش خلاصه‌ای از گزینه‌ها و خروج. هیچ آرگومانی مجاز نیست.
.TP
\fB\-\-usage\fR
نمایش فهرستی از گزینه‌های موجود و خروج. هیچ آرگومانی مجاز نیست.
.TP
\fB\-\-version\fR
چاپ نسخه برنامه و اطلاعات حق نشر و خروج.
.SH "گزینه‌ها (OPTIONS)"
.SS Operation modifiers
.TP
\fB\-\-check\-device\fR
بررسی شماره دستگاه‌ها هنگام ایجاد آرشیوهای افزایشی (پیش‌فرض).
.TP
\fB\-g\fR, \fB\-\-listed\-incremental\fR=\fIFILE\fR
مدیریت پشتیبان‌گیری‌های افزایشی با فرمت جدید گنو. \fIFILE\fR نام یک \fBفایل وضعیت لحظه‌ای (snapshot file)\fR است که tar اطلاعات تکمیلی را در آن ذخیره می‌کند تا مشخص کند کدام فایل‌ها از زمان نسخه افزایشی قبلی تغییر کرده‌اند و بنابراین باید مجدداً ذخیره شوند. اگر هنگام ایجاد آرشیو \fIFILE\fR وجود نداشته باشد، ایجاد خواهد شد و تمام فایل‌ها به آرشیو حاصل افزوده می‌شوند (پشتیبان‌گیری \fBسطح 0\fR). برای ایجاد آرشیوهای افزایشی در سطح غیر صفر \fBN\fR، یک رونوشت از فایل snapshot ایجاد شده در سطح \fBN-1\fR تهیه کنید و آن را به عنوان \fIFILE\fR به کار ببرید.

هنگام فهرست کردن یا استخراج، محتوای واقعی \fIFILE\fR بررسی نمی‌شود و تنها به دلیل الزامات نحوی مورد نیاز است؛ بنابراین استفاده از \fB/dev/null\fR به جای آن مرسوم است.
.TP
\fB\-\-hole\-detection\fR=\fIMETHOD\fR
استفاده از \fIMETHOD\fR برای تشخیص حفره‌ها در فایل‌های تنک (sparse files). این گزینه شامل \fB\-\-sparse\fR نیز می‌شود. مقادیر معتبر برای \fIMETHOD\fR عبارتند از \fBseek\fR و \fBraw\fR. حالت پیش‌فرض \fBseek\fR است که در صورت عدم پشتیبانی به \fBraw\fR بازمی‌گردد.
.TP
\fB\-G\fR, \fB\-\-incremental\fR
مدیریت پشتیبان‌گیری‌های افزایشی با فرمت قدیمی گنو.
.TP
\fB\-\-ignore\-failed\-read\fR
عدم خروج با وضعیت غیر صفر در مواجهه با فایل‌های غیرقابل خواندن.
.TP
\fB\-\-level\fR=\fINUMBER\fR
تعیین سطح پشتیبان‌گیری برای آرشیو افزایشی فهرست‌شده. در حال حاضر فقط \fB\-\-level=0\fR معنادار است: این گزینه به \fBtar\fR دستور می‌دهد فایل snapshot را پیش از آغاز پشتیبان‌گیری خالی کند و در نتیجه پشتیبان‌گیری سطح 0 را تحمیل نماید.
.TP
\fB\-n\fR, \fB\-\-seek\fR
فرض اینکه آرشیو قابلیت جستجو و پرش (seekable) دارد. به طور معمول \fBtar\fR به صورت خودکار تعیین می‌کند که آیا آرشیو قابلیت seek دارد یا خیر. این گزینه برای استفاده در مواردی در نظر گرفته شده که این تشخیص خودکار با شکست مواجه می‌شود. این گزینه فقط زمانی اعمال می‌شود که آرشیو برای خواندن باز شده باشد (برای نمونه با گزینه‌های
.B \-\-list
یا
.B \-\-extract
).
.TP
\fB\-\-no\-check\-device\fR
عدم بررسی شماره دستگاه‌ها هنگام ایجاد آرشیوهای افزایشی.
.TP
\fB\-\-no\-seek\fR
فرض اینکه آرشیو قابلیت پرش و جستجو (seekable) ندارد.
.TP
\fB\-\-occurrence\fR[=\fIN\fR]
تنها پردازش \fIN\fRمین رخداد از هر فایل در آرشیو. این گزینه فقط زمانی معتبر است که با یکی از زیردستورهای زیر استفاده شود: \fB\-\-delete\fR، \fB\-\-diff\fR، \fB\-\-extract\fR یا \fB\-\-list\fR و هنگامی که فهرستی از فایل‌ها در خط فرمان یا از طریق گزینه \fB\-T\fR ارائه شده باشد. مقدار پیش‌فرض \fIN\fR برابر با \fB1\fR است.
.TP
\fB\-\-restrict\fR
غیرفعال کردن استفاده از برخی گزینه‌های بالقوه خطرناک.
.TP
\fB\-\-sparse\-version\fR=\fIMAJOR\fR[.\fIMINOR\fR]
تعیین نسخه قالب تنک مورد استفاده (مستلزم \fB\-\-sparse\fR). این گزینه شامل
.BR \-\-sparse
نیز می‌شود. مقادیر معتبر برای آرگومان عبارتند از
.BR 0.0 ،
.BR 0.1 "، و"
.BR 1.0 .
برای بررسی دقیق فرمت‌های تنک، به \fBراهنمای گنو تار\fR، پیوست \fBD\fR، بخش "\fBSparse Formats\fR" مراجعه کنید. با استفاده از ابزار \fBinfo\fR، می‌توان با اجرای دستور زیر به آن دسترسی پیدا کرد:
.BR "info tar 'Sparse Formats'" .
.TP
\fB\-S\fR, \fB\-\-sparse\fR
مدیریت بهینه فایل‌های تنک (sparse). برخی فایل‌ها در سامانه فایل ممکن است بخش‌هایی داشته باشند که در واقع هرگز نوشته نشده‌اند (اغلب این‌ها فایل‌های پایگاه داده ایجاد شده توسط سامانه‌هایی مانند \fBDBM\fR هستند). با فعال بودن این گزینه، \fBtar\fR تلاش می‌کند پیش از آرشیو کردن بررسی کند که آیا فایل تنک است یا خیر، و در این صورت، با ننوشتن بخش‌های خالی فایل، حجم آرشیو نهایی را کاهش دهد.
.SS Overwrite control
این گزینه‌ها اقدامات \fBtar\fR را هنگام استخراج فایل روی رونوشت موجود روی دیسک کنترل می‌کنند.
.TP
\fB\-k\fR, \fB\-\-keep\-old\-files\fR
عدم جایگزینی فایل‌های موجود هنگام استخراج.
.TP
\fB\-\-keep\-newer\-files\fR
عدم جایگزینی فایل‌های موجود روی دیسک که از رونوشت‌های موجود در آرشیو تازه‌تر هستند.
.TP
\fB\-\-keep\-directory\-symlink\fR
عدم جایگزینی پیوندهای نمادین موجود به دایرکتوری‌ها هنگام استخراج.
.TP
\fB\-\-no\-overwrite\-dir\fR
حفظ فرا‌داده‌های (metadata) دایرکتوری‌های موجود.
.TP
\fB\-\-one\-top\-level\fR[\fB=\fIDIR\fR]
استخراج همه فایل‌ها در \fIDIR\fR، یا در صورت استفاده بدون آرگومان، در زیردایرکتوری نام‌گذاری‌شده بر اساس نام پایه آرشیو (بدون پسوندهای استاندارد فشرده‌سازی که توسط \fB\-\-auto\-compress\fR شناسایی می‌شوند).
.TP
\fB\-\-overwrite\fR
بازنویسی و جایگزینی فایل‌های موجود هنگام استخراج.
.TP
\fB\-\-overwrite\-dir\fR
بازنویسی فراداده‌های دایرکتوری‌های موجود هنگام استخراج (پیش‌فرض).
.TP
\fB\-\-recursive\-unlink\fR
حذف بازگشتی تمام فایل‌های درون دایرکتوری پیش از استخراج در آن.
.TP
\fB\-\-remove\-files\fR
حذف فایل‌ها از روی دیسک پس از افزودن آن‌ها به آرشیو.
.TP
\fB\-\-skip\-old\-files\fR
عدم بازنویسی فایل‌های موجود هنگام استخراج، و رد شدن بی‌صدا از آن‌ها.
.TP
\fB\-U\fR, \fB\-\-unlink\-first\fR
حذف هر فایل پیش از استخراج روی آن.
.TP
\fB\-W\fR, \fB\-\-verify\fR
بررسی و راستی‌آزمایی آرشیو پس از نوشتن آن.
.SS Output stream selection
.TP
\fB\-\-ignore\-command\-error\fR
نادیده گرفتن کدهای خروج زیرپردازه‌ها.
.TP
\fB\-\-no\-ignore\-command\-error\fR
تلقی کدهای خروج غیر صفر فرزندان به عنوان خطا (پیش‌فرض).
.TP
\fB\-O\fR, \fB\-\-to\-stdout\fR
استخراج فایل‌ها در خروجی استاندارد.
.TP
\fB\-\-to\-command\fR=\fICOMMAND\fR
هدایت فایل‌های استخراج‌شده از طریق لوله (pipe) به \fICOMMAND\fR. آرگومان مسیر یک برنامه خارجی است، به همراه آرگومان‌های خط فرمان اختیاری. این برنامه اجرا شده و محتوای فایل در حال استخراج در ورودی استاندارد به آن تحویل داده می‌شود. داده‌های اضافی از طریق متغیرهای محیطی زیر فراهم خواهند شد:
.RS
.TP
.B TAR_FILETYPE
نوع فایل. این یک حرف منفرد با معانی زیر است:
.sp
.nf
.ta 8n 20n
	f	فایل معمولی (Regular file)
	d	دایرکتوری (Directory)
	l	پیوند نمادین (Symbolic link)
	h	پیوند سخت (Hard link)
	b	دستگاه بلوکی (Block device)
	c	دستگاه نویسه‌ای (Character device)
.fi

در حال حاضر تنها فایل‌های معمولی پشتیبانی می‌شوند.
.TP
.B TAR_MODE
حالت دسترسی فایل، یک عدد در مبنای هشت.
.TP
.B TAR_FILENAME
نام فایل.
.TP
.B TAR_REALNAME
نام فایل همان‌گونه که در آرشیو ذخیره شده است.
.TP
.B TAR_UNAME
نام مالک فایل.
.TP
.B TAR_GNAME
نام گروه مالک فایل.
.TP
.B TAR_ATIME
زمان آخرین دسترسی. یک عدد ده‌دهی که نشان‌دهنده ثانیه‌ها از مبدا زمان یونیکس (Epoch) است. اگر آرشیو زمان‌ها را با دقت نانوثانیه نگهداری کند، نانوثانیه‌ها پس از یک نقطه ممیز به برچسب زمانی اضافه می‌شوند.
.TP
.B TAR_MTIME
زمان آخرین تغییر محتوا.
.TP
.B TAR_CTIME
زمان آخرین تغییر وضعیت فایل.
.TP
.B TAR_SIZE
اندازه فایل.
.TP
.B TAR_UID
شناسه کاربری (UID) مالک فایل.
.TP
.B TAR_GID
شناسه گروه (GID) مالک فایل.
.RE
.RS

علاوه بر این، متغیرهای زیر حاوی اطلاعاتی درباره حالت عملیاتی \fBtar\fR و آرشیو در حال پردازش هستند:
.TP
.B TAR_VERSION
شماره نسخه GNU \fBtar\fR.
.TP
.B TAR_ARCHIVE
نام آرشیوی که \fBtar\fR در حال پردازش آن است.
.TP
.B TAR_BLOCKING_FACTOR
ضریب بلوک‌بندی جاری، یعنی تعداد بلوک‌های ۵۱۲ بایتی در هر رکورد.
.TP
.B TAR_VOLUME
شماره ترتیبی حجمی که \fBtar\fR در حال پردازش آن است (در هنگام خواندن آرشیو چندحجمی تنظیم می‌شود).
.TP
.B TAR_FORMAT
قالب آرشیو در حال پردازش. یکی از موارد زیر:
.BR gnu ،
.BR oldgnu ،
.BR posix ،
.BR ustar ،
.BR v7 .
.TP
.B TAR_SUBCOMMAND
گزینه کوتاهی (با یک خط تیره در ابتدا) که عملیات اجرایی توسط \fBtar\fR را توصیف می‌کند.
.TP
.B TAR_FD
توصیف‌کننده فایلی (File descriptor) که می‌تواند برای اعلام نام حجم جدید به
.BR tar
استفاده شود.
.RE
.RS

اگر اسکریپت اطلاعات با خطا مواجه شود، \fBtar\fR خارج می‌شود؛ در غیر این صورت، نوشتن حجم بعدی را آغاز می‌کند.
.RE
.TP
\fB\-L\fR, \fB\-\-tape\-length\fR=\fIN\fR
تعویض نوار پس از نوشتن \fIN\fRx1024 بایت. اگر پس از \fIN\fR یک پسوند اندازه بیاید (به بخش
.B پسوندهای اندازه
در ادامه مراجعه کنید)، این پسوند ضریب ضربی مورد استفاده به جای 1024 را مشخص می‌کند.

این گزینه شامل
.BR \-M
نیز می‌شود.
.TP
\fB\-M\fR, \fB\-\-multi\-volume\fR
ایجاد/فهرست کردن/استخراج آرشیو چندحجمی.
.TP
\fB\-\-rmt\-command\fR=\fICOMMAND\fR
استفاده از \fICOMMAND\fR به جای \fBrmt\fR هنگام دسترسی به آرشیوهای راه دور. به توضیحات گزینه
.B \-f
در بالا مراجعه کنید.
.TP
\fB\-\-rsh\-command\fR=\fICOMMAND\fR
استفاده از \fICOMMAND\fR به جای \fBrsh\fR هنگام دسترسی به آرشیوهای راه دور. به توضیحات گزینه
.B \-f
در بالا مراجعه کنید.
.TP
\fB\-\-volno\-file\fR=\fIFILE\fR
هنگامی که این گزینه همراه با
.BR \-\-multi\-volume
استفاده شود،
.B tar
ردیابی خواهد کرد که در حال کار بر روی کدام حجم از یک آرشیو چندحجمی در \fIFILE\fR است.
.SS Device blocking
.TP
\fB\-b\fR, \fB\-\-blocking\-factor\fR=\fIBLOCKS\fR
تنظیم اندازه هر رکورد به اندازه \fIBLOCKS\fRx\fB512\fR بایت.
.TP
\fB\-B\fR, \fB\-\-read\-full\-records\fR
هنگام فهرست کردن یا استخراج، رکوردهای ناقص ورودی پس از نشانه پایان فایل را بپذیر.
.TP
\fB\-i\fR, \fB\-\-ignore\-zeros\fR
نادیده گرفتن بلوک‌های صفرشده در آرشیو. به طور معمول دو بلوک متوالی ۵۱۲ بایتی پر از صفر به معنی پایان فایل (EOF) هستند و tar پس از برخورد با آن‌ها خواندن را متوقف می‌کند. این گزینه دستور می‌دهد که خواندن فراتر از آن‌ها ادامه یابد و هنگام خواندن آرشیوهای ایجاد شده با گزینه \fB\-A\fR مفید است.
.TP
\fB\-\-record\-size\fR=\fINUMBER\fR
تنظیم اندازه رکورد. \fINUMBER\fR تعداد بایت‌ها در هر رکورد است. باید مضربی از \fB512\fR باشد. می‌تواند با یک \fBپسوند اندازه\fR همراه شود، مانند \fB\-\-record-size=10K\fR برای ۱۰ کیلوبایت. به بخش
.BR "پسوندهای اندازه"
برای فهرستی از پسوندهای معتبر مراجعه کنید.
.SS Archive format selection
.TP
\fB\-H\fR, \fB\-\-format\fR=\fIFORMAT\fR
ایجاد آرشیو با قالب داده‌شده. قالب‌های معتبر عبارتند از:
.RS
.TP
.B gnu
فرمت GNU tar 1.13.x
.TP
.B oldgnu
فرمت GNU بر اساس tar <= 1.12.
.TP
\fBpax\fR, \fBposix\fR
فرمت POSIX 1003.1-2001 (pax).
.TP
.B ustar
فرمت POSIX 1003.1-1988 (ustar).
.TP
.B v7
فرمت قدیمی V7 tar.
.RE
.TP
\fB\-\-old\-archive\fR, \fB\-\-portability\fR
مشابه \fB\-\-format=v7\fR.
.TP
\fB\-\-pax\-option\fR=\fIkeyword\fR[[:]=\fIvalue\fR][,\fIkeyword\fR[[:]=\fIvalue\fR]]...
کنترل کلیدواژه‌های pax هنگام ایجاد آرشیوهای \fBPAX\fR (\fB\-H pax\fR). این گزینه معادل گزینه \fB\-o\fR از ابزار
.BR pax (1)
است.
.TP
\fB\-\-posix\fR
مشابه \fB\-\-format=posix\fR.
.TP
\fB\-V\fR, \fB\-\-label\fR=\fITEXT\fR
ایجاد آرشیو با نام برچسب حجم \fITEXT\fR. در صورت فهرست کردن یا استخراج، از \fITEXT\fR به عنوان الگوی انطباق برای نام حجم استفاده کنید.
.SS Compression options
.TP
\fB\-a\fR, \fB\-\-auto\-compress\fR
استفاده از پسوند نام آرشیو برای تعیین برنامه فشرده‌سازی.
.TP
\fB\-I\fR, \fB\-\-use\-compress\-program\fI=\fICOMMAND\fR
پالایش داده‌ها از طریق \fICOMMAND\fR. این دستور باید گزینه \fB\-d\fR را برای باز کردن فشرده‌سازی بپذیرد. آرگومان می‌تواند شامل گزینه‌های خط فرمان باشد.
.TP
\fB\-j\fR, \fB\-\-bzip2\fR
فیلتر کردن آرشیو از طریق
.BR bzip2 (1).
.TP
\fB\-J\fR, \fB\-\-xz\fR
فیلتر کردن آرشیو از طریق
.BR xz (1).
.TP
\fB\-\-lzip\fR
فیلتر کردن آرشیو از طریق
.BR lzip (1).
.TP
\fB\-\-lzma\fR
فیلتر کردن آرشیو از طریق
.BR lzma (1).
.TP
\fB\-\-lzop\fR
فیلتر کردن آرشیو از طریق
.BR lzop (1).
.TP
\fB\-\-no\-auto\-compress\fR
عدم استفاده از پسوند نام آرشیو برای تعیین برنامه فشرده‌سازی.
.TP
\fB\-z\fR, \fB\-\-gzip\fR, \fB\-\-gunzip\fR, \fB\-\-ungzip\fR
فیلتر کردن آرشیو از طریق
.BR gzip (1).
.TP
\fB\-Z\fR, \fB\-\-compress\fR, \fB\-\-uncompress\fR
فیلتر کردن آرشیو از طریق
.BR compress (1).
.TP
\fB\-\-zstd\fR
فیلتر کردن آرشیو از طریق
.BR zstd (1).
.SS Handling of file attributes
.TP
\fB\-\-atime\-preserve\fR[=\fIMETHOD\fR]
حفظ زمان‌های دسترسی فایل‌های آرشیو شده، یا با بازگردانی زمان‌ها پس از خواندن (\fIMETHOD\fR=\fBreplace\fR، حالت پیش‌فرض) یا با عدم تغییر زمان‌ها از همان ابتدا (\fIMETHOD\fR=\fBsystem\fR).
.TP
\fB\-\-delay\-directory\-restore\fR
به تعویق انداختن تنظیم زمان‌های تغییر و مجوزهای دایرکتوری‌های استخراج‌شده تا پایان عملیات استخراج. هنگامی از این گزینه استفاده کنید که از آرشیوی با ترتیب اعضای غیرمعمول استخراج می‌کنید.
.TP
\fB\-\-group\fR=\fINAME\fR[:\fIGID\fR]
اجبار \fINAME\fR به عنوان گروه برای فایل‌های اضافه‌شده. اگر \fIGID\fR ارائه نشود، \fINAME\fR می‌تواند یک نام گروه یا GID عددی باشد. در این حالت بخش مفقود (GID یا نام) از پایگاه‌داده گروه‌های میزبان فعلی استخراج خواهد شد.

در صورت استفاده همراه با \fB\-\-group\-map\fR=\fIFILE\fR، تنها روی فایل‌هایی اثر می‌گذارد که گروه مالک آن‌ها در \fIFILE\fR فهرست نشده باشد.
.TP
\fB\-\-group\-map\fR=\fIFILE\fR
خواندن نگاشت تبدیل گروه از \fIFILE\fR. خطوط خالی نادیده گرفته می‌شوند. توضیحات با علامت \fB#\fR آغاز شده و تا انتهای خط ادامه می‌یابند. هر خط غیرخالی در \fIFILE\fR تبدیل را برای یک گروه مشخص می‌کند. این خط باید از دو بخش تشکیل شود که با هر میزان فاصله سفید جدا شده‌اند:

.EX
\fIOLDGRP\fR \fINEWGRP\fR[\fB:\fINEWGID\fR]
.EE

\fIOLDGRP\fR یک نام گروه معتبر یا یک GID با پیشوند \fB+\fR است. مگر اینکه \fINEWGID\fR ارائه شده باشد، \fINEWGRP\fR نیز باید یک نام گروه معتبر یا \fB+\fIGID\fR باشد. در غیر این صورت، نیازی نیست که \fINEWGRP\fR و \fINEWGID\fR در پایگاه‌داده گروه سامانه وجود داشته باشند.

در نتیجه، هر فایل ورودی متعلق به گروه \fIOLDGRP\fR در آرشیو با گروه مالک \fINEWGRP\fR و GID برابر با \fINEWGID\fR ذخیره خواهد شد.
.TP
\fB\-\-mode\fR=\fICHANGES\fR
اعمال حالت نمادین \fICHANGES\fR برای مجوزهای فایل‌های اضافه‌شده.
.TP
\fB\-\-mtime\fR=\fIDATE-OR-FILE\fR
تنظیم mtime (زمان ویرایش) برای فایل‌های اضافه‌شده. \fIDATE-OR-FILE\fR یا یک تاریخ/زمان در قالبی اختیاری است، یا نام فایلی موجود. در حالت دوم، mtime آن فایل استفاده خواهد شد.
.TP
\fB\-m\fR, \fB\-\-touch\fR
عدم استخراج زمان تغییر فایل (نگه‌داشتن زمان فعلی استخراج).
.TP
\fB\-\-no\-delay\-directory\-restore\fR
لغو اثر گزینه قبلی \fB\-\-delay\-directory\-restore\fR.
.TP
\fB\-\-no\-same\-owner\fR
استخراج فایل‌ها با هویت خودتان (پیش‌فرض برای کاربران عادی).
.TP
\fB\-\-no\-same\-permissions\fR
اعمال umask کاربر هنگام استخراج مجوزها از آرشیو (پیش‌فرض برای کاربران عادی).
.TP
\fB\-\-numeric\-owner\fR
استفاده همیشگی از شناسه‌های عددی به جای نام‌های کاربری/گروهی.
.TP
\fB\-\-owner\fR=\fINAME\fR[:\fIUID\fR]
اجبار \fINAME\fR به عنوان مالک فایل‌های اضافه‌شده. اگر \fIUID\fR ارائه نشود، \fINAME\fR می‌تواند یک نام کاربری یا UID عددی باشد. در این حالت بخش نامشخص (UID یا نام) از پایگاه‌داده کاربران میزبان فعلی استخراج می‌شود.

در صورت استفاده همراه با \fB\-\-owner\-map\fR=\fIFILE\fR، فقط روی فایل‌هایی اثر می‌گذارد که مالک آن‌ها در \fIFILE\fR فهرست نشده باشد.
.TP
\fB\-\-owner\-map\fR=\fIFILE\fR
خواندن نگاشت تبدیل مالک از \fIFILE\fR. خطوط خالی نادیده گرفته می‌شوند. توضیحات با علامت \fB#\fR آغاز شده و تا انتهای خط ادامه می‌یابند. هر خط غیرخالی در \fIFILE\fR تبدیل را برای یک UID مشخص می‌کند. این خط باید از دو فیلد تشکیل شود که با هر میزان فاصله سفید جدا شده‌اند:

.EX
\fIOLDUSR\fR \fINEWUSR\fR[\fB:\fINEWUID\fR]
.EE

\fIOLDUSR\fR یک نام کاربری معتبر یا یک UID با پیشوند \fB+\fR است. مگر اینکه \fINEWUID\fR ارائه شود، \fINEWUSR\fR نیز باید یک نام کاربری معتبر یا \fB+\fIUID\fR باشد. در غیر این صورت، نیازی نیست که \fINEWUSR\fR و \fINEWUID\fR در پایگاه‌داده کاربران سامانه موجود باشند.

در نتیجه، هر فایل ورودی متعلق به کاربر \fIOLDUSR\fR در آرشیو با نام مالک \fINEWUSR\fR و UID برابر با \fINEWUID\fR ذخیره خواهد شد.
.TP
\fB\-p\fR, \fB\-\-preserve\-permissions\fR, \fB\-\-same\-permissions\fR
استخراج اطلاعات مربوط به مجوزهای دسترسی فایل (پیش‌فرض برای کاربر ارشد/superuser).
.TP
\fB\-\-same\-owner\fR
تلاش برای استخراج فایل‌ها با همان مالکیت موجود در آرشیو (پیش‌فرض برای کاربر ارشد).
.TP
\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR
مرتب‌سازی نام‌های مورد استخراج برای تطابق با ترتیب اعضای آرشیو.
.TP
\fB\-\-sort=\fIORDER\fR
هنگام ایجاد آرشیو، ورودی‌های دایرکتوری را مطابق با \fIORDER\fR مرتب کن، که یکی از موارد زیر است:
.BR none ،
.BR name "، یا"
.BR inode .

حالت پیش‌فرض \fB\-\-sort=none\fR است که اعضای آرشیو را به همان ترتیبی که توسط سیستم‌عامل بازگردانده شده ذخیره می‌کند.

استفاده از \fB\-\-sort=name\fR تضمین می‌کند که ترتیب اعضا در آرشیو ایجاد شده یکنواخت و تکرارپذیر است.

استفاده از \fB\-\-sort=inode\fR تعداد پرش‌های دیسک (seek) در زمان ایجاد آرشیو را کاهش داده و می‌تواند سرعت بایگانی را به میزان چشمگیری افزایش دهد. این ترتیب مرتب‌سازی تنها در صورتی پشتیبانی می‌شود که سامانه زیربنایی اطلاعات لازم را فراهم کند.
.SS Extended file attributes
.TP
.B \-\-acls
فعال‌سازی پشتیبانی از POSIX ACLs.
.TP
.B \-\-no\-acls
غیرفعال‌سازی پشتیبانی از POSIX ACLs.
.TP
.B \-\-selinux
فعال‌سازی پشتیبانی از زمینه امنیتی SELinux.
.TP
.B \-\-no-selinux
غیرفعال‌سازی پشتیبانی از زمینه امنیتی SELinux.
.TP
.B \-\-xattrs
فعال‌سازی پشتیبانی از صفت‌های توسعه‌یافته (extended attributes).
.TP
.B \-\-no\-xattrs
غیرفعال‌سازی پشتیبانی از صفت‌های توسعه‌یافته.
.TP
.BI \-\-xattrs\-exclude= PATTERN
تعیین الگوی استثنا برای کلیدهای xattr. مقدار \fIPATTERN\fR یک عبارت باقاعده POSIX است، برای نمونه \fB\-\-xattrs\-exclude='^user\.'\fR، برای استثنا کردن صفت‌ها از فضای‌نام کاربر.
.TP
.BI \-\-xattrs\-include= PATTERN
تعیین الگوی شمول برای کلیدهای xattr. مقدار \fIPATTERN\fR یک عبارت باقاعده POSIX است.
.SS Device selection and switching
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR
استفاده از فایل آرشیو یا دستگاه \fIARCHIVE\fR. اگر این گزینه ارائه نشود، \fBtar\fR ابتدا متغیر محیطی `TAPE' را بررسی خواهد کرد. در صورت مقداردهی، مقدار آن به عنوان نام آرشیو استفاده خواهد شد. در غیر این صورت، \fBtar\fR مقدار پیش‌فرض زمان کامپایل را در نظر می‌گیرد. مقدار پیش‌فرض را می‌توان از طریق گزینه
.B \-\-show\-defaults
یا در انتهای خروجی \fBtar \-\-help\fR بررسی کرد.

نام آرشیوی که شامل دونقطه باشد بیانگر فایلی روی یک ماشین دوردست است. بخش قبل از دونقطه به عنوان نام میزبان یا آدرس IP ماشین، و بخش بعد از آن به عنوان مسیر فایل یا دستگاه تلقی می‌شود، مانند:

.EX
--file=remotehost:/dev/sr0
.EE

می‌توان یک نام کاربری اختیاری را با قرار دادن علامت \fB@\fR پیش از نام میزبان اضافه کرد.

به‌طور پیش‌فرض، دسترسی به ماشین دوردست از طریق دستور
.BR rsh (1)
انجام می‌شود. امروزه استفاده از
.BR ssh (1)
به جای آن رایج است. می‌توانید این کار را با ارائه گزینه زیر در خط فرمان انجام دهید:

.EX
--rsh-command=/usr/bin/ssh
.EE

روی ماشین دوردست باید دستور
.BR rmt (8)
نصب شده باشد. اگر مسیر آن با پیش‌فرض \fBtar\fR همخوانی ندارد، می‌توانید مسیر درست را با استفاده از گزینه
.B \-\-rmt\-command
به \fBtar\fR اطلاع دهید.
.TP
\fB\-\-force\-local\fR
فایل آرشیو محلی است حتی اگر در نام آن علامت دونقطه وجود داشته باشد.
.TP
\fB\-F\fR, \fB\-\-info\-script\fR=\fICOMMAND\fR, \fB\-\-new\-volume\-script\fR=\fICOMMAND\fR
اجرای \fICOMMAND\fR در پایان هر نوار (مستلزم \fB\-M\fR). دستور می‌تواند شامل آرگومان‌ها باشد. هنگام شروع، محیط \fBtar\fR به همراه متغیرهای زیر به آن به ارث خواهد رسید:
.RS
.TP
.B TAR_VERSION
شماره نسخه GNU \fBtar\fR.
.TP
.B TAR_ARCHIVE
نام آرشیوی که \fBtar\fR در حال پردازش آن است.
.TP
.B TAR_BLOCKING_FACTOR
ضریب بلوک‌بندی جاری، یعنی تعداد بلوک‌های ۵۱۲ بایتی در هر رکورد.
.TP
.B TAR_VOLUME
شماره ترتیبی حجمی که \fBtar\fR در حال پردازش آن است (در هنگام خواندن آرشیو چندحجمی تنظیم می‌شود).
.TP
.B TAR_FORMAT
قالب آرشیو در حال پردازش. یکی از:
.BR gnu ،
.BR oldgnu ،
.BR posix ،
.BR ustar ،
.BR v7 .
.TP
.B TAR_SUBCOMMAND
گزینه کوتاه (با یک خط تیره در ابتدا) که عملیات اجرایی توسط \fBtar\fR را توصیف می‌کند.
.TP
.B TAR_FD
توصیف‌کننده فایلی که می‌تواند برای ارسال نام حجم جدید به
.BR tar
به کار رود.
.RE
.RS

اگر اسکریپت اطلاع‌رسانی با شکست روبرو شود، \fBtar\fR خارج می‌شود؛ در غیر این صورت، نوشتن حجم بعدی را آغاز می‌کند.
.RE
.TP
\fB\-L\fR, \fB\-\-tape\-length\fR=\fIN\fR
تعویض نوار پس از نوشتن \fIN\fRx1024 بایت. اگر پس از \fIN\fR یک پسوند اندازه بیاید (به بخش
.B پسوندهای اندازه
در ادامه مراجعه کنید)، پسوند نشان‌دهنده ضریب مورد استفاده به جای 1024 خواهد بود.

این گزینه شامل
.BR \-M
می‌شود.
.TP
\fB\-M\fR, \fB\-\-multi\-volume\fR
ایجاد/فهرست‌گیری/استخراج آرشیو چندحجمی.
.TP
\fB\-\-rmt\-command\fR=\fICOMMAND\fR
استفاده از \fICOMMAND\fR به جای \fBrmt\fR هنگام دسترسی به آرشیوهای راه دور. توضیحات گزینه
.B \-f
را در بالا ببینید.
.TP
\fB\-\-rsh\-command\fR=\fICOMMAND\fR
استفاده از \fICOMMAND\fR به جای \fBrsh\fR هنگام دسترسی به آرشیوهای راه دور. توضیحات گزینه
.B \-f
را در بالا ببینید.
.TP
\fB\-\-volno\-file\fR=\fIFILE\fR
هنگامی که این گزینه همراه با
.BR \-\-multi\-volume
به کار رود،
.B tar
ثبت خواهد کرد که در حال کار روی کدام حجم از یک آرشیو چندحجمی در \fIFILE\fR است.
.SS Local file selection
.TP
\fB\-\-add\-file\fR=\fIFILE\fR
افزودن \fIFILE\fR به آرشیو (بسیار مفید اگر نام فایل با یک خط تیره آغاز شود).
.TP
\fB\-\-backup\fR[=\fICONTROL\fR]
پشتیبان‌گیری پیش از حذف. آرگومان \fICONTROL\fR در صورت ارائه، سیاست پشتیبان‌گیری را کنترل می‌کند. مقادیر معتبر آن عبارتند از:
.RS
.TP
.BR none ", " off
هرگز نسخه پشتیبان تهیه نکن.
.TP
.BR t ", " numbered
تهیه نسخه‌های پشتیبان شماره‌دار.
.TP
.BR nil ", " existing
تهیه نسخه‌های پشتیبان شماره‌دار در صورتی که نسخه شماره‌دار از قبل موجود باشد، و در غیر این صورت نسخه‌های پشتیبان ساده.
.TP
.BR never ", " simple
همیشه نسخه‌های پشتیبان ساده تهیه کن.
.RS
.RE

اگر \fICONTROL\fR مشخص نشود، مقدار از متغیر محیطی
.B VERSION_CONTROL
گرفته می‌شود. اگر این متغیر نیز تنظیم نشده باشد، مقدار \fBexisting\fR در نظر گرفته خواهد شد.
.RE
.TP
\fB\-C\fR, \fB\-\-directory\fR=\fIDIR\fR
تغییر دایرکتوری به \fIDIR\fR پیش از انجام هر عملیاتی. این گزینه به ترتیب قرارگیری حساس است، یعنی بر روی تمام گزینه‌های بعد از خود اثر می‌گذارد.
.TP
\fB\-\-exclude\fR=\fIPATTERN\fR
استثنا کردن فایل‌های منطبق با \fIPATTERN\fR، یک الگوی عام (wildcard) به سبک
.BR glob (3).
.TP
\fB\-\-exclude\-backups\fR
استثنا کردن فایل‌های پشتیبان و قفل.
.TP
\fB\-\-exclude\-caches\fR
استثنا کردن محتویات دایرکتوری‌های حاوی فایل \fBCACHEDIR.TAG\fR، به جز خود فایل نشانه (tag).
.TP
\fB\-\-exclude\-caches\-all\fR
استثنا کردن دایرکتوری‌های حاوی فایل \fBCACHEDIR.TAG\fR و خود فایل.
.TP
\fB\-\-exclude\-caches\-under\fR
استثنا کردن همه محتویات زیرین دایرکتوری‌های حاوی \fBCACHEDIR.TAG\fR.
.TP
\fB\-\-exclude\-ignore=\fIFILE\fR
پیش از بایگانی یک دایرکتوری، بررسی کن آیا شامل \fIFILE\fR است یا خیر. در این صورت، الگوهای استثنا را از این فایل بخوان. الگوها تنها بر روی خود همان دایرکتوری اثر می‌گذارند.
.TP
\fB\-\-exclude\-ignore\-recursive=\fIFILE\fR
مشابه \fB\-\-exclude\-ignore\fR، با این تفاوت که الگوهای موجود در \fIFILE\fR بر روی خود دایرکتوری و تمام زیردایرکتوری‌های آن اعمال می‌شوند.
.TP
\fB\-\-exclude\-tag\fR=\fIFILE\fR
استثنا کردن محتویات دایرکتوری‌های حاوی \fIFILE\fR، به جز خود \fIFILE\fR.
.TP
\fB\-\-exclude\-tag\-all\fR=\fIFILE\fR
استثنا کردن دایرکتوری‌های حاوی \fIFILE\fR.
.TP
\fB\-\-exclude\-tag\-under\fR=\fIFILE\fR
استثنا کردن همه موارد زیرین دایرکتوری‌های حاوی \fIFILE\fR.
.TP
\fB\-\-exclude\-vcs\fR
استثنا کردن دایرکتوری‌های سامانه‌های کنترل نسخه (VCS).
.TP
\fB\-\-exclude\-vcs\-ignores\fR
استثنا کردن فایل‌هایی که با الگوهای خوانده‌شده از فایل‌های نادیده‌گیری مخصوص سامانه‌های کنترل نسخه همخوانی دارند. فایل‌های پشتیبانی‌شده عبارتند از:
.BR .cvsignore ،
.BR .gitignore ،
.BR .bzrignore "، و"
.BR .hgignore .
.TP
\fB\-h\fR, \fB\-\-dereference\fR
دنبال کردن پیوندهای نمادین؛ بایگانی و ذخیره فایل‌هایی که به آن‌ها اشاره شده است.
.TP
\fB\-\-hard\-dereference\fR
دنبال کردن پیوندهای سخت؛ بایگانی و ذخیره فایل‌هایی که به آن‌ها اشاره شده است.
.TP
\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\fR
شروع عملیات از عضو داده‌شده در آرشیو.
.TP
\fB\-\-newer\-mtime\fR=\fIDATE\fR
پردازش فایل‌هایی که داده‌های آن‌ها پس از \fIDATE\fR تغییر کرده است. اگر \fIDATE\fR با \fB/\fR یا \fB.\fR آغاز شود، به عنوان نام فایل تلقی شده و زمان ویرایش (mtime) آن فایل به عنوان تاریخ در نظر گرفته می‌شود.
.TP
\fB\-\-no\-null\fR
غیرفعال کردن اثر گزینه قبلی \fB\-\-null\fR.
.TP
\fB\-\-no\-recursion\fR
جلوگیری از پیمایش بازگشتی خودکار درون دایرکتوری‌ها.
.TP
\fB\-\-no\-unquote\fR
عدم حذف نقل‌قول‌ها از فایل ورودی یا نام اعضا.
.TP
\fB\-\-no\-verbatim\-files\-from\fR
رفتار با هر خط خوانده‌شده از فهرست فایل به گونه‌ای که گویی در خط فرمان وارد شده است؛ یعنی فاصله‌های آغازین و پایانی حذف می‌شوند و اگر رشته حاصل با یک خط تیره شروع شود، به عنوان یک گزینه خط فرمان \fBtar\fR در نظر گرفته می‌شود.

این رفتار پیش‌فرض است. گزینه \fB\-\-no\-verbatim\-files\-from\fR راهکاری برای بازگرداندن این رفتار پس از استفاده از گزینه \fB\-\-verbatim\-files\-from\fR ارائه می‌دهد.

این گزینه مکانی (positional) است: بر تمام گزینه‌های \fB\-\-files\-from\fR که پس از آن می‌آیند اثر می‌گذارد، تا زمانی که گزینه \fB\-\-verbatim\-files\-from\fR یا پایان خط فرمان فرا برسد.

این گزینه با گزینه \fB\-\-no\-null\fR تلویحاً فعال می‌شود.
.TP
\fB\-\-null\fR
دستور به گزینه‌های بعدی \fB\-T\fR برای خواندن نام‌های خاتمه‌یافته با نویسه پوچ (null-terminated) به صورت دقیق (پردازش ویژه نام‌هایی را که با خط تیره آغاز می‌شوند غیرفعال می‌کند).

همچنین ببینید: \fB\-\-verbatim\-files\-from\fR.
.TP
\fB\-N\fR, \fB\-\-newer\fR=\fIDATE\fR, \fB\-\-after\-date\fR=\fIDATE\fR
تنها ذخیره فایل‌هایی که از DATE جدیدتر هستند. اگر \fIDATE\fR با \fB/\fR یا \fB.\fR آغاز شود به عنوان نام یک فایل تلقی شده و زمان ویرایش (mtime) آن به عنوان تاریخ مبنا قرار می‌گیرد.
.TP
\fB\-\-one\-file\-system\fR
هنگام ایجاد آرشیو در سامانه فایل محلی باقی بمان و از مرزهای سیستم‌فایل دیگر عبور نکن.
.TP
\fB\-P\fR, \fB\-\-absolute\-names\fR
عدم حذف اسلش‌های ابتدایی از نام فایل‌ها هنگام ایجاد آرشیو.
.TP
\fB\-\-recursion\fR
پیمایش بازگشتی درون دایرکتوری‌ها (پیش‌فرض).
.TP
\fB\-\-suffix\fR=\fISTRING\fR
پشتیبان‌گیری پیش از حذف، و جایگزینی پسوند معمول. پسوند پیش‌فرض \fB~\fR است، مگر اینکه با متغیر محیطی \fBSIMPLE_BACKUP_SUFFIX\fR لغو شده باشد.
.TP
\fB\-T\fR, \fB\-\-files\-from\fR=\fIFILE\fR
دریافت نام‌ها برای استخراج یا ایجاد از \fIFILE\fR.

مگر اینکه خلاف آن تعیین شده باشد، \fIFILE\fR باید شامل فهرستی از نام‌ها باشد که با نویسه اسکی \fBLF\fR جدا شده‌اند (یعنی یک نام در هر خط). نام‌های خوانده‌شده به همان روش آرگومان‌های خط فرمان پردازش می‌شوند. آن‌ها تحت حذف نقل‌قول و جداسازی واژه‌ها قرار می‌گیرند، و هر رشته‌ای که با \fB\-\fR شروع شود به عنوان گزینه خط فرمان \fBtar\fR رفتار خواهد شد.

اگر این رفتار نامطلوب باشد، می‌توان آن را با استفاده از گزینه \fB\-\-verbatim\-files\-from\fR غیرفعال کرد.

گزینه \fB\-\-null\fR به \fBtar\fR اعلام می‌کند که نام‌ها در \fIFILE\fR به جای \fBLF\fR با نویسه اسکی \fBNUL\fR از یکدیگر جدا شده‌اند. این گزینه زمانی مفید است که فهرست توسط بخش
.B \-print0
در دستور
.BR find (1)
تولید شده باشد.
.TP
\fB\-\-unquote\fR
حذف نقل‌قول‌ها از نام فایل‌ها یا اعضا (پیش‌فرض).
.TP
\fB\-\-verbatim\-files\-from\fR
رفتار با هر خط خوانده‌شده از فهرست فایل‌ها به عنوان یک نام فایل، حتی اگر با خط تیره آغاز شود. فهرست‌های فایل با گزینه \fB\-\-files\-from\fR (\fB\-T\fR) فراهم می‌شوند. رفتار پیش‌فرض این است که نام‌های ارائه‌شده در فهرست فایل به گونه‌ای پردازش شوند که گویی در خط فرمان تایپ شده‌اند، یعنی هر نامی که با خط تیره آغاز شود به عنوان گزینه \fBtar\fR تلقی خواهد شد. گزینه \fB\-\-verbatim\-files\-from\fR این رفتار را غیرفعال می‌کند.

این گزینه بر تمامی گزینه‌های \fB\-\-files\-from\fR که پس از آن در خط فرمان قرار می‌گیرند اثر می‌گذارد. اثر آن با گزینه \fB\-\-no\-verbatim\-files\-from\fR بازگردانده می‌شود.

این گزینه توسط گزینه \fB\-\-null\fR نیز اعمال می‌شود.

همچنین ببینید: \fB\-\-add\-file\fR.
.TP
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
استثنا کردن فایل‌های منطبق بر الگوهای فهرست‌شده در FILE.
.SS  File name transformations
.TP
\fB\-\-strip\-components\fR=\fINUMBER\fR
حذف \fINUMBER\fR بخش ابتدایی از مسیر نام فایل‌ها هنگام استخراج.
.TP
\fB\-\-transform\fR=\fIEXPRESSION\fR, \fB\-\-xform\fR=\fIEXPRESSION\fR
استفاده از عبارت جایگزینی sed به صورت \fIEXPRESSION\fR برای تبدیل نام فایل‌ها.
.SS File name matching options
این گزینه‌ها هم بر الگوهای استثنا (exclude) و هم بر الگوهای شمول (include) اثر می‌گذارند.
.TP
\fB\-\-anchored\fR
تطابق الگوها با ابتدای نام فایل.
.TP
\fB\-\-ignore\-case\fR
نادیده گرفتن بزرگی و کوچکی حروف.
.TP
\fB\-\-no\-anchored\fR
تطابق الگوها پس از هر \fB/\fR (پیش‌فرض برای استثنا کردن).
.TP
\fB\-\-no\-ignore\-case\fR
انطباق حساس به بزرگی و کوچکی حروف (پیش‌فرض).
.TP
\fB\-\-no\-wildcards\fR
انطباق رشته‌ها به صورت دقیق و لفظی (بدون کاراکترهای عام).
.TP
\fB\-\-no\-wildcards\-match\-slash\fR
کاراکترهای عام با \fB/\fR تطابق پیدا نکنند.
.TP
\fB\-\-wildcards\fR
استفاده از کاراکترهای عام (پیش‌فرض برای استثنا کردن).
.TP
\fB\-\-wildcards\-match\-slash\fR
کاراکترهای عام با \fB/\fR تطابق یابند (پیش‌فرض برای استثنا کردن).
.SS Informative output
.TP
\fB\-\-checkpoint\fR[=\fIN\fR]
نمایش پیام‌های پیشرفت کار به ازای هر \fIN\fRمین رکورد (پیش‌فرض 10).
.TP
\fB\-\-checkpoint\-action\fR=\fIACTION\fR
اجرای \fIACTION\fR در هر نقطه بازرسی (checkpoint).
.TP
\fB\-\-clamp\-mtime\fR
تنظیم زمان تنها در صورتی که زمان فایل تازه‌تر از مقدار مشخص‌شده با \-\-mtime باشد.
.TP
\fB\-\-full\-time\fR
چاپ زمان فایل با بالاترین دقت ممکن.
.TP
\fB\-\-index\-file\fR=\fIFILE\fR
ارسال خروجی پرگو (verbose) به \fIFILE\fR.
.TP
\fB\-l\fR, \fB\-\-check\-links\fR
چاپ پیام در صورتی که همه پیوندها ذخیره نشده باشند.
.TP
\fB\-\-no\-quote\-chars\fR=\fISTRING\fR
غیرفعال کردن نقل‌قول برای نویسه‌های موجود در \fISTRING\fR.
.TP
\fB\-\-quote\-chars\fR=\fISTRING\fR
قرار دادن نویسه‌های موجود در \fISTRING\fR درون نقل‌قول علاوه بر حالت معمول.
.TP
\fB\-\-quoting\-style\fR=\fISTYLE\fR
تنظیم شیوه نقل‌قول برای نام فایل‌ها و اعضا. مقادیر معتبر برای \fISTYLE\fR عبارتند از:
.BR literal ،
.BR shell ،
.BR shell-always ،
.BR c ،
.BR c-maybe ،
.BR escape ،
.BR locale ،
.BR clocale .
.TP
\fB\-R\fR, \fB\-\-block\-number\fR
نمایش شماره بلوک درون آرشیو همراه با هر پیام.
.TP
\fB\-\-show\-omitted\-dirs\fR
هنگام فهرست کردن یا استخراج، فهرست کردن هر دایرکتوری که با معیارهای جستجو مطابقت ندارد.
.TP
\fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
نمایش نام فایل‌ها یا آرشیو پس از تبدیل توسط گزینه‌های \fB\-\-strip\fR و \fB\-\-transform\fR.
.TP
\fB\-\-totals\fR[=\fISIGNAL\fR]
چاپ مجموع کل بایت‌ها پس از پردازش آرشیو. اگر \fISIGNAL\fR مشخص شده باشد، چاپ مجموع کل بایت‌ها هنگام دریافت این سیگنال انجام می‌شود. سیگنال‌های مجاز عبارتند از:
.BR SIGHUP ،
.BR SIGQUIT ،
.BR SIGINT ،
.BR SIGUSR1 "، و"
.BR SIGUSR2 .
پیشوند \fBSIG\fR را می‌توان حذف کرد.
.TP
\fB\-\-utc\fR
چاپ زمان‌های ویرایش فایل بر اساس ساعت هماهنگ جهانی (UTC).
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فهرست کردن پرجزئیات فایل‌های پردازش‌شده. هر بار تکرار این گزینه در خط فرمان، سطح جزئیات را یک واحد افزایش می‌دهد. بیشترین سطح جزئیات ۳ است. برای بررسی تفصیلی درباره نحوه تأثیرگذاری سطوح مختلف جزئیات بر خروجی tar، به \fBراهنمای گنو تار\fR، زیربخش 2.5.1 تحت عنوان "\fBThe \-\-verbose Option\fR" مراجعه کنید.
.TP
\fB\-\-warning\fR=\fIKEYWORD\fR
فعال یا غیرفعال کردن پیام‌های هشدار مشخص‌شده با \fIKEYWORD\fR. در صورتی که به \fIKEYWORD\fR پیشوند \fBno\-\fR اضافه شود، پیام‌ها خاموش می‌شوند و در غیر این صورت فعال می‌گردند.

پیام‌های چندگانه \fB\-\-warning\fR با یکدیگر تجمیع می‌شوند.

کلیدواژه‌های کنترل‌کننده عملکرد کلی \fBtar\fR:
.RS
.TP
.B all
فعال‌سازی تمام پیام‌های هشدار (پیش‌فرض).
.TP
.B none
غیرفعال‌سازی تمام پیام‌های هشدار.
.TP
.B filename-with-nuls
"%s: file name read contains nul character"
.TP
.B alone-zero-block
"A lone zero block at %s"
.HP
کلیدواژه‌های مرتبط با \fBtar --create\fR:
.TP
.B cachedir
"%s: contains a cache directory tag %s; %s"
.TP
.B file-shrank
"%s: File shrank by %s bytes; padding with zeros"
.TP
.B xdev
"%s: file is on a different filesystem; not dumped"
.TP
.B file-ignored
"%s: Unknown file type; file ignored"
.br
"%s: socket ignored"
.br
"%s: door ignored"
.TP
.B file-unchanged
"%s: file is unchanged; not dumped"
.TP
.B ignore-archive
"%s: file is the archive; not dumped"
.TP
.B file-removed
"%s: File removed before we read it"
.TP
.B file-changed
"%s: file changed as we read it"
.TP
.B failed-read
غیرفعال کردن هشدارهای مربوط به فایل‌ها یا دایرکتوری‌های غیرقابل خواندن. این کلیدواژه تنها در صورتی اثرگذار است که همراه با گزینه
.B \-\-ignore\-failed\-read
به کار رود.
.HP
کلیدواژه‌های مرتبط با \fBtar --extract\fR:
.TP
.B existing\-file
"%s: skipping existing file"
.TP
.B timestamp
"%s: implausibly old time stamp %s"
.br
"%s: time stamp %s is %s s in the future"
.TP
.B contiguous-cast
"Extracting contiguous files as regular files"
.TP
.B symlink-cast
"Attempting extraction of symbolic links as hard links"
.TP
.B unknown-cast
"%s: Unknown file type '%c', extracted as normal file"
.TP
.B ignore-newer
"Current %s is newer or same age"
.TP
.B unknown-keyword
"Ignoring unknown extended header keyword '%s'"
.TP
.B decompress-program
کنترل توضیحات پرجزئیات خطاهایی که هنگام اجرای برنامه‌های بازکننده فشرده‌سازی جایگزین رخ می‌دهند. این هشدار به‌طور پیش‌فرض غیرفعال است (مگر اینکه از \fB\-\-verbose\fR استفاده شود). نمونه رایج از آنچه هنگام استفاده از این هشدار دریافت می‌کنید:

.EX
$ tar --warning=decompress-program -x -f archive.Z
tar (child): cannot run compress: No such file or directory
tar (child): trying gzip
.EE

این به این معناست که \fBtar\fR ابتدا تلاش کرده با استفاده از \fBcompress\fR آرشیو \fBarchive.Z\fR را باز کند، و پس از شکست در این کار، به سراغ \fBgzip\fR رفته است.
.TP
.B record-size
"Record size = %lu blocks"
.HP
کلیدواژه‌های کنترل‌کننده استخراج افزایشی:
.TP
.B rename-directory
"%s: Directory has been renamed from %s"
.br
"%s: Directory has been renamed"
.TP
.B new-directory
"%s: Directory is new"
.TP
.B xdev
"%s: directory is on a different device: not purging"
.TP
.B bad-dumpdir
"Malformed dumpdir: 'X' never used"
.RE
.TP
\fB\-w\fR, \fB\-\-interactive\fR, \fB\-\-confirmation\fR
درخواست تایید برای هر عمل.
.SS Compatibility options
.TP
\fB\-o\fR
هنگام ایجاد آرشیو، مشابه با \fB\-\-old\-archive\fR عمل می‌کند. هنگام استخراج، مشابه با \fB\-\-no\-same\-owner\fR است.
.SS پسوندهای اندازه (Size suffixes)
.sp
.nf
.ta 8n 18n 42n
.ul
	پسوند	واحدها	معادل بایتی
	b	Blocks	\fISIZE\fR x 512
	B	Kilobytes	\fISIZE\fR x 1024
	c	Bytes	\fISIZE\fR
	G	Gigabytes	\fISIZE\fR x 1024^3
	K	Kilobytes	\fISIZE\fR x 1024
	k	Kilobytes	\fISIZE\fR x 1024
	M	Megabytes	\fISIZE\fR x 1024^2
	P	Petabytes	\fISIZE\fR x 1024^5
	T	Terabytes	\fISIZE\fR x 1024^4
	w	Words	\fISIZE\fR x 2
.fi
.PP
.SH "مقدار بازگشتی (RETURN VALUE)"
کد خروج Tar مشخص می‌کند که آیا توانسته عملیات درخواستی را با موفقیت انجام دهد یا خیر، و در صورت بروز خطا، چه نوع خطایی رخ داده است.
.TP
.B 0
پایان موفقیت‌آمیز.
.TP
.B 1
.I برخی فایل‌ها تفاوت دارند.
اگر tar با گزینه خط فرمان \fB\-\-compare\fR (\fB\-\-diff\fR, \fB\-d\fR) اجرا شده باشد، این کد خروج به این معناست که برخی فایل‌ها در آرشیو با نسخه‌های متناظر روی دیسک تفاوت دارند. اگر به tar یکی از گزینه‌های \fB\-\-create\fR، \fB\-\-append\fR یا \fB\-\-update\fR داده شده باشد، این کد به این معناست که برخی فایل‌ها در جریان فرآیند آرشیو شدن تغییر کرده‌اند و بنابراین آرشیو نهایی شامل رونوشت دقیق از مجموعه فایل‌ها نیست.
.TP
.B 2
.I خطای مهلک (Fatal error).
این کد نشان می‌دهد که خطایی مهلک و جبران‌ناپذیر رخ داده است.
.PP
اگر زیرپردازه‌ای که توسط
.B tar
فراخوانی شده است با کدی غیر صفر خارج شود،
.B tar
نیز خود با همان کد خارج خواهد شد. برای مثال این موضوع زمانی رخ می‌دهد که یکی از گزینه‌های فشرده‌سازی (مانند \fB\-z\fR) به کار رفته باشد و برنامه فشرده‌ساز خارجی با خطا مواجه شود. نمونه دیگر، شکست
.B rmt
در جریان پشتیبان‌گیری بر روی یک دستگاه دوردست است.
.SH "همچنین ببینید (SEE ALSO)"
.BR bzip2 (1),
.BR compress (1),
.BR gzip (1),
.BR lzma (1),
.BR lzop (1),
.BR rmt (8),
.BR symlink (7),
.BR xz (1),
.BR zstd (1).
.PP
راهنمای کامل \fBtar\fR: اجرای
.B info tar
یا استفاده از حالت info در
.BR emacs (1)
برای مطالعه آن.
.PP
نسخه‌های برخط مستندات \fBGNU tar\fR در قالب‌های گوناگون در نشانی زیر قابل دسترسی است:
.PP
.in +4
.B http://www.gnu.org/software/tar/manual
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <bug\-tar@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co 2013-2019 Free Software Foundation, Inc.
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
.ad
این یک نرم‌افزار آزاد است: شما مجاز به تغییر و توزیع مجدد آن هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end: