نام (NAME)

paxcpio — کپی و انتقال بایگانی‌های فایل به داخل و خارج

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

paxcpio -o [-0AaBcJjLVvZz] [-C bytes] [-F archive] [-H format] [-M flag] [-O archive] < name-list [> archive] paxcpio -i [-06BbcdfJjmrSstuVvZz] [-C bytes] [-E file] [-F archive] [-H format] [-I archive] [-M flag] [pattern ...] [< archive] paxcpio -p [-0adLlmuVv] destination-directory < name-list

توضیحات (DESCRIPTION)

دستور paxcpio فایل‌ها را به و از یک بایگانی cpio کپی می‌کند.

گزینه‌ها به شرح زیر هستند:

-0

استفاده از نویسه NUL (‘\0’) به عنوان پایان‌دهنده مسیر فایل، به جای خط جدید (newline) (‘\n .’) این گزینه تنها برای مسیرهای فایل خوانده‌شده از ورودی استاندارد در حالت‌های نوشتن و کپی، و برای مسیرهای نوشته‌شده در خروجی استاندارد در حالت فهرست اعمال می‌شود. انتظار می‌رود این گزینه در هماهنگی با تابع -print0 در find(1) ، گزینه -d '' برای ابزار توکار read در mksh(1) یا پرچم -0 در xargs(1) به کار رود.

-o

ایجاد یک بایگانی. فهرست فایل‌ها برای ذخیره در بایگانی را از ورودی استاندارد می‌خواند و بایگانی را در خروجی استاندارد می‌نویسد.

-A

افزودن و ضمیمه کردن به بایگانی مشخص‌شده.

-a

بازنشانی زمان‌های دسترسی فایل‌هایی که به بایگانی کپی شده‌اند.

-B

تنظیم اندازه بلوک خروجی روی ۵۱۲۰ بایت.

-C bytes

تنظیم اندازه بلوک خروجی به bytes .

-c

استفاده از قالب ASCII برای سرآیند cpio جهت سازگاری و قابلیت حمل.

-F archive

استفاده از فایل مشخص‌شده به عنوان ورودی برای بایگانی.

-H format

نوشتن بایگانی در قالب مشخص‌شده. قالب‌های شناخته‌شده عبارتند از:

ar

بایگانی‌کننده یونیکس (Unix Archiver).

bcpio

قالب باینری قدیمی cpio . با -6 انتخاب می‌شود.

cpio

قالب کاراکتری هشت‌هشتی (اکتال) قدیمی cpio . با -c انتخاب می‌شود.

sv4cpio

قالب هگزادسیمال SVR4 برای cpio .

sv4crc

قالب هگزادسیمال SVR4 برای cpio به همراه چکسام (checksums). این قالب پیش‌فرض برای ایجاد بایگانی‌های جدید است.

tar

قالب قدیمی tar.

ustar

قالب ustar استاندارد POSIX.

 

 

bin

این چهار قالب...

crc

...تنها برای...

newc

...سازگاری با...

odc

...گذشته پشتیبانی می‌شوند.

-J

استفاده از ابزار xz برای فشرده‌سازی بایگانی.

-j

استفاده از ابزار bzip2 برای فشرده‌سازی بایگانی.

-L

دنبال کردن پیوندهای نمادین (symbolic links).

-M flag

پیکربندی یکسان‌ساز و بهینه‌ساز (normaliser) بایگانی. flag یا یک مقدار عددی سازگار با strtonum(3) است که مستقیماً در کلمه پرچم‌ها ذخیره می‌شود، یا یکی از مقادیر زیر است که می‌توان به صورت اختیاری پیشوند “no-” را به آن‌ها افزود تا غیرفعال شوند:

inodes

0x0001: سریالی‌سازی inodeها، صفر کردن اطلاعات دستگاه.
(cpio, sv4cpio, sv4crc)

links

0x0002: ذخیره محتوای پیوندهای سخت (hard links) تنها برای یک بار.
(cpio, sv4cpio, sv4crc)

mtime

0x0004: صفر کردن زمان تغییر فایل (mtime).
(ar, cpio, sv4cpio, sv4crc, ustar)

uidgid

0x0008: تنظیم مالک روی 0:0 (root:wheel .)
(ar, cpio, sv4cpio, sv4crc, ustar)

verb

0x0010: اشکال‌زدایی این گزینه.

debug

0x0020: اشکال‌زدایی ذخیره‌سازی سرآیند فایل.

lncp

0x0040: استخراج پیوندهای سخت از طریق کپی کردن در صورت شکست ایجاد پیوند.

numid

0x0080: استفاده انحصاری از مقادیر عددی uid و gid.
(ustar)

gslash

0x0100: افزودن اسلش پس از نام پوشه‌ها.
(ustar)

set

0x0003: دست‌نخورده نگه داشتن اطلاعات مالکیت و زمان تغییر (mtime).

dist

0x008B: پاک‌سازی همه چیز به جز زمان تغییر (mtime).

norm

0x008F: پاک‌سازی کامل تمام موارد.

root

0x0089: پاک‌سازی اطلاعات مالک و دستگاه.

هنگام ایجاد یک بایگانی و فهرست‌بندی پرگوی خروجی، این عملیات نرمال‌سازی در خروجی منعکس نمی‌شوند، زیرا تنها پس از نمایش خروجی اعمال می‌گردند.

این گزینه تنها برای توابع نوشتن قالب‌های فایل ar، cpio، sv4cpio، sv4crc و ustar پیاده‌سازی شده است.

-O archive

استفاده از نام فایل مشخص‌شده به عنوان بایگانی مقصد برای نوشتن.

-V

چاپ یک نقطه (‘.’) به ازای هر فایل نوشته‌شده در بایگانی.

-v

حالت پرگو درباره عملیات. فهرست کردن نام فایل‌ها هم‌زمان با نوشته شدن در بایگانی.

-Z

استفاده از ابزار compress(1) برای فشرده‌سازی بایگانی.

-z

استفاده از ابزار gzip(1) برای فشرده‌سازی بایگانی.

-i

بازیابی فایل‌ها از یک بایگانی. فایل بایگانی را از ورودی استاندارد خوانده و فایل‌های منطبق با patterns مشخص‌شده در خط فرمان را استخراج می‌کند.

-6

پردازش بایگانی‌های قالب قدیمی cpio .

-B

تنظیم اندازه بلوک بایگانی در حال خواندن روی ۵۱۲۰ بایت.

-b

جابه‌جایی (swap) بایت و کلمه پس از خواندن داده‌ها از بایگانی، جهت بازیابی بایگانی‌های ایجادشده در سیستم‌هایی با ترتیب بایت متفاوت.

-C bytes

خواندن بایگانی نوشته‌شده با اندازه بلوک bytes .

-c

انتظار قرار داشتن سرآیندهای بایگانی در قالب ASCII.

-d

ایجاد پوشه‌های میانی در صورت نیاز در طول بازیابی.

-E file

خواندن فهرست الگوهای نام فایل جهت استخراج یا فهرست‌بندی از file .

-F archive, -I archive

استفاده از فایل مشخص‌شده به عنوان ورودی برای بایگانی.

-f

بازیابی تمام فایل‌ها به استثنای آن‌هایی که با patterns داده‌شده در خط فرمان مطابقت دارند.

-H format

خواندن بایگانی با قالب مشخص‌شده. قالب‌های شناخته‌شده عبارتند از:

ar

بایگانی‌کننده یونیکس (Unix Archiver).

bcpio

قالب باینری قدیمی cpio .

cpio

قالب کاراکتری هشت‌هشتی (اکتال) قدیمی cpio .

sv4cpio

قالب هگزادسیمال SVR4 برای cpio .

sv4crc

قالب هگزادسیمال SVR4 برای cpio به همراه چکسام.

tar

قالب قدیمی tar.

ustar

قالب ustar استاندارد POSIX.

 

 

bin

این چهار قالب...

crc

...تنها برای...

newc

...سازگاری با...

odc

...گذشته پشتیبانی می‌شوند.

-J

استفاده از ابزار xz برای از فشرده خارج کردن بایگانی.

-j

استفاده از ابزار bzip2 برای از فشرده خارج کردن بایگانی.

-m

بازگرداندن زمان‌های تغییر فایل‌ها (mtime).

-r

تغییر نام تعاملی فایل‌های بازیابی‌شده.

-S

جابه‌جایی کلمات (swap words) پس از خواندن داده‌ها از بایگانی.

-s

جابه‌جایی بایت‌ها (swap bytes) پس از خواندن داده‌ها از بایگانی.

-t

تنها فهرست کردن محتویات بایگانی؛ هیچ فایل یا پوشه‌ای ساخته نخواهد شد.

-u

رونویسی روی فایل‌ها حتی اگر فایل موجود در بایگانی قدیمی‌تر از فایلی باشد که رونویسی می‌شود.

-V

چاپ یک نقطه (‘.’) به ازای هر فایل خوانده‌شده از بایگانی.

-v

حالت پرگو درباره عملیات. فهرست کردن نام فایل‌ها هم‌زمان با استخراج و کپی آن‌ها از بایگانی.

-Z

استفاده از ابزار compress(1) برای از فشرده خارج کردن بایگانی.

-z

استفاده از ابزار gzip(1) برای از فشرده خارج کردن بایگانی.

-p

کپی فایل‌ها از یک مکان به مکانی دیگر در یک مرحله (تک‌گذره). فهرست فایل‌ها برای کپی از ورودی استاندارد خوانده شده و در یک پوشه متناسب با آرگومان مشخص‌شده directory نوشته می‌شود.

-a

بازنشانی زمان‌های دسترسی فایل‌هایی که کپی شده‌اند.

-d

ایجاد پوشه‌های میانی در صورت نیاز برای نوشتن فایل‌ها در مکان جدید.

-L

دنبال کردن پیوندهای نمادین (symbolic links).

-l

در صورت امکان، ایجاد پیوند به جای ساخت یک کپی اضافی.

-m

بازگرداندن زمان‌های تغییر فایل‌ها (mtime).

-u

رونویسی روی فایل‌ها حتی اگر فایل اصلی در حال کپی قدیمی‌تر از فایلی باشد که رونویسی می‌شود.

-V

چاپ یک نقطه (‘.’) به ازای هر فایل کپی‌شده.

-v

حالت پرگو درباره عملیات. فهرست کردن نام فایل‌ها هم‌زمان با کپی شدن آن‌ها.

محیط (ENVIRONMENT)

TMPDIR

مسیری که فایل‌های موقت در آن ذخیره می‌شوند.

وضعیت خروج (EXIT STATUS)

ابزار paxcpio با یکی از مقادیر زیر خارج می‌شود:

عیب‌یابی (DIAGNOSTICS)

هر زمان که paxcpio نتواند هنگام استخراج یک بایگانی فایل یا پیوندی ایجاد کند یا نتواند هنگام نوشتن یک بایگانی فایلی را بیابد، یا نتواند شناسه کاربر (UID)، شناسه گروه (GID)، حالت فایل (mode)، یا زمان‌های دسترسی و تغییر را هنگام تعیین گزینه -p حفظ کند، یک پیام عیب‌یابی در خطای استاندارد نوشته شده و یک مقدار خروج غیرصفر برگردانده می‌شود، اما پردازش ادامه خواهد یافت. در حالتی که paxcpio نتواند پیوندی به یک فایل ایجاد کند، مگر اینکه گزینه -M lncp تعیین شده باشد، paxcpio کپی دومی از فایل ایجاد نخواهد کرد.

اگر استخراج یک فایل از بایگانی پیش از موعد به دلیل یک سیگنال یا خطا متوقف شود، paxcpio ممکن است تنها بخشی از فایل مورد نظر کاربر را استخراج کرده باشد. علاوه بر این، حالت فایل‌های استخراج‌شده و پوشه‌ها ممکن است دارای بیت‌های نادرستی باشند و زمان‌های تغییر و دسترسی ممکن است اشتباه باشند.

اگر ایجاد یک بایگانی پیش از موعد توسط یک سیگنال یا خطا متوقف شود، paxcpio ممکن است بایگانی را تنها به صورت ناقص ایجاد کرده باشد، که ممکن است مشخصات قالب بایگانی مربوطه را نقض کند.

همچنین ببینید (SEE ALSO)

ar(1), cpio(1), deb(5), pax(1), paxtar(1), tar(1)

نویسندگان (AUTHORS)

Keith Muller در دانشگاه کالیفرنیا، سن دیگو. افزونه‌های MirBSD توسط mirabilos ⟨m@mirbsd.org .⟩

هشدارها (CAVEATS)

قالب‌های مختلف فایل دارای حداکثر اندازه فایل متفاوتی هستند. توصیه می‌شود برای فایل‌های بزرگ‌تر از قالبی مانند cpio یا ustar استفاده شود.

گزینه‌های قالب سازگار با گذشته در رابط pax(1) در دسترس نیستند.

گزینه -M یک افزونه MirBSD است که با شروع از در دسترس است. با این حال، بایگانی‌های نوشته‌شده با استفاده از این گزینه‌ها با استاندارد سازگار بوده و روی هر سیستم دیگری باید قابل خواندن باشند. تنها گزینه‌ای که رفتار آن صراحتاً توسط استاندارد مجاز دانسته نشده، یکپارچه‌سازی پیوندهای سخت (نوشتن محتوای فایل تنها برای یک بار) است که توسط -M 0x0002 انتخاب می‌شود.

گزینه -V یک افزونه گنو است که از به بعد در دسترس است.

قالب فایل ar با مخازن APT و مشخصات BSD در ar(1) مطابقت دارد، نه با GNU binutils (که البته می‌توانند آن‌ها را بخوانند) یا سیستم‌های SYSV.

اشکالات (BUGS)

گزینه‌های -s و -S در حال حاضر پیاده‌سازی نشده‌اند.

قالب فایل pax هنوز پشتیبانی نمی‌شود.