GlusterFS(8)

💖 GlusterFS — clustered file system 💖

okay bestie, sit DOWN, because we're talking about glusterfs from the GlusterFS(8) manual — she's a whole icon and I'm obsessed 💅

---

✨ SYNOPSIS ✨

glusterfs [options] [mountpoint]

---

🦋 DESCRIPTION 🦋

GlusterFS is a clustered file system, and no cap, she scales to several peta-bytes. Like… peta. Bytes. She takes your various storage bricks over Infiniband RDMA or TCP/IP, interconnects them, and turns them into one big parallel network file system. main character energy fr fr 👑

The storage bricks themselves? Literally anything, bestie — any commodity hardware works, like an x86-64 server with SATA-II RAID and an Infiniband HBA. Budget queen behavior 💖

GlusterFS is a fully POSIX compliant file system. On the client side she depends on the FUSE package, and on the server side she works seamlessly across different operating systems. Right now she's supported on GNU/Linux and Solaris. Periodt.

---

💅 OPTIONS 💅

🌸 Basic options 🌸

• -f, --volfile=VOLUME-FILE — the file you want to use as VOLUME-FILE. that's the one, bestie.
• -l, --log-file=LOGFILE — the file to use for logging. the default is <INSTALL-DIR>/var/log/glusterfs/<MOUNT-POINT>.log 🍓
• -L, --log-level=LOGLEVEL — how loud do we wanna be? valid options are TRACE, DEBUG, INFO, WARNING, ERROR and CRITICAL (the default is INFO).
• -s, --volfile-server=SERVER — the server to get the volume from. heads up: this option overrides the --volfile option, so she wins the argument, always 💀
• --volfile-max-fetch-attempts=MAX-ATTEMPTS — max number of connect attempts to the server. this one should be provided together with the --volfile-server option (the default is 1).

---

🎀 Advanced options 🎀

• --acl — mount the filesystem with POSIX ACL support.
• --localtime-logging — enable localtime log timestamps ⏰
• --debug — run in debug mode. this one sets --no-daemon, sets --log-level to DEBUG, and sets --log-file to console. a whole glow-up bundle 💖
• --enable-ino32=BOOL — use 32-bit inodes when mounting, as a workaround for applications that don't support 64-bit inodes.
• --fopen-keep-cache[=BOOL] — do not purge the cache on file open (default: false).
• --mac-compat=BOOL — provides stubs for the attributes needed for seamless operation on Macs (the default is off). bestie said cross-platform 🍎
• -N, --no-daemon — run in the foreground. she stays right here with you 🫶
• -p, --pid-file=PIDFILE — the file to use as the PID file.
• --read-only — mount the file system in 'read-only' mode. look, don't touch 🔥
• --selinux — enable SELinux label (extended attributes) support on inodes.
• -S, --socket-file=SOCKFILE — the file to use as the unix socket.
• --volfile-id=KEY — the key of the volume file to be fetched from the server.
• --volfile-server-port=PORT — port number of the volfile server.
• --volfile-server-transport=TRANSPORT — transport type to get the volume file from the server (the default is tcp).
• --volume-name=VOLUME-NAME — volume name to be used for MOUNT-POINT (the default is the top most volume in VOLUME-FILE).
• --worm — mount the filesystem in 'worm' mode 🐛
• --xlator-option=VOLUME-NAME.OPTION=VALUE — add or override a translator option for a volume with the value you specify.
• --subdir-mount=SUBDIR-MOUNT-PATH — mount a subdirectory instead of the '/' of the volume. not the whole thing, just a lil slice 🍰

---

🧚 Fuse options 🧚

• --attr-times-granularity=NANOSECONDS — declare the supported granularity of file attribute times. the default is 0, which the kernel handles as unspecified; valid real values are between 1 and 1000000000.
• --attribute-timeout=SECONDS — set the attribute timeout to SECONDS for inodes in the fuse kernel module (the default is 1).
• --background-qlen=N — set the fuse module's background queue length to N (the default is 64).
• --congestion-threshold=N — set the fuse module's congestion threshold to N (the default is 48).
• --direct-io-mode=BOOL|auto — specify the fuse direct I/O strategy (the default is auto).
• --dump-fuse=PATH — dump fuse traffic to PATH.
• --entry-timeout=SECONDS — set the entry timeout to SECONDS in the fuse kernel module (the default is 1).
• --gid-timeout=SECONDS — set the auxiliary group list timeout to SECONDS for the fuse translator (the default is 0).
• --kernel-writeback-cache=BOOL — enable the fuse in-kernel writeback cache.
• --negative-timeout=SECONDS — set the negative timeout to SECONDS in the fuse kernel module (the default is 0).
• --auto-invalidation=BOOL — controls whether fuse-kernel can auto-invalidate attribute, dentry and page-cache. ⚠️ only disable this if the same files/directories are not accessed across two different mounts concurrently [default: on].
• --volfile-check — enable strict volume file checking. she's checking everything, twice 🔍

---

🌈 Miscellaneous Options 🌈

• -?, --help — display this help.
• --usage — display a short usage message.
• -V, --version — print the program version.

---

🍓 FILES 🍓

/var/lib/glusterd/vols/*/*.vol

---

⭐ EXAMPLES ⭐

okay so, mount a volume named foo on server bar with log level DEBUG on mount point /mnt/foo — watch:

# glusterfs --log-level=DEBUG --volfile-id=foo --volfile-server=bar /mnt/foo

slay ✨

---

🔥 SEE ALSO 🔥

fusermount(1), mount.glusterfs(8), gluster(8)

iykyk, go read those next 💜

---

👑 COPYRIGHT 👑

Copyright(c) 2006-2011 Red Hat, Inc. <http://www.redhat.com>

---

and that's the whole vibe, bestie 🦋 this was the GlusterFS(8) page from Gluster Inc., dated 07 March 2011, filed under Clustered File System. go mount something iconic 💖✨💅