
These are the steps to follow when you want to install dim:

        1. Unpack the dim-X.YY.tar.gz file, using

                tar xzvf dim-X.YY.tar.gz 
		
	   from the current directory. GNU tar 1.11.2 was used to
	   create dim-X.YY.tar.gz

        2. You get subdirectories src, bin and examples, a document file
	   dim-X.YY.txt and a build-script.
	   
	   The dim...txt file contains a lot of information about setting up
	   you modem, kermit, gettydefs, getty.ttySx, etc. Read it when
	   you're ready for it. You don't need it for the installation proper.
	   
        3. Start editing the file build. Look for the lines:
	
                #define CONFDIM     	"/conf/dim"
                #define DIMDEST		"/usr/local/bin"
		
           The dial-in getty.ttySx files will be stored at the CONFDIM
	   subdirectory. If you don't want this name, adapt this pathname in 
	   the file build *AND* in the file config.h.
	   
	   The dim program will be installed (*only* if you do 'build install')
	   in the path named with DIMDEST. Again, modify it if you want it
	   somewhere else.
	   
	   Check out other #defines in build: do you have all the programs
	   used by build? (this should be no problem, they're pretty standard)

        4. Edit src/config.h, and check (again, to be sure) CONFDIM and
	   other defines. Edit them if necessary. Pay attention to the
	   GETTYSTRING definition. This line *MUST* be found in your
	   ps -ax output. If you have another way of having getty look at 
	   the modem, adapt the line in config.h accordingly.
	   
        5. When all #defines are the way you want them, do

                                build dim
        
           This should build the (unstripped) program dim the bin subdirectory
	   created by tar. If dim is started without arguments, it will
	   give you usage information.
	   
        6. Now that dim is created, you may want to install dim. To do that,
	   you must (probably) be root. Once you're root, go again to this
	   directory, and enter: 
	   
	                        build install
        
	   You must copy examples/getty.ttyS3.* to the CONFDIM subdirectory,
	   and you may have to edit /etc/initab and /etc/gettydefs.
	   There are demo files in the examples subdirectory. 
	   Note that /etc/default/getty.ttySx is rewritten by dim, check
	   any special things you might have in you current 
	   /etc/default/getty.ttySx. Copy them in CONFDIM/getty.ttySx.org
	   if necessary *before* you start using dim.

        7. After having installed dim, having copied/adapted 
	   CONFDIM/getty.ttySx.*, having adapted /etc/gettydefs and
	   /etc/initab, dim can be used. Try dim -file to see if
	   your current getty.ttySx file is displayed. Then start
	   using the other options to enable or disable incoming calls.

        8. If you're getting stuck: start reading dim-X.YY.txt.
	   if anythings fails, or if questions remain, send an email.
	   

        Frank
	
	(frank@icce.rug.nl)
	