1MFSMOUNT(1)                                                        MFSMOUNT(1)
2
3
4

NAME

6       mfsmount - mount Lizard File System
7

SYNOPSIS

9       mfsmount mountpoint [-d] [-f] [-s] [-m] [-n] [-p]
10                [-H HOST] [-P PORT] [-S PATH] [-o opt[,opt]...]
11
12       mfsmount -h|--help
13
14       mfsmount -V|--version
15

DESCRIPTION

17       Mount Lizard File System.
18
19       General options:
20
21       -h, --help
22           display help and exit
23
24       -V
25           display version information and exit
26
27       FUSE options:
28
29       -d, -o debug
30           enable debug mode (implies -f)
31
32       -f
33           foreground operation
34
35       -s
36           disable multi-threaded operation
37
38       LizardFS options:
39
40       -c CFGFILE, -o mfscfgfile=CFGFILE
41           loads file with additional mount options
42
43       -m, --meta, -o mfsmeta
44           mount MFSMETA companion filesystem instead of primary LizardFS
45
46       -n
47           omit default mount options (-o allow_other,default_permissions)
48
49       -p, -o askpassword
50           prompt for password (interactive version of -o mfspassword=PASS)
51
52       -H HOST, -o mfsmaster=HOST
53           connect with LizardFS master on HOST (default is mfsmaster)
54
55       -P PORT, -o mfsport=PORT
56           connect with LizardFS master on PORT (default is 9421)
57
58       -B HOST, -o mfsbind=HOST
59           local address to use for connecting with master instead of default
60           one
61
62       -S PATH, -o mfssubfolder=PATH
63           mount specified LizardFS directory (default is /, i.e. whole
64           filesystem)
65
66       -o enablefilelocks=[0,1]
67           enables/disables global file locking (disabled by default)
68
69       -o mfspassword=PASSWORD
70           authenticate to LizardFS master with PASSWORD
71
72       -o mfsmd5pass=MD5
73           authenticate to LizardFS master using directly given MD5 (only if
74           mfspassword option is not specified)
75
76       -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
81       -o mfsacl
82           enable ACL support (disabled by default)
83
84       -o mfsaclcacheto=SEC
85           set ACL cache timeout in seconds (default: 1.0)
86
87       -o mfsaclcachesize=N
88           define ACL cache size in number of entries (0: no cache; default:
89           1000)
90
91       -o mfsrwlock=0|1
92           when set to 1, parallel reads from the same descriptor are
93           performed (default: 1)
94
95       -o mfsmkdircopysgid=N
96           sgid bit should be copied during mkdir operation (on linux default:
97           1, otherwise: 0)
98
99       -o mfssugidclearmode=SMODE
100           set sugid clear mode (see below)
101
102       -o mfsdebug
103           print some LizardFS-specific debugging information
104
105       -o mfscachemode=CACHEMODE
106           set cache mode (see DATA CACHE MODES; default is AUTO)
107
108       -o mfscachefiles
109           (deprecated) preserve file data in cache (equivalent to -o
110           mfscachemode=YES)
111
112       -o mfsattrcacheto=SEC
113           set attributes cache timeout in seconds (default: 1.0)
114
115       -o mfsentrycacheto=SEC
116           set file entry cache timeout in seconds (default: 0.0, i.e. no
117           cache)
118
119       -o mfsdirentrycacheto=SEC
120           set directory entry cache timeout in seconds (default: 1.0)
121
122       -o mfswritecachesize=N
123           specify write cache size in MiB (in range: 16..2048 - default: 128)
124
125       -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
132       -o mfschunkserverreadto=MSEC
133           set timeout for whole communication with a chunkserver during read
134           operation in milliseconds (default: 2000)
135
136       -o mfschunkserverwriteto=MSEC
137           set chunkserver response timeout during write operation in
138           milliseconds (default: 5000)
139
140       -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
144       -o mfschunkserverconnectreadto=MSEC
145           set timeout for connecting with chunkservers during read operation
146           in milliseconds (default: 2000)
147
148       -o mfschunkserverwavereadto=MSEC
149           set timeout for executing each wave of a read operation in
150           milliseconds (default: 500)
151
152       -o mfschunkservertotalreadto=MSEC
153           set timeout for the whole communication with chunkservers during a
154           read operation in milliseconds (default: 2000)
155
156       -o cacheexpirationtime=MSEC
157           set timeout for read cache entries to be considered valid in
158           milliseconds (0 disables cache) (default: 300)
159
160       -o readaheadmaxwindowsize=KB
161           set max value of readahead window per single descriptor in
162           kibibytes (default: 16384)
163
164       -o mfsrlimitnofile=N
165           try to change limit of simultaneously opened file descriptors on
166           startup (default: 100000)
167
168       -o mfsnice=LEVEL
169           try to change nice level to specified value on startup (default:
170           -19)
171
172       -o mfswriteworkers=N
173           define number of write workers (default: 10)
174
175       -o mfswritewindowsize=N
176           define write window size (in blocks) for each chunk (default: 15)
177
178       -o mfsmemlock
179           try to lock memory (must be enabled at build time)
180
181       -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
185       -o mfsioretries=N
186           specify number of retries before I/O error is returned (default:
187           30)
188
189       -o mfsreportreservedperiod=N
190           specify interval of reporting reserved inodes in seconds (default:
191           60)
192
193       -o mfsiolimits=PATH
194           specify local I/O limiting configuration file (default: no I/O
195           limiting)
196
197       General mount options (see mount(8) manual):
198
199       -o rw|-o ro
200           Mount file-system in read-write (default) or read-only mode
201           respectively.
202
203       -o suid|-o nosuid
204           Enable or disable suid/sgid attributes to work.
205
206       -o dev|-o nodev
207           Enable or disable character or block special device files
208           interpretation.
209
210       -o exec|-o noexec
211           Allow or disallow execution of binaries.
212
213       -o symlinkcachetimeout=N
214           Set timeout value for symlink cache timeout in seconds. Default
215           value is 3600.
216
217       -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

DATA CACHE MODES

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
227       NO,NONE or NEVER
228           never allow files data to be kept in cache (safest but can reduce
229           efficiency)
230
231       YES or ALWAYS
232           always allow files data to be kept in cache (dangerous)
233
234       AUTO
235           file cache is managed by mfsmaster automatically (should be very
236           safe and efficient)
237

SUGID CLEAR MODE

239       SMODE can be set to:
240
241NEVER - MFS will not change suid and sgid bit on chown
242
243ALWAYS - clear suid and sgid on every chown - safest operation
244
245OSX - standard behavior in OS X and Solaris (chown made by
246           unprivileged user clear suid and sgid)
247
248BSD - standard behavior in BSD systems (like in OSX, but only when
249           something is really changed)
250
251EXT - 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
255XFS - standard behavior in XFS on Linux (like EXT but directories
256           are changed by unprivileged users)
257
258       SMODE extra info:
259
260       btrfs,ext2,ext3,ext4,hfs[+],jfs,ntfs and reiserfs on Linux work as EXT.
261
262       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

REPORTING BUGS

268       Report bugs to <contact@lizardfs.org>.
269
271       Copyright 2008-2009 Gemius SA, 2013-2015 Skytechnology sp. z o.o.
272
273       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
277       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
282       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

SEE ALSO

286       mfsmaster(8), mfstools(1), moosefs(7), mount(8)
287
288
289
290                                  01/26/2021                       MFSMOUNT(1)
Impressum