svn commit: r44471 - in head: en_US.ISO8859-1/books/handbook/filesystems share/xml

Dru Lavigne dru at
Mon Apr 7 16:40:16 UTC 2014

Author: dru
Date: Mon Apr  7 16:40:15 2014
New Revision: 44471

  Add entity for reiserfs(5).
  Fix filesystems to file systems.
  Editorial review of Linux File Systems.
  Sponsored by:	iXsystems


Modified: head/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml
--- head/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml	Mon Apr  7 16:35:40 2014	(r44470)
+++ head/en_US.ISO8859-1/books/handbook/filesystems/chapter.xml	Mon Apr  7 16:40:15 2014	(r44471)
@@ -552,7 +552,7 @@ errors: No known data errors</screen>
 	<para>Quotas limit the amount of space that a dataset and its
 	  descendants can consume, and enforce a limit on the amount
-	  of space used by filesystems and snapshots for the
+	  of space used by file systems and snapshots for the
 	  descendants.  Quotas are useful to limit the amount of space
 	  a particular user can use.</para>
@@ -648,7 +648,7 @@ errors: No known data errors</screen>
 	  quotas for all groups.</para>
 	<para>To display the amount of space consumed by each user on
-	  the specified filesystem or snapshot, along with any
+	  the specified file system or snapshot, along with any
 	  specified quotas, use <command>zfs userspace</command>.
 	  For group information, use <command>zfs
 	    groupspace</command>.  For more information about
@@ -721,15 +721,16 @@ errors: No known data errors</screen>
   <sect1 xml:id="filesystems-linux">
-    <title>&linux; Filesystems</title>
+    <title>&linux; File Systems</title>
-    <para>This section describes some of the &linux; filesystems
-      supported by &os;.</para>
+    <para>&os; provides built-in support for several &linux; file
+      systems.  This section demonstrates how to load support for and
+      how to mount the supported &linux; file systems.</para>
-      <para>The &man.ext2fs.5; file system kernel implementation has
+      <para>Kernel support for ext2 file systems has
 	been available since &os; 2.2.  In &os; 8.x and
 	earlier, the code is licensed under the
 	<acronym>GPL</acronym>.  Since &os; 9.0, the code has
@@ -737,85 +738,70 @@ errors: No known data errors</screen>
       <para>The &man.ext2fs.5; driver allows the &os; kernel to both
-	read and write to <acronym>ext2</acronym> file systems.</para>
+	read and write to ext2 file systems.</para>
-      <para>To access an <acronym>ext2</acronym> file system, first
+      <note>
+	<para>
+	  This driver can also be used to access ext3 and ext4 file
+	  systems.  However, ext3 journaling, extended attributes, and
+	  inodes greater than 128-bytes are not supported.  Support
+	  for ext4 is read-only.</para>
+      </note>
+      <para>To access an ext file system, first
 	load the kernel loadable module:</para>
       <screen>&prompt.root; <userinput>kldload ext2fs</userinput></screen>
-      <para>Then, to mount an &man.ext2fs.5; volume located on
-	<filename>/dev/ad1s1</filename>:</para>
+      <para>Then, mount the ext volume by specifying its &os;
+	partition name and an existing mount point.  This example
+	mounts <filename>/dev/ad1s1</filename> on
+	<filename>/mnt</filename>:</para>
-      <screen>&prompt.root; <userinput>mount -t ext2fs /dev/ad1s1 /mnt</userinput></screen>
+      <screen>&prompt.root; <userinput>mount -t ext2fs <replaceable>/dev/ad1s1</replaceable> <replaceable>/mnt</replaceable></userinput></screen>
-      <para><acronym>XFS</acronym> was originally written by
-	<acronym>SGI</acronym> for the <acronym>IRIX</acronym>
-	operating system and was then ported to &linux; and
-	released under the <acronym>GPL</acronym>.  See
-	<link xlink:href="">this page</link>
-	for more details.  The &os; port was started by Russel
-	Cattelan, &;, and &;.</para>
+      <para>&os; provides read-only support for <acronym>XFS</acronym>
+	file systems.</para>
-      <para>To load <acronym>XFS</acronym> as a kernel-loadable
-	module:</para>
+      <para>To load the &man.xfs.5; driver:</para>
       <screen>&prompt.root; <userinput>kldload xfs</userinput></screen>
-      <para>The &man.xfs.5; driver lets the &os; kernel access XFS
-	filesystems.  However, only read-only access is supported and
-	writing to a volume is not possible.</para>
-      <para>To mount a &man.xfs.5; volume located on
+      <para>To mount an <acronym>XFS</acronym> volume located on
-      <screen>&prompt.root; <userinput>mount -t xfs /dev/ad1s1 /mnt</userinput></screen>
+      <screen>&prompt.root; <userinput>mount -t xfs <replaceable>/dev/ad1s1</replaceable> <replaceable>/mnt</replaceable></userinput></screen>
-      <para>The <package>sysutils/xfsprogs</package>
-	port includes the <command>mkfs.xfs</command> which enables
-	the creation of <acronym>XFS</acronym> filesystems, plus
-	utilities for analyzing 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>
+      <para>The <package>sysutils/xfsprogs</package> package or
+	port includes <command>mkfs.xfs</command>, which enables
+	the creation of read-only <acronym>XFS</acronym> file systems
+	for testing purposes.  Additional
+	utilities are included for analyzing and repairing
+	<acronym>XFS</acronym> file systems.</para>
-      <para>The Reiser file system, ReiserFS, was ported to
-	&os; by &;, and has been released under the
-	<acronym>GPL</acronym> .</para>
-      <para>The ReiserFS driver permits the &os; kernel to access
-	ReiserFS file systems and read their contents, but not
-	write to them.</para>
+      <para>&os; provides read-only support for The Reiser file
+	system, ReiserFS.</para>
-      <para>First, the kernel-loadable module needs to be
-	loaded:</para>
+      <para>To load the &man.reiserfs.5; driver:</para>
       <screen>&prompt.root; <userinput>kldload reiserfs</userinput></screen>
       <para>Then, to mount a ReiserFS volume located on
-      <screen>&prompt.root; <userinput>mount -t reiserfs /dev/ad1s1 /mnt</userinput></screen>
+      <screen>&prompt.root; <userinput>mount -t reiserfs <replaceable>/dev/ad1s1</replaceable> <replaceable>/mnt</replaceable></userinput></screen>
-      XXXTR: stub sections (added later, as needed, as desire,
-      after I get opinions from -doc people):
-      Still need to discuss native and foreign file systems.
     <title>Device File System</title>

Modified: head/share/xml/man-refs.ent
--- head/share/xml/man-refs.ent	Mon Apr  7 16:35:40 2014	(r44470)
+++ head/share/xml/man-refs.ent	Mon Apr  7 16:40:15 2014	(r44471)
@@ -4115,6 +4115,7 @@
 <!ENTITY man.ranlib.5 "<citerefentry xmlns=''><refentrytitle>ranlib</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
 <!ENTITY man.rc.conf.5 "<citerefentry xmlns=''><refentrytitle>rc.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
 <!ENTITY man.rcsfile.5 "<citerefentry xmlns=''><refentrytitle>rcsfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
+<!ENTITY man.reiserfs.5 "<citerefentry xmlns=''><refentrytitle>reiserfs</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
 <!ENTITY man.remote.5 "<citerefentry xmlns=''><refentrytitle>remote</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
 <!ENTITY man.resolv.conf.5 "<citerefentry xmlns=''><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
 <!ENTITY man.resolver.5 "<citerefentry xmlns=''><refentrytitle>resolver</refentrytitle><manvolnum>5</manvolnum></citerefentry>">

More information about the svn-doc-all mailing list