From owner-svn-doc-head@FreeBSD.ORG Thu Apr 24 17:38:47 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 56122D71; Thu, 24 Apr 2014 17:38:47 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 35FED17EE; Thu, 24 Apr 2014 17:38:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3OHclqI049786; Thu, 24 Apr 2014 17:38:47 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3OHclqj049785; Thu, 24 Apr 2014 17:38:47 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404241738.s3OHclqj049785@svn.freebsd.org> From: Dru Lavigne Date: Thu, 24 Apr 2014 17:38:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44645 - head/en_US.ISO8859-1/books/handbook/disks X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 24 Apr 2014 17:38:47 -0000 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 @@ Synopsis - 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 USB - interface. + This chapter covers the use of disks and storage media in + &os;. This includes SCSI and + IDE disks, CD and + DVD media, memory-backed disks, and + USB storage devices. After reading this chapter, you will know: @@ -33,37 +34,45 @@ + How to grow the size of a disk's partition on &os;. + + + How to configure &os; to use USB storage devices. - How to set up virtual file systems, such as memory - disks. + How to use CD and + DVD media on a &os; system. - How to use quotas to limit disk space usage. + How to use the backup programs available under + &os;. - How to encrypt disks to secure them against - attackers. + How to set up memory + disks. - How to create and burn CDs and - DVDs on &os;. + What file system snapshots are and how to use them + efficiently. - How to use the backup programs available under - &os;. + How to use quotas to limit disk space usage. - What file system snapshots are and how to use them - efficiently. + How to encrypt disks and swap to secure them against + attackers. + + + + How to configure a highly available storage network. @@ -626,7 +635,7 @@ da0: <STECH Simple Drive 1.04> s/n creating - CD media provide a number of features + Compact Disc (CD) 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 CD media @@ -1966,7 +1975,7 @@ scsibus1: - Network, Memory, and File-Backed File Systems + Memory Disks @@ -1979,36 +1988,16 @@ scsibus1: - virtual disks - - disks - virtual - + In addition to physical disks, &os; also supports + the creation and use of memory disks. - In addition to physical disks such as floppies, - CDs, and hard drives, &os; also supports - virtual disks. - - NFS disks memory - These include network file systems such as the Network File System, - memory-based file systems, and file-backed file systems. - - According to the &os; version, the tools used for the - creation and use of file-backed and memory-based file systems - differ. - - - Use &man.devfs.5; to allocate device nodes transparently - for the user. - - File-Backed File System + Attaching and Detaching Existing Images disks @@ -2034,7 +2023,7 @@ scsibus1: Using <command>mdconfig</command> to Mount an Existing File System Image - &prompt.root; mdconfig -a -t vnode -f diskimage -u 0 + &prompt.root; mdconfig -f diskimage.iso -u 0 &prompt.root; mount /dev/md0 /mnt @@ -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. + + + disks + detaching a memory disk + + + 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. + + For example, to detach and free all resources used by + /dev/md4: + + &prompt.root; mdconfig -d -u 4 + + It is possible to list information about configured + &man.md.4; devices by running + mdconfig -l. - Memory-Based File System + Creating a Memory Disk disks @@ -2140,30 +2149,6 @@ Filesystem 1K-blocks Used Avail Capacity /dev/md2 4846 2 4458 0% /mnt - - - Detaching a Memory Disk from the System - - - disks - detaching a memory disk - - - 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. - - For example, to detach and free all resources used by - /dev/md4: - - &prompt.root; mdconfig -d -u 4 - - It is possible to list information about configured - &man.md.4; devices by running - mdconfig -l. -