Skip to contentSkip to conversation

doc: Fix eth_env_[gs]et_enetaddr() return value

PATCH In review Marek Vasut 2 participants 2 messages Dec 18, 2022 – Jan 3, 2023

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 doc: Fix eth_env_[gs]et_enetaddr() return value

Per env/common.c, eth_env_get_enetaddr() returns the same return values as is_valid_ethaddr(), i.e. true if valid, false otherwise. Per env/common.c, eth_env_set_enetaddr() may return -EEXIST is the ethaddr is already set. Fix both.

---
Cc: Heinrich Schuchardt <[email protected]>
Cc: Marek Behún <[email protected]>
Cc: Simon Glass <[email protected]>
Cc: Tom Rini <[email protected]>
---
V2: Update the set variant description further

---
 include/env.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
include/env.h +2 -2
index 60acb5454ec..1480efa59e3 100644
@@ -226,7 +226,7 @@ int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf,
  *
  * @name: Environment variable to get (e.g. "ethaddr")
  * @enetaddr: Place to put MAC address (6 bytes)
- * Return: 0 if OK, 1 on error
+ * Return: 1 if OK, 0 on error
  */
 int eth_env_get_enetaddr(const char *name, uint8_t *enetaddr);
 
@@ -235,7 +235,7 @@ int eth_env_get_enetaddr(const char *name, uint8_t *enetaddr);
  *
  * @name: Environment variable to set (e.g. "ethaddr")
  * @enetaddr: Pointer to MAC address to put into the variable (6 bytes)
- * Return: 0 if OK, 1 on error
+ * Return: 0 if OK, non-zero otherwise
  */
 int eth_env_set_enetaddr(const char *name, const uint8_t *enetaddr);
 
Signature · 1 line
2.35.1