Mention support of three filesystems generally encountered on Linux

systems: ext2fs, reiserfs and xfs.

This work was done by Isabell Long as part of Google Code-In (GCIN) 2011.

Submitted by:		Isabell Long (isabell121 gmail com)
Minor changes by:	me
Approved by:		bcr (mentor)
This commit is contained in:
Gavin Atkinson 2012-02-01 22:44:40 +00:00
parent 7a4d1b0458
commit aeb604418f
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=38363

View file

@ -747,6 +747,94 @@ errors: No known data errors</screen>
</sect2>
</sect1>
<sect1 id="filesystems-linux">
<title>&linux; Filesystems</title>
<para>This section will describe some of the &linux; filesystems
supported by &os;.</para>
<sect2>
<title>Ext2FS</title>
<para>The &man.ext2fs.5; file system kernel implementation was
written by Godmar Back, and the driver first appeared in
&os; 2.2. In &os; 8 and earlier, the code is licensed under
the <acronym>GNU</acronym> Public License, however under &os; 9,
the code has been rewritten and it is now licensed under the
<acronym>BSD</acronym> license.</para>
<para>The &man.ext2fs.5; driver will allow the &os; kernel
to both read and write to <acronym>ext2</acronym> file systems.</para>
<para>First, load the kernel loadable module:</para>
<screen>kldload ext2fs</screen>
<para>Then, to mount an &man.ext2fs.5; volume located on
<filename>/dev/ad1s1</filename>:</para>
<screen><userinput>mount -t ext2fs /dev/ad1s1 /mnt</userinput></screen>
</sect2>
<sect2>
<title>XFS</title>
<para>The X file system, <acronym>XFS</acronym>, was originally
written by <acronym>SGI</acronym> for the
<acronym>IRIX</acronym> operating system, and they ported it
to &linux;. The source code has been released under the
<acronym>GNU</acronym> Public License. See
<ulink url="http://oss.sgi.com/projects/xfs">this page</ulink>
for more details. The &os; port was started by Russel
Cattelan, &a.kan;, and &a.rodrigc;.</para>
<para>To load <acronym>XFS</acronym> as a kernel-loadable
module:</para>
<screen>kldload xfs</screen>
<para>The &man.xfs.5; driver lets the &os; kernel access
XFS filesystems. However, at present only read-only
access is supported. Writing to a volume is not
possible.</para>
<para>To mount a &man.xfs.5; volume located on
<filename>/dev/ad1s1</filename>, do the following:</para>
<screen><userinput>mount -t xfs /dev/as1s1 /mnt</userinput></screen>
<para>Also useful to note is that the
<filename role="package">sysutils/xfsprogs</filename> port
contains the <command>mkfs.xfs</command> utility which enables
creation of <acronym>XFS</acronym> filesystems, plus utilities
for analysing and repairing them.</para>
<para>The <literal>-p</literal> flag to
<command>mkfs.xfs</command> can be used to create an
&man.xfs.5; filesystem which is populated with files and other
metadata. This can be used to quickly create a read-only
filesystem which can be tested on &os;.</para>
</sect2>
<sect2>
<title>ReiserFS</title>
<para>The Reiser file system, ReiserFS, was ported to
&os; by &a.dumbbell;, and has been released under the
<acronym>GNU</acronym> Public License.</para>
<para>The ReiserFS driver will permit the &os; kernel to
access ReiserFS file systems and read their contents, but not
write to them, currently.</para>
<para>First, the kernel-loadable module needs to be loaded:</para>
<screen>kldload reiserfs</screen>
<para>Then, to mount a ReiserFS volume located on
<filename>/dev/ad1s1</filename>:
<screen><userinput>mount -t reiserfs /dev/ad1s1 /mnt</userinput></screen>
</sect2>
</sect1>
<!--
XXXTR: stub sections (added later, as needed, as desire,