Here are the installation instructions for cb.

For more information, the file 'callback.doc' should be consulted, or send an
e-mail to frank@icce.rug.nl

This file contains two sections: intructions on how to install callback, using
precompiled software, and instructions on how to compile the software
yourself.


How to compile the software.
----------------------------

    0. This section only defines how to compile and install the binaries.
       Using the programs is described in callback.doc.


    1. unpack callback.tgz:

	    tar xzvf callback.tgz

	This will create a directory callback, un which the software can be
	found


    2. cd callback

	All instructions are relative to this directory, unless explicitly
	mentioned otherwise.
	

    3. The installation script 'build' assumes that you have icmake installed
	on your system. Binary versions of icmake are found in the bin
	subdirectory.

	If you don't have icmake installed on your system, copy the binaries
	to your path (E.g., 'cp bin/* ~/bin') and rehash. Alternatively, you
	can fetch the most recent version of icmake from ftp.icce.rug.nl,
	directory pub/unix, and compile icmake yourself.

	From now on it is assumed that you have icmake available.

    4. The software assumes that the callback.setup file will be found in
	either

	    - /etc/callback.setup
	    - /usr/etc/callback.setup
	    - /usr/local/etc/callback.setup

	These paths are defined in the file 'configure.h'. If you don't like
	the default paths change configure.h to your wishes.

	Furthermore, at the end of the configure script some defines are
	defined for the benefit of the build script. The most important one
	is probably CALLBACKDIR at the end, defining the place where the build
	script will put the binaries.

	By default it is /conf/callback. Change it if you feel like it.


    5.	Give the command

	    build progs

	to build the programs.

	The compilation of parser.tab.c will cause some warnings, as does the
	compilation of lexer.c. The warnings can safely be ignored.


    6.	Continue with the next section: Instructions on how to install
	callback. 


Instructions on how to install callback
---------------------------------------

    0.  Either you agree with the predefined paths, or you have recompiled the
	software yourself. In any case: the binaries are now assumed present in
	./src (i.e., cb,cblogin,cbgetty).


    1. become root


    2. make a directory /conf/callback (or make your CALLBACKDIR, if you
	changed the default in configure.h), accessible for root only.


    3.	If callback is used in the dial-in mode, it can be used to control
	your modem. If callback is used in the callback mode it can be used
	to perform callbacks.

	If you want to use callback in the dial-in mode, do:

		build install dial-in
		cp examples/dial-in.setup /etc/callback.setup

	Otherwise, you want to use callback in the callback mode. Then do:

		build install callback
		cp examples/callback.setup /etc/callback.setup

	NOTE: /etc/callback.setup may be another file or in another location
		if you altered the default settings in configure.h.


    4.	Create a symlink from your path to the CALLACKDIR/cb program, e.g.,

	    ln -s /conf/callback/cb /sbin/cb


    5.  rehash.


    6. Copy files from ./examples/ to your CALLBACKDIR, e.g.,:

	cp callback.iss *.ttyS2 /conf/callback


    7. If you use modemline ttyS1 and/or ttyS3, change the extensions of the
	*.ttyS2 files so as to reflect your (extra) modemline(s). If you use
	multiple modem lines, make sure you have a set of files for each
	modemline, e.g.,
	    *.ttyS1 if you use modemline ttyS1,
	    *.ttyS2 if you use modemline ttyS2,
	    *.ttyS3 if you use modemline ttyS3.


    8. Make a symbolic link for each modemline you're using to the getty
	program used to listen to the modem(s). E.g., do

	    ln -s /sbin/getty-2.07 /sbin/modem.ttyS2


    9. Adapt gettydefs and inittab to reflect the situation at your system,
       see the inittab and gettydefs examples in the examples/ subdirectory,
       and read the file callback.doc for more information.


   10. Edit /etc/callback.setup to suit your system and callbackmode,


   11. Do
	    chmod 600 /etc/callback.setup


   12. Do
	    'cb init'

	to restart init. This loads the enable-files. The modem.ttyS?
	processes should appear in your ps-list. They should go to sleep
	shortly thereafter. 

    13. Done.

	Use cb to control your modem. If you used 'mode: calback', you
	should be able to accept callback-requests from selected users,
	as defined in your callback.setup file.

	Also, make sure that the registersetings of your modem is ok. Some
	examples are given in the file 'callback.doc'
