summaryrefslogtreecommitdiff
path: root/readme.txt
blob: 6afae725b9073f63ea36c7db0bec3aea2804c28b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
       uIP/FOSSIL Version 1.0
       ======================

       Welcome to the wonderful world of TCP/IP on MS-DOS!  This package is
   a port of uIP Version 1.0 from Adam Dunkels to MS-DOS systems running
   FOSSIL (Fido-Opus-Seadog Standard Interface Layer) drivers.  The TCP/IP
   device is implemented as a SLIP (Serial Line Interface Protocol)
   connection via the FOSSIL driver.

       The implementation is compatible with SLIP drivers present on
   GNU/Linux systems and probably many others.  The driver implements
   normal SLIP (as opposed to CSLIP or even PPP) connections, which are a
   bit on the slow side.

       This port of uIP is licensed under the highly permissive modifed BSD
   license, as explained in the COPYING file.

       The source code encompasses a complete port of uIP to
   SLIP-over-FOSSIL setups.  As an example, the web server application has
   been modified and included in the source code.  Other uIP applications
   should be able to compile using the SLIP and FOSSIL code from this port
   with minimal to no modifications.

       Compiling
       =========

       uIP in general and the FOSSIL port in particular are designed to
   compile on almost any ANSI C compiler.  The code does not use any
   floating point mathematics.

       This uIP port was engineered to compile using the OpenWatcom
   compiler.  The uIP project is contained in the topmost 'watcom'
   directory.  The entire project is stored in 'uip-rb.wpj', and a single
   target, 'httpd.exe', has been defined for this project.

       Prior to building the uIP project, the FosLib15 library must be
   built.  The library provides a simplified C interface to the FOSSIL
   driver.  The library source code is located in 'slip/foslib15'
   directory, and a watcom project file is located in the 'watcom'
   subdirectory.

       A Makefile has been included that is compatible with Turbo C 2.0.
   However, Turbo C seems to get confused during compile on certain files.
   Use at your own risk...

       The Web Server
       ==============

       The example web server code included implements a rather simple, yet
   complete, http server solution.  To start the web server over a SLIP
   connection, use the following command:

       HTTPD <gateway ip> <local ip> <netmask> <com port> <speed>

       The com port is 0-based, meaning COM1 would be '0'.  The speed is
   any acceptable FOSSIL speed up to and including 38400 when applicable.

       The web server must be located in the same directory as the root web
   pages it will be serving.

       Setting up SLIP on Linux
       ========================

       Information about configuring SLIP on Linux can be found at:

       http://jba.freeshell.org/uip-linux.html

       Questions and Support
       =====================

       Any questions about this port should be directed to PrintStar (Jeff
   Armstrong) at jeff@rainbow-100.com.

       ---
       Jeff Armstrong (aka PrintStar)
       jeff@rainbow-100.com
       http://jeff.rainbow-100.com/
       January 31, 2009