.TH xrdcopy 1 "v6.1.1"
.SH "نام (NAME)"
xrdcp \- کپی کردن فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.nf

\fBxrdcp\fR [\fIoptions\fR] \fIsource\fR \fIdestination\fR

\fIoptions\fR: [\fB--cksum\fR \fIargs\fR] [\fB--debug\fR \fIlvl\fR]
[\fB--coerce\fR] [\fB--force\fR] [\fB--help\fR] [\fB--license\fR]
[\fB--nopbar\fR] [\fB--posc\fR] [\fB--proxy \fIipaddr\fB:\fIport\fR]
[\fB--recursive\fR] [\fB--retry\fR \fItime\fR] [\fB--server\fR]
[\fB--silent\fR] [\fB--sources\fR \fInum\fR] [\fB--streams\fR \fInum\fR]
[\fB--tpc\fR [\fBdelegate\fR] \fBfirst\fR|\fBonly\fR] [\fB--verbose\fR]
[\fB--version\fR] [\fB--xrate\fR \fIrate\fR] [\fB--zip\fR \fIfile\fR]
[\fB--dynamic-src\fR] [\fB--infiles\fR \fIfn\fR]
[\fB--parallel\fR \fIn\fR] [\fB--xattr\fR]
[\fB--notlsok\fR] [\fB--tlsnodata\fR] [\fB--tlsmetalink\fR]
[\fB--zip-mtln-cksum\fR] [\fB--rm-bad-cksum\fR] [\fB--continue\fR]
[\fB--xrate-threshold\fR] [\fB--retry-policy\fR]

\fIlegacy options\fR: [\fB-adler\fR] [\fB-DS\fR\fIparm string\fR] [\fB-DI\fR\fIparm number\fR]
[\fB-md5\fR] [\fB-np\fR] [\fB-OD\fR\fIcgi\fR] [\fB-OS\fR\fIcgi\fR] [\fB-x\fR]

.fi
.br
.ad l
.SH "توضیحات (DESCRIPTION)"
ابزار \fBxrdcp\fR یک یا چند فایل را از یک مکان به مکانی دیگر کپی می‌کند. مبدأ و مقصد داده می‌تواند یک فایل یا دایرکتوری محلی یا دوردست باشد. علاوه بر این، مبدأ داده ممکن است روی چندین سرور نیز قرار داشته باشد.
.SH "گزینه‌ها (OPTIONS)"
\fB-C\fR | \fB--cksum\fR \fItype\fR[\fB:\fR\fIvalue\fR|\fIprint\fR|\fIsource\fR]
.RS 5
چک‌سام از نوع \fItype\fR (یعنی adler32،‏ crc32،‏ md5 یا zcrc32) را از مبدأ دریافت می‌کند، چک‌سام را در مقصد محاسبه کرده و یکسان بودن آن‌ها را اعتبارسنجی می‌کند. اگر \fIauto\fR به عنوان نوع چک‌سام انتخاب شود، xrdcp تلاش خواهد کرد بر اساس پیکربندی مبدأ/مقصد، نوع فایل مبدأ (metalink،‏ ZIP) و افزایه‌های چک‌سام موجود، نوع مناسب چک‌سام را به‌طور خودکار تشخیص دهد. اگر یک \fIvalue\fR مشخص شده باشد، به عنوان چک‌سام مبدأ استفاده می‌شود. در صورتی که \fIprint\fR مشخص شده باشد، چک‌سام در مقصد چاپ می‌شود اما اعتبارسنجی \fIنمی‌شود\fR.

.RE
\fB-d\fR | \fB--debug\fR \fIlvl\fR
.RS 5
سطح اشکال‌زدایی: 1 (کم)، 2 (متوسط)، 3 (زیاد)

.RE
\fB-F\fR | \fB--coerce\fR
.RS 5
معناشناسی قفل‌گذاری روی فایل مقصد را نادیده می‌گیرد. این گزینه در صورت عدم استفاده صحیح ممکن است منجر به آسیب دیدن فایل شود.

.RE
\fB-f\fR | \fB--force\fR
.RS 5
در صورتی که فایل از قبل وجود داشته باشد، آن را دوباره ایجاد می‌کند.

.RE
\fB-h\fR | \fB--help\fR
.RS 5
اطلاعات نحوه استفاده را نمایش می‌دهد.

.RE
\fB-H\fR | \fB--license\fR
.RS 5
شرایط و ضوابط پروانه را نمایش می‌دهد.

.RE
\fB-N\fR | \fB--nopbar\fR
.RS 5
نوار پیشرفت را نمایش نمی‌دهد.

.RE
\fB-P\fR | \fB--posc\fR
.RS 5
برای ایجاد یک فایل جدید، پردازش POSC (ماندگاری پس از بستن موفق یا persist-on-successful-close) را درخواست می‌کند. فایل‌ها در صورتی که با موفقیت بسته نشوند، به‌طور خودکار حذف می‌شوند.

.RE
\fB-D\fR | \fB--proxy\fR \fIproxyaddr\fB:\fIproxyport\fR
.RS 5
[هنوز پیاده‌سازی نشده است]

از \fIproxyaddr\fB:\fIproxyport\fR به عنوان پروکسی SOCKS4 استفاده می‌کند. تنها نشانی‌های عددی پشتیبانی می‌شوند.

.RE
\fB-r\fR | \fB--recursive\fR
.RS 5
تمام فایل‌ها را به صورت بازگشتی با شروع از دایرکتوری مبدأ داده‌شده کپی می‌کند.

.RE
\fB--retry\fR
.RS 5
تلاش مجدد برای کارهای کپیِ شکست‌خورده.

.RE
\fB--server\fR
.RS 5
طوری اجرا می‌شود که گویی در یک محیط سرور است. تنها برای پشتیبانی سمت سرور از رونوشت شخص ثالث (third-party copy) استفاده می‌شود.

.RE
\fB-s\fR | \fB--silent\fR
.RS 5
نه اطلاعات خلاصه‌ای تولید می‌کند و نه نوار پیشرفت را نمایش می‌دهد.

.RE
\fB-y\fR | \fB--sources\fR \fInum\fR
.RS 5
برای کپی کردن فایل از حداکثر \fInum\fR مبدأ استفاده می‌کند.

.RE
\fB-S\fR | \fB--streams\fR \fInum\fR
.RS 5
از \fInum\fR جریان موازی داده برای انجام انتقال استفاده می‌کند (در این حالت جریان اصلی برای انجام انتقال استفاده نمی‌شود). حداکثر مقدار 15 است. مقدار پیش‌فرض 0 است (یعنی فقط از جریان کنترلی استفاده شود).

.RE
\fB--tpc\fR [\fBdelegate\fR] \fBfirst\fR|\fBonly\fR
.RS 5
فایل را با استفاده از پروتکل رونوشت شخص ثالث (third-party-copy) از سرور دوردست به سرور دوردست دیگر کپی می‌کند (یعنی داده از سرور به سرور جریان می‌یابد). سرورهای مبدأ و مقصد باید از رونوشت‌های شخص ثالث پشتیبانی کنند. ممکن است محدودیت‌های امنیتی بیشتری اعمال شود و در صورت برآورده نشدن آن‌ها باعث شکست کپی شود. آرگومان '\fBfirst\fR' پروتکل tpc را امتحان می‌کند و در صورت شکست، یک کپی معمولی انجام می‌دهد؛ در حالی که '\fBonly\fR' در صورت موفق نشدن tpc، عملیات کپی را متوقف و ناموفق اعلام می‌کند. هنگامی که '\fBdelegate\fR' مشخص شود، عملیات کپی، اعتبارنامه‌های صادرکننده دستور را به سرور مقصد واگذار می‌کند و سرور مقصد از آن اعتبارنامه‌ها برای احراز هویت با سرور مبدأ استفاده می‌کند. اگر سرور مقصد برای استفاده از اعتبارنامه‌های تفویض‌شده پیکربندی نشده باشد، تفویض نادیده گرفته می‌شود. در حال حاضر، فقط اعتبارنامه‌های gsi قابل تفویض هستند.

.RE
\fB-v\fR | \fB--verbose\fR
.RS 5
خروجی خلاصه را نمایش می‌دهد.

.RE
\fB-V\fR | \fB-version\fR
.RS 5
اطلاعات نسخه را نمایش داده و بلافاصله خارج می‌شود.

.RE
\fB-z\fR | \fB--zip\fR \fIfile\fR
.RS 5
فایل داده‌شده را از یک بایگانی ZIP کپی می‌کند (مشابه اطلاعات مات xrdcl.unzip).

.RE
\fB-X\fR | \fB--xrate\fR \fIrate\fR
.RS 5
سرعت کپی را به \fIrate\fR مشخص‌شده محدود می‌کند. این نرخ می‌تواند با حروف \fBk\fR،‏ \fBm\fR یا \fBg\fR مشخص شود تا به ترتیب نشان‌دهنده کیلو، مگا یا گیگابایت باشد. این گزینه فقط زمانی اعمال می‌شود که مبدأ یا مقصد محلی باشد.

.RE
\fB-X\fR | \fB--xrate-threshold\fR \fIrate\fR
.RS 5
اگر نرخ انتقال به زیر آستانه مشخص‌شده افت کند، کلاینت را وادار می‌کند تا از مبدأ دیگری استفاده کند، یا در صورتی که مبدأ دیگری در دسترس نباشد، انتقال را با شکست مواجه کند.

.RE
\fB-Z\fR | \fB--dynamic-src\fR
.RS 5
اندازه فایل ممکن است در حین کپی تغییر کند.

.RE
\fB-I\fR | \fB--infiles\fR \fIfn\fR
.RS 5
فایلی را مشخص می‌کند که شامل فهرستی از فایل‌های ورودی است.

.RE
\fB--parallel\fR \fIn\fR
.RS 5
تعداد کارهای کپی که به‌طور هم‌زمان اجرا می‌شوند.

.RE
\fB--xattr\fR
.RS 5
ویژگی‌های توسعه‌یافته (extended attributes) را حفظ می‌کند.

.RE
\fB--notlsok\fR
.RS 5
اگر سرور برای پشتیبانی از رمزگذاری TLS بیش از حد قدیمی باشد، به ارتباط رمزگذاری‌نشده بازمی‌گردد.

.RE
\fB--tlsnodata\fR
.RS 5
در صورت استفاده از پروتکل roots/xroots، تنها جریان کنترلی را رمزگذاری می‌کند و جریان‌های داده را رمزگذاری‌نشده باقی می‌گذارد.

.RE
\fB--tlsmetalink
.RS 5
با همه URLها در metalink مانند roots/xroots رفتار می‌کند.

.RE
\fB--zip-mtln-cksum
.RS 5
حتی اگر فایلی از یک بایگانی ZIP استخراج شود، از چک‌سام موجود در فایل metalink استفاده می‌کند.

.RE
\fB--rm-bad-cksum
.RS 5
در صورت شکست در اعتبارسنجی چک‌سام، فایل هدف را حذف می‌کند (معناشناسی POSC را نیز فعال می‌کند).

.RE
\fB--continue
.RS 5
کپی کردن فایل را از نقطه‌ای که کپی قبلی قطع شده بود، ادامه می‌دهد..SH "گزینه‌های قدیمی (LEGACY OPTIONS)"
گزینه‌های قدیمی برای سازگاری با نسخه‌های پیشین ارائه شده‌اند. این گزینه‌ها اکنون
منسوخ شده‌اند و باید از آن‌ها اجتناب شود.
.RE
\fB-adler\fR
.RS 5
معادل با «\fB--cksum adler32:source\fR».

.RE
\fB-DI\fR\fIpname numberval\fR
.RS 5
تنظیم پارامتر داخلی \fIpname\fR با مقدار عددی \fInumberval\fR.

.RE
\fB-DS\fR\fIpname stringval\fR
.RS 5
تنظیم پارامتر داخلی \fIpname\fR با مقدار رشته‌ای \fIstringval\fR.

.RE
\fB-md5\fR
.RS 5
معادل با «\fB--cksum md5:source\fR».

.RE
\fB-np\fR
.RS 5
معادل با «\fB--nopbar\fR».

.RE
\fB-OD\fR\fIcgi\fR
.RS 5
افزودن اطلاعات cgi به نام \fIcgi\fR به هر URL مقصد xrootd.
باید اطلاعات مبهم (opaque) را مستقیماً در URL مقصد مشخص کنید.

.RE
\fB-OS\fR\fIcgi\fR
.RS 5
افزودن اطلاعات cgi به نام \fIcgi\fR به هر URL مبدأ xrootd.

.RE
\fB-x\fR
.RS 5
معادل با «\fB--sources 12\fR».

.RE
.SH "عملوندها (OPERANDS)"
\fIsource\fR
.RS 5
یک خط تیره (یعنی \fB-\fR) به نشانهٔ ورودی استاندارد، یک فایل محلی، نام یک دایرکتوری محلی که به / ختم می‌شود، یا
یک URL از نوع xrootd در قالب
.ce 1
\fBxroot://[\fIuser\fB@\fR]\fIhost[\fB:\fIport\fR]\fB/\fIabsolutepath\fR
مؤلفهٔ \fIabsolutepath\fR می‌تواند یک دایرکتوری باشد.

.RE
\fIdestination\fR
.RS 5
یک خط تیره (یعنی \fB-\fR) به نشانهٔ خروجی استاندارد، یک فایل محلی، نام یک دایرکتوری
محلی که به / ختم می‌شود، یا یک URL از نوع xrootd در قالب
.ce 1
\fBxroot://[\fIuser\fB@\fR]\fIhost[\fB:\fIport\fR]\fB/\fIabsolutepath\fR
مؤلفهٔ \fIabsolutepath\fR می‌تواند یک دایرکتوری باشد.

.RE

.SH "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر پشتیبانی می‌شوند. آن‌ها برای xrdfs و هر
برنامهٔ دیگری که از کتابخانهٔ libXrdCl استفاده می‌کند اعمال می‌شوند، مگر آن‌که خلاف آن مشخص شده باشد. متن
داخل براکت‌ها نام پارامتر خط فرمان متناظر در xrdcp است.
.br

XRD_LOGLEVEL
.RS 5
میزان اطلاعات عیب‌یابی که باید چاپ شوند را مشخص می‌کند. مقادیر معتبر عبارتند از:
\fIDump\fR، \fIDebug\fR، \fIInfo\fR، \fIWarning\fR و \fIError\fR.
.RE

XRD_LOGFILE
.RS 5
در صورت تنظیم، پیام‌های عیب‌یابی به جای stderr در فایل مشخص‌شده چاپ خواهند شد.
.RE

XRD_LOGMASK
.RS 5
مشخص می‌کند کدام موضوعات عیب‌یابی باید در تمامی سطوح چاپ شوند. این مقدار فهرستی
از موضوعات است که با «|» از هم جدا شده‌اند. اولین عنصر می‌تواند «All» باشد که در این حالت
تمامی موضوعات فعال می‌شوند و عناصر بعدی می‌توانند آن‌ها را غیرفعال کنند، یا
«None» باشد که در این حالت تمامی موضوعات غیرفعال شده و نشان‌های بعدی می‌توانند
آن‌ها را فعال سازند. اگر پیش از نام موضوع «^» بیاید، به این معنی است که
موضوع باید غیرفعال شود. اگر نام موضوع بدون پیشوند باشد، به این معنی است
که موضوع باید فعال گردد.
.br

ماسک ثبت وقایع می‌تواند برای هر سطح عیب‌یابی به صورت جداگانه نیز با
تنظیم یک یا چند مورد از متغیرهای زیر مدیریت شود: \fIXRD_LOGMASK_ERROR\fR،
\fIXRD_LOGMASK_WARNING\fR، \fIXRD_LOGMASK_INFO\fR، \fIXRD_LOGMASK_DEBUG\fR
و \fIXRD_LOGMASK_DUMP\fR. مقدار پیش‌فرض برای هر سطح «All» است، به جز
سطح \fIDump\fR که پیش‌فرض آن «All|^PollerMsg» می‌باشد. این بدان معناست
که در سطح \fIDump\fR، تمام موضوعات به جز «PollerMsg» فعال هستند.
.br

موضوعات دردسترس: AppMsg، UtilityMsg، FileMsg، PollerMsg، PostMasterMsg،
XRootDTransportMsg، TaskMgrMsg، XRootDMsg، FileSystemMsg، AsyncSockMsg،
TlsMsg
.RE

XRD_TLSDBGLVL
.RS 5
سطح اشکال‌زدایی را برای مولفهٔ TLS مشخص می‌کند. مقادیر معتبر عبارتند از:
\fIOFF\fR، \fICTX\fR، \fISOK\fR، \fISIO\fR، \fIALL\fR و \fIOUT\fR.
مقدار پیش‌فرض \fIOFF\fR است.
.RE

XRD_PARALLELEVTLOOP
.RS 5
تعداد حلقه‌های رویداد (یعنی تعداد ریسه‌هایی که درخواست‌ها را پردازش می‌کنند). مقدار پیش‌فرض ۱۰ است.
.RE

XRD_READRECOVERY
.RS 5
مشخص می‌کند که آیا بازیابی خواندن باید فعال یا غیرفعال باشد (به طور پیش‌فرض فعال است).
.RE

XRD_WRITERECOVERY
.RS 5
مشخص می‌کند که آیا بازیابی نوشتن باید فعال یا غیرفعال باشد (به طور پیش‌فرض فعال است).
.RE

XRD_OPENRECOVERY
.RS 5
مشخص می‌کند که آیا بازیابی باز کردن برای باز کردن‌های تغییرپذیر (truncate یا create) باید فعال یا غیرفعال باشد (به طور پیش‌فرض فعال است).
.RE

XRD_CONNECTIONWINDOW (-DIConnectionWindow)
.RS 5
یک پنجرهٔ زمانی برای برقراری اتصال. اگر اتصال در این پنجرهٔ زمانی برقرار نشود،
شکست اتصال اعلام می‌شود. اگر شکست اتصال زودتر رخ دهد، تلاش بعدی
برای اتصال تنها در ابتدای پنجرهٔ بعدی انجام خواهد شد.
.RE

XRD_CONNECTIONRETRY (-DIConnectionRetry)
.RS 5
تعداد دفعاتی که باید برای برقراری اتصال تلاش شود (تعداد پنجره‌های اتصال دردسترس)
پیش از اعلام شکست دائمی.
.RE

XRD_REQUESTTIMEOUT (-DIRequestTimeout)
.RS 5
مقدار پیش‌فرض برای مدت زمانی که پس از آن، در صورت عدم دریافت پاسخ برای یک درخواست،
خطا اعلام می‌شود.
.RE

XRD_STREAMTIMEOUT (-DIStreamTimeout)
.RS 5
مقدار پیش‌فرض برای مدت زمانی که پس از آن، در صورت وجود درخواست‌های انجام‌نشده
و عدم فعالیت سوکت یا اتمام مهلت انتظار ثبت‌شده، خطای اتصال اعلام می‌شود
(و برای بازیابی تلاش می‌گردد).
.RE

XRD_SUBSTREAMSPERCHANNEL (-DISubStreamsPerChannel)
.RS 5
تعداد جریان‌ها در هر نشست.
.RE

XRD_TIMEOUTRESOLUTION (-DITimeoutResolution)
.RS 5
دقت تفکیک برای رویدادهای اتمام مهلت زمانی؛ بدین معنا که رویدادهای اتمام
مهلت زمانی فقط هر XRD_TIMEOUTRESOLUTION ثانیه یک‌بار پردازش می‌شوند.
.RE

XRD_STREAMERRORWINDOW (-DIStreamErrorWindow)
.RS 5
مدت زمانی که پس از آن، پرچم‌های شکست دائمی پاک شده و در صورت نیاز،
می‌توان برای برقراری اتصال جدید تلاش کرد.
.RE

XRD_RUNFORKHANDLER (-DIRunForkHandler)
.RS 5
مشخص می‌کند که آیا گرداننده‌های fork باید فعال شوند تا API در برابر fork امن شود یا خیر.
.RE

XRD_REDIRECTLIMIT (-DIRedirectLimit)
.RS 5
حداکثر تعداد مجاز برای تغییر مسیرها.
.RE

XRD_NOTAUTHORIZEDRETRYLIMIT (-dNotAuthorizedRetryLimit)
.RS 5
حداکثر تعداد مجاز تلاش مجدد در یک meta-manager برای خطای عدم احراز هویت.
.RE

XRD_POLLERPREFERENCE (-DSPollerPreference)
.RS 5
فهرستی از پیاده‌سازی‌های poller که با کاما از هم جدا شده‌اند، به ترتیب اولویت.
پیش‌فرض: built-in است.
.RE

XRD_CLIENTMONITOR (-DSClientMonitor)
.RS 5
مسیر کتابخانهٔ مانیتور کلاینت.
.RE

XRD_CLIENTMONITORPARAM (-DSClientMonitorParam)
.RS 5
پارامترهای اختیاری اضافی که در هنگام مقداردهی اولیه به شیء نظارتی
پاس داده می‌شوند.
.RE

XRD_WORKERTHREADS (-DIWorkerThreads)
.RS 5
تعداد ریسه‌هایی که فراخوان‌های بازگشتی کاربر را پردازش می‌کنند.
.RE

XRD_CPPARALLELCHUNKS (-DICPParallelChunks)
.RS 5
حداکثر تعداد درخواست‌های ناهمگام در حال پردازش توسط دستور xrdcp
به ازای هر زیرجریان کانال متصل (که به صورت بلادرنگ تنظیم می‌شود).
.RE

XRD_CPCHUNKSIZE (-DICPChunkSize)
.RS 5
اندازهٔ یک تکه‌دادهٔ منفرد که توسط xrdcp اداره می‌شود.
.RE

XRD_NETWORKSTACK (-DSNetworkStack)
.RS 5
پشتهٔ شبکه‌ای که کلاینت باید برای اتصال به سرور از آن استفاده کند. مقادیر ممکن
عبارتند از:

.B IPAuto
- تشخیص خودکار پشتهٔ IP مورد استفاده

.B IPAll
- استفاده از پشتهٔ IPv6 (سوکت‌های AF_INET6) و هر دو نشانی IPv6 و IPv4 (نگاشت‌شده به IPv6)

.B IPv6
- استفاده تنها از پشته و نشانی‌های IPv6

.B IPv4
- استفاده تنها از پشته و نشانی‌های IPv4 (سوکت‌های AF_INET)

.B IPv4Mapped6
- استفاده از پشتهٔ IPv6 و نشانی‌های نگاشت‌شدهٔ IPv4
.RE

XRD_DATASERVERTTL (-DIDataServerTTL)
.RS 5
مدت زمانی که پس از آن، یک اتصال بیکار به یک سرور داده باید
بسته شود..RE

XRD_LOADBALANCERTTL (-DILoadBalancerTTL)
.RS 5
مدت زمانی که پس از آن، یک اتصال بیکار (idle) به یک مدیر (manager) یا یک متعادل‌کننده بار (load balancer) باید بسته شود.
.RE

XRD_APPNAME (-DSAppName)
.RS 5
بازنویسی نام برنامه گزارش‌شده به کارساز.
.RE

XRD_PLUGINCONFDIR
.RS 5
مسیری سفارشی حاوی فایل‌های پیکربندی افزونه‌های کلاینت.
.RE

XRD_PLUGIN
.RS 5
افزونه پیش‌فرض کلاینت که باید استفاده شود.
.RE

XRD_CPINITTIMEOUT (-DICPInitTimeout)
.RS 5
حداکثر زمان مجاز برای مقداردهی اولیه فرایند کپی، یعنی باز کردن فایل‌های مبدأ و مقصد.
.RE

XRD_CPTPCTIMEOUT (-DICPTPCTimeout)
.RS 5
حداکثر زمان مجاز برای اتمام یک عملیات کپی شخص ثالث (TPC).
.RE

XRD_TCPKEEPALIVE (-DITCPKeepAlive)
.RS 5
فعال/غیرفعال کردن قابلیت TCP keep alive.
.RE

XRD_TCPKEEPALIVETIME (-DITCPKeepAliveTime)
.RS 5
زمان بین ارسال آخرین بسته داده و نخستین کاوش keepalive (فقط لینوکس).
.RE

XRD_TCPKEEPALIVEINTERVAL (-DITCPKeepAliveInterval)
.RS 5
فاصله زمانی بین کاوش‌های keepalive متوالی (فقط لینوکس).
.RE

XRD_TCPKEEPALIVEPROBES (-DITCPKeepProbes)
.RS 5
تعداد کاوش‌های بدون پاسخ پیش از آن‌که اتصال قطع‌شده تلقی شود (فقط لینوکس).
.RE

XRD_METALINKPROCESSING
.RS 5
فعال/غیرفعال کردن پردازش Metalink (به‌طور پیش‌فرض فعال است).
.RE

XRD_LOCALMETALINKFILE
.RS 5
فعال/غیرفعال کردن پردازش فایل محلی Metalink (طبق قرارداد باید از این ساختار URL استفاده شود: root://localfile//path/filename.meta4).
معناشناسی \(lqlocalfile\(rq اکنون منسوخ شده است؛ در عوض از file://localhost/path/filename.meta4 استفاده کنید!
.RE

XRD_GLFNREDIRECTOR
.RS 5
تغییرمسیردهنده‌ای (redirector) که در صورت مشخص شدن برچسب GLFN در یک فایل Metalink، به عنوان آخرین چاره استفاده خواهد شد.
.RE

XRD_XCPBLOCKSIZE
.RS 5
حداکثر اندازه یک بلوک داده اختصاص داده‌شده به یک منبع منفرد در صورت انتقال کپی شدید (extreme copy).
.RE

XRD_NODELAY
.RS 5
در صورت تنظیم روی 1 (پیش‌فرض)، الگوریتم Nagle را غیرفعال می‌کند و اگر روی 0 تنظیم شود، آن را فعال می‌سازد.
.RE

XRD_PREFERIPV4
.RS 5
در صورت تنظیم، کلاینت ابتدا نشانی IPv4 را امتحان می‌کند (به‌طور پیش‌فرض غیرفعال است).
.RE

XRD_MAXMETALINKWAIT
.RS 5
حداکثر زمان بر حسب ثانیه که در صورت در دسترس بودن یک تغییرمسیردهنده Metalink، کلاینت می‌تواند توسط کارساز متوقف (معلق) شود (پیش‌فرض: ۶۰ ثانیه).
.RE

XRD_PRESERVELOCATETRIED
.RS 5
اگر روی 1 تنظیم شود، کلاینت XRootD اطلاعات مات cgi با نام tried/triedrc را برای درخواست kXR_locate در بین تغییرمسیرها/تلاش‌های مجدد حفظ خواهد کرد؛ و اگر روی 0 تنظیم شود، کلاینت XRootD با kXR_locate مانند هر درخواست غیرفعال (passive) دیگری رفتار خواهد کرد.
.RE

XRD_PRESERVEXATTRS
.RS 5
اگر روی 1 (پیش‌فرض) تنظیم شود، xrdcp ویژگی‌های گسترش‌یافته فایل (extended attributes) را حفظ می‌کند؛ و اگر روی 0 تنظیم شود، این ویژگی‌ها حفظ نخواهند شد.
.RE

XRD_NOTLSOK
.RS 5
اگر روی 1 تنظیم شود و کارساز قدیمی‌تر از آن باشد که از رمزنگاری TLS پشتیبانی کند، با وجود استفاده از پروتکل roots/xroots، ابزار xrdcp به انتقال رمزنشده پس‌روی (fallback) خواهد کرد.
به‌طور پیش‌فرض روی 0 تنظیم شده است.
.RE

XRD_TLSNODATA
.RS 5
اگر روی 1 تنظیم شود، در صورت استفاده از پروتکل roots/xroots فقط جریان کنترلی رمزگذاری می‌شود و جریان‌های داده رمزنشده باقی می‌مانند.
به‌طور پیش‌فرض روی 0 تنظیم شده است.
.RE

XRD_TLSMETALINK
.RS 5
اگر روی 1 تنظیم شود، تمام نشانی‌های URL درون metalink به عنوان roots/xroots در نظر گرفته می‌شوند.
به‌طور پیش‌فرض روی 0 تنظیم شده است.
.RE

XRD_ZIPMTLNCKSUM
.RS 5
اگر روی 1 تنظیم شود، از چکسام موجود در فایل metalink حتی هنگام استخراج یک فایل از یک آرشیو ZIP استفاده می‌کند.
به‌طور پیش‌فرض روی 0 تنظیم شده است.
.RE

XRD_CPTIMEOUT
.RS 5
مهلت زمانی برای یک عملیات کپی کلاسیک (غیر TPC).
به‌طور پیش‌فرض روی 0 (غیرفعال) تنظیم شده است.
.RE

XRD_CLCONFDIR
.RS 5
دایرکتوری تعریف‌شده توسط کاربر حاوی فایل‌های پیکربندی (*.conf).
.RE

XRD_CLCONFFILE
.RS 5
فایل پیکربندی تعریف‌شده توسط کاربر.
.RE

XRD_CPRETRY
.RS 5
حداکثر تعداد دفعات تلاش مجدد برای کارهای کپی ناموفق (پیش‌فرض: 0).
.RE

XRD_CPRETRYPOLICY
.RS 5
سیاست تلاش مجدد برای عملیات کپی، یکی از مقادیر force یا retry (پیش‌فرض: force).
.RE

XRD_CPUSEPGWRTRD
.RS 5
فعال‌سازی تصحیح خطای بی‌درنگ (in-fly) برای صفحات آسیب‌دیده (پیش‌فرض: 1).
.RE.SH "کدهای بازگشتی (RETURN CODES)"
.RE
\fB50\fR  : خطای عمومی (مانند پیکربندی، داخلی، داده، سیستم‌عامل، گزینه خط فرمان)

\fB51\fR  : خطای مربوط به سوکت

\fB52\fR  : خطای مربوط به postmaster

\fB53\fR  : خطای مربوط به XRootD

\fB54\fR  : خطای بازهدایت (تغییر مسیر)

\fB55\fR  : پاسخ پرس‌وجو منفی بود (این یک خطا نیست)

.SH "نکات (NOTES)"
مستندات مربوط به تمام مؤلفه‌های وابسته به \fBxrdcp\fR در نشانی زیر در دسترس است:
https://xrootd.org/docs.html

.SH "عیب‌یابی (DIAGNOSTICS)"
خطاها منجر به نمایش پیام خطا و وضعیت خروج غیرصفر می‌شوند.

.SH "مجوز (LICENSE)"
LGPL

.SH "سطح پشتیبانی (SUPPORT LEVEL)"
دستور \fBxrdcp\fR توسط گروه همکاری xrootd پشتیبانی می‌شود.
اطلاعات تماس در نشانی زیر در دسترس است:

.ce
https://xrootd.org/contact.html