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.
This commit is contained in:
Warren Block 2014-06-10 03:35:04 +00:00
parent 25834ce505
commit f61c49549c
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=45040

View file

@ -510,24 +510,24 @@
match exactly. If the checksums do not match, the file is match exactly. If the checksums do not match, the file is
corrupt and should be downloaded again.</para> corrupt and should be downloaded again.</para>
<sect3> <sect3 xml:id="bsdinstall-usb">
<title>Burning an Image File to <acronym>USB</acronym></title> <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 <emphasis>image</emphasis> of the complete contents of a
memory stick, it <emphasis>cannot</emphasis> just be copied memory stick. It <emphasis>cannot</emphasis> be copied
to the target device. Several applications are available to the target device as a file. Several applications are available
for burning the <filename>*.img</filename> to a for writing the <filename>*.img</filename> to a
<acronym>USB</acronym> stick. This section describes two of <acronym>USB</acronym> stick. This section describes two of
these utilities.</para> these utilities.</para>
<important> <important>
<para>Before proceeding, back up any important data on the <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> the existing data on the stick.</para>
</important> </important>
<procedure> <procedure xml:id="bsdinstall-usb-dd">
<title>Using <command>dd</command> to Write the <title>Using <command>dd</command> to Write the
Image</title> Image</title>
@ -540,8 +540,8 @@
</warning> </warning>
<step> <step>
<para>The <command>dd</command> command-line utility is <para>The &man.dd.1; command-line utility is
included on BSD, Linux, and &macos; systems. To burn available on BSD, &linux;, and &macos; systems. To burn
the image using <command>dd</command>, insert the the image using <command>dd</command>, insert the
<acronym>USB</acronym> stick and determine its device <acronym>USB</acronym> stick and determine its device
name. Then, specify the name of the downloaded 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> <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 <acronym>USB</acronym> stick is not mounted and that the
device name is for the disk, not a partition. Depending device name is for the disk, not a partition. Some
upon the operating system, this command may need to be operating systems might require this command to be run
issued using <command>sudo</command>.</para> with &man.sudo.8;. Systems like &linux; might buffer
writes. To force all writes to complete, use
&man.sync.8;.</para>
</step> </step>
</procedure> </procedure>
@ -897,9 +899,9 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
<para>This section shows the order of the <para>This section shows the order of the
<application>bsdinstall</application> menus and the type of <application>bsdinstall</application> menus and the type of
information that will be asked before the system is installed. information that will be asked before the system is installed.
Use the arrow keys to highlight a menu option, then the Use the arrow keys to highlight a menu option, then
<keycap>Space</keycap> key to select or deselect that menu item. <keycap>Space</keycap> to select or deselect that menu item.
When finished, use <keycap>Enter</keycap> to save the selection When finished, press <keycap>Enter</keycap> to save the selection
and move onto the next screen.</para> and move onto the next screen.</para>
<sect2 xml:id="bsdinstall-keymap"> <sect2 xml:id="bsdinstall-keymap">