svn commit: r44645 - head/en_US.ISO8859-1/books/handbook/disks
Dru Lavigne
dru at FreeBSD.org
Thu Apr 24 17:38:47 UTC 2014
Author: dru
Date: Thu Apr 24 17:38:46 2014
New Revision: 44645
URL: http://svnweb.freebsd.org/changeset/doc/44645
Log:
Rename chapter to Memory Disks as NFS is mentioned, but not covered, and
vnconfig was deprecated in 5.0.
Adjust Synopsis to match topics covered in Disks chapter.
Next commit will add an intro and do a tech review of Memory Disks chapter.
Sponsored by: iXsystems
Modified:
head/en_US.ISO8859-1/books/handbook/disks/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Thu Apr 24 15:32:08 2014 (r44644)
+++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Thu Apr 24 17:38:46 2014 (r44645)
@@ -14,10 +14,11 @@
<sect1 xml:id="disks-synopsis">
<title>Synopsis</title>
- <para>This chapter covers the use of disks in &os;. This includes
- memory-backed disks, network-attached disks, standard SCSI/IDE
- storage devices, and devices using the <acronym>USB</acronym>
- interface.</para>
+ <para>This chapter covers the use of disks and storage media in
+ &os;. This includes <acronym>SCSI</acronym> and
+ <acronym>IDE</acronym> disks, <acronym>CD</acronym> and
+ <acronym>DVD</acronym> media, memory-backed disks, and
+ <acronym>USB</acronym> storage devices.</para>
<para>After reading this chapter, you will know:</para>
@@ -33,37 +34,45 @@
</listitem>
<listitem>
+ <para>How to grow the size of a disk's partition on &os;.</para>
+ </listitem>
+
+ <listitem>
<para>How to configure &os; to use <acronym>USB</acronym>
storage devices.</para>
</listitem>
<listitem>
- <para>How to set up virtual file systems, such as memory
- disks.</para>
+ <para>How to use <acronym>CD</acronym> and
+ <acronym>DVD</acronym> media on a &os; system.</para>
</listitem>
<listitem>
- <para>How to use quotas to limit disk space usage.</para>
+ <para>How to use the backup programs available under
+ &os;.</para>
</listitem>
<listitem>
- <para>How to encrypt disks to secure them against
- attackers.</para>
+ <para>How to set up memory
+ disks.</para>
</listitem>
<listitem>
- <para>How to create and burn <acronym>CD</acronym>s and
- <acronym>DVD</acronym>s on &os;.</para>
+ <para>What file system snapshots are and how to use them
+ efficiently.</para>
</listitem>
<listitem>
- <para>How to use the backup programs available under
- &os;.</para>
+ <para>How to use quotas to limit disk space usage.</para>
</listitem>
<listitem>
- <para>What file system snapshots are and how to use them
- efficiently.</para>
+ <para>How to encrypt disks and swap to secure them against
+ attackers.</para>
+ </listitem>
+
+ <listitem>
+ <para>How to configure a highly available storage network.</para>
</listitem>
</itemizedlist>
@@ -626,7 +635,7 @@ da0: <STECH Simple Drive 1.04> s/n
<secondary>creating</secondary>
</indexterm>
- <para><acronym>CD</acronym> media provide a number of features
+ <para>Compact Disc (<acronym>CD</acronym>) media provide a number of features
that differentiate them from conventional disks. They are
designed so that they can be read continuously without delays to
move the head between tracks. While <acronym>CD</acronym> media
@@ -1966,7 +1975,7 @@ scsibus1:
<sect1 xml:id="disks-virtual">
<info>
- <title>Network, Memory, and File-Backed File Systems</title>
+ <title>Memory Disks</title>
<authorgroup>
<author>
@@ -1979,36 +1988,16 @@ scsibus1:
</authorgroup>
</info>
- <indexterm><primary>virtual disks</primary></indexterm>
- <indexterm>
- <primary>disks</primary>
- <secondary>virtual</secondary>
- </indexterm>
+ <para>In addition to physical disks, &os; also supports
+ the creation and use of memory disks.</para>
- <para>In addition to physical disks such as floppies,
- <acronym>CD</acronym>s, and hard drives, &os; also supports
- <firstterm>virtual disks</firstterm>.</para>
-
- <indexterm><primary>NFS</primary></indexterm>
<indexterm>
<primary>disks</primary>
<secondary>memory</secondary>
</indexterm>
- <para>These include network file systems such as the <link
- linkend="network-nfs">Network File System</link>,
- memory-based file systems, and file-backed file systems.</para>
-
- <para>According to the &os; version, the tools used for the
- creation and use of file-backed and memory-based file systems
- differ.</para>
-
- <note>
- <para>Use &man.devfs.5; to allocate device nodes transparently
- for the user.</para>
- </note>
<sect2 xml:id="disks-mdconfig">
- <title>File-Backed File System</title>
+ <title>Attaching and Detaching Existing Images</title>
<indexterm>
<primary>disks</primary>
@@ -2034,7 +2023,7 @@ scsibus1:
<title>Using <command>mdconfig</command> to Mount an Existing
File System Image</title>
- <screen>&prompt.root; <userinput>mdconfig -a -t vnode -f <replaceable>diskimage</replaceable> -u <replaceable>0</replaceable></userinput>
+ <screen>&prompt.root; <userinput>mdconfig -f <replaceable>diskimage.iso</replaceable> -u <replaceable>0</replaceable></userinput>
&prompt.root; <userinput>mount /dev/md<replaceable>0</replaceable> <replaceable>/mnt</replaceable></userinput></screen>
</example>
@@ -2093,10 +2082,30 @@ Filesystem 1K-blocks Used Avail Capacity
&man.mdmfs.8; uses the &man.md.4; auto-unit feature to
automatically select an unused device. For more details
about &man.mdmfs.8;, refer to its manual page.</para>
+
+ <indexterm>
+ <primary>disks</primary>
+ <secondary>detaching a memory disk</secondary>
+ </indexterm>
+
+ <para>When a memory-based or file-based file system is no
+ longer in use, its resources should be released back to
+ the system. First, unmount the file system, then use
+ &man.mdconfig.8; to detach the disk from the system and
+ release the resources.</para>
+
+ <para>For example, to detach and free all resources used by
+ <filename>/dev/md4</filename>:</para>
+
+ <screen>&prompt.root; <userinput>mdconfig -d -u <replaceable>4</replaceable></userinput></screen>
+
+ <para>It is possible to list information about configured
+ &man.md.4; devices by running
+ <command>mdconfig -l</command>.</para>
</sect2>
<sect2 xml:id="disks-md-freebsd5">
- <title>Memory-Based File System</title>
+ <title>Creating a Memory Disk</title>
<indexterm>
<primary>disks</primary>
@@ -2140,30 +2149,6 @@ Filesystem 1K-blocks Used Avail Capacity
/dev/md2 4846 2 4458 0% /mnt</screen>
</example>
</sect2>
-
- <sect2>
- <title>Detaching a Memory Disk from the System</title>
-
- <indexterm>
- <primary>disks</primary>
- <secondary>detaching a memory disk</secondary>
- </indexterm>
-
- <para>When a memory-based or file-based file system is no
- longer in use, its resources should be released back to
- the system. First, unmount the file system, then use
- &man.mdconfig.8; to detach the disk from the system and
- release the resources.</para>
-
- <para>For example, to detach and free all resources used by
- <filename>/dev/md4</filename>:</para>
-
- <screen>&prompt.root; <userinput>mdconfig -d -u <replaceable>4</replaceable></userinput></screen>
-
- <para>It is possible to list information about configured
- &man.md.4; devices by running
- <command>mdconfig -l</command>.</para>
- </sect2>
</sect1>
<sect1 xml:id="snapshots">
More information about the svn-doc-head
mailing list