.\" This file is part of GNU cpio. -*- nroff -*-
.\" Copyright 2014-2024 Free Software Foundation, Inc.
.\"
.\" GNU cpio 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 cpio 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 GNU cpio.  If not, see <http://www.gnu.org/licenses>.
.TH CPIO 1 "April 29, 2023" "CPIO" "GNU CPIO"
.SH "نام (NAME)"
cpio \- کپی پرونده‌ها به و از بایگانی‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B cpio
{\fB\-o\fR|\fB\-\-create\fR} [\fB\-0acvABLV\fR] [\fB\-C\fR \fIBYTES\fR]
[\fB\-H\fR \fIFORMAT\fR] [\fB\-M\fR \fIMESSAGE\fR]
[\fB\-O\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-F\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-\-file=\fR[[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-\-format=\fIFORMAT\fR] [\fB\-\-message=\fIMESSAGE\fR]
[\fB\-\-null\fR] [\fB\-\-reset\-access\-time\fR] [\fB\-\-verbose\fR]
[\fB\-\-dot\fR] [\fB\-\-append\fR]
[\fB\-\-block\-size=\fIblocks\fR] [\fB\-\-dereference\fR]
[\fB\-\-io\-size=\fIBYTES\fR] [\fB\-\-quiet\fR]
[\fB\-\-force\-local\fR] [\fB\-\-rsh\-command=\fICOMMAND\fR]
\fB<\fR \fIname-list\fR [\fB>\fR \fIarchive\fR]

.B cpio
{\fB\-i\fR|\fB\-\-extract\fR} [\fB\-bcdfmnrtsuvBSV\fR] [\fB\-C\fR \fIBYTES\fR]
[\fB\-E\fR \fIFILE\fR] [\fB\-H\fR \fIFORMAT\fR]
[\fB\-M\fR \fIMESSAGE\fR] [\fB\-R\fR [\fIUSER\fR][\fB:.\fR][\fIGROUP\fR]]
[\fB\-I\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-F\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-\-file=\fR[[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE\fR]
[\fB\-\-make\-directories\fR] [\fB\-\-nonmatching\fR]
[\fB\-\-preserve\-modification\-time\fR] [\fB\-\-numeric\-uid\-gid\fR]
[\fB\-\-rename\fR] [\fB\-\-list\fR] [\fB\-\-swap\-bytes\fR]
[\fB\-\-swap\fR] [\fB\-\-dot\fR] [\fB\-\-unconditional\fR]
[\fB\-\-verbose\fR] [\fB\-\-block\-size=\fIBLOCKS\fR]
[\fB\-\-swap\-halfwords\fR] [\fB\-\-io\-size=\fIBYTES\fR]
[\fB\-\-pattern\-file=\fIFILE\fR] [\fB\-\-format=\fIFORMAT\fR]
[\fB\-\-owner=\fR[\fIUSER\fR][\fB:.\fR][\fIGROUP\fR]]
[\fB\-\-no\-preserve\-owner\fR] [\fB\-\-message=\fIMESSAGE\fR]
[\fB\-\-force\-local\fR] [\fB\-\-no\-absolute\-filenames\fR] [\fB\-\-sparse\fR]
[\fB\-\-only\-verify\-crc\fR] [\fB\-\-to\-stdout\fR] [\fB\-\-quiet\fR]
[\fB\-\-rsh\-command=\fICOMMAND\fR]
[\fIpattern\fR...] [\fB<\fR \fIarchive\fR]

.B cpio
{\fB\-p\fR|\fB\-\-pass\-through\fR} [\fB\-0adlmuvLV\fR]
[\fB\-R\fR [\fIUSER\fR][\fB:.\fR][\fIGROUP\fR]]
[\fB\-\-null\fR] [\fB\-\-reset\-access\-time\fR]
[\fB\-\-make\-directories\fR] [\fB\-\-link\fR] [\fB\-\-quiet\fR]
[\fB\-\-preserve\-modification\-time\fR] [\fB\-\-unconditional\fR]
[\fB\-\-verbose\fR] [\fB\-\-dot\fR] [\fB\-\-dereference\fR]
[\fB\-\-owner=\fR[\fIUSER\fR][\fB:.\fR][\fIGROUP\fR]]
[\fB\-\-no\-preserve\-owner\fR] [\fB\-\-sparse\fR]
\fIdestination-directory\fR \fB<\fR \fIname-list\fR

.B cpio
{\fB\-?\fR|\fB\-\-help\fR|\fB\-\-usage\fR|\fB\-\-version\fR}
.SH "نکته (NOTE)"
این صفحه راهنما توصیفی کوتاه از GNU \fBcpio\fR است. برای توضیحات دقیق‌تر، شامل مثال‌ها و توصیه‌های کاربردی، به
\fBراهنمای GNU Cpio\fR
که در قالب texinfo موجود است مراجعه کنید. اگر برنامه‌خوان
\fBinfo\fR
و مستندات cpio به درستی روی سیستم شما نصب شده باشند، دستور
.PP
.RS +4
.B info cpio
.RE
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.
.PP
همچنین می‌توانید راهنما را با استفاده از حالت info در
.BR emacs (1)
مشاهده کنید، یا آن را در قالب‌های گوناگون به‌صورت برخط در
.PP
.RS +4
.B http://www.gnu.org/software/cpio/manual
.RE
.PP
بیابید. در صورت وجود هرگونه مغایرت بین این صفحه راهنما و
\fBراهنمای GNU Cpio\fR،
نسخه دوم به عنوان مرجع معتبر در نظر گرفته می‌شود.
.SH "توضیحات (DESCRIPTION)"
دستور
GNU \fBcpio\fR
پرونده‌ها را بین بایگانی‌ها و دایرکتوری‌ها کپی می‌کند. این ابزار از قالب‌های بایگانی زیر پشتیبانی می‌کند: cpio باینری قدیمی، cpio پرتابل قدیمی، SVR4 cpio با و بدون چک‌سام (checksum)، HP cpio، و قالب‌های گوناگون tar.
.PP
حالت عملیاتی توسط یکی از گزینه‌های زیر درخواست می‌شود:
.TP
.BR \-o ", " \-\-create
کپی خروجی (Copy-out). فهرستی از نام‌های پرونده را از ورودی استاندارد می‌خواند و در خروجی استاندارد (مگر اینکه توسط گزینه
.B \-\-file
لغو شود) یک بایگانی حاوی این پرونده‌ها ایجاد می‌کند.
.TP
.BR \-i ", " \-\-extract
کپی ورودی (Copy-in). بایگانی را از ورودی استاندارد (یا از پرونده ارائه‌شده با گزینه
.BR \-\-file )
می‌خواند و پرونده‌ها را از آن استخراج می‌کند، یا (اگر گزینه
.B \-t
داده شده باشد) محتویات آن را در خروجی استاندارد فهرست می‌کند. اگر یک یا چند
.I pattern
داده شود، فقط پرونده‌های منطبق با این الگوها خوانده یا فهرست می‌شوند. گزینه
.B \-t
به تنهایی به معنی
.B \-i
است.
.TP
.BR \-p ", " \-\-pass\-through
انتقال مستقیم (Pass-through). فهرستی از نام‌های پرونده را از ورودی استاندارد می‌خواند و آنها را در دایرکتوری مشخص‌شده کپی می‌کند.
.TP
.BR \-? ", " \-\-help
نمایش خلاصه کوتاهی از راهنما و خروج.
.TP
.B \-\-usage
چاپ یک پیام کوتاه درباره نحوه استفاده و خروج.
.TP
.B \-\-version
چاپ نسخه برنامه و خروج.
.SH "گزینه‌ها (OPTIONS)"
.SS "اصلاح‌کننده‌های عملیات معتبر در هر حالت"
.TP
\fB\-\-block\-size=\fIBLOCK-SIZE\fR
تنظیم اندازه بلوک I/O روی
\fIBLOCK-SIZE\fR * 512
بایت.
.TP
.B \-B
تنظیم اندازه بلوک I/O روی ۵۱۲۰ بایت.
.TP
.B \-c
استفاده از قالب بایگانی پرتابل قدیمی (ASCII). این معادل با
\fB\-H odc\fR
است.
.TP
\fB\-C\fR, \fB\-\-io\-size=\fINUMBER\fR
تنظیم اندازه بلوک I/O روی مقدار مشخص‌شده
.I NUMBER
بر حسب بایت.
.TP
\fB\-D\fR, \fB\-\-directory=\fIDIR\fR
تغییر دایرکتوری کاری به
.IR DIR .
.TP
.B \-\-force\-local
پرونده بایگانی محلی فرض می‌شود، حتی اگر نام آن شامل دو نقطه (:) باشد.
.TP
\fB\-H\fR, \fB\-\-format=\fIFORMAT\fR
استفاده از قالب بایگانی مشخص‌شده
.BR FORMAT .
قالب‌های معتبر عبارتند از (عدد داخل پرانتز حداکثر اندازه را برای هر عضو بایگانی مشخص می‌کند):
.RS
.TP
.B bin
قالب باینری منسوخ‌شده. (۲۱۴۷۴۸۳۶۴۷ بایت)
.TP
.B odc
قالب پرتابل قدیمی (POSIX.1). (۸۵۸۹۹۳۴۵۹۱ بایت)
.TP
.B newc
قالب پرتابل جدید (SVR4)، که از سیستم‌های پرونده با بیش از ۶۵۵۳۶ آی‌نود (inode) پشتیبانی می‌کند. (۴۲۹۴۹۶۷۲۹۵ بایت)
.TP
.B crc
قالب پرتابل جدید (SVR4) با یک چک‌سام اضافه شده.
.TP
.B tar
قالب قدیمی tar. (۸۵۸۹۹۳۴۵۹۱ بایت)
.TP
.B ustar
قالب POSIX.1 tar. همچنین بایگانی‌های GNU tar را که مشابه اما نه کاملاً یکسان هستند، شناسایی می‌کند. (۸۵۸۹۹۳۴۵۹۱ بایت)
.TP
.B hpbin
قالب باینری منسوخ‌شده مورد استفاده توسط cpio در HPUX (که پرونده‌های دستگاه را متفاوت ذخیره می‌کند).
.TP
.B hpodc
قالب پرتابل مورد استفاده توسط cpio در HPUX (که پرونده‌های دستگاه را متفاوت ذخیره می‌کند).
.RE
.TP
\fB\-R\fR, \fB\-\-owner=\fR[\fIUSER\fR][\fB:.\fR][\fIGROUP\fR]
در حالت‌های copy-in و copy-pass، مالکیت تمام پرونده‌های ایجادشده را روی
.I USER
و/یا
.I GROUP
مشخص‌شده تنظیم می‌کند. در حالت copy-out، اطلاعات مالک ارائه‌شده را در بایگانی ذخیره می‌کند.
.PP
ابتدا
.I USER
و
.I GROUP
در پایگاه‌های داده کاربر و گروه سیستم جستجو می‌شوند. در صورت پیدا نشدن،
.B cpio
بررسی می‌کند که آیا آنها فقط از ارقام ده‌دهی تشکیل شده‌اند یا خیر، و در صورت مثبت بودن، آنها را به ترتیب به عنوان UID و GID عددی در نظر می‌گیرد.
.PP
برای جلوگیری از جستجو در پایگاه داده و اطمینان از اینکه آرگومان‌ها به عنوان مقادیر عددی در نظر گرفته می‌شوند، یک علامت مثبت قبل از آنها قرار دهید، مانند:
\fB-R +0:+0\fR.
.TP
.B \-\-quiet
عدم چاپ تعداد بلوک‌های کپی‌شده در پایان اجرا.
.TP
.BI \-\-rsh\-command= COMMAND
استفاده از دستور راه دور
.I COMMAND
به جای
.BR rsh .
.TP
.BR \-v ", " \-\-verbose
فهرست کردن پرونده‌های پردازش‌شده با جزئیات کامل.
.TP
.BR \-V ", " \-\-dot
چاپ یک علامت
"\fB.\fR"
به ازای هر پرونده پردازش‌شده.
.TP
\fB\-W\fR, \fB\-\-warning=\fIFLAG\fR
کنترل هشدارهای نمایش‌داده‌شده. مقدار
.I FLAG
می‌تواند یکی از موارد زیر باشد:
.BR none
برای غیرفعال کردن همه هشدارها،
.BR all
برای فعال کردن آنها،
.BR truncate
برای فعال کردن هشدارهای مربوط به کوتاه‌سازی فیلدها، و
.BR no\-truncate
برای غیرفعال کردن آنها.
.PP
استفاده از چند گزینه
.B \-W
با هم جمع می‌شوند.
.SS "اصلاح‌کننده‌های عملیات معتبر در حالت‌های copy-in و copy-out"
.TP
\fB\-F\fR, \fB\-\-file=\fR[[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE-FILE\fR
استفاده از این
.I ARCHIVE-FILE
به جای ورودی استاندارد (در حالت copy-in) یا خروجی استاندارد (در حالت copy-out). مقادیر اختیاری
.I USER
و
.I HOST
نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.
.TP
\fB\-M\fR, \fB\-\-message=\fISTRING\fR
چاپ
.I STRING
هنگامی که به انتهای یک حجم از رسانه پشتیبان برسد.
.SS "اصلاح‌کننده‌های عملیات معتبر فقط در حالت copy-in"
.TP
.BR \-b ", " \-\-swap
جابجایی (swap) هر دو نیم‌کلمه در کلمه‌ها و بایت‌ها در نیم‌کلمه‌ها در داده‌ها. معادل با
\fB\-sS\fR.
.TP
.BR \-f ", " \-\-nonmatching
فقط کپی پرونده‌هایی که با هیچ‌یک از الگوهای داده‌شده مطابقت ندارند.
.TP
.BR \-n ", " \-\-numeric\-uid\-gid
در فهرست محتویات پرجزئیات، شناسه‌های عددی UID و GID نشان داده شوند.
.\" FIXME: special meaning when storing tar files.
.TP
.BR \-r ", " \-\-rename
تغییر نام تعاملی پرونده‌ها.
.TP
.BR \-s ", " \-\-swap\-bytes
جابجایی بایت‌های هر نیم‌کلمه در پرونده‌ها.
.TP
.BR \-S ", " \-\-swap\-halfwords
جابجایی نیم‌کلمه‌های هر کلمه (۴ بایت) در پرونده‌ها.
.TP
.B \-\-to\-stdout
استخراج پرونده‌ها در خروجی استاندارد.
.TP
\fB\-E\fR, \fB\-\-pattern\-file=\fIFILE\fR
خواندن الگوهای اضافی مشخص‌کننده نام پرونده‌ها برای استخراج یا فهرست کردن از
.IR FILE .
.TP
.B \-\-only\-verify\-crc
هنگام خواندن یک بایگانی با قالب CRC، فقط CRC هر پرونده در بایگانی بررسی شود، بدون اینکه پرونده‌ها واقعاً استخراج شوند.
.SS "اصلاح‌کننده‌های عملیات معتبر فقط در حالت copy-out"
.TP
.BR \-A ", " \-\-append
افزودن به یک بایگانی موجود.
.TP
.BR \-\-device\-independent ", " \-\-reproducible
ایجاد بایگانی‌های بازتولیدپذیر. این معادل با
.BR "\-\-ignore\-devno \-\-ignore\-dirnlink \-\-renumber\-inodes"
است.
.TP
.B \-\-ignore\-devno
ذخیره مقدار ۰ در فیلد شماره دستگاه هر عضو بایگانی، به جای شماره واقعی دستگاه.
.TP
.B \-\-ignore\-dirnlink
ذخیره مقدار ۲ در فیلد
.I nlink
هر عضو دایرکتوری بایگانی، به جای تعداد واقعی پیوندها.
.TP
\fB\-O\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE-NAME\fR
استفاده از
.I ARCHIVE-NAME
به جای خروجی استاندارد. مقادیر اختیاری
.I USER
و
.I HOST
نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.
.PP
نام بایگانی خروجی را می‌توان با استفاده از این گزینه یا با استفاده از
.B \-F
.RB ( \-\-file )
مشخص کرد، اما نه هر دو.
.TP
.B \-\-renumber\-inodes
شماره‌گذاری مجدد آی‌نودها هنگام ذخیره آنها در بایگانی.
.SS "اصلاح‌کننده‌های عملیات معتبر فقط در حالت copy-pass"
.TP
.BR \-l ", " \-\-link
ایجاد پیوند برای پرونده‌ها به جای کپی کردن آنها، در صورت امکان.
.SS "اصلاح‌کننده‌های عملیات معتبر در حالت‌های copy-in و copy-out"
.TP
.B \-\-absolute\-filenames
پیشوندهای سیستم پرونده از نام‌های پرونده حذف نشوند. این حالت پیش‌فرض است.
.TP
.B \-\-no\-absolute\-filenames
ایجاد تمام پرونده‌ها به صورت نسبی نسبت به دایرکتوری جاری.
.SS "اصلاح‌کننده‌های عملیات معتبر در حالت‌های copy-out و copy-pass"
.TP
.BR \-0 ", " \-\-null
نام‌های پرونده در فهرست به جای خط جدید با نویسه‌های تهی (null) جدا شوند.
.TP
.BR \-a ", " \-\-reset\-access\-time
بازنشانی زمان‌های دسترسی پرونده‌ها پس از خواندن آنها.
.TP
\fB\-I\fR [[\fIUSER\fB@\fR]\fIHOST\fB:\fR]\fIARCHIVE-NAME\fR
استفاده از
.I ARCHIVE-NAME
به جای ورودی استاندارد. مقادیر اختیاری
.I USER
و
.I HOST
نام‌های کاربر و میزبان را در صورت استفاده از بایگانی راه دور مشخص می‌کنند.
.PP
نام بایگانی ورودی را می‌توان با استفاده از این گزینه یا با استفاده از
.B \-F
.RB ( \-\-file )
مشخص کرد، اما نه هر دو.
.TP
.BR \-L ", " \-\-dereference
ارجاع‌گشایی پیوندهای نمادین (کپی کردن پرونده‌هایی که پیوندها به آنها اشاره دارند به جای کپی کردن خود پیوندها).
.SS "اصلاح‌کننده‌های عملیات معتبر در حالت‌های copy-in و copy-pass"
.TP
.BR \-d ", " \-\-make\-directories
ایجاد دایرکتوری‌های والد در صورت نیاز.
.TP
.BR \-m ", " \-\-preserve\-modification\-time
حفظ زمان‌های اصلاح قبلی پرونده هنگام ایجاد پرونده‌ها.
.TP
.B \-\-no\-preserve\-owner
مالکیت پرونده‌ها تغییر داده نشود.
.TP
.B \-\-sparse
نوشتن پرونده‌های دارای بلوک‌های بزرگ صفر به عنوان پرونده‌های پراکنده (sparse files).
.TP
.BR \-u ", " \-\-unconditional
جایگزینی بدون قید و شرط تمام پرونده‌ها.
.SH "مقدار بازگشتی (RETURN VALUE)"
دستور
GNU \fBcpio\fR
در صورتی که بتواند عملیات درخواستی را با موفقیت به پایان برساند با کد
\fB0\fR
خارج می‌شود. در صورت بروز خطا، با کد
\fB2\fR
خارج می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR tar (1),
.BR rmt (8),
.BR mt (1).
.SH "گزارش باگ‌ها (BUG REPORTS)"
گزارش اشکالات به <bug\-cpio@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2014--2023 Free Software Foundation, Inc.
.br
.na
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <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: