.TH CP 1 "September 2022" "GNU coreutils 9.1" "دستورات کاربر"
.SH "نام (NAME)"
cp \- رونوشت‌برداری از فایل‌ها و دایرکتوری‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B cp
[\fI\,گزینه‌ها\/\fR]... [\fI\,-T\/\fR] \fI\,مبدأ مقصد\/\fR
.br
.B cp
[\fI\,گزینه‌ها\/\fR]... \fI\,مبدأ\/\fR... \fI\,دایرکتوری\/\fR
.br
.B cp
[\fI\,گزینه‌ها\/\fR]... \fI\,-t دایرکتوری مبدأ\/\fR...
.SH "توضیحات (DESCRIPTION)"
رونوشت‌برداری از \fIمبدأ\fR به \fIمقصد\fR، یا چندین \fIمبدأ\fR به یک \fIدایرکتوری\fR.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-a\fR, \fB\-\-archive\fR
مشابه \fB\-dR\fR \fB\-\-preserve\fR=\fI\,all\/\fR
.TP
\fB\-\-attributes\-only\fR
تنها رونوشت‌برداری از مشخصه‌ها، بدون رونوشت‌برداری از داده‌های فایل
.TP
\fB\-\-backup\fR[=\fI\,CONTROL\/\fR]
تهیه نسخه پشتیبان از هر فایل مقصد موجود
.TP
\fB\-b\fR
مشابه \fB\-\-backup\fR اما بدون دریافت آرگومان
.TP
\fB\-\-copy\-contents\fR
رونوشت‌برداری از محتوای فایل‌های ویژه در حالت بازگشتی
.TP
\fB\-d\fR
مشابه \fB\-\-no\-dereference\fR \fB\-\-preserve\fR=\fI\,links\/\fR
.TP
\fB\-f\fR, \fB\-\-force\fR
اگر باز کردن فایل مقصد موجود امکان‌پذیر نباشد، آن را حذف کرده و مجدداً تلاش کند (این گزینه در صورت استفاده هم‌زمان از گزینه \fB\-n\fR نادیده گرفته می‌شود)
.TP
\fB\-i\fR, \fB\-\-interactive\fR
درخواست تأیید پیش از بازنویسی (روی گزینه پیشین \fB\-n\fR بازنویسی می‌شود)
.TP
\fB\-H\fR
دنبال کردن پیوندهای نمادین مشخص‌شده در خط فرمان در \fIمبدأ\fR
.TP
\fB\-l\fR, \fB\-\-link\fR
ایجاد پیوند سخت برای فایل‌ها به‌جای رونوشت‌برداری
.TP
\fB\-L\fR, \fB\-\-dereference\fR
دنبال کردن همیشگی پیوندهای نمادین در \fIمبدأ\fR
.TP
\fB\-n\fR, \fB\-\-no\-clobber\fR
عدم بازنویسی بر روی فایل موجود (روی گزینه پیشین \fB\-i\fR بازنویسی می‌شود)
.TP
\fB\-P\fR, \fB\-\-no\-dereference\fR
هرگز پیوندهای نمادین در \fIمبدأ\fR را دنبال نکند
.TP
\fB\-p\fR
مشابه \fB\-\-preserve\fR=\fI\,mode\/\fR,ownership,timestamps
.TP
\fB\-\-preserve\fR[=\fI\,ATTR_LIST\/\fR]
حفظ مشخصه‌های تعیین‌شده (پیش‌فرض: دسترسی، مالکیت، زمان‌بندی‌ها)؛ مشخصه‌های اضافی در صورت امکان: context ،links ،xattr ،all
.TP
\fB\-\-no\-preserve\fR=\fI\,ATTR_LIST\/\fR
عدم حفظ مشخصه‌های تعیین‌شده
.TP
\fB\-\-parents\fR
استفاده از نام کامل فایل مبدأ ذیل \fIدایرکتوری\fR
.TP
\fB\-R\fR, \fB\-r\fR, \fB\-\-recursive\fR
رونوشت‌برداری بازگشتی از دایرکتوری‌ها
.TP
\fB\-\-reflink\fR[=\fI\,WHEN\/\fR]
کنترل رونوشت‌برداری clone/CoW؛ توضیحات در ادامه آمده است
.TP
\fB\-\-remove\-destination\fR
حذف هر فایل مقصد موجود پیش از اقدام به باز کردن آن (متفاوت با \fB\-\-force\fR)
.TP
\fB\-\-sparse\fR=\fI\,WHEN\/\fR
کنترل ایجاد فایل‌های کم‌پشت (sparse)؛ توضیحات در ادامه آمده است
.TP
\fB\-\-strip\-trailing\-slashes\fR
حذف هرگونه ممیز پایانی (/) از هر آرگومان \fIمبدأ\fR
.TP
\fB\-s\fR, \fB\-\-symbolic\-link\fR
ایجاد پیوند نمادین به‌جای رونوشت‌برداری
.TP
\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
تغییر پسوند معمول پشتیبان‌گیری
.TP
\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR
رونوشت‌برداری از تمامی آرگومان‌های \fIمبدأ\fR درون \fIدایرکتوری\fR
.TP
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
رفتار با \fIمقصد\fR به‌عنوان یک فایل معمولی
.TP
\fB\-u\fR, \fB\-\-update\fR
تنها زمانی رونوشت‌برداری انجام شود که فایل \fIمبدأ\fR جدیدتر از فایل مقصد باشد یا فایل مقصد وجود نداشته باشد
.TP
\fB\-v\fR, \fB\-\-verbose\fR
توضیح عملیات در حال انجام
.TP
\fB\-x\fR, \fB\-\-one\-file\-system\fR
باقی ماندن روی همین سیستم فایل
.TP
\fB\-Z\fR
تنظیم بافت امنیتی SELinux فایل مقصد روی نوع پیش‌فرض
.TP
\fB\-\-context\fR[=\fI\,CTX\/\fR]
مشابه \fB\-Z\fR، یا در صورت تعیین CTX، تنظیم بافت امنیتی SELinux یا SMACK روی CTX
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
به‌طور پیش‌فرض، فایل‌های کم‌پشت (sparse) مبدأ با روشی تقریبی تشخیص داده می‌شوند و فایل مقصد مربوطه نیز کم‌پشت ایجاد می‌گردد. این رفتار با گزینه \fB\-\-sparse\fR=\fI\,auto\/\fR انتخاب می‌شود. با تعیین \fB\-\-sparse\fR=\fI\,always\/\fR هر زمان که فایل مبدأ دارای دنباله به اندازه کافی طولانی از بایت‌های صفر باشد، فایل کم‌پشت ایجاد می‌شود. برای جلوگیری از ایجاد فایل‌های کم‌پشت از \fB\-\-sparse\fR=\fI\,never\/\fR استفاده کنید.
.PP
هنگامی که \fB\-\-reflink\fR[=\fI\,always\/\fR] مشخص شود، رونوشت‌برداری سبک انجام می‌گیرد که در آن بلوک‌های داده تنها هنگام تغییر کپی می‌شوند (CoW). اگر این کار امکان‌پذیر نباشد، عملیات کپی با شکست مواجه می‌شود، یا در صورت تعیین \fB\-\-reflink\fR=\fI\,auto\/\fR به کپی استاندارد تنزل می‌یابد. از \fB\-\-reflink\fR=\fI\,never\/\fR برای اطمینان از انجام کپی استاندارد استفاده کنید.
.PP
پسوند پشتیبان‌گیری \(aq~\(aq است، مگر اینکه با \fB\-\-suffix\fR یا SIMPLE_BACKUP_SUFFIX تنظیم شود. روش کنترل نسخه را می‌توان از طریق گزینه \fB\-\-backup\fR یا متغیر محیطی VERSION_CONTROL انتخاب کرد. مقادیر عبارتند از:
.TP
none, off
هرگز نسخه پشتیبان تهیه نشود (حتی اگر \fB\-\-backup\fR داده شده باشد)
.TP
numbered, t
تهیه نسخه‌های پشتیبان شماره‌گذاری‌شده
.TP
existing, nil
شماره‌گذاری‌شده در صورت وجود نسخه‌های شماره‌دار، در غیر این صورت ساده
.TP
simple, never
همیشه نسخه‌های پشتیبان ساده تهیه شود
.PP
به‌عنوان یک حالت خاص، دستور \fBcp\fR در صورتی که گزینه‌های \fBforce\fR و \fBbackup\fR داده شده باشند و \fIمبدأ\fR و \fIمقصد\fR نام یکسانی برای یک فایل معمولی موجود باشند، از \fIمبدأ\fR نسخه پشتیبان تهیه می‌کند.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Torbjorn Granlund ،David MacKenzie و Jim Meyering.
.SH "گزارش اشکالات (REPORTING BUGS)"
راهنمای برخط GNU coreutils: <https://www.gnu.org/software/coreutils>
.br
گزارش هرگونه اشکال در ترجمه به: <https://translationproject.org/team>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2022 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل در <https://www.gnu.org/software/coreutils/cp>
.br
یا در دسترس به‌صورت محلی از طریق: \fBinfo \(aq(coreutils) cp invocation\(aq\fR