IPCop InterfaceLED README file. (This README is adapted from the sifled README written by Martin Pot) What is it? ----------- (IP)Cop InterfaceLED (cifled) is heavily based on Smoothwall InterfaceLED (sifled), a program that uses the keybord LEDs to indicated various things about a specified interface, ie, if a network card is sending or receiving data. sifled (Smoothwall InterfaceLED) is based on InterfaceLED (ifled). cifled has some functionality specifically for use with IPCop (www.ipcop.org), namely to allow one of the LEDs to indicate the status of the IPCop RED interface (ie, up or down). sifled homepage: http://martybugs.net/smoothwall/leds.cgi cifled homepage: http://www.ipadd.de/binary.html How do i install it? -------------------- General installation guidelines: http://www.ipadd.de/binary.html#guide To make it automatically start whenever your IPCop box reboots, add some lines to the end of your /etc/rc.d/rc.event.local to start cifled. ie, ### STARTaddto cifled if [ ${1} == "red" -a ${2} == "up" ]; then /usr/bin/cifled console wan-1 -c ltr -f fi ### ENDaddto cifled How do i use it? ---------------- Just run "cifled [tty here] [interface here]" to use the default settings. Use "console" as tty to use the current tty, as interface use the interface you would like to monitor eg: lan-1, wan-1 ppp0. To run the cifled in background add -f to the command line. Example command: cifled console wan-1 -f How do i config the LEDs? / How do i get cifled not to touch my num-lock etc? ---------------------------------------------------------------------------- Look in the list of options from the help (start cifled with no arguments). For exmaple "-c crt" will make num-lock indicate collisions, caps-lock indicate receiveing of data and scroll-lock indicate transmitting of data. A popular LED config is "-c nna" this will make num-lock and caps-lock work as normal (hopefully) and scroll-lock indicate activity (the interface is receiving or transmitting data) Note: You can't use arguments like "-ic nna", use "-i -c nna" insted. How do i get the none option to work in console? ------------------------------------------------ If you can't use your (num,caps,scroll)-lock as normal when you use the none option on them, try the "-a" option it may work. The keybord is weird, keys get stuck etc ---------------------------------------- Try to increase the LED update delay by use the -d parameter. 100ms should solve the problem, if not try to increase even more. Note that the LEDs will flash slower at higher LED update delays. How to i monitor more then one interface? ----------------------------------------- Use the "n" option with the "-c" parameter for example: ./cifled console ppp0 -c nla -f // Caps-lock will indicate status of IPCop RED interface // and Scroll-lock will flash on activity on ppp0 ./cifled console lan-1 -c ann -f // Num-lock will flash on activity on lan-1 The terminal LEDs gets fu*ked up after i have run cifled ------------------------------------------------------- Type the command "reset" to do a terminal initialization. Note that you'll probably have to login to your IPCop console to do this, as I haven't had much success running this through a SSH connection. Tom Eichstaedt Martin Pot Mattias Wadman