1MFSMOUNT(1) MFSMOUNT(1)
2
6 mfsmount - mount Lizard File System
7
9 mfsmount mountpoint [-d] [-f] [-s] [-m] [-n] [-p]
10 [-H HOST] [-P PORT] [-S PATH] [-o opt[,opt]...]
11 mfsmount -h|--help
13 mfsmount -V|--version
15
17 Mount Lizard File System.
18 General options:
20 -h, --help
22 display help and exit
23 -V
25 display version information and exit
26 FUSE options:
28 -d, -o debug
30 enable debug mode (implies -f)
31 -f
33 foreground operation
34 -s
36 disable multi-threaded operation
37 LizardFS options:
39 -c CFGFILE, -o mfscfgfile=CFGFILE
41 loads file with additional mount options
42 -m, --meta, -o mfsmeta
44 mount MFSMETA companion filesystem instead of primary LizardFS
45 -n
47 omit default mount options (-o allow_other,default_permissions)
48 -p, -o askpassword
50 prompt for password (interactive version of -o mfspassword=PASS)
51 -H HOST, -o mfsmaster=HOST
53 connect with LizardFS master on HOST (default is mfsmaster)
54 -P PORT, -o mfsport=PORT
56 connect with LizardFS master on PORT (default is 9421)
57 -B HOST, -o mfsbind=HOST
59 local address to use for connecting with master instead of default
60 one
61 -S PATH, -o mfssubfolder=PATH
63 mount specified LizardFS directory (default is /, i.e. whole
64 filesystem)
65 -o enablefilelocks=[0,1]
67 enables/disables global file locking (disabled by default)
68 -o mfspassword=PASSWORD
70 authenticate to LizardFS master with PASSWORD
71 -o mfsmd5pass=MD5
73 authenticate to LizardFS master using directly given MD5 (only if
74 mfspassword option is not specified)
75 -o mfsdelayedinit
77 connection with master is done in background - with this option
78 mount can be run without network (good for being run from fstab /
79 init scripts etc.)
80 -o mfsacl
82 enable ACL support (disabled by default)
83 -o mfsaclcacheto=SEC
85 set ACL cache timeout in seconds (default: 1.0)
86 -o mfsaclcachesize=N
88 define ACL cache size in number of entries (0: no cache; default:
89 1000)
90 -o mfsrwlock=0|1
92 when set to 1, parallel reads from the same descriptor are
93 performed (default: 1)
94 -o mfsmkdircopysgid=N
96 sgid bit should be copied during mkdir operation (on linux default:
97 1, otherwise: 0)
98 -o mfssugidclearmode=SMODE
100 set sugid clear mode (see below)
101 -o mfsdebug
103 print some LizardFS-specific debugging information
104 -o mfscachemode=CACHEMODE
106 set cache mode (see DATA CACHE MODES; default is AUTO)
107 -o mfscachefiles
109 (deprecated) preserve file data in cache (equivalent to -o
110 mfscachemode=YES)
111 -o mfsattrcacheto=SEC
113 set attributes cache timeout in seconds (default: 1.0)
114 -o mfsentrycacheto=SEC
116 set file entry cache timeout in seconds (default: 0.0, i.e. no
117 cache)
118 -o mfsdirentrycacheto=SEC
120 set directory entry cache timeout in seconds (default: 1.0)
121 -o mfswritecachesize=N
123 specify write cache size in MiB (in range: 16..2048 - default: 128)
124 -o mfscacheperinodepercentage=N
126 specify what part of the write cache non occupied by other inodes
127 can a single inode occupy (measured in %). E.g. When N=75 and the
128 inode X uses 10 MiB, and all other inodes use 20 MiB out of 100 MiB
129 cache, X can use 50 MiB more (since 75% of 80 MiB is 60 MiB).
130 Default: 25.
131 -o mfschunkserverreadto=MSEC
133 set timeout for whole communication with a chunkserver during read
134 operation in milliseconds (default: 2000)
135 -o mfschunkserverwriteto=MSEC
137 set chunkserver response timeout during write operation in
138 milliseconds (default: 5000)
139 -o mfschunkserverrtt=MSEC
141 set timeout after which SYN packet is considered lost during the
142 first retry of connecting a chunkserver (default: 200)
143 -o mfschunkserverconnectreadto=MSEC
145 set timeout for connecting with chunkservers during read operation
146 in milliseconds (default: 2000)
147 -o mfschunkserverwavereadto=MSEC
149 set timeout for executing each wave of a read operation in
150 milliseconds (default: 500)
151 -o mfschunkservertotalreadto=MSEC
153 set timeout for the whole communication with chunkservers during a
154 read operation in milliseconds (default: 2000)
155 -o cacheexpirationtime=MSEC
157 set timeout for read cache entries to be considered valid in
158 milliseconds (0 disables cache) (default: 300)
159 -o readaheadmaxwindowsize=KB
161 set max value of readahead window per single descriptor in
162 kibibytes (default: 16384)
163 -o mfsrlimitnofile=N
165 try to change limit of simultaneously opened file descriptors on
166 startup (default: 100000)
167 -o mfsnice=LEVEL
169 try to change nice level to specified value on startup (default:
170 -19)
171 -o mfswriteworkers=N
173 define number of write workers (default: 10)
174 -o mfswritewindowsize=N
176 define write window size (in blocks) for each chunk (default: 15)
177 -o mfsmemlock
179 try to lock memory (must be enabled at build time)
180 -o mfsdonotrememberpassword
182 do not remember password in memory - more secure, but when session
183 is lost then new session is created without password
184 -o mfsioretries=N
186 specify number of retries before I/O error is returned (default:
187 30)
188 -o mfsreportreservedperiod=N
190 specify interval of reporting reserved inodes in seconds (default:
191 60)
192 -o mfsiolimits=PATH
194 specify local I/O limiting configuration file (default: no I/O
195 limiting)
196 General mount options (see mount(8) manual):
198 -o rw|-o ro
200 Mount file-system in read-write (default) or read-only mode
201 respectively.
202 -o suid|-o nosuid
204 Enable or disable suid/sgid attributes to work.
205 -o dev|-o nodev
207 Enable or disable character or block special device files
208 interpretation.
209 -o exec|-o noexec
211 Allow or disallow execution of binaries.
212 -o symlinkcachetimeout=N
214 Set timeout value for symlink cache timeout in seconds. Default
215 value is 3600.
216 -o bandwidthoveruse=N
218 Define ratio of allowed bandwidth overuse when fetching data.
219 Default value is 1.0. This option is effective only with N+M goals
220 (xors and erasure codes).
221
223 There are three cache modes: NO, YES and AUTO. Default option is AUTO
224 and you shuldn’t change it unless you really know what you are doing.
225 In AUTO mode data cache is managed automatically by mfsmaster.
226 NO,NONE or NEVER
228 never allow files data to be kept in cache (safest but can reduce
229 efficiency)
230 YES or ALWAYS
232 always allow files data to be kept in cache (dangerous)
233 AUTO
235 file cache is managed by mfsmaster automatically (should be very
236 safe and efficient)
237
239 SMODE can be set to:
240 • NEVER - MFS will not change suid and sgid bit on chown
242 • ALWAYS - clear suid and sgid on every chown - safest operation
244 • OSX - standard behavior in OS X and Solaris (chown made by
246 unprivileged user clear suid and sgid)
247 • BSD - standard behavior in BSD systems (like in OSX, but only when
249 something is really changed)
250 • EXT - standard behavior in most file systems on Linux (directories
252 not changed, others: suid cleared always, sgid only when group exec
253 bit is set)
254 • XFS - standard behavior in XFS on Linux (like EXT but directories
256 are changed by unprivileged users)
257 SMODE extra info:
259 btrfs,ext2,ext3,ext4,hfs[+],jfs,ntfs and reiserfs on Linux work as EXT.
261 Only xfs on Linux works a little different. Beware that there is a
263 strange operation - chown(-1,-1) which is usually converted by a kernel
264 into something like chmod ug-s, and therefore can’t be controlled by
265 MFS as chown
266
268 Report bugs to <contact@lizardfs.org>.
269
271 Copyright 2008-2009 Gemius SA, 2013-2015 Skytechnology sp. z o.o.
272 LizardFS is free software: you can redistribute it and/or modify it
274 under the terms of the GNU General Public License as published by the
275 Free Software Foundation, version 3.
276 LizardFS is distributed in the hope that it will be useful, but WITHOUT
278 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
279 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
280 for more details.
281 You should have received a copy of the GNU General Public License along
283 with LizardFS. If not, see http://www.gnu.org/licenses/.
284
286 mfsmaster(8), mfstools(1), moosefs(7), mount(8)
287 07/20/2023 MFSMOUNT(1)