old-www/LDP/nag

                  The Linux Network Administrators' Guide

                      Olaf Kirch, <okir@monad.swb.de>
                        Linux Documentation Project


                               18. Aug. 1994
                                Release 1.0



   Welcome to the public release of the new Linux Network Administrators'
   Guide!  After one year of work in (well, almost) seclusion, I'm  proud
   to  present  you  a  completely revised, greatly improved and expanded
   Networking Guide.


   1.  What's In It?

   The new NAG is an almost complete rewrite of the  version  I  released
   almost  exactly  one  year  ago.   It  features  several new chapters,
   including the setup of SLIP, PPP, and NIS.  It  also  has  a  complete
   sendmail chapter now, written by Vince Skahan.

   The  NAG is written mainly for networking rookies (as I have been when
   I started this project almost two years ago), but I hope  it  will  be
   useful to more experienced networkers alike. It explains everything in
   pretty much detail, beginning with the basics of networking and slowly
   working  its  way  up  to the configuration of mail and news, covering
   both the setup of TCP/IP-based services and UUCP. The  following  list
   shows the table of contents:

      +      Preface

      +      Introduction to Networking

      +      Issues of TCP/IP Networking

      +      Configuring the Networking Hardware

      +      Setting up the Serial Hardware

      +      Configuring TCP/IP Networking

      +      Name Service and Resolver Configuraton

      +      Serial Line IP

      +      The Point-to-Point Protocol

      +      Various Network Applications

      +      The Network Information System

      +      The Network File System

      +      Managing Taylor UUCP

      +      Electronic Mail

      +      Getting smail Up and Running

      +      Sendmail+IDA

      +      Netnews

      +      C News

      +      A Description of NNTP

      +      Newsreader Configuration

      +      Glossary

      +      Annotated Bibliography

   The  level of detail comes at a certain cost, which is the size of the
   book. When running it through LaTeX, it comes out at around 350  pages
   at  the  moment, counting table of contents, glossary, and index. This
   is quite a bit. I hope you'll enjoy it nevertheless.


   2.  With a little help...

   The NAG wouldn't be what it is today if it wasn't for the  involvement
   of  O'Reilly  and Associates in this project, who are going to publish
   the Official Printed Version of the NAG some  time  later  this  year.
   Since  December 1993, I've been working with Andy Oram at O'Reilly who
   read everything I wrote, and sent me countless reviews, so much of the
   quality in this book is actually due to him.

   Still,  the NAG will remain freely distributable under the Linux Docu-
   mentation Project's License, just the way the  previous  release  was.
   Thus,  no-one  will  be  shut  off; rather, you will be able to choose
   between the online version and a high-quality printed version.


   3.  Obtaining the NAG

   The NAG is available both as LaTeX source, and preformatted in several
   ways. The primary FTP sites are

               sunsite.unc.edu:/pub/Linux/docs/LDP
               tsx-11.mit.edu:/pub/linux/docs/LDP

   The following packages are available:

   nag-1.0.tar.gz This  file  contains  the LaTeX source of the NAG. I've
        tried to make it as portable as possible, so I do  hope  it  will
        compile cleanly on most LaTeX installations.  Some nuances of the
        DVI and Postscript output can be controlled  by  a  configuration
        file  which  allows  you, among other things, to select a tighter
        printing which reduces the size of the printed book by almost 100
        pages.  For  details,  please  refer to the installation notes in
        that archive.

   nag-dvi-1.0.tar.gz This file contains the preformatted DVI  output  of
        the NAG, suitable for printing on US Letter paper. All figures in
        the NAG are  done  using  using  xfig,  from  which  I  generated
        epic/eepic  output  for the DVI version. The eepic macros rely on
        some LaTeX \special's that some DVI printer drivers may not  have
        implemented.  If  you  don't see any figures on your printout, or
        get pages full of error messages about \special's  not  supported
        while printing the NAG, your best option may be this: Convert the
        DVI file to PostScript and print the offending pages  from  using
        ghostcsript.

   nag-ps-1.0.tar.gz This  file contains the preformatted PostScript out-
        put of the NAG, again suitable for printing on Letter Paper. This
        should be almost painless to use.

   nag-ascii-1.0.tar.gz This  is the ASCII version, which is provided for
        the benefit of those without the disk space or printer  capabili-
        ties  to  handle a full TeX or ghostcript installation. As things
        go with ASCII, the output is not very high quality, will eat hor-
        rendous  amounts of paper when actually printing it (close to 400
        pages), and doesn't have any figures (anybody who is  willing  to
        try his or her hand on ASCII art is very welcome).

   All these files are gzipped tar archives.


   4.  Feedback

   If  you have complaints, suggestions, fixes, or questions, please mail
   me at the address given above. However, let me say a word about  `bug'
   reporting:  if you have fixes to the NAG itself, please don't use ref-
   erences like `page 87, second paragraph', but rather give me a section
   number,  or  even a detailed description like `In the mount section of
   the NFS chapter'. Although I may find the sentence you refer  to  when
   you  use page numbers, there's no guarantee the mistake you spotted is
   anywhere close to that page on my printed copy.

   I hope I didn't forget anything,
   Enjoy
                   Olaf Kirch