user/diald/README

   1 The Diald README File
   2
   3 ----------------------------------------------------------------------------
   4
   5 This is release 0.16 of diald.
   6
   7 Diald is a daemon that provides on demand IP links via SLIP or PPP. The
   8 purpose of diald is to make it transparently appear that you have a
   9 permanent connection to a remote site. Diald sets up a "proxy" device which
  10 stands in for the physical connection to a remote site. It then monitors the
  11 proxy, waiting for packets to arrive. When interesting packets arrive it
  12 will attempt to establish the physical link to the remote site using either
  13 SLIP or PPP, and if it succeeds it will forward traffic from the proxy to
  14 the physical link. As well, diald will monitor traffic once the physical
  15 link is up, and when it has determined that the link is idle, the remote
  16 connection is terminated. The criteria for bringing the link up and taking
  17 it down are configurable at run time, and are based upon the type of traffic
  18 passing over the link.
  19
  20 Getting Diald
  21
  22 The file is called diald-0.16.tar.gz. I've uploaded it to
  23 sunsite.unc.edu:/pub/Linux/Incoming. It should move to
  24 sunsite.unc.edu:/pub/Linux/system/Network/serial after a suitable interval.
  25 It can also be obtained from the diald home page at
  26 "http://www.dna.lth.se/~erics/diald.html". Note that the diald home page has
  27 moved from its old location at the University of Toronto.
  28
  29 Mailing List
  30
  31 David S. Miller provides a mailing for the discussion of diald on his
  32 Majordomo server at vger.rutgers.edu. Send mail containing the line
  33 "subscribe linux-diald" in the BODY of the message to
  34 Majordomo@vger.rutgers.edu to join the list. Send mail with the word "help"
  35 in the body to get help on the correct use of the Majordomo list server.
  36 Announcements of new releases are made on the mailing list, and its a good
  37 place to ask questions of users who already have diald up and running. I
  38 would prefer the mailing list to be my primary channel of communication with
  39 users. This gives you the added benefit of asking your questions of everyone
  40 on the list, many of whom may have the same question, or some of who may
  41 have already solved your problem. This minimizes the time I have to spend
  42 answering questions about diald, and gives me more time to spend improving
  43 the program. Let me repeat that. Please, if at all possible, use the mailing
  44 list to ask questions! I read the list every day, sometimes more than once,
  45 and your question will not be answered any more quickly if it is sent
  46 directly to me, in fact, if I don't see the answer to your question right
  47 away, then it may just get filed until I have time to deal with it. Someone
  48 on the mailing list will probably be able to suggest a solution to your
  49 problem well before that.
  50
  51 The mailing list is being archived by Jeremy Hall . Copies of the archive
  52 can be obtained at ftp://rex.isdn.net/pub/diald. Currently the archives are
  53 updated once a month.
  54
  55 FAQ
  56
  57 There is a copy of the FAQ distributed with the diald release in the
  58 subdirectory "doc". This is the version that was current when the diald
  59 release was packaged. This may not be the most up to date version of the
  60 FAQ. The most up to date version can always be obtained from the diald home
  61 page. (See "Getting Diald" for the address of the home page.)
  62
  63 Before Installation
  64
  65 You must have SLIP devices in your kernel in order to use diald, EVEN IF YOU
  66 PLAN TO USE ONLY PPP CONNECTIONS! Let me repeat that, diald needs SLIP to
  67 work under all circumstances. It uses a SLIP link on a pseudo terminal to
  68 create the proxy device that stands in for the real connection. Naturally,
  69 if you plan on using diald to establish PPP connections, you must also have
  70 PPP devices in your kernel. You must also have a program like "chat" to do
  71 dialing.
  72
  73 Configuring Diald
  74
  75 Various pathnames that diald needs to know can be configured in "config.h".
  76 Edit this file appropriately. The eventual installation location for the
  77 diald binaries, the man pages and the diald definitions files can be
  78 configured in the Makefile.
  79
  80 Basic Installation (First Time Users)
  81
  82 First run "make depend" then "make" and then "make install" as root. This
  83 makes the diald daemon and installs it. After installation you need to write
  84 a /etc/diald.conf file to be able to use diald. Read the manual page to find
  85 out what this file can contain. The diald-examples manual page gives several
  86 example diald.conf files.
  87
  88 Installation If You Are Already Using an Earlier Version
  89
  90 Unlike previous releases of diald, the basic installation procedure no
  91 longer installs an /etc/diald.conf file. Therefore, you can follow the same
  92 installation procedure as for first time users (above). The set of standard
  93 filters rules is now located in "/usr/lib/diald/standard.filter". This used
  94 to be installed as /etc/diald.conf. If you want, you can now include this
  95 file into your /etc/diald.conf file with the new "include" directive. If you
  96 wish to change the rules in this file you should just copy them into another
  97 file and edit them as desired. You can either place rules directly in
  98 /etc/diald.conf, or put then in another file that is included by
  99 /etc/diald.conf. In any case, the syntax of the filter rules has not changed
 100 between diald 0.14 and diald 0.15, so you should be able to continue using
 101 your old /etc/diald.conf file. If you want to use a particuarly old
 102 /etc/diald.conf file you may need to update some of the contents as the
 103 names and meanings of various commands have evolved a little over time. In
 104 particular a major change in syntax took place between version 0.3 and 0.4
 105 and a change in semantics took place between version 0.7 and 0.8 and again
 106 between 0.10 and 0.11. See the CHANGES file for more information. If you are
 107 planning to use diald with a kernel numbered 1.3.75 or greater, then you
 108 MUST compile diald using the include files for that kernel.
 109
 110 Using Diald
 111
 112 There are several manual pages that cover the use of diald. The "diald"
 113 manual page is the basic reference manual for diald. It will point you at
 114 other relevant manual pages. Of particular interest will be the
 115 "diald-examples" manual page, which will help you get diald configured. You
 116 might also want to look at the contents of the "contrib" directory in this
 117 distribution.
 118
 119 Bugs, Limitations and Warnings
 120
 121 There are some known problems and limitations.
 122
 123 Lines in options files can contain at most 1024 characters. Longer lines are
 124 silently truncated.
 125
 126 If there are no filter rules specified then no packets will be matched and
 127 the daemon won't do anything. It should probably match all packets by
 128 default in this case.
 129
 130 Diald attempts to automatically adjust the MTU of the proxy to match the MTU
 131 of the actual connection negotiated by ppp, but this is not guaranteed to
 132 work, since changing the MTU on an active interface is not supported by the
 133 kernel. It is possible that an auto adjusted MTU will cause some long
 134 packets to get dropped on the floor. If you are having problems you should
 135 match these values manually. Diald will report the negotiated MTU in the
 136 system logs and warn you that you should adjust the settings.
 137
 138 The monitor command represents a security risk as anyone who has access to a
 139 diald control fifo can ask diald to write to any named pipe in the system.
 140 Be careful with the permissions on your fifo's.
 141
 142 Please send bug reports, patches or suggestions for improvements to me,
 143 preferably via the mailing list.
 144
 145 Eric Schenk
 146 Eric.Schenk@dna.lth.se
 147
 148 Lund, Sweden, January 28th, 1997.