All:

Included is a massive set of patches to guide/en/chap-
net-{practice,misc}.xml;

This is a very large patch that due to many circumstances.  Firstly,
this patch was based on diff's to chap-net.xml rev 1.13 from work I
started in October `04.  There have been many revisions since then,
including the very large patch between r1.18 and r1.19; -- not to
mention, the breaking and reorganization of chap-net-*. 

Because my original changes to chap-net.xml were so radical, combined
with the branching, I was forced to manually merge my original changes
and "catch up", resulting in a less-than-optimal set of patches below.

It was very difficult to track NON-FORMATING changes between
chap-net.xml's final revision and the first revisions of
chap-net-misc.xml and chap-net-practice.xml, but I believe I got the
formatting and section names right.

However visually poor the patches may appear, I believe that I have made
a great number improvements worth reviewing.

I was originally planning to allocate time to write a great deal more
content; however I other priorities occupy my time, so I'm submitting
the work I have, now, before someone else commits an radical change >:}

Patch to chap-net-practice.xml:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-practicee.xml.patch.gz

Patch to chap-net-misc.xml:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-misc.xml.patch.gz

Full versions:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-practice.xml.gz
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-misc.xml.gz

Viewable versions (w/ my NetBSD.css of course) at:
http://digitalfreaks.org/~lavalamp/htdocs/guide/en/chap-net-practice.html
http://digitalfreaks.org/~lavalamp/htdocs/guide/en/chap-net-misc.html

I will post URLs to original graphics/images soon, but in the mean time:
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_hub.png
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_bridge.png
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_VLAN.png

---

Hopefully this document will marginalize the need for
htdocs/Documentation/network/index.html, also hopefully encourage other
parts of htdocs/Documentation/network/* to be migrated, and maybe
motiviate more users to contribute to sections that I've outlined, but
not been able to complete.

Before commiting, general many incomplete <sect1>'s will need to be
commented out, and any contributors to either
chap-net-{practice,misc}.xml since Oct 2004 will want to verify
everything was merged in properly.

My hope is that some day NetBSD will feature the most comprehensive set
of Network-related documentation (FAQ/Tutorial/Howto/References/etc.)

~BAS

----------------------------------
Itemized Changes:
-> Improved organizational layout/skeleton for future content sections
(ask for volunteers in the lists?)
-> Added an ifaliases(5) section to chap-net-misc
-> Added mount_nfs(8) arguments to NFS section
-> Outlined more (all, I think?) network configuration files and
syntaxes where applicable
-> Outlined more (all, I think) userland bin/sbin network related
commands
-> Lots of &rprompt; substitutions
-> Removal of all ^I (tab) characters; replaced with proper spacing
(softtab=2)
-> Standardize the use of "host" and "machine" and "node"
-> Standardize on <screen> and <programlisting>
-> Added brconfig(8) output contents to the soft-Bridge section (that
wasn't there...because?)
-> Added VLAN / vlan(4) section **Graphics need work!***
-> Merged Kerberos docs from htdocs/Documentation/network/index.html
-> Explained pppd config options; added more content there
-> Removed the section on connecting a NetBSD and WinNT machine via
serial port 
-> Removed some inappropriate remarks.

----------------------------------
Missing / To-Do's:
-> OSI Model | TCP/IP Model comparison
-> Content for the following sections: Non-Std INterfaces, PXE, IPSect,
IPNat/IPF, AltQ, GRE, Security, Troubleshooting/FAQ

----------------------------------

Original Document:
http://www.netbsd.org/guide/en/chap-net.html (404 in the Attic/)

I merged ideas from material in:
-http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/networking.html
-http://www.openbsd.org/faq/faq6.html
-http://www.netbsd.org/Documentation/network/[*/*]
-http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/config-network-setup.html
-http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-virtual-hosts.html
-http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/advanced-networking.html
-Stevens - TCP/IP Illust. Vol. 1 (ISBN#)

----------------------------------

Originally planned layout:

Sect 1 - Intro & Network Concepts
    [Existing material]
    + Add OSI Model Diagram

Sect 2 - Practice 
    *) Kernel Config
     -- device drivers & pseudo devices
     -- Network device identification & notes on platform indepenent
drivers
     -- Supported media (ifconfig -m etc)
    *) Network Config Files
     - /etc/hosts /etc/ethers /etc/services /etc/protocols /etc/rc.conf 
	/etc/resolv.conf /etc/myname /etc/mygate /etc/nsswitch.conf 
	/etc/ifconfig.${IF} /etc/sysctl.conf 
         /etc/ipf.conf    /etc/ipnat.conf
    *) Network Userland Utilities
      - ifconfig, route, netstat, sysctl, tcpdump, ping, traceroute
	wiconfig, arp, host, dig, nslookup, ipf, ipmon
    *) Manual Interface Configuration
    *) Automatic Interface configuration w/ DHCP
      - Localizing settigs w/ custom dhclient.conf
    *) PPP
       - Analog modem
       - ISDN
       - Dial-on-Demand
    *) Special interfaces
      - WiFi, PPPoE, PPPoA

Sect 3 - Advanced Topics

    *) Interface Aliases
    *) Inetd (xref)
    *) IPFilter
    *) IPNat
    *) Bridging
    *) NFS
    *) SMB
    *) /net using amd(8)
    *) 6to4 Tunnel
    *) GRE Tunnel
    *) Kerberos
    *) AltQ
    *) VLANs 
    *) DHCP Server
    *) IPSec & VPNs
    *) PXE
    *) Network Performance Tuning
    *) Zebra Routing Daemon and/orDDR w/ PPP
    *) Securing Running Services
      - Service level ACLs
      - TCP Wrappers
      - IPF
      - Trusted Networks & Security Policies

Sect 4 - Troubleshooting & FAQ

    [populate]