From owner-svn-doc-all@FreeBSD.ORG  Mon Jun 11 07:03:43 2012
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 69143106564A;
	Mon, 11 Jun 2012 07:03:43 +0000 (UTC)
	(envelope-from rodrigc@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 52B0D8FC12;
	Mon, 11 Jun 2012 07:03:43 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q5B73hOA049009;
	Mon, 11 Jun 2012 07:03:43 GMT (envelope-from rodrigc@svn.freebsd.org)
Received: (from rodrigc@localhost)
	by svn.freebsd.org (8.14.4/8.14.4/Submit) id q5B73hTr049006;
	Mon, 11 Jun 2012 07:03:43 GMT (envelope-from rodrigc@svn.freebsd.org)
Message-Id: <201206110703.q5B73hTr049006@svn.freebsd.org>
From: Craig Rodrigues <rodrigc@FreeBSD.org>
Date: Mon, 11 Jun 2012 07:03:43 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
	svn-doc-head@freebsd.org
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r39022 - in head: en_US.ISO8859-1/books/handbook
	en_US.ISO8859-1/books/handbook/advanced-networking
	share/images/books/handbook/advanced-networking
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
	user&quot; , &quot; projects&quot; , and &quot;
	translations&quot; \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
	<mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
	<mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Jun 2012 07:03:43 -0000

Author: rodrigc (src committer)
Date: Mon Jun 11 07:03:42 2012
New Revision: 39022
URL: http://svn.freebsd.org/changeset/doc/39022

Log:
  Enhance text which explains how to debug networking
  problems when setting up PXE.
  
  Reviewed by: gjb

Added:
  head/share/images/books/handbook/advanced-networking/pxe-nfs.png   (contents, props changed)
Modified:
  head/en_US.ISO8859-1/books/handbook/Makefile
  head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml

Modified: head/en_US.ISO8859-1/books/handbook/Makefile
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/Makefile	Sun Jun 10 21:50:47 2012	(r39021)
+++ head/en_US.ISO8859-1/books/handbook/Makefile	Mon Jun 11 07:03:42 2012	(r39022)
@@ -49,6 +49,7 @@ IMAGES_EN = advanced-networking/isdn-bus
 IMAGES_EN+= advanced-networking/isdn-twisted-pair.eps
 IMAGES_EN+= advanced-networking/natd.eps
 IMAGES_EN+= advanced-networking/net-routing.pic
+IMAGES_EN+= advanced-networking/pxe-nfs.png
 IMAGES_EN+= advanced-networking/static-routes.pic
 IMAGES_EN+= bsdinstall/bsdinstall-adduser1.png
 IMAGES_EN+= bsdinstall/bsdinstall-adduser2.png

Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml	Sun Jun 10 21:50:47 2012	(r39021)
+++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml	Mon Jun 11 07:03:42 2012	(r39022)
@@ -4590,7 +4590,7 @@ myhost.example.com:/b/tftpboot/FreeBSD/i
 	them.</para>
     </sect2>
 
-    <sect2>
+    <sect2 id="network-pxe-setting-up-dhcp">
       <title>Setting up the DHCP Server</title>
 
       <para>PXE requires a <acronym>TFTP</acronym> server and a
@@ -4659,11 +4659,64 @@ subnet 192.168.0.0 netmask 255.255.255.0
 	</step>
 
 	<step>
-	  <para>Use the
-	    <filename role="package">net/wireshark</filename> port to
-	    debug the <acronym>DHCP</acronym> and
-	    <acronym>TFTP</acronym> network traffic to look for any
-	    problems.</para>
+	  <para>Use the <filename role="package">net/wireshark</filename>
+	    port to debug the network traffic involved during the
+	    <acronym>PXE</acronym> booting process, which is
+	    illustrated in the diagram below.
+	    In <xref linkend="network-pxe-setting-up-dhcp">, an
+	    example configuration is shown where the
+	    <acronym>DHCP</acronym>, <acronym>TFTP</acronym>, and
+	    <acronym>NFS</acronym> servers are actually on the same
+	    machine.  However, these severs can be on separate
+	    machines.</para>
+
+	  <figure>
+	    <title>PXE Booting process with NFS root mount</title>
+	    <mediaobjectco>
+		<imageobjectco>
+		  <areaspec units="calspair">
+		    <area id="co-pxenfs1" coords="2873,8133 3313,7266">
+		    <area id="co-pxenfs2" coords="3519,6333 3885,5500">
+		    <area id="co-pxenfs3" coords="4780,5866 5102,5200">
+		    <area id="co-pxenfs4" coords="4794,4333 5102,3600">
+		    <area id="co-pxenfs5" coords="3108,2666 3519,1800">
+		  </areaspec>
+		  <imageobject>
+		    <imagedata fileref="advanced-networking/pxe-nfs">
+		  </imageobject>
+		  <calloutlist>
+		    <callout arearefs="co-pxenfs1">
+		      <para>Client broadcasts DHCPDISCOVER.</para>
+		    </callout>
+		    <callout arearefs="co-pxenfs2">
+		      <para>DHCP server responds with IP address,
+			<literal>next-server</literal>,
+			<literal>filename</literal>, and
+			<literal>root-path</literal>.</para>
+		    </callout>
+		    <callout arearefs="co-pxenfs3">
+		      <para>Client sends <acronym>TFTP</acronym>
+			request to <literal>next-server</literal>
+			asking to retrieve
+			<literal>filename</literal>.</para>
+		    </callout>
+		    <callout arearefs="co-pxenfs4">
+		      <para>TFTP server responds and sends
+			<literal>filename</literal> to client.</para>
+		    </callout>
+		    <callout arearefs="co-pxenfs5">
+		      <para>Client executes
+			<literal>filename</literal> which is
+			&man.pxeboot.8;.  &man.pxeboot.8; loads the
+			kernel.  When the kernel executes, the root
+			filesystem specified by
+			<literal>root-path</literal> is mounted over
+			<acronym>NFS</acronym>.</para>
+		    </callout>
+		  </calloutlist>
+		</imageobjectco>
+	    </mediaobjectco>
+	  </figure>
 	</step>
 
 	<step>

Added: head/share/images/books/handbook/advanced-networking/pxe-nfs.png
==============================================================================
Binary file. No diff available.