From aeb604418f6dc97e779861b1a0950f25a791c2da Mon Sep 17 00:00:00 2001
From: Gavin Atkinson <gavin@FreeBSD.org>
Date: Wed, 1 Feb 2012 22:44:40 +0000
Subject: [PATCH] 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)
---
 .../books/handbook/filesystems/chapter.sgml   | 88 +++++++++++++++++++
 1 file changed, 88 insertions(+)

diff --git a/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml b/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml
index b9cf0c9fb5..ffe7e4f77e 100644
--- a/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/filesystems/chapter.sgml
@@ -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,