#
# ReadMe
#
#
# Version:	@(#)./samples/ReadMe	1.02	1.July.1995
#
#
# Author:	Joachim Bartz, <injb@sun.rz.tu-clausthal.de>
#
#		There have been so many changes to get  dip work under
#		BSD...   So I believe, you can call me an author, too.
#		Please read the  ReadMe  file and the man page to know
#		what, when, why.
#
#
#		This program is free software; you can redistribute it
#		and/or  modify it under  the terms of  the GNU General
#		Public  License as  published  by  the  Free  Software
#		Foundation;  either  version 2 of the License, or  (at
#		your option) any later version.
#
#		This program is  distributed in the  hope that it will
#		be useful, but WITHOUT ANY WARRANTY;  without even the
#		implied warranty of MERCHANTABILITY  or  FITNESS FOR A
#		PARTICULAR  PURPOSE.    See  the  GNU  General  Public
#		License for more details.
#
#		You  should have received  a copy  of the  GNU General
#		Public License along with this program;  if not, write
#		to the
#			Free Software Foundation, Inc.
#			675 Mass Ave
#			Cambridge, MA 02139, USA
#


This directory contains a set of sample files for use with dip.


diphosts	A simple diphosts file.
		Place a similar file (your own version) in /etc/ and
		make the neccessary changes to /etc/passwd via the
		command vipw (please refer the man pages!).
		Note:	I have no real chance to test the dip host
			mode and so I cannot guarantee it will work.

sample.dip	My personal dialing script.  OK, it is very verbose,
		but I think it is better to be verbose than too
		silent. Every state is reported by this script and so
		I always know, what has happend or if it's all all
		right.
		Note 1:	This is a "dynamic" slip startup script,
			because at startup my system doesn't know
			anything about external systems.
		Note 2: Although dip has the ability to execute
			external shell scripts, I prefer the "simple"
			solution using the internal ifconfig(8) and
			route(8) executed commands.
		Note 3: If you don't know, how to start developing your
			personal dip command script, have a look at the
			file ReadMe.HowTo in this directory.
		Note 4: Changes! The new mode feature (errlvl==+1) is
			used to cause a redialing if the carrier is
			lost.

sample1.dip	The original sample dip dialing script (by Fred N. van
		Kempen) slightly modified to use this dip modified
		wait-command the right way.

sample2.dip	Another very compact dialing script for a dynamic slip
		startup (also modified to suit the wait-command).


The next three files belong together.

Note:	To run this sample, check, if all files are at their correct
	places.  After plain install they aren't!
	And remember: This is just a sample!

startup.sh.sample
		This is an example /bin/sh shell script, which starts
		up a SLIP connection and tries to keep it alive.  There
		are also some security features to prevent the system
		from starting the same connection twice.
		Take a look at the script, it is not very difficult to
		understand and tells always, what happens.

setup.sh.sample
		A sample setup shell script for /bin/sh, too.
		It does nearly the same actions as dip without an
		external shell script.

dialout.dip.sample
			! Must be renamed to a file with suffix .pid !
		Sample dip command script, very compact and similar to
		sample2.dip.


Hmmm, it is not easy to write a good and useful example!

On my system, I like it simple and so I only use a dip dialout script
started on demand.  So I wrote these samples only to show you a
possible use of dip, but I was not able to check all the features.

Just take the samples as small hints, do not rely on them.
