Debian Codegraph @

src/data/sfsexports.cfg

raw ◀ ▶
Source reconstructed at patch state 0 of 1 — not the installed (fully patched) source.
1 Debian patch touch this file
1 # sfsexports.cfg(5)
2 #
3 # This file contains SaunaFS access list for sfsmount clients.
4 #
5 #
6 # Line format:
7 #
8 # [ip range] [path] [options]
9 #
10 #
11 # ip range:
12 #
13 # *
14 # any IP (same as 0.0.0.0/0)
15 #
16 # A.B.C.D
17 # given IP address
18 #
19 # A.B.C.D-E.F.G.H
20 # range of IP addresses
21 #
22 # A.B.C.D/BITS
23 # A.B.C.D network with BITS ones in netmask
24 #
25 # A.B.C.D/E.F.G.H
26 # A.B.C.D network with E.F.G.H netmask
27 #
28 #
29 # path:
30 #
31 # .
32 # special 'path' that means 'meta'
33 #
34 # /...
35 # path in sfs structure
36 #
37 #
38 # options:
39 #
40 # ro/rw/readonly/readwrite
41 # obvious meaning
42 #
43 # alldirs
44 # any subdirectory can be mounted as root
45 #
46 # dynamicip
47 # IP is tested only during first authentication, then client can use the
48 # same session id from any IP
49 #
50 # ignoregid
51 # group id (gid) is not tested - important when you want to use auxiliary
52 # groups
53 #
54 # allcanchangequota
55 # non-root users are allowed to change quotas
56 #
57 # nomasterpermcheck
58 # disable permission checks in master server
59 #
60 # maproot=UID[:GID]
61 # treat all root (user with uid equal to zero) operations as operations done
62 # by user with uid equal to UID and gid equal to GID (or default gid of this
63 # user)
64 #
65 # mapall=UID[:GID}
66 # like above but for all operations (for both options UID and/or GID can be
67 # specified as username or groupname existing on master machine)
68 #
69 # password=TEXT
70 # force authentication using given password
71 #
72 # md5pass=MD5
73 # like above, but with password defined as it's MD5 hash (MD5 specified as
74 # 128-bit hexadecimal number)
75 #
76 # minversion=VERS
77 # allow only clients with version number equal or greater than VERS (VERS
78 # can be specified as X or X.Y or X.Y.Z)
79 #
80 # mingoal=N
81 # do not allow to set goal below N (N should be a number from '1' to '20')
82 #
83 # maxgoal=N
84 # do not allow to set goal above N (N as above)
85 #
86 # mintrashtime=TIMEDURATION
87 # do not allow to set trashtime below TIMEDURATION (TIMEDURATION can be
88 # specified as number of seconds or combination of elements #W,#D,#H,#M,#S
89 # with given order)
90 #
91 # maxtrashtime=TIMEDURATION
92 # do not allow to set trashtime above TIMEDURATION (TIMEDURATION can be
93 # specified as above)
94 #
95 #
96 # Defaults:
97 #
98 # readonly,maproot=999:999,mingoal=1,maxgoal=20,mintrashtime=0,maxtrashtime=4294967295
99 #
100 #
101 # TIMEDURATION examples:
102 #
103 # 2H
104 # 2 hours
105 #
106 # 4h30M
107 # 4 hours and 30 minutes (time units are case insensitive)
108 #
109 # 12w
110 # 12 weeks
111 #
112 # 86400
113 # 86400 seconds = 1 day
114 #
115 # 11d13h46m40s
116 # 1000000 seconds (defined as 11 days, 13 hours, 46 minutes and 40 seconds)
117 #
118 # 48H
119 # 48 hours = 2 days (it is allowed to use any positive number with any time
120 # unit as long as calculated number of seconds do not overrun 4294967295)
121 #
122 # 30m12h
123 # wrong definition (minutes before hours)
124 #
125 # 30m12
126 # wrong definition (12 without unit definition - only one, alone number is
127 # allowed without unit definition)
128 #
129 # 50000d
130 # wrong definition (calculated number of seconds is 4320000000 which is
131 # greater than 4294967295)
132
133
134 #
135 # Examples:
136 #
137
138
139 # Users from any IP can mount root directory as a read-only file system. Local
140 # roots are mapped as users with uid:gid = 999:999.
141 #
142 #* / ro
143
144 # Users from IP 192.168.1.0-192.168.1.255 can mount root directory as a
145 # standard read/write file system. Local roots are mapped as users with
146 # uid:gid = 999:999.
147 #
148 #192.168.1.0/24 / rw
149
150 # Users from IP 192.168.1.0-192.168.1.255 when give password 'passcode' can
151 # mount any subdirectory as a standard read/write file system. Local roots are
152 # left unmapped.
153 #
154 #192.168.1.0/24 / rw,alldirs,maproot=0,password=passcode
155
156 # Users from IP 10.0.0.0-10.0.0.5 when give password 'test' can mount 'test'
157 # subdirectory as a standard read/write file system. Local roots are mapped as
158 # 'nobody' users (usually uid=65534). To mount a subdirectory on the client use
159 # sfsmount -o sfssubdirectory=/test /mnt/mountpoint
160 #
161 #10.0.0.0-10.0.0.5 /test rw,maproot=nobody,password=test
162
163 # Users from IP 10.1.0.0-10.1.255.255 can mount 'public' subdirectory as a
164 # standard read/write file system. All users are mapped as users with
165 # uid:gid = 1000:1000.
166 #
167 #10.1.0.0/255.255.0.0 /public rw,mapall=1000:1000
168
169 # Users from IP 10.2.0.0-10.2.255.255 can mount everything, but can't decrease
170 # trash time below 2 hours and 30 minutes and above 2 weeks
171 #
172 #10.2.0.0/16 / rw,alldirs,maproot=0,mintrashtime=2h30m,maxtrashtime=2w
173
174 # Allow everything but "meta"
175
176 * / rw,alldirs,maproot=0
177
178 # Allow "meta"
179
180 * . rw