نام (NAME)

xrdfs - ابزار فرادادهٔ فایل و دایرکتوری xrootd

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

xrdfs [--no-cwd] host[:port] [command [args]]
command: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
           truncate, prepare, cat, tail, spaceinfo

توضیحات (DESCRIPTION)

ابزار xrdfs عملیات‌های مرتبط با فراداده (مانند ls، mv، rm و غیره) را روی یک یا چند سرور xrootd اجرا می‌کند. راهنمای دستورها با فراخوانی xrdfs بدون هیچ گزینه یا پارامتر خط فرمان، و سپس وارد کردن «help» در پاسخ به اعلان ورودی در دسترس است.

گزینه‌ها (OPTIONS)

--no-cwd

در حالت تعاملی، هیچ دایرکتوری کاری جاری (CWD) از پیش تعیین نمی‌شود.

دستورها (COMMANDS)

chmod path <user><group><other>

مجوزهای path را تغییر می‌دهد. نمونه رشتهٔ مجوز: rwxr-x--x

ls [-l] [-u] [-R] [-D] [-Z] [-C] [dirname]

فهرست محتویات دایرکتوری را دریافت می‌کند.
-l وضعیت (stat) هر مدخل را دریافت کرده و فهرست طولانی چاپ می‌کند
-u مسیرها را به صورت URL چاپ می‌کند
-R زیردایرکتوری‌ها را به صورت بازگشتی فهرست می‌کند
-D مدخل‌های تکراری را نمایش می‌دهد
-Z بررسی می‌کند که آیا فایل یک آرشیو ZIP است یا خیر، و در صورت مثبت بودن محتوای آن را فهرست می‌کند
-C چکسام هر مدخل را محاسبه می‌کند

locate [-n] [-r] [-d] [-m] [-i] [-p] <path>

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

mkdir [-p] [-m<user><group><other>] <dirname>

یک دایرکتوری یا درختی از دایرکتوری‌ها را ایجاد می‌کند.
-p ایجاد کل درخت دایرکتوری به صورت بازگشتی
-m<user><group><other> مجوزها برای دایرکتوری‌های جدید ایجادشده

mv <path1> <path2>

انتقال path1 به path2 به صورت محلی روی همان سرور.

stat <path> [<paths>]

دریافت اطلاعات دربارهٔ فایل(ها) یا دایرکتوری(ها).
-q <flags> در صورتی که ترکیب پرچم درخواست‌شده موجود نباشد، باعث می‌شود xrdfs کد خطای 55 را به پوسته برگرداند؛ پرچم‌ها می‌توانند با استفاده از «|» یا «&» با یکدیگر ترکیب شوند
پرچم‌های موجود: XBitSet, IsDir, Other, Offline, POSCPending, IsReadable, IsWriteable, BackUpExists

statvfs <path>

دریافت اطلاعات دربارهٔ یک سیستم فایل مجازی.

query <code> <params>

دریافت اطلاعات سرور. کدهای پرس‌وجو:
config <what> پیکربندی سرور؛ <what> یکی از موارد زیر است:

bind_max - حداکثر تعداد جریان‌های موازی
chksum - چکسام پشتیبانی‌شده
pio_max - حداکثر تعداد درخواست‌های ورودی/خروجی (I/O) موازی
readv_ior_max - حداکثر اندازهٔ یک عنصر readv
readv_iov_max - حداکثر تعداد مدخل‌های readv
tpc - پشتیبانی از رونوشت‌های شخص ثالث (third party copies)
wan_port - درگاه مورد استفاده برای رونوشت‌های wan
wan_window - اندازهٔ پنجرهٔ wan_port
window - اندازهٔ پنجرهٔ tcp
cms - وضعیت cmsd
role - نقش در کلاستر
sitename - نام سایت
version - نسخهٔ سرور

checksumcancel <path> لغو چکسام فایل
checksum <path> چکسام فایل
opaque <arg> وابسته به پیاده‌سازی
opaquefile <arg> وابسته به پیاده‌سازی
space <space> آمارهای فضای منطقی
stats <what> آمارهای سرور؛ <what> فهرستی از حروف است که اطلاعات بازگشتی را مشخص می‌کند:

a - تمام آمارها
p - آمارهای پروتکل
b - آمارهای استفاده از بافر
s - آمارهای زمان‌بندی
d - آمارهای سرکشی (polling) دستگاه
u - آمارهای استفاده
i - شناسایی سرور
z - آمارهای همگام‌شده
l - آمارهای اتصال

xattr <path> ویژگی‌های گسترش‌یافته
prepare <reqid> [filenames] وضعیت درخواست prepare

rm <filename> [<filenames>]

حذف یک فایل.

rmdir <dirname>

حذف یک دایرکتوری.

truncate <filename> <length>

کوتاه کردن طول یک فایل.

prepare [-c] [-f] [-s] [-w] [-e] [-p priority] [-a requestid] filenames

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

cat [-o localfile] files

چاپ محتویات یک یا چند فایل در stdout
-o چاپ در فایل محلی مشخص‌شده

tail [-c bytes] [-f] file

خروجی دادن آخرین بخش فایل‌ها در stdout.
-c خروجی دادن آخرین num_bytes بایت
-f خروجی دادن داده‌های الحاق‌شده همگام با رشد فایل

spaceinfo path

دریافت آمارهای فضای ذخیره‌سازی برای مسیر داده‌شده.

xattr <path> <code> <params>

عملیات روی ویژگی‌های گسترش‌یافته. کدها:
set <attr> تنظیم ویژگی گسترش‌یافته؛
<attr> رشته‌ای به شکل name=value است
get <name> دریافت ویژگی گسترش‌یافته.
del <name> حذف ویژگی گسترش‌یافته.
list فهرست کردن ویژگی‌های گسترش‌یافته.