FairuzaWRT README DISCLAIMER FairuzaWRT is experimental software. If you brick your WRT by using this firmware it is not our fault, we warned you. Also, if you use this firmware to do something you should not be doing, then that is also your fault and shame on you. DOCUMENTATION We know there is an extreme lack of documentation. If you run in to problems or find a problem we may not know about please contact us: fairuzawrt {at} hackerpimps {dot} com Check for new versions at: www.hackerpimps.com **EXPECTATIONS OF A FAIRUZAWRT USER** **YOU'D BETTER DAMNED SURE READ THIS BEFORE INSTALLING** If you do not know how to use telnet, SSH or TFTP before loading this firmware, YOU ARE ON YOUR OWN!!! Do NOT email us asking how to get your old firmware back on to your WRT54GS, how to use the tools that are on the firmware or where the telnet command is in Windows (actual email). We expect the user to know these things already, otherwise, what exactly is the point of you using our firmware? It's all text based tools in there. The web interface we include in our firmware currently does NOTHING. If you're not comfortable with a command line interface, then you're probably better off either keeping the default firmware or using something like Sveasoft. Also, please use Google (or learn to use Google) before emailing us something stupid. Bug reports and feature requests good. Stupid questions BAD. INSTALLATION On a default firmware just go to your update firmware page, press the button to browse for new firmware, and choose the firmware you would like to upload from your hard drive. LOGGING IN The first time you log in you can do it via telnet to the standard telnet port 23. This will allow you to change the root password with the passwd command. There is only the root account on FairuzaWRT, so if you try to SSH in it will ask you for the root password. If you really must know what the root password is, it should be asdfasdf for this version of FairuzaWRT. If you have any problems please let us know. ssh -l root CHANGING SETTINGS FairuzaWRT is based off of the OpenWRT project www.openwrt.org. Configuration of the base firmware is pretty much the same. There are many settings that can be changed in FairuzaWRT. The initial settings you are most likely going to want to change are things like SSID and WEP keys. These things can be done though modifying their associated nvram variables or can be done through the FairuzaUS utility loaded in the /usr/bin directory. Some basic functions can be done thorough the FairuzaUS interface. Other settings are set in nvram. It may be necessary when configuring FairuzaWRT to change some of these settings. There are quite a few. nvram show - lists the nvram settings nvram set = - will set the nvram value for the given variable nvram commit - commits the change in nvram There are times when setting things in nvram when the access point needs to be rebooted for the change to take effect. If you set a value and it doesn't seem to be taking effect reboot the access point. INSTALLING & REMOVING SOFTWARE Some of the software necessary to perform some of the functions have not been installed by default. This is because of personal preference. Some individuals may want to space to do other things. So if you are looking to do something you may need to install software from the repository. The default software repository for FairuzaWRT is the Hacker Pimps repository. Installing software is done through ipkg. Ipkg is similar to apt. There are several useful commands: ipkg update - updates the software from the repository ipkg list - lists the software available ipkg install - installs the selected package ipkg remove - removes the selected package Ipkg software repositories are configured through the ipkg.conf file in the /etc directory. This file is read only and cannot be modified by default. To modify the ipkg.conf file delete it with: rm ipkg.conf and then copy the ipkg.conf from rom into the /etc directory like so: cp /rom/etc/ipkg.conf /etc/ipkg.conf Now you are able to add software repositories to your ipkg.conf RUNNING THE EXPLOITS The exploits are located in /usr/sbin. Navigate to that directory and you will see them in that folder. FairuzaUS FairuzaUS is a small menu-driven utility for easing certain tasks in FairuzaWRT. It is still in the beginning stages and is meant for much more integration into FairuzaWRT. CHANGELOG 0.01 Initial Release 0.02 Added fairuzaus.sh to /usr/bin (FairuzaUS configuration script) sha1 sums: bef4e919b06ae44eff40667d2b217d20ca493874 fairuzawrt-02.bin af55e9e17210a64d62eacc923de3e6f781abcde7 fairuzawrt-02.trx