.TH xrdfs 1 "v6.1.1"
.SH "نام (NAME)"
xrdfs \- ابزار فرادادهٔ فایل و دایرکتوری xrootd
.SH "خلاصه دستور (SYNOPSIS)"
.nf

\fBxrdfs\fR \fI[--no-cwd]\fR \fIhost[:port]\fR \fI[command [args]]\fR

\fBcommand\fR: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
           truncate, prepare, cat, tail, spaceinfo
.fi
.br
.ad l
.SH "توضیحات (DESCRIPTION)"
ابزار \fBxrdfs\fR عملیات‌های مرتبط با فراداده (مانند ls، mv، rm و غیره) را روی یک یا چند سرور xrootd اجرا می‌کند.
راهنمای دستورها با فراخوانی \fBxrdfs\fR بدون هیچ گزینه یا پارامتر خط فرمان، و سپس وارد کردن «help» در پاسخ به اعلان ورودی در دسترس است.

.SH "گزینه‌ها (OPTIONS)"
\fB--no-cwd\fR
.RS 3
در حالت تعاملی، هیچ دایرکتوری کاری جاری (CWD) از پیش تعیین نمی‌شود.

.SH "دستورها (COMMANDS)"
\fBchmod\fR \fIpath\fR \fI<user><group><other>\fR
.RS 3
مجوزهای \fIpath\fR را تغییر می‌دهد. نمونه رشتهٔ مجوز:
\fIrwxr-x--x\fR

.RE
\fBls\fR \fI[-l]\fR \fI[-u]\fR \fI[-R]\fR \fI[-D]\fR \fI[-Z]\fR \fI[-C]\fR \fI[dirname]\fR
.RS 3
فهرست محتویات دایرکتوری را دریافت می‌کند.
.br
\fI-l\fR وضعیت (stat) هر مدخل را دریافت کرده و فهرست طولانی چاپ می‌کند
.br
\fI-u\fR مسیرها را به صورت URL چاپ می‌کند
.br
\fI-R\fR زیردایرکتوری‌ها را به صورت بازگشتی فهرست می‌کند
.br
\fI-D\fR مدخل‌های تکراری را نمایش می‌دهد
.br
\fI-Z\fR بررسی می‌کند که آیا فایل یک آرشیو ZIP است یا خیر، و در صورت مثبت بودن محتوای آن را فهرست می‌کند
.br
\fI-C\fR چکسام هر مدخل را محاسبه می‌کند

.RE
\fBlocate\fR \fI[-n]\fR \fI[-r]\fR \fI[-d]\fR \fI[-m]\fR \fI[-i]\fR \fI[-p]\fR \fI<path>\fR
.RS 3
مکان‌های مسیر را به دست می‌آورد.
.br
\fI-r\fR تازه‌سازی؛ از مکان‌های ذخیره‌شده در حافظه موقت (کَش) استفاده نمی‌کند
.br
\fI-n\fR سرور را وادار می‌کند تا پاسخ را فوراً برگرداند، حتی اگر ناقص باشد
.br
\fI-d\fR انجام مکان‌یابی عمیق و بازگشتی برای یافتن سرورهای داده
.br
\fI-m\fR ترجیح دادن نام‌های میزبان به نشانی‌های IP
.br
\fI-i\fR نادیده گرفتن وابستگی‌های شبکه (IPv6/IPv4)
.br
\fI-p\fR حالت غیرفعال (passive): نادیده گرفتن اطلاعات مبهم (opaque) cgi برای tried/triedrc


.RE
\fBmkdir\fR \fI[-p] [-m<user><group><other>] <dirname>\fR
.RS 3
یک دایرکتوری یا درختی از دایرکتوری‌ها را ایجاد می‌کند.
.br
\fI-p\fR ایجاد کل درخت دایرکتوری به صورت بازگشتی
.br
\fI-m\fR\fB<user><group><other>\fR مجوزها برای دایرکتوری‌های جدید ایجادشده

.RE
\fBmv\fR \fI<path1> <path2>\fR
.RS 3
انتقال path1 به path2 به صورت محلی روی همان سرور.

.RE
\fBstat\fR \fI<path>\fR \fI[<paths>]\fR
.RS 3
دریافت اطلاعات دربارهٔ فایل(ها) یا دایرکتوری(ها).
.br
\fI-q\fR \fB<flags>\fR در صورتی که ترکیب پرچم درخواست‌شده موجود نباشد،
باعث می‌شود xrdfs کد خطای 55 را به پوسته برگرداند؛
پرچم‌ها می‌توانند با استفاده از «|» یا «&» با یکدیگر ترکیب شوند
.br
پرچم‌های موجود:
\fBXBitSet\fR, \fBIsDir\fR, \fBOther\fR, \fBOffline\fR, \fBPOSCPending\fR,
\fBIsReadable\fR, \fBIsWriteable\fR, \fBBackUpExists\fR

.RE
\fBstatvfs\fR \fI<path>\fR
.RS 3
دریافت اطلاعات دربارهٔ یک سیستم فایل مجازی.

.RE
\fBquery\fR \fI<code> <params>\fR
.RS 3
دریافت اطلاعات سرور. کدهای پرس‌وجو:
.br
\fIconfig\fR         \fB<what>\fR   پیکربندی سرور؛ <what> یکی از موارد زیر است:
.RS 5
bind_max      - حداکثر تعداد جریان‌های موازی
.br
chksum        - چکسام پشتیبانی‌شده
.br
pio_max       - حداکثر تعداد درخواست‌های ورودی/خروجی (I/O) موازی
.br
readv_ior_max - حداکثر اندازهٔ یک عنصر readv
.br
readv_iov_max - حداکثر تعداد مدخل‌های readv
.br
tpc           - پشتیبانی از رونوشت‌های شخص ثالث (third party copies)
.br
wan_port      - درگاه مورد استفاده برای رونوشت‌های wan
.br
wan_window    - اندازهٔ پنجرهٔ wan_port
.br
window        - اندازهٔ پنجرهٔ tcp
.br
cms           - وضعیت cmsd
.br
role          - نقش در کلاستر
.br
sitename      - نام سایت
.br
version       - نسخهٔ سرور
.br
.RE
\fIchecksumcancel\fR \fB<path>\fR   لغو چکسام فایل
.br
\fIchecksum\fR       \fB<path>\fR   چکسام فایل
.br
\fIopaque\fR         \fB<arg>\fR    وابسته به پیاده‌سازی
.br
\fIopaquefile\fR     \fB<arg>\fR    وابسته به پیاده‌سازی
.br
\fIspace\fR          \fB<space>\fR  آمارهای فضای منطقی
.br
\fIstats\fR          \fB<what>\fR   آمارهای سرور؛ <what> فهرستی از حروف است
که اطلاعات بازگشتی را مشخص می‌کند:
.RS 5
a - تمام آمارها
.br
p - آمارهای پروتکل
.br
b - آمارهای استفاده از بافر
.br
s - آمارهای زمان‌بندی
.br
d - آمارهای سرکشی (polling) دستگاه
.br
u - آمارهای استفاده
.br
i - شناسایی سرور
.br
z - آمارهای همگام‌شده
.br
l - آمارهای اتصال
.br
.RE
\fIxattr\fR          \fB<path>\fR   ویژگی‌های گسترش‌یافته
.br
\fIprepare\fR        \fB<reqid> [filenames]\fR  وضعیت درخواست prepare


.RE
\fBrm\fR \fI<filename>\fR \fI[<filenames>]\fR
.RS 3
حذف یک فایل.

.RE
\fBrmdir\fR \fI<dirname>\fR
.RS 3
حذف یک دایرکتوری.

.RE
\fBtruncate\fR \fI<filename> <length>\fR
.RS 3
کوتاه کردن طول یک فایل.

.RE
\fBprepare\fR \fI[-c]\fR \fI[-f]\fR \fI[-s]\fR \fI[-w]\fR \fI[-e]\fR \fI[-p priority]\fR \fI[-a requestid]\fR \fIfilenames\fR
.RS 3
آماده‌سازی یک یا چند فایل برای دسترسی.
.br
\fI-c\fR استقرار هم‌مکان (co-locate) فایل‌های منتقل‌شده (staged) در صورت امکان
.br
\fI-f\fR تازه‌سازی زمان دسترسی فایل، حتی اگر مکان آن معلوم باشد
.br
\fI-s\fR انتقال فایل‌ها به دیسک (stage) در صورتی که برخط نیستند
.br
\fI-w\fR هنگامی که فایل‌ها برای تغییر مورد دسترسی قرار خواهند گرفت
.br
\fI-p\fR اولویت درخواست، 0 (کمترین) تا 3 (بیشترین)
.br
\fI-a\fR لغو (abort) درخواست
.br
\fI-e\fR خارج کردن (evict) فایل از حافظه موقت دیسک

.RE
\fBcat\fR \fI[-o localfile]\fR \fIfiles\fR
.RS 3
چاپ محتویات یک یا چند فایل در stdout
.br
\fI-o\fR چاپ در فایل محلی مشخص‌شده

.RE
\fBtail\fR \fI[-c bytes] [-f]\fR \fIfile\fR
.RS 3
خروجی دادن آخرین بخش فایل‌ها در stdout.
.br
\fI-c\fR خروجی دادن آخرین num_bytes بایت
.br
\fI-f\fR           خروجی دادن داده‌های الحاق‌شده همگام با رشد فایل

.RE
\fBspaceinfo\fR \fIpath\fR
.RS 3
دریافت آمارهای فضای ذخیره‌سازی برای مسیر داده‌شده.

.RE
\fBxattr\fR \fI<path> <code> <params>\fR
.RS 3
عملیات روی ویژگی‌های گسترش‌یافته. کدها:
.br
\fIset\fR         \fB<attr>\fR   تنظیم ویژگی گسترش‌یافته؛
                     <attr> رشته‌ای به شکل name=value است
.br
\fIget\fR         \fB<name>\fR   دریافت ویژگی گسترش‌یافته.
.br
\fIdel\fR         \fB<name>\fR   حذف ویژگی گسترش‌یافته.
.br
\fIlist\fR                 فهرست کردن ویژگی‌های گسترش‌یافته.

.SH "کدهای بازگشتی (RETURN CODES)"
.RE
\fB50\fR  : خطای عمومی (مانند پیکربندی، داخلی، داده، سیستم‌عامل)

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

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

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

\fB54\fR  : خطای تغییر مسیر (redirection)

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

.SH "نکات (NOTES)"
برای فهرست متغیرهای محیطی در دسترس، لطفاً به xrdcopy(1) مراجعه کنید

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

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

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

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