xref: /freebsd/share/man/man5/ext2fs.5 (revision c697fb7f)
1.\"
2.\" Copyright (c) 2006 Craig Rodrigues
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. The name of the author may not be used to endorse or promote products
14.\"    derived from this software without specific prior written permission
15.\"
16.\" THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd December 30, 2018
30.Dt EXT2FS 5
31.Os
32.Sh NAME
33.Nm ext2fs
34.Nd "ext2/ext3/ext4 file system"
35.Sh SYNOPSIS
36To link into the kernel:
37.Bd -ragged -offset indent
38.Cd "options EXT2FS"
39.Ed
40.Pp
41To load as a kernel loadable module:
42.Pp
43.Dl "kldload ext2fs"
44.Sh DESCRIPTION
45The
46.Nm
47driver will permit the
48.Fx
49kernel to access
50ext2
51file systems and its derivatives.
52It currently implements most of the features required by
53.Em ext3
54and
55.Em ext4
56file systems.
57Support for Extended Attributes in
58.Em ext4
59is experimental.
60Journalling and encryption are currently not supported.
61.Sh EXAMPLES
62To mount a
63.Nm
64volume located on
65.Pa /dev/ada1s1 :
66.Pp
67.Dl "mount -t ext2fs /dev/ada1s1 /mnt"
68.Sh SEE ALSO
69.Xr nmount 2 ,
70.Xr unmount 2 ,
71.Xr fstab 5 ,
72.Xr mount 8
73.Sh HISTORY
74The
75.Nm
76driver first appeared in
77.Fx 2.2 .
78.Sh AUTHORS
79.An -nosplit
80The
81.Nm
82kernel implementation is derived from code written,
83or modified,
84by
85.An Godmar Back
86using the UFS CSRG sources for CMU Mach.
87.Pp
88.An John Dyson
89did the initial port to
90.Fx .
91.An Aditya Sarawgi
92merged important parts of the allocation code from a clean-room
93.Nx
94implementation.
95.An Zheng Liu
96and
97.An Fedor Upurov
98implemented the read and write support respectively for
99.Em ext4
100filesystems.
101The
102.Fx
103community has contributed a huge amount of modifications.
104.Pp
105The initial version of this manual page was written by
106.An Craig Rodrigues Aq Mt rodrigc@FreeBSD.org .
107