Mount options
leil-mount is the native LeilFS client. It uses FUSE3 to present the filesystem as a standard POSIX directory. This page lists its options; for a first mount see Mounting the client.
The legacy sfsmount name is still installed as a compatibility symlink to leil-mount, but it is deprecated and will be removed in a future release. Confirm the option set on your version with man leil-mount.
Basic mounting
# Mount, giving the master host explicitly
sudo leil-mount /mnt/client -H 192.168.10.10
# Prompt for a password (export protected with password=)
sudo leil-mount /mnt/client -H 192.168.10.10 -p
# Mount a subdirectory of the namespace
sudo leil-mount /mnt/client -H 192.168.10.10 -S /projects/teamA
| Flag | Meaning |
|---|---|
-H HOST | Master host to connect to |
-P PORT | Master port (default 9421) |
-S PATH | Mount this subdirectory of the LeilFS namespace |
-p | Prompt for the export password interactively |
-o options
| Option | Meaning | Default |
|---|---|---|
sfsmaster=HOST | Master host (alternative to -H) | — |
sfsport=PORT | Master port (alternative to -P) | 9421 |
sfsbind=HOST | Local address to bind the client socket to | — |
sfssubfolder=PATH | Mount this subdirectory (alternative to -S) | / |
sfspassword=PASS | Export password (non‑interactive) | — |
sfsmd5pass=MD5 | Export password as an MD5 hash | — |
sfsdonotrememberpassword | Do not cache the password in memory | — |
sfsdelayedinit | Connect to the master in the background | — |
sfscachemode=MODE | Data cache mode: NO, YES, AUTO | AUTO |
sfsattrcacheto=SEC | Attribute cache timeout (seconds) | 1.0 |
sfsentrycacheto=SEC | Entry cache timeout (seconds) | 0.0 |
sfsdirentrycacheto=SEC | Directory‑entry cache timeout (seconds) | 1.0 |
cacheexpirationtime=MSEC | Read‑cache validity window (ms) | 1000 |
symlinkcachetimeout=SEC | Symlink cache timeout (seconds) | 3600 |
sfswritecachesize=MIB | Write cache size (MiB, range 16–2048) | 128 |
readaheadmaxwindowsize=KB | Per‑descriptor readahead (KiB) | 16384 |
readcachemaxsizepercentage=P | Read cache as % of system memory | 60 |
sudo leil-mount /mnt/client -H 192.168.10.10 \
-o sfssubfolder=/projects,sfswritecachesize=512,sfscachemode=AUTO
See Performance tuning for which of these to change and when.
Mounting at boot with /etc/fstab
Add a line so the client mounts automatically. Use _netdev so the mount waits for the network:
# <master>:<subfolder> <mountpoint> <type> <options> 0 0
# 192.168.10.10:/ /mnt/client fuse _netdev,defaults 0 0
The exact fstab syntax (filesystem type and master/subfolder field) depends on your package version. Verify the format for your install against man leil-mount before relying on an fstab entry, and test with mount /mnt/client before rebooting.