| 1 |
.\" -*- nroff -*- |
| 2 |
.\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. |
| 3 |
.\" This file may be copied under the terms of the GNU Public License. |
| 4 |
.\" |
| 5 |
.TH FUSE2FS 1 "July 2025" "E2fsprogs version 1.47.3" |
| 6 |
.SH NAME |
| 7 |
fuse2fs \- FUSE file system client for ext2/ext3/ext4 file systems |
| 8 |
.SH SYNOPSIS |
| 9 |
.B fuse2fs |
| 10 |
[ |
| 11 |
.B device/image |
| 12 |
] |
| 13 |
[ |
| 14 |
.B mountpoint |
| 15 |
] |
| 16 |
[ |
| 17 |
.I options |
| 18 |
] |
| 19 |
.SH DESCRIPTION |
| 20 |
.B fuse2fs |
| 21 |
is a FUSE file system client that supports reading and writing from |
| 22 |
devices or image files containing ext2, ext3, and ext4 file systems. |
| 23 |
.SH OPTIONS |
| 24 |
.SS "general options:" |
| 25 |
.TP |
| 26 |
\fB\-o\fR opt,[opt...] |
| 27 |
mount options |
| 28 |
.TP |
| 29 |
\fB\-h\fR \fB\-\-help\fR |
| 30 |
print help |
| 31 |
.TP |
| 32 |
\fB\-V\fR \fB\-\-version\fR |
| 33 |
print version |
| 34 |
.SS "fuse2fs options:" |
| 35 |
.TP |
| 36 |
\fB-o\fR ro |
| 37 |
read-only mount |
| 38 |
.TP |
| 39 |
\fB-o\fR errors=panic |
| 40 |
dump core on error |
| 41 |
.TP |
| 42 |
\fB-o\fR minixdf |
| 43 |
minix-style df |
| 44 |
.TP |
| 45 |
\fB-o\fR fakeroot |
| 46 |
pretend to be root for permission checks |
| 47 |
.TP |
| 48 |
\fB-o\fR no_default_opts |
| 49 |
do not include default fuse options |
| 50 |
.TP |
| 51 |
\fB-o\fR norecovery |
| 52 |
do not replay the journal and mount the file system read-only |
| 53 |
.TP |
| 54 |
\fB-o\fR fuse2fs_debug |
| 55 |
enable fuse2fs debugging |
| 56 |
.TP |
| 57 |
\fB-o\fR kernel |
| 58 |
Behave more like the kernel ext4 driver in the following ways: |
| 59 |
Allows processes owned by other users to access the filesystem. |
| 60 |
Uses the kernel's permissions checking logic instead of fuse2fs's. |
| 61 |
Enables setuid and device files. |
| 62 |
Note that these options can still be overridden (e.g. |
| 63 |
.I nosuid |
| 64 |
) later. |
| 65 |
.TP |
| 66 |
\fB-o\fR direct |
| 67 |
Use O_DIRECT to access the block device. |
| 68 |
.TP |
| 69 |
\fB-o\fR cache_size |
| 70 |
Set the disk cache size to this quantity. |
| 71 |
The quantity may contain the suffixes k, m, or g. |
| 72 |
By default, the size is 32MB. |
| 73 |
The size may not be larger than 2GB. |
| 74 |
.SS "FUSE options:" |
| 75 |
.TP |
| 76 |
\fB-d -o\fR debug |
| 77 |
enable debug output (implies -f) |
| 78 |
.TP |
| 79 |
\fB-f\fR |
| 80 |
foreground operation |
| 81 |
.TP |
| 82 |
\fB-s\fR |
| 83 |
disable multi-threaded operation |
| 84 |
.P |
| 85 |
For other FUSE options please see |
| 86 |
.BR mount.fuse (8) |
| 87 |
or see the output of |
| 88 |
.I fuse2fs \-\-helpfull |
| 89 |
.SH AVAILABILITY |
| 90 |
.B fuse2fs |
| 91 |
is part of the e2fsprogs package and is available from |
| 92 |
http://e2fsprogs.sourceforge.net. |
| 93 |
.SH SEE ALSO |
| 94 |
.BR ext4 (5) |
| 95 |
.BR e2fsck (8), |
| 96 |
.BR mount.fuse (8) |
| 97 |
|