@@ -536,6 +536,13 @@ ethtool \- query or control network driver and hardware settings
.I devname
.RB [ podl\-pse\-admin\-control
.BR enable | disable ]
+.HP
+.B ethtool \-\-flash\-module\-firmware
+.I devname
+.BI file
+.IR FILE
+.RB [ pass
+.IR PASS ]
.
.\" Adjust lines (i.e. full justification) and hyphenate.
.ad
@@ -1772,6 +1779,28 @@ Set Power Sourcing Equipment (PSE) parameters.
This parameter manages PoDL PSE Admin operations in accordance with the IEEE
802.3-2018 30.15.1.2.1 (acPoDLPSEAdminControl) specification.
+.RE
+.TP
+.B \-\-flash\-module\-firmware
+Flash the transceiver module's firmware. The firmware update process is
+composed from three logical steps. Downloading a firmware image to the
+transceiver module, running the image and committing the image so that it is
+run upon reset. When flash command is given, the firmware update process is
+performed in its entirety in that order.
+.RS 4
+.TP
+.BI file \ FILE
+Specifies the filename of the transceiver module firmware image. The firmware
+must first be installed in one of the directories where the kernel firmware
+loader or firmware agent will look, such as /lib/firmware. The firmware image
+is downloaded to the transceiver module, validated, run and committed.
+.RE
+.RS 4
+.TP
+.BI pass \ PASS
+Optional transceiver module password that might be required as part of the
+transceiver module firmware update process.
+
.SH BUGS
Not supported (in part or whole) on all network drivers.
.SH AUTHOR
@@ -6218,6 +6218,13 @@ static const struct option args[] = {
.xhelp = " [ podl-pse-admin-control enable|disable ]\n"
" [ c33-pse-admin-control enable|disable ]\n"
},
+ {
+ .opts = "--flash-module-firmware",
+ .nlfunc = nl_flash_module_fw,
+ .help = "Flash transceiver module firmware",
+ .xhelp = " file FILE\n"
+ " [ pass PASS ]\n"
+ },
{
.opts = "-h|--help",
.no_dev = true,
@@ -496,6 +496,17 @@ static const struct pretty_nla_desc __mm_desc[] = {
NLATTR_DESC_NESTED(ETHTOOL_A_MM_STATS, mm_stat),
};
+static const struct pretty_nla_desc __module_fw_flash_desc[] = {
+ NLATTR_DESC_INVALID(ETHTOOL_A_MODULE_FW_FLASH_UNSPEC),
+ NLATTR_DESC_NESTED(ETHTOOL_A_MODULE_FW_FLASH_HEADER, header),
+ NLATTR_DESC_STRING(ETHTOOL_A_MODULE_FW_FLASH_FILE_NAME),
+ NLATTR_DESC_U32(ETHTOOL_A_MODULE_FW_FLASH_PASS),
+ NLATTR_DESC_U32(ETHTOOL_A_MODULE_FW_FLASH_STATUS),
+ NLATTR_DESC_STRING(ETHTOOL_A_MODULE_FW_FLASH_STATUS_MSG),
+ NLATTR_DESC_UINT(ETHTOOL_A_MODULE_FW_FLASH_DONE),
+ NLATTR_DESC_UINT(ETHTOOL_A_MODULE_FW_FLASH_TOTAL),
+};
+
const struct pretty_nlmsg_desc ethnl_umsg_desc[] = {
NLMSG_DESC_INVALID(ETHTOOL_MSG_USER_NONE),
NLMSG_DESC(ETHTOOL_MSG_STRSET_GET, strset),
@@ -541,6 +552,7 @@ const struct pretty_nlmsg_desc ethnl_umsg_desc[] = {
NLMSG_DESC(ETHTOOL_MSG_PLCA_GET_STATUS, plca),
NLMSG_DESC(ETHTOOL_MSG_MM_GET, mm),
NLMSG_DESC(ETHTOOL_MSG_MM_SET, mm),
+ NLMSG_DESC(ETHTOOL_MSG_MODULE_FW_FLASH_ACT, module_fw_flash),
};
const unsigned int ethnl_umsg_n_desc = ARRAY_SIZE(ethnl_umsg_desc);
@@ -590,6 +602,7 @@ const struct pretty_nlmsg_desc ethnl_kmsg_desc[] = {
NLMSG_DESC(ETHTOOL_MSG_PLCA_NTF, plca),
NLMSG_DESC(ETHTOOL_MSG_MM_GET_REPLY, mm),
NLMSG_DESC(ETHTOOL_MSG_MM_NTF, mm),
+ NLMSG_DESC(ETHTOOL_MSG_MODULE_FW_FLASH_NTF, module_fw_flash),
};
const unsigned int ethnl_kmsg_n_desc = ARRAY_SIZE(ethnl_kmsg_desc);
@@ -55,6 +55,7 @@ int nl_get_mm(struct cmd_context *ctx);
int nl_set_mm(struct cmd_context *ctx);
int nl_gpse(struct cmd_context *ctx);
int nl_spse(struct cmd_context *ctx);
+int nl_flash_module_fw(struct cmd_context *ctx);
void nl_monitor_usage(void);
@@ -130,6 +131,7 @@ nl_get_eeprom_page(struct cmd_context *ctx __maybe_unused,
#define nl_set_mm NULL
#define nl_gpse NULL
#define nl_spse NULL
+#define nl_flash_module_fw NULL
#endif /* ETHTOOL_ENABLE_NETLINK */
@@ -10,6 +10,7 @@
#include <inttypes.h>
#include <string.h>
#include <stdio.h>
+#include <stdarg.h>
#include "../internal.h"
#include "../common.h"
@@ -177,3 +178,185 @@ int nl_smodule(struct cmd_context *ctx)
else
return nlctx->exit_code ?: 83;
}
+
+/* MODULE_FW_FLASH_ACT */
+
+static const struct param_parser flash_module_fw_params[] = {
+ {
+ .arg = "file",
+ .type = ETHTOOL_A_MODULE_FW_FLASH_FILE_NAME,
+ .handler = nl_parse_string,
+ .min_argc = 1,
+ },
+ {
+ .arg = "pass",
+ .type = ETHTOOL_A_MODULE_FW_FLASH_PASS,
+ .handler = nl_parse_direct_u32,
+ .min_argc = 1,
+ },
+ {}
+};
+
+struct module_flash_context {
+ uint8_t breakout:1,
+ first:1;
+};
+
+static int module_fw_flash_ntf_cb(const struct nlmsghdr *nlhdr, void *data)
+{
+ const struct nlattr *tb[ETHTOOL_A_MODULE_FW_FLASH_MAX + 1] = {};
+ struct module_flash_context *mfctx;
+ struct nl_context *nlctx = data;
+ DECLARE_ATTR_TB_INFO(tb);
+ u8 status = 0;
+ int ret;
+
+ mfctx = nlctx->cmd_private;
+
+ ret = mnl_attr_parse(nlhdr, GENL_HDRLEN, attr_cb, &tb_info);
+ if (ret < 0)
+ return MNL_CB_OK;
+ nlctx->devname = get_dev_name(tb[ETHTOOL_A_MODULE_FW_FLASH_HEADER]);
+ if (!dev_ok(nlctx))
+ return MNL_CB_OK;
+
+ if (tb[ETHTOOL_A_MODULE_FW_FLASH_STATUS])
+ status = mnl_attr_get_u32(tb[ETHTOOL_A_MODULE_FW_FLASH_STATUS]);
+
+ switch (status) {
+ case ETHTOOL_MODULE_FW_FLASH_STATUS_STARTED:
+ print_string(PRINT_FP, NULL,
+ "Transceiver module firmware flashing started for device %s\n",
+ nlctx->devname);
+ break;
+ case ETHTOOL_MODULE_FW_FLASH_STATUS_IN_PROGRESS:
+ if (mfctx->first) {
+ print_string(PRINT_FP, NULL,
+ "Transceiver module firmware flashing in progress for device %s\n",
+ nlctx->devname);
+ mfctx->first = 0;
+ }
+ break;
+ case ETHTOOL_MODULE_FW_FLASH_STATUS_COMPLETED:
+ print_nl();
+ print_string(PRINT_FP, NULL,
+ "Transceiver module firmware flashing completed for device %s\n",
+ nlctx->devname);
+ mfctx->breakout = 1;
+ break;
+ case ETHTOOL_MODULE_FW_FLASH_STATUS_ERROR:
+ print_nl();
+ print_string(PRINT_FP, NULL,
+ "Transceiver module firmware flashing encountered an error for device %s\n",
+ nlctx->devname);
+ mfctx->breakout = 1;
+ break;
+ default:
+ break;
+ }
+
+ if (tb[ETHTOOL_A_MODULE_FW_FLASH_STATUS_MSG]) {
+ const char *status_msg;
+
+ status_msg = mnl_attr_get_str(tb[ETHTOOL_A_MODULE_FW_FLASH_STATUS_MSG]);
+ print_string(PRINT_FP, NULL, "Status message: %s\n", status_msg);
+ }
+
+ if (tb[ETHTOOL_A_MODULE_FW_FLASH_DONE] &&
+ tb[ETHTOOL_A_MODULE_FW_FLASH_TOTAL]) {
+ uint64_t done, total;
+
+ done = attr_get_uint(tb[ETHTOOL_A_MODULE_FW_FLASH_DONE]);
+ total = attr_get_uint(tb[ETHTOOL_A_MODULE_FW_FLASH_TOTAL]);
+
+ if (total)
+ print_u64(PRINT_FP, NULL, "Progress: %"PRIu64"%\r",
+ done * 100 / total);
+ }
+
+ return MNL_CB_OK;
+}
+
+static int nl_flash_module_fw_cb(const struct nlmsghdr *nlhdr, void *data)
+{
+ const struct genlmsghdr *ghdr = (const struct genlmsghdr *)(nlhdr + 1);
+
+ if (ghdr->cmd != ETHTOOL_MSG_MODULE_FW_FLASH_NTF)
+ return MNL_CB_OK;
+
+ module_fw_flash_ntf_cb(nlhdr, data);
+
+ return MNL_CB_STOP;
+}
+
+static int nl_flash_module_fw_process_ntf(struct cmd_context *ctx)
+{
+ struct nl_context *nlctx = ctx->nlctx;
+ struct module_flash_context *mfctx;
+ struct nl_socket *nlsk;
+ int ret;
+
+ nlsk = nlctx->ethnl_socket;
+
+ mfctx = malloc(sizeof(struct module_flash_context));
+ if (!mfctx)
+ return -ENOMEM;
+
+ mfctx->breakout = 0;
+ mfctx->first = 1;
+ nlctx->cmd_private = mfctx;
+
+ while (!mfctx->breakout) {
+ ret = nlsock_process_reply(nlsk, nl_flash_module_fw_cb, nlctx);
+ if (ret)
+ goto out;
+ nlsk->seq++;
+ }
+
+out:
+ free(mfctx);
+ return ret;
+}
+
+int nl_flash_module_fw(struct cmd_context *ctx)
+{
+ struct nl_context *nlctx = ctx->nlctx;
+ struct nl_msg_buff *msgbuff;
+ struct nl_socket *nlsk;
+ int ret;
+
+ if (netlink_cmd_check(ctx, ETHTOOL_MSG_MODULE_FW_FLASH_ACT, false))
+ return -EOPNOTSUPP;
+ if (!ctx->argc) {
+ fprintf(stderr, "ethtool (--flash-module-firmware): parameters missing\n");
+ return 1;
+ }
+
+ nlctx->cmd = "--flash-module-firmware";
+ nlctx->argp = ctx->argp;
+ nlctx->argc = ctx->argc;
+ nlctx->devname = ctx->devname;
+ nlsk = nlctx->ethnl_socket;
+ msgbuff = &nlsk->msgbuff;
+
+ ret = msg_init(nlctx, msgbuff, ETHTOOL_MSG_MODULE_FW_FLASH_ACT,
+ NLM_F_REQUEST | NLM_F_ACK);
+ if (ret < 0)
+ return 2;
+ if (ethnla_fill_header(msgbuff, ETHTOOL_A_MODULE_FW_FLASH_HEADER,
+ ctx->devname, 0))
+ return -EMSGSIZE;
+
+ ret = nl_parser(nlctx, flash_module_fw_params, NULL, PARSER_GROUP_NONE,
+ NULL);
+ if (ret < 0)
+ return 1;
+
+ ret = nlsock_sendmsg(nlsk, NULL);
+ if (ret < 0)
+ fprintf(stderr, "Cannot flash transceiver module firmware\n");
+ else
+ ret = nl_flash_module_fw_process_ntf(ctx);
+
+ return ret;
+}
@@ -175,4 +175,20 @@ static inline int netlink_init_rtnl_socket(struct nl_context *nlctx)
return nlsock_init(nlctx, &nlctx->rtnl_socket, NETLINK_ROUTE);
}
+static inline uint64_t attr_get_uint(const struct nlattr *attr)
+{
+ switch (mnl_attr_get_payload_len(attr)) {
+ case sizeof(uint8_t):
+ return mnl_attr_get_u8(attr);
+ case sizeof(uint16_t):
+ return mnl_attr_get_u16(attr);
+ case sizeof(uint32_t):
+ return mnl_attr_get_u32(attr);
+ case sizeof(uint64_t):
+ return mnl_attr_get_u64(attr);
+ }
+
+ return -1ULL;
+}
+
#endif /* ETHTOOL_NETLINK_INT_H__ */
@@ -15,6 +15,8 @@
#include <linux/if_link.h>
#include <libmnl/libmnl.h>
+#include "../internal.h"
+#include "netlink.h"
#include "prettymsg.h"
#define __INDENT 4
@@ -114,6 +116,9 @@ static int pretty_print_attr(const struct nlattr *attr,
case NLA_U64:
printf("%" PRIu64, mnl_attr_get_u64(attr));
break;
+ case NLA_UINT:
+ printf("%" PRIu64, attr_get_uint(attr));
+ break;
case NLA_X8:
printf("0x%02x", mnl_attr_get_u8(attr));
break;
@@ -18,6 +18,7 @@ enum pretty_nla_format {
NLA_U16,
NLA_U32,
NLA_U64,
+ NLA_UINT,
NLA_X8,
NLA_X16,
NLA_X32,
@@ -67,6 +68,7 @@ struct pretty_nlmsg_desc {
#define NLATTR_DESC_U16(_name) NLATTR_DESC(_name, NLA_U16)
#define NLATTR_DESC_U32(_name) NLATTR_DESC(_name, NLA_U32)
#define NLATTR_DESC_U64(_name) NLATTR_DESC(_name, NLA_U64)
+#define NLATTR_DESC_UINT(_name) NLATTR_DESC(_name, NLA_UINT)
#define NLATTR_DESC_X8(_name) NLATTR_DESC(_name, NLA_X8)
#define NLATTR_DESC_X16(_name) NLATTR_DESC(_name, NLA_X16)
#define NLATTR_DESC_X32(_name) NLATTR_DESC(_name, NLA_X32)
@@ -1164,6 +1164,32 @@ _ethtool_set_module()
COMPREPLY=( $( compgen -W "${!settings[*]}" -- "$cur" ) )
}
+# Completion for ethtool --flash-module-firmware
+_ethtool_flash_module_firmware()
+{
+ local -A settings=(
+ [file]=1
+ [pass]=1
+ )
+
+ case "$prev" in
+ file)
+ _ethtool_firmware
+ return ;;
+ pass)
+ # Number
+ return ;;
+ esac
+
+ # Remove settings which have been seen
+ local word
+ for word in "${words[@]:3:${#words[@]}-4}"; do
+ unset "settings[$word]"
+ done
+
+ COMPREPLY=( $( compgen -W "${!settings[*]}" -- "$cur" ) )
+}
+
# Complete any ethtool command
_ethtool()
{
@@ -1217,6 +1243,7 @@ _ethtool()
[--test]=test
[--set-module]=set_module
[--show-module]=devname
+ [--flash-module-firmware]=flash_module_firmware
)
local -A other_funcs=(
[--config-ntuple]=config_nfc