CPIO(1) GNU CPIO CPIO(1)

cpio - کپی پرونده‌ها به و از بایگانی‌ها

cpio {-o|--create} [-0acvABLV] [-C BYTES] [-H FORMAT] [-M MESSAGE] [-O [[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--format=FORMAT] [--message=MESSAGE] [--null] [--reset-access-time] [--verbose] [--dot] [--append] [--block-size=blocks] [--dereference] [--io-size=BYTES] [--quiet] [--force-local] [--rsh-command=COMMAND] < name-list [> archive]

cpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C BYTES] [-E FILE] [-H FORMAT] [-M MESSAGE] [-R [USER][:.][GROUP]] [-I [[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--make-directories] [--nonmatching] [--preserve-modification-time] [--numeric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot] [--unconditional] [--verbose] [--block-size=BLOCKS] [--swap-halfwords] [--io-size=BYTES] [--pattern-file=FILE] [--format=FORMAT] [--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--message=MESSAGE] [--force-local] [--no-absolute-filenames] [--sparse] [--only-verify-crc] [--to-stdout] [--quiet] [--rsh-command=COMMAND] [pattern...] [< archive]

cpio {-p|--pass-through} [-0adlmuvLV] [-R [USER][:.][GROUP]] [--null] [--reset-access-time] [--make-directories] [--link] [--quiet] [--preserve-modification-time] [--unconditional] [--verbose] [--dot] [--dereference] [--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--sparse] destination-directory < name-list

cpio {-?|--help|--usage|--version}

این صفحه راهنما توصیفی کوتاه از GNU cpio است. برای توضیحات دقیق‌تر، شامل مثال‌ها و توصیه‌های کاربردی، به راهنمای GNU Cpio که در قالب texinfo موجود است مراجعه کنید. اگر برنامه‌خوان info و مستندات cpio به درستی روی سیستم شما نصب شده باشند، دستور

info cpio

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

همچنین می‌توانید راهنما را با استفاده از حالت info در emacs(1) مشاهده کنید، یا آن را در قالب‌های گوناگون به‌صورت برخط در

http://www.gnu.org/software/cpio/manual

بیابید. در صورت وجود هرگونه مغایرت بین این صفحه راهنما و راهنمای GNU Cpio، نسخه دوم به عنوان مرجع معتبر در نظر گرفته می‌شود.

دستور GNU cpio پرونده‌ها را بین بایگانی‌ها و دایرکتوری‌ها کپی می‌کند. این ابزار از قالب‌های بایگانی زیر پشتیبانی می‌کند: cpio باینری قدیمی، cpio پرتابل قدیمی، SVR4 cpio با و بدون چک‌سام (checksum)، HP cpio، و قالب‌های گوناگون tar.

حالت عملیاتی توسط یکی از گزینه‌های زیر درخواست می‌شود:

کپی خروجی (Copy-out). فهرستی از نام‌های پرونده را از ورودی استاندارد می‌خواند و در خروجی استاندارد (مگر اینکه توسط گزینه --file لغو شود) یک بایگانی حاوی این پرونده‌ها ایجاد می‌کند.
کپی ورودی (Copy-in). بایگانی را از ورودی استاندارد (یا از پرونده ارائه‌شده با گزینه --file) می‌خواند و پرونده‌ها را از آن استخراج می‌کند، یا (اگر گزینه -t داده شده باشد) محتویات آن را در خروجی استاندارد فهرست می‌کند. اگر یک یا چند pattern داده شود، فقط پرونده‌های منطبق با این الگوها خوانده یا فهرست می‌شوند. گزینه -t به تنهایی به معنی -i است.
انتقال مستقیم (Pass-through). فهرستی از نام‌های پرونده را از ورودی استاندارد می‌خواند و آنها را در دایرکتوری مشخص‌شده کپی می‌کند.
-?, --help
نمایش خلاصه کوتاهی از راهنما و خروج.
چاپ یک پیام کوتاه درباره نحوه استفاده و خروج.
چاپ نسخه برنامه و خروج.

تنظیم اندازه بلوک I/O روی BLOCK-SIZE * 512 بایت.
تنظیم اندازه بلوک I/O روی ۵۱۲۰ بایت.
استفاده از قالب بایگانی پرتابل قدیمی (ASCII). این معادل با -H odc است.
تنظیم اندازه بلوک I/O روی مقدار مشخص‌شده NUMBER بر حسب بایت.
تغییر دایرکتوری کاری به DIR.
پرونده بایگانی محلی فرض می‌شود، حتی اگر نام آن شامل دو نقطه (:) باشد.
استفاده از قالب بایگانی مشخص‌شده FORMAT. قالب‌های معتبر عبارتند از (عدد داخل پرانتز حداکثر اندازه را برای هر عضو بایگانی مشخص می‌کند):
قالب باینری منسوخ‌شده. (۲۱۴۷۴۸۳۶۴۷ بایت)
قالب پرتابل قدیمی (POSIX.1). (۸۵۸۹۹۳۴۵۹۱ بایت)
قالب پرتابل جدید (SVR4)، که از سیستم‌های پرونده با بیش از ۶۵۵۳۶ آی‌نود (inode) پشتیبانی می‌کند. (۴۲۹۴۹۶۷۲۹۵ بایت)
قالب پرتابل جدید (SVR4) با یک چک‌سام اضافه شده.
قالب قدیمی tar. (۸۵۸۹۹۳۴۵۹۱ بایت)
قالب POSIX.1 tar. همچنین بایگانی‌های GNU tar را که مشابه اما نه کاملاً یکسان هستند، شناسایی می‌کند. (۸۵۸۹۹۳۴۵۹۱ بایت)
قالب باینری منسوخ‌شده مورد استفاده توسط cpio در HPUX (که پرونده‌های دستگاه را متفاوت ذخیره می‌کند).
قالب پرتابل مورد استفاده توسط cpio در HPUX (که پرونده‌های دستگاه را متفاوت ذخیره می‌کند).
در حالت‌های copy-in و copy-pass، مالکیت تمام پرونده‌های ایجادشده را روی USER و/یا GROUP مشخص‌شده تنظیم می‌کند. در حالت copy-out، اطلاعات مالک ارائه‌شده را در بایگانی ذخیره می‌کند.

ابتدا USER و GROUP در پایگاه‌های داده کاربر و گروه سیستم جستجو می‌شوند. در صورت پیدا نشدن، cpio بررسی می‌کند که آیا آنها فقط از ارقام ده‌دهی تشکیل شده‌اند یا خیر، و در صورت مثبت بودن، آنها را به ترتیب به عنوان UID و GID عددی در نظر می‌گیرد.

برای جلوگیری از جستجو در پایگاه داده و اطمینان از اینکه آرگومان‌ها به عنوان مقادیر عددی در نظر گرفته می‌شوند، یک علامت مثبت قبل از آنها قرار دهید، مانند: -R +0:+0.

عدم چاپ تعداد بلوک‌های کپی‌شده در پایان اجرا.
استفاده از دستور راه دور COMMAND به جای rsh.
فهرست کردن پرونده‌های پردازش‌شده با جزئیات کامل.
چاپ یک علامت "." به ازای هر پرونده پردازش‌شده.
کنترل هشدارهای نمایش‌داده‌شده. مقدار FLAG می‌تواند یکی از موارد زیر باشد: none برای غیرفعال کردن همه هشدارها، all برای فعال کردن آنها، truncate برای فعال کردن هشدارهای مربوط به کوتاه‌سازی فیلدها، و no-truncate برای غیرفعال کردن آنها.

استفاده از چند گزینه -W با هم جمع می‌شوند.

استفاده از این ARCHIVE-FILE به جای ورودی استاندارد (در حالت copy-in) یا خروجی استاندارد (در حالت copy-out). مقادیر اختیاری USER و HOST نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.
چاپ STRING هنگامی که به انتهای یک حجم از رسانه پشتیبان برسد.

جابجایی (swap) هر دو نیم‌کلمه در کلمه‌ها و بایت‌ها در نیم‌کلمه‌ها در داده‌ها. معادل با -sS.
فقط کپی پرونده‌هایی که با هیچ‌یک از الگوهای داده‌شده مطابقت ندارند.
در فهرست محتویات پرجزئیات، شناسه‌های عددی UID و GID نشان داده شوند.
تغییر نام تعاملی پرونده‌ها.
جابجایی بایت‌های هر نیم‌کلمه در پرونده‌ها.
جابجایی نیم‌کلمه‌های هر کلمه (۴ بایت) در پرونده‌ها.
استخراج پرونده‌ها در خروجی استاندارد.
خواندن الگوهای اضافی مشخص‌کننده نام پرونده‌ها برای استخراج یا فهرست کردن از FILE.
هنگام خواندن یک بایگانی با قالب CRC، فقط CRC هر پرونده در بایگانی بررسی شود، بدون اینکه پرونده‌ها واقعاً استخراج شوند.

افزودن به یک بایگانی موجود.
ایجاد بایگانی‌های بازتولیدپذیر. این معادل با --ignore-devno --ignore-dirnlink --renumber-inodes است.
ذخیره مقدار ۰ در فیلد شماره دستگاه هر عضو بایگانی، به جای شماره واقعی دستگاه.
ذخیره مقدار ۲ در فیلد nlink هر عضو دایرکتوری بایگانی، به جای تعداد واقعی پیوندها.
استفاده از ARCHIVE-NAME به جای خروجی استاندارد. مقادیر اختیاری USER و HOST نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.

نام بایگانی خروجی را می‌توان با استفاده از این گزینه یا با استفاده از -F (--file) مشخص کرد، اما نه هر دو.

شماره‌گذاری مجدد آی‌نودها هنگام ذخیره آنها در بایگانی.

ایجاد پیوند برای پرونده‌ها به جای کپی کردن آنها، در صورت امکان.

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

-0, --null
نام‌های پرونده در فهرست به جای خط جدید با نویسه‌های تهی (null) جدا شوند.
بازنشانی زمان‌های دسترسی پرونده‌ها پس از خواندن آنها.
استفاده از ARCHIVE-NAME به جای ورودی استاندارد. مقادیر اختیاری USER و HOST نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.

نام بایگانی ورودی را می‌توان با استفاده از این گزینه یا با استفاده از -F (--file) مشخص کرد، اما نه هر دو.

ارجاع‌گشایی پیوندهای نمادین (کپی کردن پرونده‌هایی که پیوندها به آنها اشاره دارند به جای کپی کردن خود پیوندها).

ایجاد دایرکتوری‌های والد در صورت نیاز.
حفظ زمان‌های اصلاح قبلی پرونده هنگام ایجاد پرونده‌ها.
مالکیت پرونده‌ها تغییر داده نشود.
نوشتن پرونده‌های دارای بلوک‌های بزرگ صفر به عنوان پرونده‌های پراکنده (sparse files).
جایگزینی بدون قید و شرط تمام پرونده‌ها.

دستور GNU cpio در صورتی که بتواند عملیات درخواستی را با موفقیت به پایان برساند با کد 0 خارج می‌شود. در صورت بروز خطا، با کد 2 خارج می‌شود.

tar(1), rmt(8), mt(1).

گزارش اشکالات به <bug-cpio@gnu.org>.

حق نشر © 2014--2023 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر http://gnu.org/licenses/gpl.html
این نرم‌افزار آزاد است: شما می‌توانید آن را تغییر داده و بازتوزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

April 29, 2023 CPIO