table of contents
UPSLUG2(8) | System Manager's Manual | UPSLUG2(8) |
NAME¶
upslug2 - utility to upgrade the firmware of a NSLU2 via the networkSYNOPSIS¶
upslug2 [options]DESCRIPTION¶
upslug2 is a command line program intended to allow the upgrade the firmware of a Linksys NSLU2 (Network Storage Link for USB 2.0 Disk Drives) to new or different versions. When a NSLU2 in the local network is put in upgrade mode, upslug2 can connect to it and upload a new firmware.OPTIONS¶
- -C, --Complete-reprogram
- Reprogram the complete flash, including the RedBoot boot
loader and the SysConf partition holding configuration information. Using
this option may result in the NSLU2 becoming permanently unusable! By
default, upslug2 will not touch these two partitions since this
allows flashing a new firmware if an uploaded firmware does not work. This
is not possible if RedBoot itself is damaged. Use with caution.
- -d, --device
- The network device on the host machine connected to the
network on which the NSLU2 is located. (Default: eth0).
- -e, --endian
- The endianness of the files to be uploaded. upslug2
will usually detected the endianness automatically but this option can be
used to force byte swapping to occur. This option accepts three values,
separated by comma: endianness of kernel, data and RedBoot FIS directory.
Valid values are l (little endian), p (pdp endian) and
b (big endian). (Default: ,b,b)
- -f, --from
- The MAC address of the host system.
- -h, --help
- Show summary of options.
- -i, --image
- The complete flash image to use.
- -j, --rootfs
- A root filesystem, usually of type jffs.
- -k, --kernel
- A compressed kernel zImage image.
- -n, --no-reboot
- Do not reboot after upgrade
- -p, --payload
- FIS directory payload. There are about 140 Kb in the last
block (between the FIS dir and the trailer at the end) which can be used
for data.
- -r, --ramdisk
- A compressed ramdisk image.
- -R, --ram-payload
- A ram paylod (replaced ramdisk). (FIXME: if it replaced the
ramdisk, why cannot you just use the -r option? What's the difference)
- -t, --target
- The MAC address of the NSLU2 to upgrade. Without this
option, upslug2 will only perform an upgrade if there is just one
NSLU2 in upgrade mode.
- -U, --no-verify
- Do not verify the image, only upgrade.
- -v, --verify
- Do not write to flash, only verify the image.
Options to specify firmware information¶
The following options should be used when individual kernel, ramdisk and root filesystem files are specified rather than a complete firmware image.- -E, --extra-version
- Extra version information, a 2 byte value. (Default:
0x90f7)
- -F, --firmware-version
- The firmware version, a 2 byte value. (Default: 0x2329)
- -P, --product-id
- The product ID, a 2 byte value. (Default: 1)
- -T, --protocol-id
- The protocol ID, a 2 byte value. (Default: 0)
USING UPSLUG2¶
In order to use upslug2 the NSLU2 which is to be upgraded has to be put in upgrade mode:EXAMPLES¶
The most common use of upslug2 is the following:upslug2 --image NSLU2_V23R63.bin
This specifies a complete firmware image which will be written to flash.
upslug2 -k nslu2-zImage -r ramdisk -j
root.jffs
In this case, the options -E, -F, -P and -T should
typically be specified as well.
upslug2 -d eth1 --image NSLU2_V23R63.bin
upslug2 -t 00:11:85:12:34:56 --image
NSLU2_V23R63.bin
SEE ALSO¶
slugimage(1)AUTHOR¶
John Bowler <jbowler@acm.org>January 2006 |