نام (NAME)

cp - رونوشت‌برداری از فایل‌ها و دایرکتوری‌ها

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

cp [گزینه‌ها]... [-T] مبدأ مقصد
cp [گزینه‌ها]... مبدأ... دایرکتوری
cp [گزینه‌ها]... -t دایرکتوری مبدأ...

توضیحات (DESCRIPTION)

رونوشت‌برداری از مبدأ به مقصد، یا چندین مبدأ به یک دایرکتوری.

آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.

-a, --archive: مشابه -dR --preserve=all
--attributes-only: تنها رونوشت‌برداری از مشخصه‌ها، بدون رونوشت‌برداری از داده‌های فایل
--backup[=CONTROL]: تهیه نسخه پشتیبان از هر فایل مقصد موجود
-b: مشابه --backup اما بدون دریافت آرگومان
--copy-contents: رونوشت‌برداری از محتوای فایل‌های ویژه در حالت بازگشتی
-d: مشابه --no-dereference --preserve=links
-f, --force: اگر باز کردن فایل مقصد موجود امکان‌پذیر نباشد، آن را حذف کرده و مجدداً تلاش کند (این گزینه در صورت استفاده هم‌زمان از گزینه -n نادیده گرفته می‌شود)
-i, --interactive: درخواست تأیید پیش از بازنویسی (روی گزینه پیشین -n بازنویسی می‌شود)
-H: دنبال کردن پیوندهای نمادین مشخص‌شده در خط فرمان در مبدأ
-l, --link: ایجاد پیوند سخت برای فایل‌ها به‌جای رونوشت‌برداری
-L, --dereference: دنبال کردن همیشگی پیوندهای نمادین در مبدأ
-n, --no-clobber: عدم بازنویسی بر روی فایل موجود (روی گزینه پیشین -i بازنویسی می‌شود)
-P, --no-dereference: هرگز پیوندهای نمادین در مبدأ را دنبال نکند
-p: مشابه --preserve=mode,ownership,timestamps
--preserve[=ATTR_LIST]: حفظ مشخصه‌های تعیین‌شده (پیش‌فرض: دسترسی، مالکیت، زمان‌بندی‌ها)؛ مشخصه‌های اضافی در صورت امکان: context ،links ،xattr ،all
--no-preserve=ATTR_LIST: عدم حفظ مشخصه‌های تعیین‌شده
--parents: استفاده از نام کامل فایل مبدأ ذیل دایرکتوری
-R, -r, --recursive: رونوشت‌برداری بازگشتی از دایرکتوری‌ها
--reflink[=WHEN]: کنترل رونوشت‌برداری clone/CoW؛ توضیحات در ادامه آمده است
--remove-destination: حذف هر فایل مقصد موجود پیش از اقدام به باز کردن آن (متفاوت با --force)
--sparse=WHEN: کنترل ایجاد فایل‌های کم‌پشت (sparse)؛ توضیحات در ادامه آمده است
--strip-trailing-slashes: حذف هرگونه ممیز پایانی (/) از هر آرگومان مبدأ
-s, --symbolic-link: ایجاد پیوند نمادین به‌جای رونوشت‌برداری
-S, --suffix=SUFFIX: تغییر پسوند معمول پشتیبان‌گیری
-t, --target-directory=DIRECTORY: رونوشت‌برداری از تمامی آرگومان‌های مبدأ درون دایرکتوری
-T, --no-target-directory: رفتار با مقصد به‌عنوان یک فایل معمولی
-u, --update: تنها زمانی رونوشت‌برداری انجام شود که فایل مبدأ جدیدتر از فایل مقصد باشد یا فایل مقصد وجود نداشته باشد
-v, --verbose: توضیح عملیات در حال انجام
-x, --one-file-system: باقی ماندن روی همین سیستم فایل
-Z: تنظیم بافت امنیتی SELinux فایل مقصد روی نوع پیش‌فرض
--context[=CTX]: مشابه -Z، یا در صورت تعیین CTX، تنظیم بافت امنیتی SELinux یا SMACK روی CTX
--help: نمایش این راهنما و خروج
--version: نمایش اطلاعات نسخه و خروج

به‌طور پیش‌فرض، فایل‌های کم‌پشت (sparse) مبدأ با روشی تقریبی تشخیص داده می‌شوند و فایل مقصد مربوطه نیز کم‌پشت ایجاد می‌گردد. این رفتار با گزینه --sparse=auto انتخاب می‌شود. با تعیین --sparse=always هر زمان که فایل مبدأ دارای دنباله به اندازه کافی طولانی از بایت‌های صفر باشد، فایل کم‌پشت ایجاد می‌شود. برای جلوگیری از ایجاد فایل‌های کم‌پشت از --sparse=never استفاده کنید.

هنگامی که --reflink[=always] مشخص شود، رونوشت‌برداری سبک انجام می‌گیرد که در آن بلوک‌های داده تنها هنگام تغییر کپی می‌شوند (CoW). اگر این کار امکان‌پذیر نباشد، عملیات کپی با شکست مواجه می‌شود، یا در صورت تعیین --reflink=auto به کپی استاندارد تنزل می‌یابد. از --reflink=never برای اطمینان از انجام کپی استاندارد استفاده کنید.

پسوند پشتیبان‌گیری '~' است، مگر اینکه با --suffix یا SIMPLE_BACKUP_SUFFIX تنظیم شود. روش کنترل نسخه را می‌توان از طریق گزینه --backup یا متغیر محیطی VERSION_CONTROL انتخاب کرد. مقادیر عبارتند از:

none, off: هرگز نسخه پشتیبان تهیه نشود (حتی اگر --backup داده شده باشد)
numbered, t: تهیه نسخه‌های پشتیبان شماره‌گذاری‌شده
existing, nil: شماره‌گذاری‌شده در صورت وجود نسخه‌های شماره‌دار، در غیر این صورت ساده
simple, never: همیشه نسخه‌های پشتیبان ساده تهیه شود

به‌عنوان یک حالت خاص، دستور cp در صورتی که گزینه‌های force و backup داده شده باشند و مبدأ و مقصد نام یکسانی برای یک فایل معمولی موجود باشند، از مبدأ نسخه پشتیبان تهیه می‌کند.

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

نوشته‌شده توسط Torbjorn Granlund ،David MacKenzie و Jim Meyering.

گزارش اشکالات (REPORTING BUGS)

راهنمای برخط GNU coreutils: https://www.gnu.org/software/coreutils
گزارش هرگونه اشکال در ترجمه به: https://translationproject.org/team

حق نشر (COPYRIGHT)

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

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

مستندات کامل در https://www.gnu.org/software/coreutils/cp
یا در دسترس به‌صورت محلی از طریق: info '(coreutils) cp invocation'