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

\fBxrootdfs\fR [\fIoptions\fR] \fIparameters\fR

.fi
.br
.ad l
.SH "توضیحات (DESCRIPTION)"
دیمن \fBxrootdfs\fR با استفاده از FUSE یک نمای سامانه فایل از یک کلاستر xrootd ارائه می‌دهد.
خلاصه نحوه استفاده را می‌توان با وارد کردن «\fBxrootdfs -h\fR» مشاهده کرد.
مستندات کوتاه در یک فایل README در دایرکتوری سورس src/XrdFfs قابل مشاهده است.

.SH "مثال‌ها (EXAMPLES)"
با فرض اینکه هدایت‌کننده (redirector)
.B rdr:port
باشد

اجرا از خط فرمان همراه با خروجی اشکال‌زدایی
.RS
xrootdfs -d -o rdr=root://rdr:port//data,uid=daemon /mnt
.RE

استفاده در /etc/fstab
.RS
xrootdfs /mnt fuse rdr=root://rdr:port//data,uid=daemon 1 2
.RE

استفاده به همراه autofs
.RS
1. افزودن یک خط به /etc/auto.master
.br
/\- /etc/auto.fuse

2. ایجاد /etc/auto.fuse تنها با همین یک خط
.br
/mnt \-fstype=fuse,uid=2,rdr=root://rdr\\:port//data :xrootdfs.sh

3. ایجاد اسکریپت /usr/bin/xrootdfs.sh (مطمئن شوید بیت اجرای +x تنظیم شده باشد)
.br
#!/bin/sh
.br
exec /usr/bin/xrootdfs $@ >/dev/null 2>&1

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

دستور xrootdfs به کاربران و مدیران سیستم امکان می‌دهد پارامترهای داخلی را در حین اجرا از طریق ویژگی‌های توسعه‌یافته سامانه فایل (extended attributes) پرس‌وجو کرده و تغییر دهند

getfattr -n attribute_name /mount_point
.br 
setfattr -n attribute_name [ -v value ] /mount_point

attribute_name:
.RS
.B xroot.url:
پرس‌وجوی نشانی ROOT واقعی فایل (این یک گزینه قدیمی است)
.br
.B xrootdfs.fs.nworkers:
پرس‌وجو یا تغییر تعداد ریسه‌هایی (threads) که به‌صورت موازی روی عملیاتی مانند stat()، unlink()/rmdir()، readdir()، statvfs() و غیره کار می‌کنند.
.br
.B xrootdfs.fs.dataserverlist: 
پرس‌وجو یا تازه‌سازی فهرست تمام سرورهای داده شناخته‌شده برای این نمونه از xrootdfs (یا استفاده از «kill -USR1 pid» جهت تازه‌سازی)

.SH "امنیت (SECURITY)"
به‌طور پیش‌فرض، XrootdFS هویت مجزای کاربران را به سرورهای ذخیره‌سازی Xrootd ارسال نمی‌کند.
بنابراین فضای ذخیره‌سازی Xrootd تصور می‌کند تمامی عملیات‌های دریافتی از یک نمونه XrootdFS از سوی کاربری انجام می‌شود
که نمونه XrootdFS را اجرا کرده است. هنگامی که ماژول امنیتی «sss» در Xrootd (مخفف Simple Shared Security)
هم در XrootdFS و هم در سامانه ذخیره‌سازی Xrootd فعال باشد، XrootdFS اطلاعات هویت مجزای کاربران
را به سرورهای ذخیره‌سازی Xrootd ارسال خواهد کرد. از این اطلاعات می‌توان همراه با ACL در Xrootd
برای کنترل دسترسی به فایل‌ها/دایرکتوری‌ها استفاده کرد.

برای استفاده از ماژول امنیتی «sss»، هر دو بخش سرورهای داده Xrootd و XrootdFS باید
به‌گونه‌ای پیکربندی شوند که از «sss» به روش مشخصی استفاده کنند؛ برای نمونه هر دو طرف باید از یک
فایل کلید استفاده کنند که حاوی همان کلید تولید شده توسط برنامه xrdsssadmin به شیوه
زیر باشد:

xrdsssadmin -k my_key_name -u anybody -g usrgroup add keyfile

(تنها «my_key_name» و «keyfile» را تغییر دهید). لطفاً برای اطلاعات بیشتر درباره
محل keyfile و بیت‌های دسترسی یونیکس آن، به متغیر محیطی «XrdSecsssKT» در
«Authentication & Access Control Configuration Reference» مربوط به Xrootd مراجعه کنید. همان
سند همچنین فایل پایگاه‌داده ACL در Xrootd را شرح می‌دهد.

جهت فعال‌سازی «sss» به همراه XrootdFS، از گزینه sss=/keyfile در XrootdFS استفاده کنید.

مثال زیر نحوه استفاده از هر دو ماژول امنیتی unix و sss را همراه با سرورهای داده Xrootd
نشان می‌دهد.

.RS
  xrootd.seclib /usr/lib64/libXrdSec.so
.br
  sec.protocol /usr/lib64 sss -s /keyfile
.br
  sec.protocol /usr/lib64 unix
.br
  acc.authdb /your_xrootd_ACL_auth_db_file
.br
  acc.authrefresh 300
.br
  ofs.authorize

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

اطلاعات گزارش‌گیری تکمیلی را می‌توان در syslog (/var/log/messages) یافت
.SH "مجوز (LICENSE)"
شرایط مجوز را می‌توان با تایپ «\fBxrootd -H\fR» مشاهده کرد.
.SH "سطح پشتیبانی (SUPPORT LEVEL)"
دیمن \fBxrootdfs\fR توسط تیم همکاری xrootd پشتیبانی می‌شود.
اطلاعات تماس در نشانی زیر در دسترس است:
.ce
https://xrootd.org/contact.html