eth: fbnic: Cleanup macros and string function
Subsystems (3)
cover eth: fbnic: Cleanup macros and string function
We have received some feedback that the macros we use for reading FW mailbox attributes are too large in scope and confusing to understanding. Additionally the string function did not provide errors allowing it to silently succeed. This patch set fixes theses issues.
Lee Trager (3):
eth: fbnic: Prepend TSENE FW fields with FBNIC_FW
eth: fbnic: Update fbnic_tlv_attr_get_string() to work like
nla_strscpy()
eth: fbnic: Replace firmware field macros
drivers/net/ethernet/meta/fbnic/fbnic_fw.c | 109 ++++++++++---------- drivers/net/ethernet/meta/fbnic/fbnic_fw.h | 8 +- drivers/net/ethernet/meta/fbnic/fbnic_tlv.c | 55 +++++++--- drivers/net/ethernet/meta/fbnic/fbnic_tlv.h | 39 ++----- 4 files changed, 110 insertions(+), 101 deletions(-)
--
2.43.5
PATCH 1/3 eth: fbnic: Prepend TSENE FW fields with FBNIC_FW
All other firmware fields are prepended with FBNIC_FW. Update TSENE fields to follow the same format.
--- drivers/net/ethernet/meta/fbnic/fbnic_fw.c | 16 ++++++++-------- drivers/net/ethernet/meta/fbnic/fbnic_fw.h | 8 ++++---- 2 files changed, 12 insertions(+), 12 deletions(-)
drivers/net/ethernet/meta/fbnic/fbnic_fw.c +8 -8
@@ -743,9 +743,9 @@ int fbnic_fw_xmit_tsene_read_msg(struct fbnic_dev *fbd, }static const struct fbnic_tlv_index fbnic_tsene_read_resp_index[] = { -FBNIC_TLV_ATTR_S32 (FBNIC_TSENE_THERM ), -FBNIC_TLV_ATTR_S32 (FBNIC_TSENE_VOLT ), -FBNIC_TLV_ATTR_S32 (FBNIC_TSENE_ERROR ), +FBNIC_TLV_ATTR_S32 (FBNIC_FW_TSENE_THERM ), +FBNIC_TLV_ATTR_S32 (FBNIC_FW_TSENE_VOLT ), +FBNIC_TLV_ATTR_S32 (FBNIC_FW_TSENE_ERROR ),FBNIC_TLV_ATTR_LAST };
@@ -762,21 +762,21 @@ static int fbnic_fw_parse_tsene_read_resp(void *opaque,if (!cmpl_data)return -EINVAL ; -if (results[FBNIC_TSENE_ERROR ]) { - err =fbnic_tlv_attr_get_unsigned (results[FBNIC_TSENE_ERROR ]); +if (results[FBNIC_FW_TSENE_ERROR ]) { + err =fbnic_tlv_attr_get_unsigned (results[FBNIC_FW_TSENE_ERROR ]);if (err) goto exit_complete; } -if (!results[FBNIC_TSENE_THERM ] || !results[FBNIC_TSENE_VOLT ]) { +if (!results[FBNIC_FW_TSENE_THERM ] || !results[FBNIC_FW_TSENE_VOLT ]) { err = -EINVAL ; goto exit_complete; } cmpl_data->u.tsene.millidegrees = -fbnic_tlv_attr_get_signed (results[FBNIC_TSENE_THERM ]); +fbnic_tlv_attr_get_signed (results[FBNIC_FW_TSENE_THERM ]); cmpl_data->u.tsene.millivolts = -fbnic_tlv_attr_get_signed (results[FBNIC_TSENE_VOLT ]); +fbnic_tlv_attr_get_signed (results[FBNIC_FW_TSENE_VOLT ]); exit_complete: cmpl_data->result = err;
drivers/net/ethernet/meta/fbnic/fbnic_fw.h +4 -4
@@ -139,10 +139,10 @@ enum { };enum { -FBNIC_TSENE_THERM =0x0 , -FBNIC_TSENE_VOLT =0x1 , -FBNIC_TSENE_ERROR =0x2 , -FBNIC_TSENE_MSG_MAX +FBNIC_FW_TSENE_THERM =0x0 , +FBNIC_FW_TSENE_VOLT =0x1 , +FBNIC_FW_TSENE_ERROR =0x2 , +FBNIC_FW_TSENE_MSG_MAX };enum {
--
2.43.5
PATCH 2/3 eth: fbnic: Update fbnic_tlv_attr_get_string() to work like nla_strscpy()
In reply to Lee TragerAllow fbnic_tlv_attr_get_string() to return an error code. In the event the source mailbox attribute is missing return -EINVAL. Like nla_strscpy() return -E2BIG when the source string is larger than the destination string. In this case the amount of data copied is equal to dstsize.
--- drivers/net/ethernet/meta/fbnic/fbnic_tlv.c | 39 ++++++++++++++++----- drivers/net/ethernet/meta/fbnic/fbnic_tlv.h | 4 +-- 2 files changed, 32 insertions(+), 11 deletions(-)
drivers/net/ethernet/meta/fbnic/fbnic_tlv.c +30 -9
@@ -233,19 +233,40 @@ s64 fbnic_tlv_attr_get_signed(struct fbnic_tlv_msg *attr)/** * fbnic_tlv_attr_get_string - Retrieve string value from result * @attr: Attribute to retrieve data from -* @str: Pointer to an allocated string to store the data -* @max_size: The maximum size which can be in str +* @dst: Pointer to an allocated string to store the data +* @dstsize: The maximum size which can be in dst * -* Return: the size of the string read from firmware +* Return: the size of the string read from firmware or negative error. **/ -size_t fbnic_tlv_attr_get_string (struct fbnic_tlv_msg *attr,char *str, -size_t max_size) +ssize_t fbnic_tlv_attr_get_string (struct fbnic_tlv_msg *attr,char *dst, +size_t dstsize) { - max_size =min_t (size_t, max_size, - (le16_to_cpu (attr->hdr.len) *4 ) -sizeof (*attr)); -memcpy (str, &attr->value, max_size); +size_t srclen, len; +ssize_t ret; -return max_size; +if (!attr) +return -EINVAL ; + +if (dstsize ==0 ) +return -E2BIG ; + + srclen =le16_to_cpu (attr->hdr.len) -sizeof (*attr); +if (srclen >0 && attr->value[srclen -1 ] =='\0' ) + srclen--; + +if (srclen >= dstsize) { + len = dstsize -1 ; + ret = -E2BIG ; + }else { + len = srclen; + ret = len; + } + +memcpy (dst, &attr->value, len); +/* Zero pad end of dst. */ +memset (dst + len,0 , dstsize - len); + +return ret; }/**
drivers/net/ethernet/meta/fbnic/fbnic_tlv.h +2 -2
@@ -116,8 +116,8 @@ static inline bool fbnic_tlv_attr_get_bool(struct fbnic_tlv_msg *attr)u64 fbnic_tlv_attr_get_unsigned (struct fbnic_tlv_msg *attr);s64 fbnic_tlv_attr_get_signed (struct fbnic_tlv_msg *attr); -size_t fbnic_tlv_attr_get_string (struct fbnic_tlv_msg *attr,char *str, -size_t max_size); +ssize_t fbnic_tlv_attr_get_string (struct fbnic_tlv_msg *attr,char *dst, +size_t dstsize);#define get_unsigned_result (id, location) \ do { \
--
2.43.5
PATCH 3/3 eth: fbnic: Replace firmware field macros
In reply to Lee TragerReplace the firmware field macros with new macros which follow typical kernel standards. No variables are required to be predefined for use and results are now returned. These macros are prefixed with fta or fbnic TLV attribute.
--- drivers/net/ethernet/meta/fbnic/fbnic_fw.c | 101 ++++++++++---------- drivers/net/ethernet/meta/fbnic/fbnic_tlv.c | 16 +++- drivers/net/ethernet/meta/fbnic/fbnic_tlv.h | 35 ++----- 3 files changed, 70 insertions(+), 82 deletions(-)
drivers/net/ethernet/meta/fbnic/fbnic_fw.c +48 -53
@@ -494,16 +494,13 @@ static int fbnic_fw_parse_bmc_addrs(u8 bmc_mac_addr[][ETH_ALEN],static int fbnic_fw_parse_cap_resp (void *opaque,struct fbnic_tlv_msg **results) { -u32 active_slot =0 , all_multi =0 ; +u32 all_multi =0 , version =0 ;struct fbnic_dev *fbd = opaque; -u32 speed =0 , fec =0 ; -size_t commit_size =0 ;bool bmc_present;int err; -get_unsigned_result (FBNIC_FW_CAP_RESP_VERSION , - fbd->fw_cap.running.mgmt.version); - + version =fta_get_uint (results,FBNIC_FW_CAP_RESP_VERSION ); + fbd->fw_cap.running.mgmt.version = version;if (!fbd->fw_cap.running.mgmt.version)return -EINVAL ;
@@ -524,43 +521,41 @@ static int fbnic_fw_parse_cap_resp(void *opaque, struct fbnic_tlv_msg **results)return -EINVAL ; } -get_string_result (FBNIC_FW_CAP_RESP_VERSION_COMMIT_STR , commit_size, - fbd->fw_cap.running.mgmt.commit, -FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); -if (!commit_size) +if (fta_get_str (results,FBNIC_FW_CAP_RESP_VERSION_COMMIT_STR , + fbd->fw_cap.running.mgmt.commit, +FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ) <=0 )dev_warn (fbd->dev,"Firmware did not send mgmt commit!\n" ); -get_unsigned_result (FBNIC_FW_CAP_RESP_STORED_VERSION , - fbd->fw_cap.stored.mgmt.version); -get_string_result (FBNIC_FW_CAP_RESP_STORED_COMMIT_STR , commit_size, - fbd->fw_cap.stored.mgmt.commit, -FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); - -get_unsigned_result (FBNIC_FW_CAP_RESP_CMRT_VERSION , - fbd->fw_cap.running.bootloader.version); -get_string_result (FBNIC_FW_CAP_RESP_CMRT_COMMIT_STR , commit_size, - fbd->fw_cap.running.bootloader.commit, -FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); - -get_unsigned_result (FBNIC_FW_CAP_RESP_STORED_CMRT_VERSION , - fbd->fw_cap.stored.bootloader.version); -get_string_result (FBNIC_FW_CAP_RESP_STORED_CMRT_COMMIT_STR , commit_size, - fbd->fw_cap.stored.bootloader.commit, -FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); - -get_unsigned_result (FBNIC_FW_CAP_RESP_UEFI_VERSION , - fbd->fw_cap.stored.undi.version); -get_string_result (FBNIC_FW_CAP_RESP_UEFI_COMMIT_STR , commit_size, - fbd->fw_cap.stored.undi.commit, -FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); - -get_unsigned_result (FBNIC_FW_CAP_RESP_ACTIVE_FW_SLOT , active_slot); - fbd->fw_cap.active_slot = active_slot; - -get_unsigned_result (FBNIC_FW_CAP_RESP_FW_LINK_SPEED , speed); -get_unsigned_result (FBNIC_FW_CAP_RESP_FW_LINK_FEC , fec); - fbd->fw_cap.link_speed = speed; - fbd->fw_cap.link_fec = fec; + version =fta_get_uint (results,FBNIC_FW_CAP_RESP_STORED_VERSION ); + fbd->fw_cap.stored.mgmt.version = version; +fta_get_str (results,FBNIC_FW_CAP_RESP_STORED_COMMIT_STR , + fbd->fw_cap.stored.mgmt.commit, +FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); + + version =fta_get_uint (results,FBNIC_FW_CAP_RESP_CMRT_VERSION ); + fbd->fw_cap.running.bootloader.version = version; +fta_get_str (results,FBNIC_FW_CAP_RESP_CMRT_COMMIT_STR , + fbd->fw_cap.running.bootloader.commit, +FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); + + version =fta_get_uint (results,FBNIC_FW_CAP_RESP_STORED_CMRT_VERSION ); + fbd->fw_cap.stored.bootloader.version = version; +fta_get_str (results,FBNIC_FW_CAP_RESP_STORED_CMRT_COMMIT_STR , + fbd->fw_cap.stored.bootloader.commit, +FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); + + version =fta_get_uint (results,FBNIC_FW_CAP_RESP_UEFI_VERSION ); + fbd->fw_cap.stored.undi.version = version; +fta_get_str (results,FBNIC_FW_CAP_RESP_UEFI_COMMIT_STR , + fbd->fw_cap.stored.undi.commit, +FBNIC_FW_CAP_RESP_COMMIT_MAX_SIZE ); + + fbd->fw_cap.active_slot = +fta_get_uint (results,FBNIC_FW_CAP_RESP_ACTIVE_FW_SLOT ); + fbd->fw_cap.link_speed = +fta_get_uint (results,FBNIC_FW_CAP_RESP_FW_LINK_SPEED ); + fbd->fw_cap.link_fec = +fta_get_uint (results,FBNIC_FW_CAP_RESP_FW_LINK_FEC ); bmc_present = !!results[FBNIC_FW_CAP_RESP_BMC_PRESENT ];if (bmc_present) {
@@ -575,7 +570,8 @@ static int fbnic_fw_parse_cap_resp(void *opaque, struct fbnic_tlv_msg **results)if (err)return err; -get_unsigned_result (FBNIC_FW_CAP_RESP_BMC_ALL_MULTI , all_multi); + all_multi = +fta_get_uint (results,FBNIC_FW_CAP_RESP_BMC_ALL_MULTI ); }else {memset (fbd->fw_cap.bmc_mac_addr,0 ,sizeof (fbd->fw_cap.bmc_mac_addr));
@@ -754,32 +750,31 @@ static int fbnic_fw_parse_tsene_read_resp(void *opaque, {struct fbnic_fw_completion *cmpl_data;struct fbnic_dev *fbd = opaque; +s32 err_resp;int err =0 ;/* Verify we have a completion pointer to provide with data */ cmpl_data =fbnic_fw_get_cmpl_by_type (fbd,FBNIC_TLV_MSG_ID_TSENE_READ_RESP );if (!cmpl_data) -return -EINVAL ; +return -ENOSPC ; -if (results[FBNIC_FW_TSENE_ERROR ]) { - err =fbnic_tlv_attr_get_unsigned (results[FBNIC_FW_TSENE_ERROR ]); -if (err) - goto exit_complete; - } + err_resp =fta_get_sint (results,FBNIC_FW_TSENE_ERROR ); +if (err_resp) + goto msg_err;if (!results[FBNIC_FW_TSENE_THERM ] || !results[FBNIC_FW_TSENE_VOLT ]) { err = -EINVAL ; - goto exit_complete; + goto msg_err; } cmpl_data->u.tsene.millidegrees = -fbnic_tlv_attr_get_signed (results[FBNIC_FW_TSENE_THERM ]); +fta_get_sint (results,FBNIC_FW_TSENE_THERM ); cmpl_data->u.tsene.millivolts = -fbnic_tlv_attr_get_signed (results[FBNIC_FW_TSENE_VOLT ]); +fta_get_sint (results,FBNIC_FW_TSENE_VOLT ); -exit_complete: - cmpl_data->result = err; +msg_err: + cmpl_data->result = err_resp ? : err;complete (&cmpl_data->done);fbnic_fw_put_cmpl (cmpl_data);
drivers/net/ethernet/meta/fbnic/fbnic_tlv.c +13 -3
@@ -196,13 +196,17 @@ int fbnic_tlv_attr_put_string(struct fbnic_tlv_msg *msg, u16 attr_id,/** * fbnic_tlv_attr_get_unsigned - Retrieve unsigned value from result * @attr: Attribute to retrieve data from +* @def: The default value if attr is NULL * * Return: unsigned 64b value containing integer value **/ -u64 fbnic_tlv_attr_get_unsigned (struct fbnic_tlv_msg *attr) +u64 fbnic_tlv_attr_get_unsigned (struct fbnic_tlv_msg *attr,u64 def) {__le64 le64_value =0 ; +if (!attr) +return def; +memcpy (&le64_value, &attr->value[0 ],le16_to_cpu (attr->hdr.len) -sizeof (*attr));
@@ -212,15 +216,21 @@ u64 fbnic_tlv_attr_get_unsigned(struct fbnic_tlv_msg *attr)/** * fbnic_tlv_attr_get_signed - Retrieve signed value from result * @attr: Attribute to retrieve data from +* @def: The default value if attr is NULL * * Return: signed 64b value containing integer value **/ -s64 fbnic_tlv_attr_get_signed (struct fbnic_tlv_msg *attr) +s64 fbnic_tlv_attr_get_signed (struct fbnic_tlv_msg *attr,s64 def) { -int shift = (8 +sizeof (*attr) -le16_to_cpu (attr->hdr.len)) *8 ;__le64 le64_value =0 ; +int shift;s64 value; +if (!attr) +return def; + + shift = (8 +sizeof (*attr) -le16_to_cpu (attr->hdr.len)) *8 ; +/* Copy the value and adjust for byte ordering */ memcpy (&le64_value, &attr->value[0 ],le16_to_cpu (attr->hdr.len) -sizeof (*attr));
drivers/net/ethernet/meta/fbnic/fbnic_tlv.h +9 -26
@@ -114,34 +114,10 @@ static inline bool fbnic_tlv_attr_get_bool(struct fbnic_tlv_msg *attr)return !!attr; } -u64 fbnic_tlv_attr_get_unsigned (struct fbnic_tlv_msg *attr); -s64 fbnic_tlv_attr_get_signed (struct fbnic_tlv_msg *attr); +u64 fbnic_tlv_attr_get_unsigned (struct fbnic_tlv_msg *attr,u64 def); +s64 fbnic_tlv_attr_get_signed (struct fbnic_tlv_msg *attr,s64 def);ssize_t fbnic_tlv_attr_get_string (struct fbnic_tlv_msg *attr,char *dst,size_t dstsize); - -#define get_unsigned_result (id, location) \ -do { \ - struct fbnic_tlv_msg *result = results[id]; \ - if (result) \ - location = fbnic_tlv_attr_get_unsigned(result); \ -} while (0) - -#define get_signed_result (id, location) \ -do { \ - struct fbnic_tlv_msg *result = results[id]; \ - if (result) \ - location = fbnic_tlv_attr_get_signed(result); \ -} while (0) - -#define get_string_result (id, size, str, max_size) \ -do { \ - struct fbnic_tlv_msg *result = results[id]; \ - if (result) \ - size = fbnic_tlv_attr_get_string(result, str, max_size); \ -} while (0) - -#define get_bool (id) (!!(results[id])) -struct fbnic_tlv_msg *fbnic_tlv_msg_alloc (u16 msg_id);int fbnic_tlv_attr_put_flag (struct fbnic_tlv_msg *msg,const u16 attr_id); int fbnic_tlv_attr_put_value(struct fbnic_tlv_msg *msg, const u16 attr_id,
@@ -170,6 +146,13 @@ int fbnic_tlv_msg_parse(void *opaque, struct fbnic_tlv_msg *msg, const struct fbnic_tlv_parser *parser);int fbnic_tlv_parser_error (void *opaque,struct fbnic_tlv_msg **results); +#define fta_get_uint (_results, _id) \ + fbnic_tlv_attr_get_unsigned(_results[_id], 0) +#define fta_get_sint (_results, _id) \ + fbnic_tlv_attr_get_signed(_results[_id], 0) +#define fta_get_str (_results, _id, _dst, _dstsize) \ + fbnic_tlv_attr_get_string(_results[_id], _dst, _dstsize) +#define FBNIC_TLV_MSG_ERROR \ FBNIC_TLV_PARSER(UNKNOWN, NULL, fbnic_tlv_parser_error)#endif /* _FBNIC_TLV_H_ */
--
2.43.5
Quoted 4 lines · On Fri, 28 Feb 2025 11:15:25 -0800 Lee Trager wrote:
We have received some feedback that the macros we use for reading FW mailbox attributes are too large in scope and confusing to understanding. Additionally the string function did not provide errors allowing it to silently succeed. This patch set fixes theses issues.
Applied, thanks!