Date: Tue, 10 Jun 2014 03:35:05 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r45040 - head/en_US.ISO8859-1/books/handbook/bsdinstall Message-ID: <201406100335.s5A3Z53X017717@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Tue Jun 10 03:35:04 2014 New Revision: 45040 URL: http://svnweb.freebsd.org/changeset/doc/45040 Log: Update the section on using dd(1) to write the USB stick. Add a note on using sync(8) on Linux, and fix some terminology. Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Tue Jun 10 03:24:13 2014 (r45039) +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Tue Jun 10 03:35:04 2014 (r45040) @@ -510,24 +510,24 @@ match exactly. If the checksums do not match, the file is corrupt and should be downloaded again.</para> - <sect3> - <title>Burning an Image File to <acronym>USB</acronym></title> + <sect3 xml:id="bsdinstall-usb"> + <title>Writing an Image File to <acronym>USB</acronym></title> - <para>Since the <filename>*.img</filename> file is an + <para>The <filename>*.img</filename> file is an <emphasis>image</emphasis> of the complete contents of a - memory stick, it <emphasis>cannot</emphasis> just be copied - to the target device. Several applications are available - for burning the <filename>*.img</filename> to a + memory stick. It <emphasis>cannot</emphasis> be copied + to the target device as a file. Several applications are available + for writing the <filename>*.img</filename> to a <acronym>USB</acronym> stick. This section describes two of these utilities.</para> <important> <para>Before proceeding, back up any important data on the - <acronym>USB</acronym> stick as this procedure will erase + <acronym>USB</acronym> stick. This procedure will erase the existing data on the stick.</para> </important> - <procedure> + <procedure xml:id="bsdinstall-usb-dd"> <title>Using <command>dd</command> to Write the Image</title> @@ -540,8 +540,8 @@ </warning> <step> - <para>The <command>dd</command> command-line utility is - included on BSD, Linux, and &macos; systems. To burn + <para>The &man.dd.1; command-line utility is + available on BSD, &linux;, and &macos; systems. To burn the image using <command>dd</command>, insert the <acronym>USB</acronym> stick and determine its device name. Then, specify the name of the downloaded @@ -553,11 +553,13 @@ <screen>&prompt.root; <userinput>dd if=<replaceable>FreeBSD-10.0-RELEASE-amd64-memstick.img</replaceable> of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen> - <para>Should this command fail, verify that the + <para>If this command fails, verify that the <acronym>USB</acronym> stick is not mounted and that the - device name is for the disk, not a partition. Depending - upon the operating system, this command may need to be - issued using <command>sudo</command>.</para> + device name is for the disk, not a partition. Some + operating systems might require this command to be run + with &man.sudo.8;. Systems like &linux; might buffer + writes. To force all writes to complete, use + &man.sync.8;.</para> </step> </procedure> @@ -897,9 +899,9 @@ Ethernet address 0:3:ba:b:92:d4, Host ID <para>This section shows the order of the <application>bsdinstall</application> menus and the type of information that will be asked before the system is installed. - Use the arrow keys to highlight a menu option, then the - <keycap>Space</keycap> key to select or deselect that menu item. - When finished, use <keycap>Enter</keycap> to save the selection + Use the arrow keys to highlight a menu option, then + <keycap>Space</keycap> to select or deselect that menu item. + When finished, press <keycap>Enter</keycap> to save the selection and move onto the next screen.</para> <sect2 xml:id="bsdinstall-keymap">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201406100335.s5A3Z53X017717>