add directory docs

docs/net-guide/COPYING

@@ -0,0 +1,58 @@
+
+
+
+      COPYING CONDITIONS
+
+      The Linux Network Administrators' Guide is 
+      Copyright (C) 1993 Olaf Kirch
+      Kattreinstr. 38, 64295 Darmstadt, Germany
+      okir@monad.swb.de
+
+      The Linux Network Administrators' Guide  may  be  reproduced
+      and  distributed in whole or in part, subject to the follow-
+      ing conditions:
+
+      1.   The copyright notice above and this  permission  notice
+           must  be  preserved complete on all complete or partial
+           copies.
+
+      2.   Any translation or derivative work of The Linux Network
+           Administrators' Guide must be approved by the author in
+           writing before distribution.
+
+      3.   If you distribute  The  Linux  Network  Administrators'
+           Guide  in part, instructions for obtaining the complete
+           version of The Linux Network Administrators' Guide must
+           be  included, and a means for obtaining a complete ver-
+           sion provided.
+
+      4.   Small portions may be reproduced as  illustrations  for
+           reviews  or  quotes in other works without this permis-
+           sion notice if proper citation is given.
+
+      5.   The GNU General Public License referenced below may  be
+           reproduced under the conditions given within it.
+
+      6.   Several  sections of this document are held under sepa-
+           rate copyright.  When these sections are covered  by  a
+           different  copyright,  the seperate copyright is noted.
+           If you distribute  The  Linux  Network  Administrators'
+           Guide  in  part,  and  that  part is, in whole, covered
+           under a seperate, noted copyright,  the  conditions  of
+           that copyright apply.
+
+           Exceptions  to  these rules may be granted for academic
+           purposes: Write to Olaf Kirch at the above address,  or
+           email  okir@monad.swb.de,  and ask.  These restrictions
+           are here to protect us as authors, not to restrict  you
+           as educators and learners.
+
+           All  source  code  in The Linux Network Administrators'
+           Guide is placed under the GNU General  Public  License.
+           See  appendix  GNU  License, , , app} for a copy of the
+           GNU ``GPL.''
+
+
+           The author is not liable for  any  damages,  direct  or
+      indirect,  resulting from the use of information provided in
+      this document.

docs/net-guide/MANIFEST

@@ -0,0 +1,6 @@
+./netguide/COPYING
+./netguide/MANIFEST
+./netguide/Makefile
+./netguide/README
+./netguide/TODO
+./netguide/nag.ps

docs/net-guide/Makefile

@@ -0,0 +1,121 @@
+############################################################# 
+# Makefile for the Linux Network Administrators' Guide
+# Copyright (C) Olaf Kirch, 1992, 1993.
+#
+#############################################################
+VERSION=0.4.3
+
+#############################################################
+# Get the filesets for the various format distributions
+#############################################################
+include FILESETS
+
+#############################################################
+# Commands
+#############################################################
+TEXIFY=	  texify
+MAKEINFO= makeinfo
+TEXI2ROFF=texi2roff
+
+#############################################################
+# Rules section
+#############################################################
+all:	dvi	# default target
+
+clean:  cleantex cleanps cleaninfo cleanroff
+
+#############################################################
+# Targets relating to fig picture conversion
+#############################################################
+tcpip/dns.tex:tcpip/dns.fig
+	fig2dev -Leepic tcpip/dns.fig > tcpip/dns.tex
+
+#tcpip/groucho.tex:tcpip/groucho.fig
+#	fig2dev -Leepic tcpip/groucho.fig > tcpip/groucho.tex
+
+news/flow.tex: news/flow.fig
+	fig2dev -Leepic news/flow.fig > news/flow.tex
+
+#############################################################
+# Targets relating to TeX/DVI/PS
+dvi:	nag.dvi
+
+ps:	nag.ps
+
+nag.dvi:$(TEX)
+	export TEXINPUTS=:styles; latex nag.tex || touch nag.tex
+	-@grep -s Rerun nag.log && touch nag.tex
+
+nag.ps:	nag.dvi
+	dvips -M nag.dvi -o nag.ps
+
+cleantex:
+	rm -f *.aux */*.aux *.log *.lof *.toc nag.dvi nag.dvi-err
+
+cleanps:
+	rm -f nag.ps
+
+#############################################################
+# Targets relating to TeXinfo/Info
+#############################################################
+texi:	net.texi
+
+info: 	netguide
+
+netguide:$(TEXI)
+	$(MAKEINFO) nag.texi
+
+net.texi:$(TEXISRC)
+	$(TEXIFY) net.tex
+	$(TEXIFY) net.tex
+
+cleaninfo:
+	rm -f netguide netguide-[0-9] netguide-[0-9][0-9] \
+		net.texi net.auxi net.ff net.menu
+
+#############################################################
+# Targets relating to groff/ASCII
+#############################################################
+roff:	$(ROFF)
+
+net.ms:$(ROFFSRC)
+	texi2roff -ms net.texi > net.ms
+
+ascii:	nag.ascii
+
+nag.ascii:$(ROFF)
+	groff -mgs nag.ms | sed 's/.//g' > nag.ascii
+
+cleanroff:
+	rm -f net.ms nag.ascii
+
+#############################################################
+# Make distribution files
+#############################################################
+dist:	srcdist dvidist psdist texidist roffdist
+
+srcdist:
+	@ls $(SRCDIST)  | sed "s/^/.\/netguide\//" > MANIFEST
+	-cd ..; tar  -cvf - -T netguide/MANIFEST |\
+		 gzip > nagsrc-$(VERSION).tgz
+
+dvidist:
+	@ls $(DVIDIST)  | sed "s/^/.\/netguide\//" > MANIFEST
+	-cd ..; tar  -cvf - -T netguide/MANIFEST |\
+		gzip > nagdvi-$(VERSION).tgz
+
+psdist:
+	@ls $(PSDIST)   | sed "s/^/.\/netguide\//" > MANIFEST
+	-cd ..; tar  -cvf - -T netguide/MANIFEST |\
+		gzip > nagps-$(VERSION).tgz
+
+texidist:
+	@ls $(TEXIDIST) | sed "s/^/.\/netguide\//" > MANIFEST
+	-cd ..; tar  -cvf - -T netguide/MANIFEST |\
+		gzip > nagtexi-$(VERSION).tgz
+
+roffdist:
+	@ls $(ROFFDIST) | sed "s/^/.\/netguide\//" > MANIFEST
+	-cd ..; tar  -cvf - -T netguide/MANIFEST |\
+		gzip > nagroff-$(VERSION).tgz
+

docs/net-guide/README

@@ -0,0 +1,173 @@
+
+Hi, all!
+
+Finally, here it comes: The Linux Network Administrators' Guide!
+Although it is far from perfect, I feel that it's high time to release
+a version to the public.
+
+This Guide has been written in cooperation with the Linux 
+Documentation Project, and covers both TCP/IP-based as well as
+UUCP networking.
+
+The document is available in DVI, Postscript, and Latex source.
+ASCII support is also provided, giving a version that can be
+processed by groff. It may be far from perfect, but at least
+it's there :-) If desired, I can also make a GNU info
+version of the book.
+
+
+What is the Network Administrators' Guide?
+------------------------------------------
+
+This is version 0.4 ALPHA of my networking guide for Linux.
+I still call it an ALPHA release because NET-2 is still changing
+so quickly; furthermore some chapters will need serious
+rewriting.
+
+The Networking Guide is written for people who want to use
+their Linux system in a networked environment, relying either
+on TCP/IP or UUCP. When writing it I tried to put in enough
+information so that people who know next to nothing about
+networking can get their machine working nevertheless (at least
+in theory... :-)
+
+Features:
+
+	* Includes an extensive introduction to TCP/IP
+	covering the whole thing from the physical layer
+	up to the application layer.
+
+	* Covers NET-2 setup, including hardware setup
+	(Ethernet, SLIP, PLIP), IP interface setup,
+	and building of static routing tables with route(8).
+	NOTE: I have been away for the last two weeks, so I
+	don't know if I missed any important developments in
+	from NET-2 department. This chapter is the next
+	candidate for revision.
+
+	* Explains the most important TCP/IP applications
+	along with their config files: inetd, tcpd, the r*
+	clients, RPC, NFS, and FTP server setup.
+
+	* Covers setup of Taylor UUCP (compiled for
+	BNU configuration).
+
+	* Explains basic concepts of email, and covers
+	setup of smail and sendmail.
+
+	* Setup of Cnews and assorted newsreaders
+
+	* Has three fancy pictures :-)
+
+	* TeXinfo and roff versions available.
+
+Misfeatures:
+
+	* The Guide still has gaping holes in some
+	places: There is no remote printing, no BOOTP setup, 
+	no automounter, etc. See the TODO file for what's not yet
+	in.
+
+	* I'm not yet content with the sendmail chapter.
+	Same applies to the newsreader section. Suggestions
+	on what to include and omit are welcome.
+
+	* Needs more pictures.
+
+	* TeXinfo and roff versions don't look too nice.
+
+
+Networking Guide Distribution
+-----------------------------
+
+The NAG comes in a number of formats. You may either retrieve
+the complete LaTeX source, or any preconverted version. They
+may currently be found at
+
+	tsx-11.mit.edu:/pub/linux/docs/LDP
+
+or
+	sunsite.unc.edu:/pub/Linux/docs/LDP
+
+The different packages are:
+
+netguide-0.4.src.tgz:	The complete source, together with the
+			files needed for generating the other
+			formats (except for the texify tool).
+
+netguide-0.4.dvi.tgz:	DVI version
+
+netguide-0.4.ps.tgz:	Postscript version
+
+netguide-0.4.roff.tgz:	roff version. This was generated from the
+			TeXinfo version using texi2roff. It is not
+			very satisfactory yet, but then, I've no
+			idea of roff. I converted it to use the ms
+			macro package, because the commands looked
+			vaguely familiar to me. To show it on the
+			screen, type
+
+			 groff -mgs nag.roff | less
+
+			Some day in the future I may turn to mm macros
+			instead, because they have good cross-references
+			etc.
+
+
+Source Notes
+------------
+
+The pictures in this book have been produced with xfig, and translated
+to eepic/Latex input. You need the epic and eepic style files for this. 
+Since they are not incorporated in the SLS release of TeX (at least not
+the one I've got), I have included them here.
+
+If your dvi printer filter doesn't recognize the graphic specials, you
+may have to use the Postscript version. Either get the Posscript version or
+convert the dvi file to Postscript. Simply type 'make net.ps'. Note that
+this will use dvips, because I know that dvitops does _not_ understand
+the eepic graphics specials.
+
+If this still won't work, you have to wait until I upload the FIG
+versions of the pictures (I lost the FIG version of one of these
+images :-() and convert these to Postscript as well.
+
+The pictures are also there in the ASCII version. If you know what they
+are meant to show, you can even see it.
+
+
+Formatting now looks quite well in most places (thanks to
+Michael K. Johnson's work!), but there are still a few overfull hboxes.
+These come from {\tt very/long/file/names} and the like. They will be dealt
+with once we have a fixed version.
+
+
+
+Author's Blurb
+--------------
+
+Last not least, some personal words: As I said when volunteering
+for this job, my knowledge of TCP/IP networking is a bit on
+the theoretical side. On my Linux box, I do everything in loopback
+mode, and in terms of UUCP connectivity, I only run a leaf site.
+Thus I can't claim too much first-hand experience. So if you find
+anything you think is wrong or ambiguous, don't hesitate to point
+this out. Thanks a lot.
+
+
+If you have suggestions/comments/complaints, mail me at
+
+	okir@monad.swb.de.
+
+
+Yours,
+Olaf
+
+
+
+Copyright Notice
+----------------
+
+The Linux Network Administrators' Guide is Copyright (C) by Olaf Kirch.
+See the file COPYING for your rights in copying and printing it.
+

docs/net-guide/TODO

@@ -0,0 +1,20 @@
+Things that remain to do
+------------------------
+
+*	There's no index either (look at the file 'index' for
+	an off-the-top-of-my-head list of index items).
+
+*	Using the Linux bootp client.
+
+*	NIS support. (I recently read that there are copyright
+	problems with Sun? Or is that just rumor?)
+
+*	Remote printing
+
+*	Automounter (amd)
+
+*	Add PCNFS?
+
+*	Improve the nslookup section.
+
+*	Mention hostcvt in the DNS setup section.