الاستخدام التقليدي¶

tar {A|c|d|r|t|u|x}[GnSkUWOmpsMBiajJzZhPlRvwo] [ARG...]

استخدام نمط يونكس¶

tar -A [OPTIONS] -f ARCHIVE ARCHIVE...

tar -c [-f ARCHIVE] [OPTIONS] [FILE...]

tar -d [-f ARCHIVE] [OPTIONS] [FILE...]

tar -r [-f ARCHIVE] [OPTIONS] [FILE...]

tar -t [-f ARCHIVE] [OPTIONS] [MEMBER...]

tar -u [-f ARCHIVE] [OPTIONS] [FILE...]

tar -x [-f ARCHIVE] [OPTIONS] [MEMBER...]

استخدام نمط جنو¶

tar {--catenate|--concatenate} [OPTIONS] --file ARCHIVE ARCHIVE...

tar --create [--file ARCHIVE] [OPTIONS] [FILE...]

tar {--diff|--compare} [--file ARCHIVE] [OPTIONS] [FILE...]

tar --delete [--file ARCHIVE] [OPTIONS] [MEMBER...]

tar --append [--file ARCHIVE] [OPTIONS] [FILE...]

tar --list [--file ARCHIVE] [OPTIONS] [MEMBER...]

tar --test-label [--file ARCHIVE] [OPTIONS] [LABEL...]

tar --update [--file ARCHIVE] [OPTIONS] [FILE...]

tar {--extract|--get} [--file ARCHIVE] [OPTIONS] [MEMBER...]

أنماط الخيارات¶

يمكن تقديم الخيارات لبرنامج GNU tar بثلاثة أنماط مختلفة. في النمط التقليدي، يكون المعامل الأول هو مجموعة من أحرف الخيارات وجميع المعاملات اللاحقة توفر معاملات لتلك الخيارات التي تتطلبها. تُقرأ المعاملات بنفس ترتيب أحرف الخيارات. أي كلمات في سطر الأوامر تبقى بعد معالجة جميع الخيارات تُعامل كمعاملات ليست خيارات: أسماء الملفات أو أعضاء الأرشيف.

على سبيل المثال، يتطلب الخيار c إنشاء الأرشيف، ويطلب الخيار v عملية مفصلة، ويأخذ الخيار f معاملاً يحدد اسم الأرشيف المراد العمل عليه. الأمر التالي، المكتوب بالنمط التقليدي، يوجه tar لتخزين جميع الملفات من الدليل /etc في ملف الأرشيف etc.tar، مع سرد الملفات التي يتم أرشفتها بالتفصيل:

tar cfv etc.tar /etc

في نمط يونكس أو نمط الخيار القصير، يسبق كل حرف خيار شرطة واحدة، كما هو الحال في أدوات سطر الأوامر الأخرى. إذا كان الخيار يأخذ معاملاً، فإن المعامل يتبعه، إما ككلمة منفصلة في سطر الأوامر، أو مباشرة بعد الخيار. ومع ذلك، إذا كان الخيار يأخذ معاملاً اختياريًا، فيجب أن يتبع المعامل حرف الخيار دون أي مسافة بيضاء فاصلة، كما في -g/tmp/snar.db.

يمكن تجميع أي عدد من الخيارات التي لا تأخذ معاملات معًا بعد شرطة واحدة، مثل -vkp. يمكن أن يظهر الخيار الذي يأخذ معاملاً (سواء كان إلزاميًا أو اختياريًا) في نهاية مثل هذا التجمع، مثل -vkpf a.tar.

الأمر المثال أعلاه المكتوب بـ نمط الخيار القصير يمكن أن يبدو كالتالي:

tar -cvf etc.tar /etc

tar -c -v -f etc.tar /etc

في نمط جنو أو نمط الخيار الطويل، يبدأ كل خيار بشرطتين وله اسم ذو معنى، يتكون من أحرف صغيرة وشرطات. عند استخدامه، يمكن اختصار الخيار الطويل إلى حروفه الأولى، بشرط ألا يؤدي ذلك إلى غموض. يتم توفير المعاملات للخيارات الطويلة إما ككلمة منفصلة في سطر الأوامر، مباشرة بعد الخيار، أو مفصولة عن الخيار بعلامة يساوي دون أي مسافة بيضاء فاصلة. يجب أن تستخدم المعاملات الاختيارية دائمًا الطريقة الأخيرة.

إليك عدة طرق لكتابة الأمر المثال بهذا النمط:

tar --create --file etc.tar --verbose /etc

tar --cre --file=etc.tar --verb /etc

يمكن خلط الخيارات في جميع الأنماط الثلاثة، على الرغم من أن القيام بذلك مع الخيارات القديمة غير مشجع.

وضع العملية¶

تخبر الخيارات المدرجة في الجدول أدناه برنامج GNU tar بالعملية التي يجب تنفيذها. يجب إعطاء واحد منها بالضبط. يعتمد معنى المعاملات التي ليست خيارات على وضع العملية المطلوب.

-A، --catenate، --concatenate

إلحاق الأرشيفات بنهاية أرشيف آخر. تُعامل المعاملات كأنسماء للأرشيفات المراد إلحاقها. يجب أن تكون جميع الأرشيفات بنفس تنسيق الأرشيف الذي يتم إلحاقها به، وإلا فقد يكون الأرشيف الناتج غير قابل للاستخدام مع تطبيقات tar غير التابعة لجنو. لاحظ أيضًا أنه عند إعطاء أكثر من أرشيف واحد، فإن الأعضاء من أرشيفات أخرى غير الأول لن يمكن الوصول إليها في الأرشيف الناتج إلا عند استخدام الخيار -i (--ignore-zeros).

لا يمكن دمج الأرشيفات المضغوطة.

-c، --create

إنشاء أرشيف جديد. توفر المعاملات أسماء الملفات المراد أرشفتها. تُؤرشف الأدلة بشكل تكراري، ما لم يتم إعطاء الخيار --no-recursion.

-d، --diff، --compare

البحث عن الفروق بين الأرشيف ونظام الملفات. المعاملات اختيارية وتحدد أعضاء الأرشيف المراد مقارنتها. إذا لم تُعطَ، يُفترض دليل العمل الحالي.

--delete

الحذف من الأرشيف. توفر المعاملات أسماء أعضاء الأرشيف المراد إزالتهم. يجب إعطاء معامل واحد على الأقل.

هذا الخيار لا يعمل على الأرشيفات المضغوطة. لا يوجد خيار قصير مكافئ.

-r، --append

إلحاق ملفات بنهاية أرشيف. المعاملات لها نفس معنى الخيار -c (--create).

-t، --list

سرد محتويات أرشيف. المعاملات اختيارية. عند إعطائها، فإنها تحدد أسماء الأعضاء المراد سردها.

--test-label

اختبار لَصيقة وحدة تخزين الأرشيف والخروج. عند استخدامه بدون معاملات، فإنه يطبع لصيقة وحدة التخزين (إن وجدت) ويخرج بالحالة 0. عندما يتم إعطاء معامل واحد أو أكثر في سطر الأوامر، يقارن tar لصيقة وحدة التخزين مع كل معامل. يخرج بالرمز 0 إذا عُثر على تطابق، وبالرمز 1 خلاف ذلك. لا يتم عرض أي مخرجات، ما لم يُستخدم مع الخيار -v (--verbose).

لا يوجد خيار قصير مكافئ لهذا الخيار.

-u، --update

إلحاق الملفات الأحدث من النسخة المقابلة في الأرشيف. المعاملات لها نفس المعنى كما في الخيارين -c و -r. لاحظ أن الملفات الأحدث لا تحل محل نسخها القديمة في الأرشيف، بل يتم إلحاقها بنهاية الأرشيف. وبالتالي يمكن أن يحتوي الأرشيف الناتج على عدة أعضاء بنفس الاسم، تقابل إصدارات مختلفة من نفس الملف.

-x، --extract، --get

استخراج الملفات من أرشيف. المعاملات اختيارية. عند إعطائها، فإنها تحدد أسماء أعضاء الأرشيف المراد استخراجها.

--show-defaults

إظهار القيم المبدئية المضمنة لمختلف خيارات tar والخروج.

-؟، --help

اعرض ملخصاً قصيراً للخيارات ثم اخرج.

--usage

عرض قائمة بالخيارات المتاحة والخروج.

--version

طباعة إصدار البرنامج ومعلومات حقوق النشر والخروج.

معدلات العمليات¶

--check-device

التحقق من أرقام الأجهزة عند إنشاء أرشيفات تزايدية (مبدئي).

-g، --listed-incremental=FILE

التعامل مع النسخ الاحتياطية التزايدية الجديدة بتنسيق جنو. FILE هو اسم ملف لقطة، حيث يخزن tar معلومات إضافية تُستخدم لتحديد الملفات التي تغيرت منذ النسخة التزايدية السابقة، وبالتالي، يجب نسخها مرة أخرى. إذا كان FILE غير موجود عند إنشاء أرشيف، فسيتم إنشاؤه وستُضاف جميع الملفات إلى الأرشيف الناتج (نسخة المستوى 0). لإنشاء أرشيفات تزايدية بمستوى غير صفري N، تحتاج إلى نسخة من ملف اللقطة الذي تم إنشاؤه للمستوى N-1، واستخدامه كـ FILE.

عند السرد أو الاستخراج، لا يتم فحص المحتوى الفعلي لـ FILE، فهو مطلوب فقط بسبب المتطلبات النحوية. لذلك من الممارسات الشائعة استخدام /dev/null في مكانه.

--hole-detection=METHOD

استخدم METHOD لاكتشاف الفجوات في الملفات المتناثرة. يتضمن هذا الخيار --sparse. القيم الصالحة لـ METHOD هي seek و raw. القيمة المبدئية هي seek مع الرجوع إلى raw عندما لا يكون ذلك قابلاً للتطبيق.

-G، --incremental

التعامل مع النسخ الاحتياطية التزايدية القديمة بتنسيق جنو.

--ignore-failed-read

لا تخرج بقيمة غير صفرية عند وجود ملفات غير قابلة للقراءة.

--level=NUMBER

تعيين مستوى النسخ لأرشيف تزايدي مدرج تم إنشاؤه. حاليًا فقط --level=0 له معنى: فهو يوجه tar لاقتطاع ملف اللقطة قبل النسخ، مما يجبر على إجراء نسخة من المستوى 0.

-n، --seek

افترض أن الأرشيف قابل للبحث. عادةً ما يحدد tar آليًا ما إذا كان الأرشيف قابلاً للبحث أم لا. هذا الخيار مخصص للاستخدام في الحالات التي يفشل فيها هذا التعرف. يسري مفعوله فقط إذا كان الأرشيف مفتوحًا للقراءة (على سبيل المثال مع خياري --list أو --extract).

--no-check-device

لا تتحقق من أرقام الأجهزة عند إنشاء أرشيفات تزايدية.

--no-seek

افترض أن الأرشيف لا يدعم البحث (seekable).

--occurrence[=N]

عالج الظهور رقم N فقط لكل ملف في الأرشيف. هذا الخيار صالح فقط عند استخدامه مع أحد الأوامر الفرعية التالية: --delete أو --diff أو --extract أو --list وعند تقديم قائمة ملفات إما في سطر الأوامر أو عبر الخيار -T. القيمة المبدئية لـ N هي 1.

--restrict

عطّل استخدام بعض الخيارات التي قد تكون ضارة.

--sparse-version=MAJOR[.MINOR]

اضبط إصدار التنسيق المتناثر (sparse) المراد استخدامه. هذا الخيار يتضمن --sparse. قيم المعطيات الصالحة هي 0.0 و 0.1 و 1.0. لمناقشة مفصلة حول التنسيقات المتناثرة، راجع دليل GNU Tar، الملحق D، "Sparse Formats". باستخدام قارئ info، يمكن الوصول إليه بتشغيل الأمر التالي: info tar 'Sparse Formats'.

-S, --sparse

عالج الملفات المتناثرة بكفاءة. قد تحتوي بعض الملفات في نظام ملفات على أجزاء لم تُكتب فعليًا (غالبًا ما تكون ملفات قواعد بيانات منشأة بواسطة أنظمة مثل DBM). عند إعطاء هذا الخيار، يحاول tar تحديد ما إذا كان الملف متناثرًا قبل أرشفته، وإذا كان الأمر كذلك، يُقلل حجم الأرشيف الناتج بعدم تفريغ الأجزاء الفارغة من الملف.

التحكم في الكتابة فوق الملفات¶

تتحكم هذه الخيارات في إجراءات tar عند استخراج ملف فوق نسخة موجودة على القرص.

-k, --keep-old-files

لا تستبدل الملفات الموجودة عند الاستخراج.

--keep-newer-files

لا تستبدل الملفات الموجودة التي تعد أحدث من نسخها في الأرشيف.

--keep-directory-symlink

لا تستبدل الروابط الرمزية الموجودة للمجلدات عند الاستخراج.

--no-overwrite-dir

احفظ البيانات الوصفية للمجلدات الموجودة.

--one-top-level[=DIR]

استخرج جميع الملفات إلى DIR، أو، إذا استُخدم دون معطى، إلى مجلد فرعي يُسمى باسم الأرشيف الأساسي (مطروحًا منه لواحق الضغط القياسية التي يتعرف عليها --auto-compress).

--overwrite

اكتب فوق الملفات الموجودة عند الاستخراج.

--overwrite-dir

اكتب فوق البيانات الوصفية للمجلدات الموجودة عند الاستخراج (مبدئي).

--recursive-unlink

أزِل جميع الملفات في المجلد تكراريًا قبل استخراجه.

--remove-files

أزِل الملفات من القرص بعد إضافتها إلى الأرشيف.

--skip-old-files

لا تستبدل الملفات الموجودة عند الاستخراج، وتخطها بصمت.

-U, --unlink-first

أزِل كل ملف قبل الاستخراج فوقه.

-W, --verify

تحقق من الأرشيف بعد كتابته.

اختيار دفق المخرجات¶

--ignore-command-error

تجاهل رموز خروج العمليات الفرعية.

--no-ignore-command-error

عامل رموز الخروج غير الصفرية للأبناء كخطأ (مبدئي).

-O, --to-stdout

استخرج الملفات إلى المخرج القياسي.

--to-command=COMMAND

مرر الملفات المستخرجة عبر أنبوب إلى COMMAND. المعطى هو مسار برنامج خارجي، اختياريًا مع وسائط سطر الأوامر. سيُستدعى البرنامج وتُمرر محتويات الملف الذي يجري استخراجه إليه في دخله القياسي. ستُوفر بيانات إضافية عبر متغيرات البيئة التالية:

التعامل مع سمات الملفات¶

--atime-preserve[=METHOD]

احفظ أوقات الوصول في الملفات المفرغة، إما عن طريق استعادة الأوقات بعد القراءة (METHOD=replace، وهذا هو المبدئي) أو بعدم ضبط الأوقات في المقام الأول (METHOD=system).

--delay-directory-restore

أخّر ضبط أوقات التعديل وأذونات المجلدات المستخرجة حتى نهاية عملية الاستخراج. استخدم هذا الخيار عند الاستخراج من أرشيف يحتوي على ترتيب أعضاء غير معتاد.

--group=NAME[:GID]

افرض NAME كمجموعة للملفات المضافة. إذا لم يُزود GID، يمكن أن يكون NAME إما اسم مستخدم أو معرف مجموعة (GID) رقمي. في هذه الحالة سيُستنتج الجزء المفقود (GID أو الاسم) من قاعدة بيانات مجموعات المضيف الحالي.

عند استخدامه مع --group-map=FILE، فإنه يؤثر فقط على تلك الملفات التي لم تُدرج مجموعة مالكها في FILE.

--group-map=FILE

اقرأ خريطة ترجمة المجموعات من FILE. تُتجاهل الأسطر الفارغة. تبدأ التعليقات بعلامة # وتمتد إلى نهاية السطر. يحدد كل سطر غير فارغ في FILE ترجمة لمجموعة واحدة. ويجب أن يتكون من حقلين، تفصل بينهما أي كمية من المسافات البيضاء:

OLDGRP NEWGRP[:NEWGID]
    

OLDGRP هو إما اسم مجموعة صالح أو معرف مجموعة (GID) مسبوق بعلامة +. ما لم يُزود NEWGID، يجب أن يكون NEWGRP أيضًا إما اسم مجموعة صالحًا أو +GID. وخلاف ذلك، لا يشترط إدراج كل من NEWGRP و NEWGID في قاعدة بيانات مجموعات النظام.

نتيجة لذلك، سيُخزن كل ملف دخل بمجموعة مالك OLDGRP في الأرشيف بمجموعة مالك NEWGRP ومعرف مجموعة NEWGID.

--mode=تغييرات

فرض وضع تغييرات الرمزي للملفات المضافة.

--mtime=DATE-OR-FILE

يضبط وقت التعديل (mtime) للملفات المضافة. DATE-OR-FILE هو إما تاريخ/وقت بتنسيق حر تقريبًا، أو اسم ملف موجود. وفي الحالة الأخيرة، سيُستخدم وقت تعديل ذلك الملف.

-m, --touch

لا يستخرج وقت تعديل الملف.

--no-delay-directory-restore

يلغي مفعول خيار --delay-directory-restore السابق.

--no-same-owner

يستخرج الملفات بصفتك المستخدم الحالي (المبدئي للمستخدمين العاديين).

--no-same-permissions

يطبق قناع المستخدم (umask) عند استخراج الأذونات من الأرشيف (المبدئي للمستخدمين العاديين).

--numeric-owner

يستخدم الأرقام دائمًا لأسماء المستخدمين/المجموعات.

--owner=NAME[:UID]

يفرض NAME كمالك للملفات المضافة. إذا لم يُزوّد المعرّف الرقمي UID، يمكن أن يكون NAME إما اسم مستخدم أو معرّفًا رقميًا. في هذه الحالة، سيُستنتج الجزء المفقود (المعرّف أو الاسم) من قاعدة بيانات المستخدمين على الحاسوب المضيف الحالي.

عند استخدامه مع --owner-map=FILE، فإنه يؤثر فقط على تلك الملفات التي لا يدرج مالكها في FILE.

--owner-map=FILE

يقرأ خريطة تحويل المالك من FILE. تُتجاهل الأسطر الفارغة. تبدأ التعليقات بعلامة # وتمتد إلى نهاية السطر. يحدد كل سطر غير فارغ في FILE تحويلاً لمعرّف مستخدم واحد. يجب أن يتكون من حقلين، يفصل بينهما أي قدر من المساحات البيضاء:

OLDUSR NEWUSR[:NEWUID]
    

OLDUSR هو إما اسم مستخدم صالح أو معرّف UID مسبوق بعلامة +. وما لم يُزوّد NEWUID، يجب أن يكون NEWUSR أيضًا إما اسم مستخدم صالح أو +UID. بخلاف ذلك، لا يشترط وجود كل من NEWUSR و NEWUID في قاعدة بيانات مستخدمي النظام.

نتيجة لذلك، سيُخزن كل ملف مدخل يملكه OLDUSR في الأرشيف باسم المالك NEWUSR ومعرّف UID‏ NEWUID.

-p, --preserve-permissions, --same-permissions

يضبط أذونات الملفات المستخرجة لتكون تلك المسجلة في الأرشيف (المبدئي للمستخدم الخارق).

--same-owner

يحاول استخراج الملفات بنفس الملكية الموجودة في الأرشيف (المبدئي للمستخدم الخارق).

-s, --preserve-order, --same-order

يخبر tar بأن قائمة أسماء الملفات المطلوب معالجتها مرتبة بنفس ترتيب الملفات في الأرشيف.

--sort=ORDER

عند إنشاء أرشيف، تُرتب مدخلات الدليل وفقًا لـ ORDER، وهو واحد من none أو name أو inode.

المبدئي هو --sort=none، والذي يخزن أعضاء الأرشيف بنفس الترتيب الذي يرجعه نظام التشغيل.

يضمن استخدام --sort=name أن يكون ترتيب الأعضاء في الأرشيف المنشأ موحدًا وقابلاً للتكرار.

يؤدي استخدام --sort=inode إلى تقليل عدد عمليات البحث في القرص عند إنشاء الأرشيف، وبالتالي يمكن أن يسرع عملية الأرشفة بشكل ملحوظ. هذا الترتيب مدعوم فقط إذا كان النظام الأساسي يوفر المعلومات اللازمة.

سمات الملفات الموسعة¶

--acls

يمكّن دعم POSIX ACLs.

--no-acls

يعطّل دعم POSIX ACLs.

--selinux

يمكّن دعم سياق SELinux.

--no-selinux

يعطّل دعم سياق SELinux.

--xattrs

يمكّن دعم السمات الموسعة.

--no-xattrs

يعطّل دعم السمات الموسعة.

--xattrs-exclude=PATTERN

يحدد نمط الاستبعاد لمفاتيح xattr. ‏PATTERN هو نمط مطابقة، مثلاً --xattrs-exclude='user.*' لتضمين السمات من مساحة أسماء المستخدم فقط.

--xattrs-include=PATTERN

يحدد نمط التضمين لمفاتيح xattr. ‏PATTERN هو نمط مطابقة.

اختيار الأجهزة والتبديل¶

-f, --file=ARCHIVE

يستخدم ملف الأرشيف أو جهاز ARCHIVE. إذا لم يُعطَ هذا الخيار، سيفحص tar أولاً متغير البيئة `TAPE'. إذا كان معينًا، ستُستخدم قيمته كاسم للأرشيف. خلاف ذلك، سيفترض tar القيمة المبدئية المضمنة عند التصريف. يمكن فحص القيمة المبدئية إما باستخدام خيار --show-defaults، أو في نهاية مخرجات tar --help.

اسم الأرشيف الذي يحتوي على نقطتين رأسيتين يحدد ملفًا أو جهازًا على آلة بعيدة. الجزء الذي يسبق النقطتين يُؤخذ كاسم للآلة أو عنوان IP، والجزء الذي يليهما كمسار للملف أو الجهاز، مثلاً:

--file=remotehost:/dev/sr0
    

يمكن بادئة اسم المستخدم اختيارياً لاسم المضيف، مع وضع علامة @ بينهما.

بشكل مبدئي، يتم الوصول إلى المضيف البعيد عبر أمر rsh(1). في الوقت الحاضر، من الشائع استخدام ssh(1) بدلاً منه. يمكنك القيام بذلك عن طريق إعطاء خيار سطر الأوامر التالي:

--rsh-command=/usr/bin/ssh
    

يجب أن يكون لدى الآلة البعيدة أمر rmt(8) مثبتًا. إذا كان مساره لا يطابق المسار المبدئي في tar، يمكنك إبلاغ tar بالمسار الصحيح باستخدام خيار --rmt-command.

--force-local

ملف الأرشيف محلي حتى لو كان يحتوي على نقطتين رأسيتين.

-F, --info-script=COMMAND, --new-volume-script=COMMAND

يشغل COMMAND في نهاية كل شريط (يستلزم -M). يمكن أن يتضمن الأمر وسائط. عند البدء، سيرث بيئة tar بالإضافة إلى المتغيرات التالية:

-L, --tape-length=N

يغير الشريط بعد كتابة Nx1024 بايت. إذا كان N متبوعًا بلاحقة حجم (انظر القسم الفرعي Size suffixes أدناه)، فإن اللاحقة تحدد عامل الضرب الذي سيُستخدم بدلاً من 1024.

هذا الخيار يستلزم -M.

-M, --multi-volume

ينشئ/يدرج/يستخرج أرشيفًا متعدد المجلدات.

--rmt-command=COMMAND

يستخدم COMMAND بدلاً من rmt عند الوصول إلى الأرشيفات البعيدة. انظر وصف خيار -f أعلاه.

--rsh-command=COMMAND

يستخدم COMMAND بدلاً من rsh عند الوصول إلى الأرشيفات البعيدة. انظر وصف خيار -f أعلاه.

--volno-file=FILE

عند استخدام هذا الخيار بالاقتران مع --multi-volume، سيقوم tar بتتبع أي مجلد من مجلدات الأرشيف متعدد المجلدات يعمل عليه في FILE.

تكتيل الأجهزة¶

-b, --blocking-factor=BLOCKS

يضبط حجم السجل إلى BLOCKSx512 بايت.

-B, --read-full-records

عند الإدراج أو الاستخراج، يقبل سجلات المدخلات غير المكتملة بعد علامة نهاية الملف.

-i، --ignore-zeros

يتجاهل الكتل المصفرة في الأرشيف. عادةً ما تعني كتلتان متتاليتان بحجم 512 بايت مملوءتان بالأصفار نهاية الملف (EOF) ويتوقف tar عن القراءة بعد مواجهتهما. يوجهه هذا الخيار لمواصلة القراءة وهو مفيد عند قراءة الأرشيفات المنشأة بخيار -A.

--record-size=NUMBER

يضبط حجم السجل. NUMBER هو عدد البايتات لكل سجل. يجب أن يكون مضاعفًا لـ 512. يمكن إلحاقه بـ size suffix، مثلاً --record-size=10K لـ 10 كيلوبايت. انظر القسم الفرعي Size suffixes للحصول على قائمة باللواحق الصالحة.

اختيار تنسيق الأرشيف¶

-H، --format=FORMAT

ينشئ أرشيفًا بالتنسيق المحدد. التنسيقات الصالحة هي:

--old-archive، --portability

نفس خيار --format=v7.

--pax-option=keyword[[:]=value][,keyword[[:]=value]]...

يتحكم في كلمات pax المفتاحية عند إنشاء أرشيفات PAX‏ (-H pax). هذا الخيار مكافئ لخيار -o في أداة pax(1).

--posix

مثله مثل --format=posix.

-V، --label=TEXT

يُنشئ أرشيفًا باسم الجزء TEXT. في حال الإدراج أو الاستخراج، يُستخدم TEXT كنمط مطابقة (globbing) لاسم الجزء.

خيارات الضغط¶

-a، --auto-compress

استخدم لاحقة الأرشيف لتحديد برنامج الضغط.

-I، --use-compress-program=COMMAND

مرشح البيانات عبر COMMAND. يجب أن يقبل الخيار -d لفك الضغط. يمكن أن يحتوي المعطى على خيارات سطر الأوامر.

-j، --bzip2

مرشح الأرشيف عبر bzip2(1).

-J، --xz

مرشح الأرشيف عبر xz(1).

--lzip

مرشح الأرشيف عبر lzip(1).

--lzma

مرشح الأرشيف عبر lzma(1).

--lzop

مرشح الأرشيف عبر lzop(1).

--no-auto-compress

لا تستخدم لاحقة الأرشيف لتحديد برنامج الضغط.

-z، --gzip، --gunzip، --ungzip

مرشح الأرشيف عبر gzip(1).

-Z، --compress، --uncompress

مرشح الأرشيف عبر compress(1).

--zstd

مرشح الأرشيف عبر zstd(1).

اختيار الملفات المحلية¶

--add-file=FILE

أضف FILE إلى الأرشيف (مفيد إذا كان اسمه يبدأ بشرطة).

--backup[=CONTROL]

أنشئ نسخة احتياطية قبل الإزالة. معطى CONTROL، في حال توفيره، يتحكم في سياسة النسخ الاحتياطي. قيمه الصالحة هي:

-C، --directory=DIR

غيّر إلى الدليل DIR قبل تنفيذ أي عمليات. هذا الخيار حساس للترتيب، أي أنه يؤثر على جميع الخيارات التي تليه.

--exclude=PATTERN

استثنِ الملفات التي تطابق PATTERN، وهو نمط محارف بدل بأسلوب glob(3).

--exclude-backups

استثنِ ملفات النسخ الاحتياطي والقفل.

--exclude-caches

استثنِ محتويات الأدلة التي تحتوي على الملف CACHEDIR.TAG، باستثناء ملف الوسم نفسه.

--exclude-caches-all

استثنِ الأدلة التي تحتوي على الملف CACHEDIR.TAG والملف نفسه.

--exclude-caches-under

استثنِ كل شيء تحت الأدلة التي تحتوي على CACHEDIR.TAG

--exclude-ignore=FILE

قبل تفريغ دليل ما، تحقق مما إذا كان يحتوي على FILE. إذا كان الأمر كذلك، فاقرأ أنماط الاستثناء من هذا الملف. تؤثر الأنماط على الدليل نفسه فقط.

--exclude-ignore-recursive=FILE

مثله مثل --exclude-ignore، إلا أن الأنماط من FILE تؤثر على الدليل وجميع أدلته الفرعية.

--exclude-tag=FILE

استثنِ محتويات الأدلة التي تحتوي على FILE، باستثناء FILE نفسه.

--exclude-tag-all=FILE

استثنِ الأدلة التي تحتوي على FILE.

--exclude-tag-under=FILE

استثنِ كل شيء تحت الأدلة التي تحتوي على FILE.

--exclude-vcs

استثنِ أدلة نظام التحكم في الإصدار.

--exclude-vcs-ignores

استثنِ الملفات التي تطابق الأنماط المقروءة من ملفات التجاهل الخاصة بأنظمة التحكم في الإصدار (VCS). الملفات المدعومة هي: .cvsignore و .gitignore و .bzrignore و .hgignore.

-h، --dereference

اتبع الروابط الرمزية؛ وأرشف وأفرغ الملفات التي تشير إليها.

--hard-dereference

اتبع الروابط الصلبة؛ وأرشف وأفرغ الملفات التي تشير إليها.

-K، --starting-file=MEMBER

ابدأ عند العضو المحدد في الأرشيف.

--newer-mtime=DATE

اعمل على الملفات التي تغيرت بياناتها بعد DATE. إذا بدأ DATE بـ / أو . فسيُعتبر اسم ملف؛ ويُستخدم وقت التعديل (mtime) لذلك الملف كالتاريخ.

--no-null

عطّل مفعول خيار --null السابق.

--no-recursion

تجنب النزول آليًا في الأدلة.

--no-unquote

لا تزل علامات الاقتباس من أسماء ملفات الإدخال أو الأعضاء.

--no-verbatim-files-from

عامل كل سطر يُقرأ من قائمة ملفات كما لو كان مُعطى في سطر الأوامر. أي، تُزال المسافات البيضاء في البداية والنهاية، وإذا بدأت السلسلة الناتجة بشرطة، تُعامل كخيار لسطر أوامر tar.

هذا هو السلوك المبدئي. يُوفر خيار --no-verbatim-files-from كوسيلة لاستعادته بعد خيار --verbatim-files-from.

هذا الخيار موضعي: فهو يؤثر على جميع خيارات --files-from التي تظهر بعده، حتى خيار --verbatim-files-from أو نهاية السطر، أيهما يحدث أولًا.

يتضمنه الخيار --no-null.

--null

وجّه خيارات -T اللاحقة لقراءة الأسماء المنتهية بمحرف صفري (null) حرفيًا (يعطل المعالجة الخاصة للأسماء التي تبدأ بشرطة).

انظر أيضًا --verbatim-files-from.

-N، --newer=DATE، --after-date=DATE

خزّن الملفات الأحدث من DATE فقط. إذا بدأ DATE بـ / أو . فسيُعتبر اسم ملف؛ ويُستخدم وقت التعديل (mtime) لذلك الملف كالتاريخ.

--one-file-system

ابقَ في نظام الملفات المحلي عند إنشاء الأرشيف.

-P، --absolute-names

لا تجرد الشرطات المائلة في بداية أسماء الملفات عند إنشاء الأرشيفات.

--recursion

كرّر في الأدلة (مبدئي).

--suffix=STRING

أنشئ نسخة احتياطية قبل الإزالة، وتجاوز اللاحقة المعتادة. اللاحقة المبدئية هي ~، ما لم تُتجاوز بواسطة متغير البيئة SIMPLE_BACKUP_SUFFIX.

-T، --files-from=FILE

احصل على أسماء الملفات للاستخراج أو الإنشاء من FILE.

ما لم يُحدد خلاف ذلك، يجب أن يحتوي الملف على قائمة أسماء تفصل بينها محارف LF بترميز ASCII (أي اسم واحد لكل سطر). تُعامل الأسماء المقروءة بنفس طريقة معاملة وسائط سطر الأوامر. حيث تخضع لإزالة الاقتباس وتقسيم الكلمات، وأي سلسلة نصية تبدأ بـ - تُعامل بصفتها خيارًا لسطر أوامر tar.

إذا كان هذا السلوك غير مرغوب فيه، يمكن إيقافه باستخدام الخيار --verbatim-files-from.

يوجه الخيار --null البرنامج tar بأن الأسماء في الملف مفصولة بمحرف ASCII NUL، بدلًا من LF. وهو مفيد إذا وُلدت القائمة بواسطة مسند -print0 للأمر find(1).

--unquote

إزالة الاقتباس من أسماء الملفات أو الأعضاء (مبدئي).

--verbatim-files-from

عامل كل سطر يُحصل عليه من قائمة ملفات كاسم ملف، حتى لو بدأ بشرطة. تُزود قوائم الملفات عبر الخيار --files-from (-T). السلوك المبدئي هو معاملة الأسماء المزودة في قوائم الملفات كما لو كتبت في سطر الأوامر، أي أن أي أسماء تبدأ بشرطة تُعامل بصفتها خيارات لـ tar. الخيار --verbatim-files-from يعطل هذا السلوك.

يؤثر هذا الخيار على جميع خيارات --files-from التي تأتي بعده في سطر الأوامر. ويُلغى أثره بواسطة الخيار --no-verbatim-files-from.

يتضمن الخيار --null هذا الخيار ضمنيًا.

انظر أيضًا --add-file.

-X، --exclude-from=ملف

استثنِ الملفات التي تطابق الأنماط المدرجة في الملف.

تحويلات أسماء الملفات¶

--strip-components=NUMBER

جرد عدد NUMBER من المكونات البادئة من أسماء الملفات عند الاستخراج.

--transform=EXPRESSION، --xform=EXPRESSION

استخدم تعبير sed للاستبدال EXPRESSION لتحويل أسماء الملفات.

خيارات مطابقة أسماء الملفات¶

تؤثر هذه الخيارات على أنماط الاستثناء والاشتمال معًا.

--anchored

تطابق الأنماط بداية اسم الملف.

--ignore-case

تجاهل حالة الأحرف.

--no-anchored

تطابق الأنماط ما بعد أي / (مبدئي للاستثناء).

--no-ignore-case

مطابقة حساسة لحالة الأحرف (مبدئي).

--no-wildcards

مطابقة نصية حرفية.

--no-wildcards-match-slash

لا تطابق المحارف البديلة (wildcards) العلامة /.

--wildcards

استخدم المحارف البديلة (مبدئي للاستثناء).

--wildcards-match-slash

تطابق المحارف البديلة العلامة / (مبدئي للاستثناء).

المخرجات المعلوماتية¶

--checkpoint[=N]

اعرض رسائل التقدم عند كل سجل N (المبدئي 10).

--checkpoint-action=ACTION

نفذ الإجراء عند كل نقطة فحص.

--clamp-mtime

لا تضبط الوقت إلا إذا كان الملف أحدث مما أُعطي مع الخيار --mtime.

--full-time

اطبع وقت الملف بدقته الكاملة.

--index-file=الملف

أرسل المخرجات التفصيلية إلى الملف.

-l، --check-links

اطبع رسالة إذا لم تُنسخ جميع الروابط.

--no-quote-chars=السلسلة

عطل الاقتباس للمحارف الموجودة في السلسلة.

--quote-chars=السلسلة

اقتبس إضافيًا المحارف الموجودة في السلسلة.

--quoting-style=النمط

اضبط نمط الاقتباس لأسماء الملفات والأعضاء. القيم الصالحة لـ النمط هي literal، shell، shell-always، c، c-maybe، escape، locale، clocale.

-R، --block-number

أظهر رقم الكتلة داخل الأرشيف مع كل رسالة.

--show-omitted-dirs

عند السرد أو الاستخراج، اسرد كل دليل لا يطابق معايير البحث.

--show-transformed-names، --show-stored-names

أظهر أسماء الملفات أو الأرشيف بعد التحويل بواسطة خيارات --strip و --transform.

--totals[=الإشارة]

اطبع إجمالي البايتات بعد معالجة الأرشيف. إذا أُعطيت إشارة، فاطبع إجمالي البايتات عند وصول هذه الإشارة. الإشارات المسموح بها هي: SIGHUP، SIGQUIT، SIGINT، SIGUSR1، و SIGUSR2. يمكن حذف البادئة SIG.

--utc

اطبع أوقات تعديل الملف بالتوقيت العالمي الموحد (UTC).

-v، --verbose

اسرد الملفات المعالجة بشكل تفصيلي. كل تكرار لهذا الخيار في سطر الأوامر يزيد مستوى التفصيل بمقدار واحد. أقصى مستوى للتفصيل هو 3. لمناقشة مفصلة حول كيفية تأثير مستويات التفصيل المختلفة على مخرجات tar، يرجى الرجوع إلى دليل GNU Tar، القسم الفرعي 2.5.2 "الخيار '--verbose'".

--warning=الكلمة_المفتاحية

مكّن أو عطّل رسائل التحذير المحددة بـ الكلمة_المفتاحية. تُكتم الرسائل إذا سُبقت الكلمة_المفتاحية بـ no- وتُمكّن بخلاف ذلك.

تتراكم خيارات --warning المتعددة.

الكلمات المفتاحية التي تتحكم في عملية tar العامة:

-w، --interactive، --confirmation

طلب التأكيد لكل إجراء.

خيارات التوافق¶

-o

عند الإنشاء، يماثل --old-archive. عند الاستخراج، يماثل --no-same-owner.

لواحق الحجم¶

	اللاحقة	الوحدات	ما يعادلها بالبايت
	b	كتل	SIZE x 512
	B	كيلوبايت	SIZE x 1024
	c	بايت	SIZE
	G	جيجابايت	SIZE x 1024^3
	K	كيلوبايت	SIZE x 1024
	k	كيلوبايت	SIZE x 1024
	M	ميجابايت	SIZE x 1024^2
	P	بيتابايت	SIZE x 1024^5
	T	تيرابايت	SIZE x 1024^4
	w	كلمات	SIZE x 2