.nh
.TH "GH-CODESPACE-CP" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-codespace-cp \- کپی کردن فایل‌ها بین سیستم لوکال و کداستیس


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh codespace cp [-e] [-r] [-- [<scp flags>...]] <sources>... <dest>\fR


.SH "توضیحات (DESCRIPTION)"
دستور
.B cp
فایل‌ها را بین سیستم‌های فایل محلی و راه دور کپی می‌کند.

.PP
مشابه با دستور
.B cp
در یونیکس، آرگومان اول مبدا و آخرین آرگومان مقصد را مشخص می‌کند؛ اگر مقصد یک دایرکتوری باشد، می‌توان پس از آرگومان اول، مبداهای بیشتری را مشخص کرد.

.PP
اگر هر یک از مبداها دایرکتوری باشد، پرچم
.B \-\-recursive
الزامی است.

.PP
پیشوند
.B remote:
در هر آرگومان نام فایل نشان‌دهنده آن است که به سیستم فایل ماشین راه دور (Codespace) اشاره دارد. این مسیر نسبت به دایرکتوری خانگی کاربر راه دور حل‌وفصل می‌شود.

.PP
به‌طور پیش‌فرض، نام فایل‌های راه دور به‌صورت تحت‌اللفظی تفسیر می‌شوند. با پرچم
.BR \-\-expand ,
هر یک از این آرگومان‌ها همانند
.B scp
به‌عنوان یک عبارت Bash در نظر گرفته می‌شود که روی ماشین راه دور ارزیابی خواهد شد و مشمول گسترش مدک (tilde)، آکولادها، الگوهای جانشینی (globs)، متغیرهای محیطی و بک‌تیک‌ها است. برای امنیت، از این پرچم با آرگومان‌های ارائه‌شده توسط کاربران غیرقابل اعتماد استفاده نکنید؛ برای توضیحات بیشتر پیوند
\[la]https://lwn.net/Articles/835962\[ra]
را ببینید.

.PP
به‌طور پیش‌فرض، دستور
.B cp
یک جفت کلید ssh عمومی/خصوصی برای احراز هویت با کداستیس در داخل دایرکتوری
.B ~/.ssh
ایجاد خواهد کرد.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-c\fR, \fB--codespace\fR \fB<string>\fR
نام کداستیس

.TP
\fB-e\fR, \fB--expand\fR
گسترش نام فایل‌های راه دور در شل راه دور

.TP
\fB-p\fR, \fB--profile\fR \fB<string>\fR
نام پروفایل SSH مورد استفاده

.TP
\fB-r\fR, \fB--recursive\fR
کپی بازگشتی دایرکتوری‌ها

.TP
\fB-R\fR, \fB--repo\fR \fB<string>\fR
فیلتر کردن انتخاب کداستیس بر اساس نام مخزن (user/repo)

.TP
\fB--repo-owner\fR \fB<string>\fR
فیلتر کردن انتخاب کداستیس بر اساس مالک مخزن (نام کاربری یا سازمان)


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج بیشتری داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.


.SH "مثال‌ها (EXAMPLES)"
.EX
$ gh codespace cp -e README.md 'remote:/workspaces/$RepositoryName/'
$ gh codespace cp -e 'remote:~/*.go' ./gofiles/
$ gh codespace cp -e 'remote:/workspaces/myproj/go.{mod,sum}' ./gofiles/
$ gh codespace cp -e -- -F ~/.ssh/codespaces_config 'remote:~/*.go' ./gofiles/
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-codespace(1)\fR