ethtool: Add a new ethtool option to flash a firmware image from the specified file to a device.
Subsystems (2)
RFC PATCH v5 1/1 ethtool: Add a new ethtool option to flash a firmware image from the specified file to a device.
This patch adds a new "-f" option to the ethtool utility
to flash a firmware image specified by a file, to a network device. The filename is passed to the network driver which will flash the image on the chip using the request_firmware path.
The region "on the chip" to be flashed can be specified by an option. It is upto the device driver to enumerate the region number passed by ethtool, to the region to be flashed.
The default behavior is to flash all the regions on the chip.
Usage:
ethtool -f <interface name> <filename of firmware image>
ethtool -f <interface name> <filename of firmware image> [ REGION-NUMBER-TO-FLASH ]
--- ethtool-copy.h | 13 +++++++++++++ ethtool.8 | 15 +++++++++++++++ ethtool.c | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 3 files changed, 82 insertions(+), 1 deletions(-)
ethtool-copy.h +13 -0
@@ -272,6 +272,18 @@ struct ethtool_perm_addr {__u8 data[0 ]; }; +#define ETHTOOL_FLASH_MAX_FILENAME 128 +enum ethtool_flash_op_type { +ETHTOOL_FLASH_ALL_REGIONS =0 , +}; + +/* for passing firmware flashing related parameters */ +struct ethtool_flash { +__u32 cmd; +__u32 region; +char data[ETHTOOL_FLASH_MAX_FILENAME ]; +}; +/* boolean flags controlling per-interface behavior characteristics. * When reading, the flag indicates whether or not a certain behavior * is enabled/present. When writing, the flag indicates whether
@@ -338,6 +350,7 @@ struct ethtool_rxnfc {#define ETHTOOL_SRXFH 0x0000002a/* Set RX flow hash configuration */ #define ETHTOOL_GGRO 0x0000002b/* Get GRO enable (ethtool_value) */ #define ETHTOOL_SGRO 0x0000002c/* Set GRO enable (ethtool_value) */ +#define ETHTOOL_FLASHDEV 0x00000033/* Flash firmware to device */ /* compatibility with older code */ #define SPARC_ETH_GSET ETHTOOL_GSET
ethtool.8 +15 -0
@@ -207,6 +207,11 @@ ethtool \- Display or change ethernet card settings .I ethX .RB [ rx-flow-hash \ \*(FL .RB \ \*(HO] + +.B ethtool \-f|\-\-flash +.I ethX +.RI FILE +.RI [ N ] .SH DESCRIPTION .BI ethtool is used for querying settings of an ethernet device and changing them.
@@ -501,6 +506,16 @@ Hash on bytes 2 and 3 of the Layer 4 header of the rx packet. Discard all packets of this flow type. When this option is set, all other options are ignored. .PD .RE +.TP +.B \-f \-\-flash \ FILE +Flash firmware image from the specified file to a region on the adapter. +By default this will flash all the regions on the adapter. +.TP +.B N +A number to identify flash region where the image should be flashed. +Default region is 0 which denotes all regions in the flash. +.PD +.RE .SH BUGS Not supported (in part or whole) on all ethernet drivers. .SH AUTHOR
ethtool.c +54 -1
109 lines not on this page · raw message
Signature · 1 line
1.6.0.4