docs/147347: [request] Missing memstick install setup instructions in Handbook

[Marc Fonvieille]

On Sat, Jul 31, 2010 at 06:36:30PM -0400, Glen Barber wrote:
> Hi,
> 
> I've attached a new patch, which, pointed out by Warren Block off-list, 
> instructs to set kern.geom.debugflags=16, making the USB device 
> bootable.  I've also corrected my whitespace issues. :(
> 
> -- 
> Glen Barber


Hello Glen,

Few comments:

> --- install/chapter.sgml.orig	2010-07-28 15:32:17.000000000 -0400
> +++ install/chapter.sgml	2010-07-31 18:26:49.796116150 -0400
> @@ -630,6 +630,10 @@
>  	</listitem>
>  
>  	<listitem>
> +	  <para>A USB Memory Stick</para>
> +	</listitem>
> +
> +	<listitem>
>  	  <para>A DOS partition on the same computer</para>
>  	</listitem>
>  
> @@ -695,7 +699,14 @@
>        <procedure>
>  	<step>
>  	  <title>Acquire the Boot Floppy Images</title>
> -	  
> +
> +	  <important>
> +	    <para>Please note, as of &os; release 8.0, floppy disk

					you can remove "release" here,
					it sounds weird and it's implicit

> +	      images are no longer available.  Please see below for
> +	      instructions on how to install &os; using a USB memory
> +	      stick.</para>
> +	  </important>
> +
>  	  <para>The boot disks are available on your installation media
>  	    in the <filename>floppies/</filename> directory, and
>  	    can also be downloaded from the floppies directory, <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable><arch></replaceable>/<replaceable><version></replaceable>-RELEASE/floppies/</literal>.
> @@ -799,6 +810,70 @@
>  	</step>
>        </procedure>
>  
> +      <para>To create a bootable memory stick, follow these steps:</para>
> +
> +      <procedure>
> +	<step>
> +	  <title>Acquire the Memory Stick Image</title>
> +
> +	  <para>The memory stick image can be downloaded from the
> +            <filename>ISO-IMAGES/</filename> directory from

	if it's a directory then you have to use
	<filename class="directory">ISO-IMAGES/</filename>

> +	    <literal>ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/<replaceable><arch></replaceable>/ISO-IMAGES/<replaceable><version></replaceable>/&rel.current;-RELEASE-<arch>-memstick.img</literal>.
> +	    Replace <replaceable><arch></replaceable> and
> +	    <replaceable><version></replaceable>
> +	    with the architecture and the version number
> +	    which you want to install, respectively.
> +	    For example, the memory stick images for

Are you sure about the lines length?  It should be close to 70 (you
should check that for the rest of your patch as well).


> +	    &os;/&arch.i386; &rel.current;-RELEASE are available
> +	    from <ulink url="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/&arch.i386;/ISO-IMAGES/&rel.current;/&rel.current;-RELEASE-&arch.i386;-memstick.img"></ulink>.</para>
> +
> +	  <para>The memory stick image has a <filename>.img</filename> extension.
> +	    The <filename>ISO-IMAGES/</filename> directory contains a number of

		+class="directory"

> +	    different images, and the ones you will need to use depends on the

					 ^ -------------------------- ^
					 (grammar?)

> +	    version of FreeBSD you are installing, and in some cases, the

	               you should use &os;

> +	    hardware you are installing to.</para>
> +
> +	  <important>
> +	    <para>Before proceeding, <emphasis>back up</emphasis> the

					"back up" or "backup"?

> +              data you currently have on your USB stick, as this
> +              procedure will <emphasis>erase</emphasis> it.</para>
> +	  </important>
> +	</step>
> +
> +	<step>
> +	  <title>Prepare the Memory Stick</title>
> +
> +	  <warning>
> +	    <para>The example below lists <literal>/dev/da0</literal>

					see "4.2.5.7 Devices" from
					http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup-docbook.html

					should be
					<filename>/dev/da0</filename>

> +	      as the target device from which you will be booting.  Be
> +	      very careful that you have the correct device as the
> +	      output target, or you may destroy your existing 

							     ^ trailing
							     space :)

> +	      data.</para>
> +	  </warning>
> +
> +	  <para>Set the <literal>kern.geom.debugflags</literal> sysctl
> +	    to be able to write a master boot record to the target
> +	    device.</para>
> +
> +	  <screen><userinput>&prompt.root; sysctl kern.geom.debugflags=16</userinput></screen>
> +	</step>
> +
> +	<step>
> +	  <title>Write the Image File to the Memory Stick</title>
> +
> +	  <para>The <filename>.img</filename> file is
> +	    <emphasis>not</emphasis> a regular file you copy to the
> +	      memory stick.  It is an image of the complete contents of
> +	      the disk.  This means that you <emphasis>cannot</emphasis>
> +	      simply copy files from one disk to another.  Instead, you
> +	      must use &man.dd.1; to write the images directly to the
> +	      disk:</para>
> +
> +	  <screen>&prompt.root; <userinput>dd if=&rel.current;-RELEASE-&arch.i386;-memstick.img of=/dev/<replaceable>da0</replaceable> bs=64k</userinput></screen>
> +
> +	</step>
> +      </procedure>
> +
>        <para>You are now ready to start installing FreeBSD.</para>
>      </sect2>
>    </sect1>

> _______________________________________________
> freebsd-doc at freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"


-- 
Marc