svn commit: r44471 - in head: en_US.ISO8859-1/books/handbook/filesystems share/xml
Dru Lavigne
dru at FreeBSD.org
Mon Apr 7 16:40:16 UTC 2014
Author: dru
Date: Mon Apr 7 16:40:15 2014
New Revision: 44471
URL: http://svnweb.freebsd.org/changeset/doc/44471
Log:
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/share/xml/man-refs.ent
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>
<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>
<sect2>
<title><acronym>ext2</acronym></title>
- <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>
licensed.</para>
<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>
</sect2>
<sect2>
<title>XFS</title>
- <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="http://oss.sgi.com/projects/xfs">this page</link>
- for more details. The &os; port was started by Russel
- Cattelan, &a.kan.email;, and &a.rodrigc.email;.</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
<filename>/dev/ad1s1</filename>:</para>
- <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>
</sect2>
<sect2>
<title>ReiserFS</title>
- <para>The Reiser file system, ReiserFS, was ported to
- &os; by &a.dumbbell.email;, 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
<filename>/dev/ad1s1</filename>:</para>
- <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>
</sect2>
</sect1>
<!--
- 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.
-
<sect1>
<title>Device File System</title>
</sect1>
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='http://docbook.org/ns/docbook'><refentrytitle>ranlib</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
<!ENTITY man.rc.conf.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>rc.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
<!ENTITY man.rcsfile.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>rcsfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
+<!ENTITY man.reiserfs.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>reiserfs</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
<!ENTITY man.remote.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>remote</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
<!ENTITY man.resolv.conf.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
<!ENTITY man.resolver.5 "<citerefentry xmlns='http://docbook.org/ns/docbook'><refentrytitle>resolver</refentrytitle><manvolnum>5</manvolnum></citerefentry>">
More information about the svn-doc-head
mailing list