1xrootdfs(1)                 General Commands Manual                xrootdfs(1)
2
3
4

NAME

6       xrootdfs - xrootd FUSE file system daemon
7

SYNOPSIS

9       xrootdfs [options] parameters
10
11

DESCRIPTION

13       The xrootdfs daemon provides a file system view of an xrootd cluster
14       using FUSE.  Usage synopsis can be displayed by typing "xrootdfs -h".
15       Short documentation can be found in a README file in the src/XrdFfs
16       source directory.
17
18

EXAMPLES

20       Assuming the redirector is rdr:port
21
22       run from command line with debugging output
23              xrootdfs -d -o rdr=root://rdr:port//data,uid=daemon /mnt
24
25       use in /etc/fstab
26              xrootdfs /mnt fuse rdr=root://rdr:port//data,uid=daemon 1 2
27
28       use with autofs
29              1. add a line to /etc/auto.master
30              /- /etc/auto.fuse
31
32              2. create /etc/auto.fuse with the following one line
33              /mnt -fstype=fuse,uid=2,rdr=root://rdr\:port//data :xrootdfs.sh
34
35              3. create script /usr/bin/xrootdfs.sh (make sure +x bit is set)
36              #!/bin/sh
37              exec /usr/bin/xrootdfs $@ >/dev/null 2>&1
38
39

NOTES

41       Documentation for all components associated with xrootdfs can be found
42       at http://xrootd.org/docs.html
43
44       xrootdfs allows users and administators to query and change the inter‐
45       nal parameters on the fly via the filesystem extended attributes
46
47       getfattr -n attribute_name /mount_point
48       setfattr -n attribute_name [ -v value ] /mount_point
49
50       attribute_name:
51              xroot.url: query the actual ROOT url of the file (this is an old
52              one)
53              xrootdfs.fs.nworkers: query or change the number of threads
54              working in parallel on operations such as stat(), un‐
55              link()/rmdir(), readdir(), statvfs(), etc.
56              xrootdfs.fs.dataserverlist: query or refresh the list of all
57              data servers known to this xrootdfs instance (or "kill -USR1
58              pid" to refresh)
59
60

SECURITY

62       By default, XrootdFS does not send individual user identity to the
63       Xrootd storage servers.  So Xrootd storage thinks that all operations
64       from an XrootdFS instance come from the user that runs the XrootdFS in‐
65       stance. When the Xrootd "sss" security module (Simple Shared Security)
66       is enabled at both XrootdFS and Xrootd storage system, XrootdFS will
67       send individual user identity information to the Xrootd storage
68       servers. This info can be used along with the Xrootd ACL to control
69       file/directory access.
70
71       To use "sss" security module, both Xrootd data servers and XrootdFS
72       should be configured to use "sss" in a particular way, e.g. both sides
73       should use a key file that contains the same key generated by the
74       xrdsssadmin program in the following way:
75
76       xrdsssadmin -k my_key_name -u anybody -g usrgroup add keyfile
77
78       (change only "my_key_name" and "keyfile"). Please refer to environment
79       variable "XrdSecsssKT" in Xrootd "Authentication & Access Control Con‐
80       figuration Reference" for more information on the location of the key‐
81       file and its unix permission bits. That same document also describes
82       the Xrootd ACL DB file.
83
84       To enable "sss" with XrootdFS, use the sss=/keyfile option with
85       XrootdFS.
86
87       The following example shows how to use both unix and sss security mod‐
88       ules with the Xrootd data servers.
89
90                xrootd.seclib /usr/lib64/libXrdSec.so
91                sec.protocol /usr/lib64 sss -s /keyfile
92                sec.protocol /usr/lib64 unix
93                acc.authdb /your_xrootd_ACL_auth_db_file
94                acc.authrefresh 300
95                ofs.authorize
96
97

DIAGNOSTICS

99       Errors yield an error message and a non-zero exit status.  The program
100       never exits upon success.  Use the umount command to terminate the pro‐
101       gram.
102
103       Additional logging information can be found in syslog (/var/log/mes‐
104       sages)
105

LICENSE

107       License terms can be displayed by typing "xrootd -H".
108

SUPPORT LEVEL

110       The xrootdfs daemon is supported by the xrootd collaboration.  Contact
111       information can be found at
112                           http://xrootd.org/contact.html
113
114
115
116                                    v5.4.3                         xrootdfs(1)
Impressum