.\" -*- nroff -*-
.\" Copyright 1993, 1994, 1995 by Theodore Ts'o.  All Rights Reserved.
.\" This file may be copied under the terms of the GNU Public License.
.\"
.TH FUSE2FS 1 "March 2025" "E2fsprogs version 1.47.4"
.SH NAME
fuse2fs \- FUSE file system client for ext2/ext3/ext4 file systems
.SH SYNOPSIS
.B fuse2fs
[
.B device/image
]
[
.B mountpoint
]
[
.I options
]
.SH DESCRIPTION
.B fuse2fs
is a FUSE file system client that supports reading and writing from
devices or image files containing ext2, ext3, and ext4 file systems.
.SH OPTIONS
.SS "general options:"
.TP
\fB\-o\fR opt,[opt...]
mount options
.TP
\fB\-h\fR   \fB\-\-help\fR
print help
.TP
\fB\-V\fR   \fB\-\-version\fR
print version
.SS "fuse2fs options:"
.TP
\fB-o\fR ro
read-only mount
.TP
\fB-o\fR rw
read-write mount (default)
.TP
\fB-o\fR bsddf
bsd-style df (default)
.TP
\fB-o\fR minixdf
minix-style df
.TP
\fB-o\fR acl
enable file access control lists
.TP
\fB-o\fR cache_size
Set the disk cache size to this quantity.
The quantity may contain the suffixes k, m, or g.
By default, the size is 32MB.
The size may not be larger than 2GB.
.TP
\fB-o\fR direct
Use O_DIRECT to access the block device.
.TP
\fB-o\fR errors=panic
dump core on error
.TP
\fB-o\fR fakeroot
pretend to be root for permission checks
.TP
\fB-o\fR fuse2fs_debug
enable fuse2fs debugging
.TP
\fB-o\fR kernel
Behave more like the kernel ext4 driver in the following ways:
Allows processes owned by other users to access the filesystem.
Uses the kernel's permissions checking logic instead of fuse2fs's.
Enables setuid and device files.
Note that these options can still be overridden (e.g.
.I nosuid
) later.
.TP
\fB-o\fR lockfile=path
use this file to control access to the filesystem
.TP
\fB-o\fR no_default_opts
do not include default fuse options
.TP
\fB-o\fR norecovery
do not replay the journal and mount the file system read-only
.SS "FUSE options:"
.TP
\fB-d -o\fR debug
enable debug output (implies -f)
.TP
\fB-f\fR
foreground operation
.TP
\fB-s\fR
disable multi-threaded operation
.P
For other FUSE options please see
.BR mount.fuse (8)
or see the output of
.I fuse2fs \-\-helpfull
.SH AVAILABILITY
.B fuse2fs
is part of the e2fsprogs package and is available from
http://e2fsprogs.sourceforge.net.
.SH SEE ALSO
.BR ext4 (5)
.BR e2fsck (8),
.BR mount.fuse (8)