UpSlug is written in C. You need to compile it with GNU C Compiler. These instructions are good for Linux, BSD, commercial SysV-compatible Unix, and under Windows with either Cygwin or MSYS.
First, you should install CVS, GCC, and GNU Make. Then open a command line shell, create a directory named something like slugtools, change directories there, and checkout the upslug module with CVS:
[when it asks for a password, leave blank and just press enter]
If this fails try "
note: upslug as found in CVS only compiles on Linux boxes. Wim Lewis has ported revision 1.16 to *BSD by making it use libpcap and (optionally) the pcap_inject() call found in recent libpcaps. This version of upslug is built as upslug-pcap. This version does not work on Linux, but should work fine (perhaps with a little extra porting) on other operating systems.
This should create a program called upslug in there. Copy it to /usr/local/bin if you like. Make sure your PATH contains /usr/local/bin or whatever directory upslug is in.
[enter root password]
Now comes the fun part :-) The following link has very good instructions on how to get the NSLU2 into the bootloader, where you can flash the ROM with relative ease (the web-based update has never worked reliably with any of my three slugs).
I use the perl script provided in that page, it's not failed me once. Copy and paste the perl script into a file named
Then shut off your NSLU2 unit, and get ready to run the script
Press enter at the same time you turn on the NSLU2!
Once you have telnetted into the NSLU2 RedBoot, then do the following:
type the command upgrade
The NSLU will stop responding to the keyboard, and the top LED will flash red. That's OK, it means it's ready to be flashed. Quit telnet by typing Ctrl-] then at the telnet> prompt, type quit or exit (Windows's telnet uses quit, most Unix use exit).
Then run upslug
upslug -u [unslung-image-filename-goes-here]
CAREFUL: DO NOT type -U <-- uppercase u. BIG MISTAKE!!! (unless you have JTAG cables and embedded systems experience)