Welcome to DIP, the Dialup IP connection handler.


This document should help you, to install and use dip.  Please read it
carefully and stay to the end.

The following topics are discussed:

- What is DIP?
- How to install DIP?
- How to use DIP?
- Who is the author?
- Bugs, errors and questions.
- What does it cost?

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

What is DIP?


DIP is mainly a tool to establish a SLIP connection.  It handles all
the necessary actions to set up the tty port and the modem, dial out
and finally build up a SLIP connection between the tty port and the
kernel.  To do so, dip offers an own very simple command language (a
mostly complete description can be found in the man page).

Dip can handle both incoming and outgoing connections using password
security for incoming connections.

For more details, have a look at the man page!

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

How to install DIP?


I tried to make this as easy as possible (although at the moment is
*not* bsd-ported-program-compatible).  But there are two things to be
mentioned:

 - Have all the dip depended files in a separate directory.
   Un-tar-ing the original bsdip.tar.gz does so!
 - Use the Makefile to install (or uninstall dip).
   Note: You have to start the bsd make to use the default Makefile.
	 gmake will not work unless you delete some lines in the
	 original Makefile (e.g. you have to modify the lines
	 containing .if, .else and .endif).

The Makefile contains the following targets:

all		Compile all for dip necessary sources in the main dip
		directory and link them together.

install		Compiles dip and it's man page.  Then install these
		new files in the directories /sbin/ and
		/usr/share/man/cat8/.  A full install includes also
		two hard links: /sbin/diplogin, which is the same as
		/sbin/dip -i, and a man page for diplogin, a link to
		the dip man page.
		Used targets: dip, maninstall.

dip		Compile the C sources and link them together.

debug		Compile the C sources including gdb debugger info.
		Note:	If a debugging version has to be created, all
			normal compiled C files must be deleted; use
			a 'make clean' to do so.

maninstall	Only compile the man page via groff, then install it
		and it's link in the /usr/share/man/cat8.
		The compiled man page is not compressed per default.
		If you want to do so, you have to compress the files
		yourself.  The saved space will be about 20 kB.
		Uses target: man.

man		Compile the manpage via groff.

samples		Install the sample files in the separate directory
		/etc/dip.samples/.  This target must be given by hand.

clean		Remove compiled C sources (*.o) and a probably
		existing core file.

clobber		Remove compiled C sources (*.o) and the compiled man
		page (normal: dip.0) also.
		Used target: clean.

uninstall	Removes the installed files (dip executables and
		compiled man page) from their directories.  This is
		only done, if these files are found.  Sample files
		won't be uninstalled because there might be your own
		important changes. 

The normal way to install dip is:

  become/login as the super-user.  Only the super-user normally is
		allowed to use dip, because the routing table will be
		modified at runtime.

  make all	See, if all is all right with compiling.

  make man	Compile the man page.

  make install	Install the exectuables and the man pages.

  make samples	Install the sample files.

And that's all, dip should be installed after that.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

How to use dip?


All necessary information is given in the man page (use: man 8 dip).

But if you have really no idea how to start, have a look at
./samples/ReadMe.HowTo.  In that file I tried to describe, how I
developed a dip command file only given the output from my host.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Who is the author?


The original (Linux) version was written by:

	Fred N. van Kempen (waltje@uwalt.nl.mugent.org).

Note:	Please do *not* ask him concerning *this* BSD dip version.
	He is not responsible for this version.

There have also been some other modifications, tips and hints (see man
page, Authors section).

But there was a big disadvantage: The original dip was only written
for Linux.  No chance to compile it using BSD Unix without some work.

So I made the necessary changes to get dip work under BSD.  While
testing and changing, I found some (small) bugs and inconsistencies
and removed them.  And, last but not least, I did some enhancements
I missed in the original dip version.

This NetBSD port was done by:

	Joachim Bartz  injb@sun.rz.tu-clausthal.de

Note:	I said NetBSD, because I only have a system with NetBSD
	installed on it.  FreeBSD might do well, but I can't promise!

If there are any questions concering this BSD dip version, do not
hesitate to write me (Joachim Bartz) a message.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Bugs, errors and questions.


Well, this is the second public version of BSD dip.

The first public version bsddip-1.01 (23.April.1995) is nearly the same
to this version 1.02.  The only change I've done is the carrier lost and
redialing feature.  No serious bugs or error have been found or mailed
to me, so no real bugfixes were done in this new version.

I tried and tested a lot of features again, but I'm sure I missed some.

There are some combinations of commands, which are able to break down
the whole system. but in normal circumstances the program (should)
behave well.


But whatever happens to you or your system using this software:

		I do not give any warranty!


If you find a bug, error or inconsitencies, feel free to write me.
Hints and new ideas are also very welcome.
I'll try to correct known errors and to improve the program, but I'll
need your help to do so.

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

What does it cost?


I don't want earn money with this program, but if someone absolutely
wants to send me some money, I don't say no.

But what I want YOU to do is: Send me a postcard from your city/town.
My address:
		Joachim Bartz
		Burgstaetter Strasse 17
		38678 Clausthal-Zellerfeld
		Germany

Note:	There is also a file called COPYING in the main dip directory.
	Please read that file carefully, because dip applies to these
	terms!

