user/netflash/netflash.8

   1 .Dd May 26, 2001
   2 .Dt NETFLASH 8
   3 .Os "uClinux-coldfire-tools"
   4 .Sh NAME
   5 .Nm netflash
   6 .Nd upgrade firmware on uclinux-coldfire platforms using the blkmem interface.
   7 .Sh SYNOPSIS
   8 .Nm netflash
   9 .Op Fl vnbhk?
  10 .Op Fl d Ar delay
  11 .Op Fl c Ar console
  12 .Op Fl r Ar flash-device
  13 .Op Ar net-server
  14 .Ar file-name
  15 .Sh DESCRIPTION
  16 .Nm netflash
  17 is a program that allows upgrading to the latest versions of software
  18 available.  It is able to download these images over the network using either
  19 .Tn http
  20 or
  21 .Tn tftp.
  22 It can flash into any /dev/rom device that provides a blkmem
  23 interface.
  24 .Sh OPERATION
  25 .Pp
  26 When invoked,
  27 .B netflash
  28 attempts to entirely load the specified file into main memory, and then write
  29 out the file to the desired flash device.  If there is not enough memory to
  30 entirely load the file into memory,
  31 .B netflash
  32 exists in error.
  33 .Pp
  34 A file can be loaded from a local file, over an IP network using either
  35 http or tftp, on some systems ftp is available.
  36 .Sh COMMAND LINE
  37 .Bl -tag -width Ds
  38 .It Fl v
  39 Output version information for the netflash.
  40 .It Fl n
  41 Don't check the checksum at the end of the file that is downloaded.
  42 .It Fl b
  43 Don't reboot the system once the file has been programmed into the flash device.
  44 .It Fl h
  45 Print online help.
  46 .It Fl k
  47 Don't kill processes to try and make enough room for the downloaded image.  On
  48 units that are running a lot of services (i.e. a lot of pptp-server connections)
  49 , or units that don't have much RAM, this option may not work.
  50 .It Fl d Ar delay
  51 Wait
  52 .Ar delay
  53 seconds before starting to aqcuire the requested image.
  54 .It Fl c Ar console
  55 Use the specified device as the main tty when the program is run.
  56 .It Fl r Ar flash-device
  57 Once the image is acquired, try to load the image into the specified flash
  58 device.
  59 .It Ar net-server
  60 Either the name, or IP address of the server that contains the device.  If you
  61 are flashing a local file, or downloading a file using http, then you don't need
  62 this option.
  63 .It Ar file-name
  64 The filename which you are trying to load locally.  For http transfers this
  65 should be of the type:
  66 .Pp
  67 http://my.server.com/filename.
  68 .Sh SEE ALSO
  69 .Xr flashw 8
  70 .Sh AUTHOR
  71 Matthew Natalier (matthewn@snapgear.com)