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
This commit is contained in:
Dru Lavigne 2014-04-24 17:38:46 +00:00
parent d6ab797f42
commit 79760f32f0
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44645

View file

@ -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>
@ -32,28 +33,18 @@
system.</para>
</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>
</listitem>
<listitem>
<para>How to use quotas to limit disk space usage.</para>
</listitem>
<listitem>
<para>How to encrypt disks to secure them against
attackers.</para>
</listitem>
<listitem>
<para>How to create and burn <acronym>CD</acronym>s and
<acronym>DVD</acronym>s on &os;.</para>
<para>How to use <acronym>CD</acronym> and
<acronym>DVD</acronym> media on a &os; system.</para>
</listitem>
<listitem>
@ -61,10 +52,28 @@
&os;.</para>
</listitem>
<listitem>
<para>How to set up memory
disks.</para>
</listitem>
<listitem>
<para>What file system snapshots are and how to use them
efficiently.</para>
</listitem>
<listitem>
<para>How to use quotas to limit disk space usage.</para>
</listitem>
<listitem>
<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>
<para>Before reading this chapter, you should:</para>
@ -626,7 +635,7 @@ da0: &lt;STECH Simple Drive 1.04&gt; s/n WD-WXE508CAN263 detached
<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 Mounted on
&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 Mounted on
/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">