Return to README.openwrt CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / miniupnpd

Annotation of embedaddon/miniupnpd/README.openwrt, revision 1.1.1.1

1.1       misho       1: MiniUPnP Daemon
                      2: (c) 2006 Thomas Bernard
                      3: This software is subject to the conditions detailed in
                      4: the LICENCE file provided within the distribution.
                      5: 
                      6: How to build and run miniupnpd for your router running openwrt.
                      7: These instructions apply to the OpenWRT WHITE RUSSIAN (RC6) version.
                      8: My device is a Linksys WRT54G v1, used in pppoe mode.
                      9: More information about OpenWRT on http://openwrt.org/
                     10: 
                     11: First make sure that openwrt white russian RC6 is up and running on your
                     12: router device.
                     13: 
                     14: NOTES : Makefile.openwrt has been updated, following informations could
                     15:         be inacurate.
                     16:         The X-Wrt team made an ipk package out of miniupnpd,
                     17:         check the webpage : http://www.x-wrt.org/
                     18: 
                     19: * A. COMPILATION *
                     20: 
                     21: To Build, use your PC. I have been using the SDK but you might need
                     22: to compile the cross compiler yourself.
                     23: 
                     24: 1. Get the SDK from http://downloads.openwrt.org/whiterussian/rc6/
                     25:    I used http://downloads.openwrt.org/whiterussian/rc6/OpenWrt-SDK-Linux-ppc-1.tar.bz2
                     26:    unpack somewhere and add the bin directory to your PATH environement :
                     27:    > tar xvjf OpenWrt-SDK-Linux-i686-1.tar.bz2
                     28:    > PATH=`pwd`/OpenWrt-SDK-Linux-i686-1/staging_dir_mipsel/bin:$PATH
                     29:    >  mipsel-linux-gcc --version
                     30: mipsel-linux-gcc (GCC) 3.4.4 (OpenWrt-1.0)
                     31: [...]
                     32: 
                     33: 2. Get iptables 1.3.3 sources from http://downloads.openwrt.org/sources/iptables-1.3.3.tar.bz2
                     34:    unpack and compile libiptc.a
                     35:    > tar xvjf iptables-1.3.3.tar.bz2
                     36:    > cd iptables-1.3.3/libiptc/
                     37:    > make CC=mipsel-linux-gcc
                     38: 
                     39: 3. Go to miniupnpd directory and edit the Makefile.openwrt to make
                     40:    IPTABLESINC and LIBS variables point to the correct directory.
                     41:    > make -f Makefile.openwrt
                     42:    > mipsel-linux-strip miniupnpd
                     43: 
                     44: That's it !
                     45: 
                     46: 
                     47: * B. INSTALLATION - USAGE *
                     48: 
                     49: 1. copy miniupnpd and scripts to the device :
                     50:    > scp miniupnpd root@192.168.1.1:.
                     51:    > cd linux
                     52:    > scp iptables_init.sh iptables_flush.sh root@192.168.1.1:.
                     53:    > scp iptables_display.sh iptables_removall.sh root@192.168.1.1:.
                     54: 
                     55: 2. log onto your router and edit the scripts in order to adapt to your
                     56:    configuration : EXTIF variable shoud be set to your external network
                     57:    interface. In my case it is ppp0
                     58: 
                     59: 3. init tables :
                     60:    > ./iptables_init.sh
                     61: 
                     62: 4. run the daemon :
                     63:    ./miniupnpd -i ppp0 -a 192.168.1.1 -p 5000 -U -d
                     64:    -d option is a debug option to prevent the program from going to
                     65:    background. It is usefull to see the debug messages and check if everything
                     66:    is ok.
                     67: 
                     68: 5. Once you checked that everything is ok,
                     69:    you can set up a script in /etc/init.d etc...
                     70: 
                     71:    If you can build an ipkg package for miniupnpd, I'll be glad !
                     72: 
                     73: Thomas
                     74: contact me by email : miniupnp@free.fr
                     75: 
                     76: