Add a tool for configuration of DCB
Subsystems (4)
cover Add a tool for configuration of DCB
The Linux DCB interface allows configuration of a broad range of hardware-specific attributes, such as TC scheduling, flow control, per-port buffer configuration, TC rate, etc.
Currently a common libre tool for configuration of DCB is OpenLLDP. This suite contains a daemon that uses Linux DCB interface to configure HW according to the DCB TLVs exchanged over an interface. The daemon can also be controlled by a client, through which the user can adjust and view the configuration. The downside of using OpenLLDP is that it is somewhat heavyweight and difficult to use in scripts, and does not support extensions such as buffer and rate commands.
For access to many HW features, one would be perfectly fine with a fire-and-forget tool along the lines of "ip" or "tc". For scripting in particular, this would be ideal. This author is aware of one such tool, mlnx_qos from Mellanox OFED scripts collection[1].
The downside here is that the tool is very verbose, the command line language is awkward to use, it is not packaged in Linux distros, and generally has the appearance of a very vendor-specific tool, despite not being one.
This patchset addresses the above issues by providing a seed of a clean, well-documented, easily usable, extensible fire-and-forget tool for DCB configuration:
# dcb ets set dev eni1np1 \
tc-tsa all:strict 0:ets 1:ets 2:ets \
tc-bw all:0 0:33 1:33 2:34 # dcb ets show dev eni1np1 tc-tsa tc-bw
tc-tsa 0:ets 1:ets 2:ets 3:strict 4:strict 5:strict 6:strict 7:strict
tc-bw 0:33 1:33 2:34 3:0 4:0 5:0 6:0 7:0# dcb ets set dev eni1np1 tc-bw 1:30 2:37
# dcb -j ets show dev eni1np1 | jq '.["tc-bw"]["2"]'
37The patchset proceeds as follows:
- Many tools in iproute2 have an option to work in batch mode, where the commands to run are given in a file. The code to handle batching is largely the same independent of the tool in question. In patch #1, add a helper to handle the batching, and migrate individual tools to use it.
- A number of configuration options come in a form of an on-off switch. This in turn can be considered a special case of parsing one of a given set of strings. Currently each tool open-codes the logic to parse the on-off toggle. And on top of the on-off parsing, tools have logic to set or unset a flag according to the keyword parsed.
In patches #2-#7, extract helpers to parse one of a number of strings, on top of which build an on-off parser, on top of which build a flag set / unset handler. Then migrate all known instances of this code over to the new helpers.
- The DCB tool is built on top of libmnl. Several routines will be basically the same in DCB as they are currently in devlink. In patches #8-#10, extract them to a new module, mnl_utils, for easy reuse.
- Much of DCB is built around arrays. A syntax similar to the iplink_vlan's ingress-qos-map / egress-qos-map is very handy for describing changes done to such arrays. Therefore in patch #11, extract a helper, parse_mapping(), which manages parsing of key-value arrays. In patch #12, fix a buglet in the helper, and in patch #13, extend it to allow setting of all array elements in one go.
- In patch #14, add a skeleton of "dcb", which contains common helpers and dispatches to subtools for handling of individual objects. The skeleton is empty as of this patch.
In patch #15, add "dcb_ets", a module for handling of specifically DCB ETS objects.
The intention is to gradually add handlers for at least PFC, APP, peer configuration, buffers and rates.
[1] https://github.com/Mellanox/mlnx-tools/tree/master/ofed_scripts
Petr Machata (15):
Unify batch processing across tools
lib: Add parse_one_of(), parse_on_off()
bridge: link: Port over to parse_on_off()
lib: Add parse_flag_on_off(), set_flag()
ip: iplink: Convert to use parse_on_off(), parse_flag_on_off()
ip: iplink_vlan: Port over to parse_flag_on_off()
ip: iplink_bridge_slave: Port over to parse_on_off()
lib: Extract from devlink/mnlg a helper, mnlu_socket_open()
lib: Extract from devlink/mnlg a helper, mnlu_msg_prepare()
lib: Extract from devlink/mnlg a helper, mnlu_socket_recv_run()
lib: Extract from iplink_vlan a helper to parse key:value arrays
lib: parse_mapping: Update argc, argv on error
lib: parse_mapping: Recognize a keyword "all"
Add skeleton of a new tool, dcb
dcb: Add a subtool for the DCB ETS object
Makefile | 2 +- bridge/bridge.c | 38 +--- bridge/link.c | 79 ++++--- dcb/Makefile | 24 +++ dcb/dcb.c | 379 +++++++++++++++++++++++++++++++++ dcb/dcb.h | 36 ++++ dcb/dcb_ets.c | 450 +++++++++++++++++++++++++++++++++++++++ devlink/Makefile | 2 +- devlink/devlink.c | 41 +--- devlink/mnlg.c | 93 ++------ include/mnl_utils.h | 11 + include/utils.h | 21 ++ ip/ip.c | 46 +--- ip/iplink.c | 182 ++++++---------- ip/iplink_bridge_slave.c | 12 +- ip/iplink_vlan.c | 86 +++----- ip/ipmacsec.c | 52 +---- lib/Makefile | 2 +- lib/mnl_utils.c | 115 ++++++++++ lib/utils.c | 114 ++++++++++ man/man8/dcb-ets.8 | 185 ++++++++++++++++ man/man8/dcb.8 | 114 ++++++++++ rdma/rdma.c | 38 +--- tc/tc.c | 38 +--- 24 files changed, 1652 insertions(+), 508 deletions(-) create mode 100644 dcb/Makefile create mode 100644 dcb/dcb.c create mode 100644 dcb/dcb.h create mode 100644 dcb/dcb_ets.c create mode 100644 include/mnl_utils.h create mode 100644 lib/mnl_utils.c create mode 100644 man/man8/dcb-ets.8 create mode 100644 man/man8/dcb.8
Signature · 1 line
2.25.1
PATCH 2/15 lib: Add parse_one_of(), parse_on_off()
Take from the macsec code parse_one_of() and adapt so that it passes the primary result as the main return value, and error result through a pointer. That is the simplest way to make the code reusable across data types without introducing extra magic.
Also from macsec take the specialization of parse_one_of() for parsing specifically the strings "off" and "on".
Convert the macsec code to the new helpers.
--- include/utils.h | 4 ++++ ip/ipmacsec.c | 52 +++++++++++-------------------------------------- lib/utils.c | 28 ++++++++++++++++++++++++++ 3 files changed, 43 insertions(+), 41 deletions(-)
include/utils.h +4 -0
@@ -325,4 +325,8 @@ char *sprint_time64(__s64 time, char *buf);int do_batch (const char *name,bool force,int (*cmd)(int argc,char *argv[],void *user),void *user); +int parse_one_of (const char *msg,const char *realval,const char *const *list, +size_t len,int *p_err); +int parse_on_off (const char *msg,const char *realval,int *p_err); +#endif /* __UTILS_H__ */
ip/ipmacsec.c +11 -41
118 lines not on this page · raw message
lib/utils.c +28 -0
@@ -1735,3 +1735,31 @@ int do_batch(const char *name, bool force,return ret; } + +int parse_one_of (const char *msg,const char *realval,const char *const *list, +size_t len,int *p_err) +{ +int i; + +for (i =0 ; i < len; i++) { +if (list[i] &&matches (realval, list[i]) ==0 ) { + *p_err =0 ; +return i; + } + } + +fprintf (stderr,"Error: argument of \"%s\" must be one of " , msg); +for (i =0 ; i < len; i++) +if (list[i]) +fprintf (stderr,"\"%s\", " , list[i]); +fprintf (stderr,"not \"%s\"\n" , realval); + *p_err = -EINVAL ; +return 0 ; +} + +int parse_on_off (const char *msg,const char *realval,int *p_err) +{ +static const char *const values_on_off[] = {"off" ,"on" }; + +return parse_one_of (msg, realval, values_on_off,ARRAY_SIZE (values_on_off), p_err); +}
Signature · 1 line
2.25.1
PATCH 4/15 lib: Add parse_flag_on_off(), set_flag()
In reply to Petr MachataSome iplink code makes a heavy use of code that sets or unsets a certain flag depending on whether "on" or "off" of specified. Extract this logic into a new function, parse_flag_on_off(). The bit that sets or clears a flag will be useful separately, so add it to a named function, set_flag().
--- include/utils.h | 10 ++++++++++ lib/utils.c | 11 +++++++++++ 2 files changed, 21 insertions(+)
include/utils.h +10 -0
@@ -325,8 +325,18 @@ char *sprint_time64(__s64 time, char *buf);int do_batch (const char *name,bool force,int (*cmd)(int argc,char *argv[],void *user),void *user); +static inline void set_flag (unsigned int *p_flags,unsigned int flag,bool on) +{ +if (on) + *p_flags |= flag; +else + *p_flags &= ~flag; +} +int parse_one_of (const char *msg,const char *realval,const char *const *list,size_t len,int *p_err);int parse_on_off (const char *msg,const char *realval,int *p_err); +void parse_flag_on_off (const char *msg,const char *realval, +unsigned int *p_flags,unsigned int flag,int *p_ret);#endif /* __UTILS_H__ */
lib/utils.c +11 -0
@@ -1763,3 +1763,14 @@ int parse_on_off(const char *msg, const char *realval, int *p_err)return parse_one_of (msg, realval, values_on_off,ARRAY_SIZE (values_on_off), p_err); } + +void parse_flag_on_off (const char *msg,const char *realval, +unsigned int *p_flags,unsigned int flag,int *p_ret) +{ +int on_off =parse_on_off (msg, realval, p_ret); + +if (*p_ret) +return ; + +set_flag (p_flags, flag, on_off); +}
Signature · 1 line
2.25.1
PATCH 6/15 ip: iplink_vlan: Port over to parse_flag_on_off()
In reply to Petr MachataConvert bridge/link.c from a hand-rolled on_off parsing to the new global one.
--- ip/iplink_vlan.c | 55 +++++++++++++++++------------------------------- 1 file changed, 19 insertions(+), 36 deletions(-)
ip/iplink_vlan.c +19 -36
@@ -43,12 +43,6 @@ static void explain(void)print_explain (stderr); } -static int on_off (const char *msg,const char *arg) -{ -fprintf (stderr,"Error: argument of \"%s\" must be \"on\" or \"off\", not \"%s\"\n" , msg, arg); -return -1 ; -} -static int vlan_parse_qos_map (int *argcp,char ***argvp,struct nlmsghdr *n,int attrtype) {
@@ -87,6 +81,7 @@ static int vlan_parse_opt(struct link_util *lu, int argc, char **argv, {struct ifla_vlan_flags flags = {0 };__u16 id, proto; +int ret;while (argc >0 ) {if (matches (*argv,"protocol" ) ==0 ) {
@@ -102,48 +97,36 @@ static int vlan_parse_opt(struct link_util *lu, int argc, char **argv, }else if (matches (*argv,"reorder_hdr" ) ==0 ) {NEXT_ARG (); flags.mask |=VLAN_FLAG_REORDER_HDR ; -if (strcmp (*argv,"on" ) ==0 ) - flags.flags |=VLAN_FLAG_REORDER_HDR ; -else if (strcmp (*argv,"off" ) ==0 ) - flags.flags &= ~VLAN_FLAG_REORDER_HDR ; -else -return on_off ("reorder_hdr" , *argv); +parse_flag_on_off ("reorder_hdr" , *argv, &flags.flags,VLAN_FLAG_REORDER_HDR , + &ret); +if (ret) +return ret; }else if (matches (*argv,"gvrp" ) ==0 ) {NEXT_ARG (); flags.mask |=VLAN_FLAG_GVRP ; -if (strcmp (*argv,"on" ) ==0 ) - flags.flags |=VLAN_FLAG_GVRP ; -else if (strcmp (*argv,"off" ) ==0 ) - flags.flags &= ~VLAN_FLAG_GVRP ; -else -return on_off ("gvrp" , *argv); +parse_flag_on_off ("gvrp" , *argv, &flags.flags,VLAN_FLAG_GVRP , &ret); +if (ret) +return ret; }else if (matches (*argv,"mvrp" ) ==0 ) {NEXT_ARG (); flags.mask |=VLAN_FLAG_MVRP ; -if (strcmp (*argv,"on" ) ==0 ) - flags.flags |=VLAN_FLAG_MVRP ; -else if (strcmp (*argv,"off" ) ==0 ) - flags.flags &= ~VLAN_FLAG_MVRP ; -else -return on_off ("mvrp" , *argv); +parse_flag_on_off ("mvrp" , *argv, &flags.flags,VLAN_FLAG_MVRP , &ret); +if (ret) +return ret; }else if (matches (*argv,"loose_binding" ) ==0 ) {NEXT_ARG (); flags.mask |=VLAN_FLAG_LOOSE_BINDING ; -if (strcmp (*argv,"on" ) ==0 ) - flags.flags |=VLAN_FLAG_LOOSE_BINDING ; -else if (strcmp (*argv,"off" ) ==0 ) - flags.flags &= ~VLAN_FLAG_LOOSE_BINDING ; -else -return on_off ("loose_binding" , *argv); +parse_flag_on_off ("loose_binding" , *argv, &flags.flags, +VLAN_FLAG_LOOSE_BINDING , &ret); +if (ret) +return ret; }else if (matches (*argv,"bridge_binding" ) ==0 ) {NEXT_ARG (); flags.mask |=VLAN_FLAG_BRIDGE_BINDING ; -if (strcmp (*argv,"on" ) ==0 ) - flags.flags |=VLAN_FLAG_BRIDGE_BINDING ; -else if (strcmp (*argv,"off" ) ==0 ) - flags.flags &= ~VLAN_FLAG_BRIDGE_BINDING ; -else -return on_off ("bridge_binding" , *argv); +parse_flag_on_off ("bridge_binding" , *argv, &flags.flags, +VLAN_FLAG_BRIDGE_BINDING , &ret); +if (ret) +return ret; }else if (matches (*argv,"ingress-qos-map" ) ==0 ) {NEXT_ARG (); if (vlan_parse_qos_map(&argc, &argv, n,
Signature · 1 line
2.25.1
PATCH 7/15 ip: iplink_bridge_slave: Port over to parse_on_off()
In reply to Petr MachataInvoke parse_on_off() from bridge_slave_parse_on_off() instead of hand-rolling one. Exit on failure, because the invarg that was ivoked here before would.
--- ip/iplink_bridge_slave.c | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-)
ip/iplink_bridge_slave.c +4 -8
@@ -297,15 +297,11 @@ static void bridge_slave_print_opt(struct link_util *lu, FILE *f,static void bridge_slave_parse_on_off (char *arg_name,char *arg_val,struct nlmsghdr *n,int type) { -__u8 val; - -if (strcmp (arg_val,"on" ) ==0 ) - val =1 ; -else if (strcmp (arg_val,"off" ) ==0 ) - val =0 ; -else -invarg ("should be \"on\" or \"off\"" , arg_name); +int ret; +__u8 val =parse_on_off (arg_name, arg_val, &ret); +if (ret) +exit (1 );addattr8 (n,1024 , type, val); }
Signature · 1 line
2.25.1
PATCH 8/15 lib: Extract from devlink/mnlg a helper, mnlu_socket_open()
In reply to Petr MachataThis little dance of mnl_socket_open(), option setting, and bind, is the same regardless of tool. Extract into a new module that should hold helpers for working with libmnl, mnl_util.c.
--- devlink/Makefile | 2 +- devlink/mnlg.c | 19 ++++--------------- include/mnl_utils.h | 7 +++++++ lib/Makefile | 2 +- lib/mnl_utils.c | 35 +++++++++++++++++++++++++++++++++++ 5 files changed, 48 insertions(+), 17 deletions(-) create mode 100644 include/mnl_utils.h create mode 100644 lib/mnl_utils.c
devlink/Makefile +1 -1
@@ -12,7 +12,7 @@ endif all: $(TARGETS) $(LIBS) -devlink: $(DEVLINKOBJ) +devlink: $(DEVLINKOBJ) $(LIBNETLINK) $(QUIET_LINK)$(CC) $^ $(LDFLAGS) $(LDLIBS) -o $@ install: all
devlink/mnlg.c +4 -15
@@ -19,6 +19,7 @@#include <linux/genetlink.h> #include "libnetlink.h" +#include "mnl_utils.h" #include "utils.h" #include "mnlg.h"
@@ -263,7 +264,6 @@ struct mnlg_socket *mnlg_socket_open(const char *family_name, uint8_t version) {struct mnlg_socket *nlg;struct nlmsghdr *nlh; -int one =1 ;int err; nlg =malloc (sizeof (*nlg));
@@ -274,19 +274,9 @@ struct mnlg_socket *mnlg_socket_open(const char *family_name, uint8_t version)if (!nlg->buf) goto err_buf_alloc; - nlg->nl =mnl_socket_open (NETLINK_GENERIC ); + nlg->nl =mnlu_socket_open (NETLINK_GENERIC );if (!nlg->nl) - goto err_mnl_socket_open; - -/* Older kernels may no support capped/extended ACK reporting */ -mnl_socket_setsockopt (nlg->nl,NETLINK_CAP_ACK , &one,sizeof (one)); -mnl_socket_setsockopt (nlg->nl,NETLINK_EXT_ACK , &one,sizeof (one)); - - err =mnl_socket_bind (nlg->nl,0 ,MNL_SOCKET_AUTOPID ); -if (err <0 ) - goto err_mnl_socket_bind; - - nlg->portid =mnl_socket_get_portid (nlg->nl); + goto err_socket_open; nlh =__mnlg_msg_prepare (nlg,CTRL_CMD_GETFAMILY ,NLM_F_REQUEST |NLM_F_ACK ,GENL_ID_CTRL ,1 );
@@ -305,9 +295,8 @@ struct mnlg_socket *mnlg_socket_open(const char *family_name, uint8_t version) err_mnlg_socket_recv_run: err_mnlg_socket_send: -err_mnl_socket_bind:mnl_socket_close (nlg->nl); -err_mnl_socket_open: +err_socket_open:free (nlg->buf); err_buf_alloc:free (nlg);
include/mnl_utils.h new file +7 -0
@@ -0,0 +1,7 @@ +/* SPDX-License-Identifier: GPL-2.0 */ +#ifndef __MNL_UTILS_H__ +#define __MNL_UTILS_H__ 1 + +struct mnl_socket *mnlu_socket_open (int bus); + +#endif /* __MNL_UTILS_H__ */
lib/Makefile +1 -1
@@ -7,7 +7,7 @@ UTILOBJ = utils.o rt_names.o ll_map.o ll_types.o ll_proto.o ll_addr.o \ inet_proto.o namespace.o json_writer.o json_print.o \ names.o color.o bpf.o exec.o fs.o cg_map.o -NLOBJ=libgenl.o libnetlink.o +NLOBJ=libgenl.o libnetlink.o mnl_utils.o all: libnetlink.a libutil.a
lib/mnl_utils.c new file +35 -0
@@ -0,0 +1,35 @@ +/* +* mnl_utils.c Helpers for working with libmnl. +* +* This program is free software; you can redistribute it and/or +* modify it under the terms of the GNU General Public License +* as published by the Free Software Foundation; either version +* 2 of the License, or (at your option) any later version. +* +*/ + +#include <libmnl/libmnl.h> + +#include "mnl_utils.h" + +struct mnl_socket *mnlu_socket_open (int bus) +{ +struct mnl_socket *nl; +int one =1 ; + + nl =mnl_socket_open (bus); +if (nl ==NULL ) +return NULL ; + +mnl_socket_setsockopt (nl,NETLINK_CAP_ACK , &one,sizeof (one)); +mnl_socket_setsockopt (nl,NETLINK_EXT_ACK , &one,sizeof (one)); + +if (mnl_socket_bind (nl,0 ,MNL_SOCKET_AUTOPID ) <0 ) + goto err_bind; + +return nl; + +err_bind: +mnl_socket_close (nl); +return NULL ; +}
Signature · 1 line
2.25.1
PATCH 9/15 lib: Extract from devlink/mnlg a helper, mnlu_msg_prepare()
In reply to Petr MachataAllocation of a new netlink message with the two usual headers is reusable with other netlink netlink message types. Extract it into a helper, mnlu_msg_prepare(). Take the second header as an argument, instead of passing in parameters to initialize it, and copy it in.
--- devlink/mnlg.c | 18 ++++++------------ include/mnl_utils.h | 2 ++ lib/mnl_utils.c | 19 +++++++++++++++++++ 3 files changed, 27 insertions(+), 12 deletions(-)
devlink/mnlg.c +6 -12
@@ -14,7 +14,6 @@#include <string.h> #include <errno.h> #include <unistd.h> -#include <time.h> #include <libmnl/libmnl.h> #include <linux/genetlink.h>
@@ -36,19 +35,14 @@ static struct nlmsghdr *__mnlg_msg_prepare(struct mnlg_socket *nlg, uint8_t cmd, uint16_t flags, uint32_t id, uint8_t version) { + struct genlmsghdr genl = { + .cmd = cmd, + .version = version, + };struct nlmsghdr *nlh; -struct genlmsghdr *genl; - - nlh =mnl_nlmsg_put_header (nlg->buf); - nlh->nlmsg_type = id; - nlh->nlmsg_flags = flags; - nlg->seq =time (NULL ); - nlh->nlmsg_seq = nlg->seq; - - genl =mnl_nlmsg_put_extra_header (nlh,sizeof (struct genlmsghdr )); - genl->cmd = cmd; - genl->version = version; + nlh =mnlu_msg_prepare (nlg->buf, id, flags, &genl,sizeof (genl)); + nlg->seq = nlh->nlmsg_seq;return nlh; }
include/mnl_utils.h +2 -0
@@ -3,5 +3,7 @@#define __MNL_UTILS_H__ 1struct mnl_socket *mnlu_socket_open (int bus); +struct nlmsghdr *mnlu_msg_prepare (void *buf,uint32_t nlmsg_type,uint16_t flags, +void *extra_header,size_t extra_header_size);#endif /* __MNL_UTILS_H__ */
lib/mnl_utils.c +19 -0
@@ -8,6 +8,8 @@* */ +#include <string.h> +#include <time.h> #include <libmnl/libmnl.h> #include "mnl_utils.h"
@@ -33,3 +35,20 @@ err_bind:mnl_socket_close (nl);return NULL ; } + +struct nlmsghdr *mnlu_msg_prepare (void *buf,uint32_t nlmsg_type,uint16_t flags, +void *extra_header,size_t extra_header_size) +{ +struct nlmsghdr *nlh; +void *eh; + + nlh =mnl_nlmsg_put_header (buf); + nlh->nlmsg_type = nlmsg_type; + nlh->nlmsg_flags = flags; + nlh->nlmsg_seq =time (NULL ); + + eh =mnl_nlmsg_put_extra_header (nlh, extra_header_size); +memcpy (eh, extra_header, extra_header_size); + +return nlh; +}
Signature · 1 line
2.25.1
PATCH 11/15 lib: Extract from iplink_vlan a helper to parse key:value arrays
In reply to Petr MachataVLAN netdevices have two similar attributes: ingress-qos-map and egress-qos-map. These attributes can be configured with a series of 802.1-priority-to-skb-priority (and vice versa) mappings. A reusable helper along those lines will be handy for configuration of various priority-to-tc, tc-to-algorithm, and other arrays in DCB. Therefore extract the logic to a function parse_mapping(), move to utils.c, and dispatch to utils.c from iplink_vlan.c.
--- include/utils.h | 4 ++++ ip/iplink_vlan.c | 37 ++++++++++++++++--------------------- lib/utils.c | 28 ++++++++++++++++++++++++++++ 3 files changed, 48 insertions(+), 21 deletions(-)
include/utils.h +4 -0
@@ -339,4 +339,8 @@ int parse_on_off(const char *msg, const char *realval, int *p_err);void parse_flag_on_off (const char *msg,const char *realval,unsigned int *p_flags,unsigned int flag,int *p_ret); +int parse_mapping (int *argcp,char ***argvp, +int (*mapping_cb)(__u32 key,char *value,void *data), +void *mapping_cb_data); +#endif /* __UTILS_H__ */
ip/iplink_vlan.c +16 -21
@@ -43,36 +43,31 @@ static void explain(void)print_explain (stderr); } +static int parse_qos_mapping (__u32 key,char *value,void *data) +{ +struct nlmsghdr *n = data; +struct ifla_vlan_qos_mapping m = { + .from = key, + }; + +if (get_u32 (&m.to, value,0 )) +return 1 ; + +addattr_l (n,1024 ,IFLA_VLAN_QOS_MAPPING , &m,sizeof (m)); +return 0 ; +} +static int vlan_parse_qos_map (int *argcp,char ***argvp,struct nlmsghdr *n,int attrtype) { -int argc = *argcp; -char **argv = *argvp; -struct ifla_vlan_qos_mapping m;struct rtattr *tail; tail =addattr_nest (n,1024 , attrtype); -while (argc >0 ) { -char *colon =strchr (*argv,':' ); - -if (!colon) -break ; - *colon ='\0' ; - -if (get_u32 (&m.from, *argv,0 )) -return 1 ; -if (get_u32 (&m.to, colon +1 ,0 )) -return 1 ; - argc--, argv++; - -addattr_l (n,1024 ,IFLA_VLAN_QOS_MAPPING , &m,sizeof (m)); - } +if (parse_mapping (argcp, argvp, &parse_qos_mapping, n)) +return 1 ;addattr_nest_end (n, tail); - - *argcp = argc; - *argvp = argv;return 0 ; }
lib/utils.c +28 -0
@@ -1774,3 +1774,31 @@ void parse_flag_on_off(const char *msg, const char *realval,set_flag (p_flags, flag, on_off); } + +int parse_mapping (int *argcp,char ***argvp, +int (*mapping_cb)(__u32 key,char *value,void *data), +void *mapping_cb_data) +{ +int argc = *argcp; +char **argv = *argvp; + +while (argc >0 ) { +char *colon =strchr (*argv,':' ); +__u32 key; + +if (!colon) +break ; + *colon ='\0' ; + +if (get_u32 (&key, *argv,0 )) +return 1 ; +if (mapping_cb (key, colon +1 , mapping_cb_data)) +return 1 ; + + argc--, argv++; + } + + *argcp = argc; + *argvp = argv; +return 0 ; +}
Signature · 1 line
2.25.1
PATCH 12/15 lib: parse_mapping: Update argc, argv on error
In reply to Petr MachataCurrently argc and argv are not updated unless parsing of all of the mapping was successful. However in that case, "ip link" will point at the wrong argument when complaining:
# ip link add name eth0.100 link eth0 type vlan id 100 egress 1:1 2:foo
Error: argument "1" is wrong: invalid egress-qos-mapUpdate argc and argv even in the case of parsing error, so that the right element is indicated.
--- lib/utils.c | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-)
lib/utils.c +10 -5
@@ -1781,6 +1781,7 @@ int parse_mapping(int *argcp, char ***argvp, {int argc = *argcp;char **argv = *argvp; +int ret =0 ;while (argc >0 ) {char *colon =strchr (*argv,':' );
@@ -1790,15 +1791,19 @@ int parse_mapping(int *argcp, char ***argvp,break ; *colon ='\0' ; -if (get_u32 (&key, *argv,0 )) -return 1 ; -if (mapping_cb (key, colon +1 , mapping_cb_data)) -return 1 ; +if (get_u32 (&key, *argv,0 )) { + ret =1 ; +break ; + } +if (mapping_cb (key, colon +1 , mapping_cb_data)) { + ret =1 ; +break ; + } argc--, argv++; } *argcp = argc; *argvp = argv; -return 0 ; +return ret; }
Signature · 1 line
2.25.1
PATCH 13/15 lib: parse_mapping: Recognize a keyword "all"
In reply to Petr MachataThe DCB tool will have to provide an interface to a number of fixed-size arrays. Unlike the egress- and ingress-qos-map, it makes good sense to have an interface to set all members to the same value. For example to set strict priority on all TCs besides select few, or to reset allocated bandwidth to all zeroes, again besides several explicitly-given ones.
To support this usage, extend the parse_mapping() with a boolean that determines whether this special use is supported. If "all" is given and recognized, mapping_cb is called with the key of -1.
Have iplink_vlan pass false for allow_all.
--- include/utils.h | 2 +- ip/iplink_vlan.c | 2 +- lib/utils.c | 6 ++++-- 3 files changed, 6 insertions(+), 4 deletions(-)
include/utils.h +1 -1
@@ -339,7 +339,7 @@ int parse_on_off(const char *msg, const char *realval, int *p_err);void parse_flag_on_off (const char *msg,const char *realval,unsigned int *p_flags,unsigned int flag,int *p_ret); -int parse_mapping (int *argcp,char ***argvp, +int parse_mapping (int *argcp,char ***argvp,bool allow_all,int (*mapping_cb)(__u32 key,char *value,void *data),void *mapping_cb_data);
ip/iplink_vlan.c +1 -1
@@ -64,7 +64,7 @@ static int vlan_parse_qos_map(int *argcp, char ***argvp, struct nlmsghdr *n, tail =addattr_nest (n,1024 , attrtype); -if (parse_mapping (argcp, argvp, &parse_qos_mapping, n)) +if (parse_mapping (argcp, argvp, false, &parse_qos_mapping, n))return 1 ;addattr_nest_end (n, tail);
lib/utils.c +4 -2
@@ -1775,7 +1775,7 @@ void parse_flag_on_off(const char *msg, const char *realval,set_flag (p_flags, flag, on_off); } -int parse_mapping (int *argcp,char ***argvp, +int parse_mapping (int *argcp,char ***argvp,bool allow_all,int (*mapping_cb)(__u32 key,char *value,void *data),void *mapping_cb_data) {
@@ -1791,7 +1791,9 @@ int parse_mapping(int *argcp, char ***argvp,break ; *colon ='\0' ; -if (get_u32 (&key, *argv,0 )) { +if (allow_all &&matches (*argv,"all" ) ==0 ) { + key = (__u32) -1 ; + }else if (get_u32 (&key, *argv,0 )) { ret =1 ;break ; }
Signature · 1 line
2.25.1
PATCH 10/15 lib: Extract from devlink/mnlg a helper, mnlu_socket_recv_run()
In reply to Petr MachataReceiving a message in libmnl is a somewhat involved operation. Devlink's mnlg library has an implementation that is going to be handy for other tools as well. Extract it into a new helper.
--- devlink/mnlg.c | 56 ++--------------------------------------- include/mnl_utils.h | 2 ++ lib/mnl_utils.c | 61 +++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 65 insertions(+), 54 deletions(-)
devlink/mnlg.c +2 -54
@@ -28,7 +28,6 @@ struct mnlg_socket {uint32_t id;uint8_t version;unsigned int seq; -unsigned int portid; }; static struct nlmsghdr *__mnlg_msg_prepare(struct mnlg_socket *nlg, uint8_t cmd,
@@ -57,61 +56,10 @@ int mnlg_socket_send(struct mnlg_socket *nlg, const struct nlmsghdr *nlh)return mnl_socket_sendto (nlg->nl, nlh, nlh->nlmsg_len); } -static int mnlg_cb_noop (const struct nlmsghdr *nlh,void *data) -{ -return MNL_CB_OK ; -} - -static int mnlg_cb_error (const struct nlmsghdr *nlh,void *data) -{ -const struct nlmsgerr *err =mnl_nlmsg_get_payload (nlh); - -/* Netlink subsystems returns the errno value with different signess */ -if (err->error <0 ) - errno = -err->error; -else - errno = err->error; - -if (nl_dump_ext_ack (nlh,NULL )) -return MNL_CB_ERROR ; - -return err->error ==0 ?MNL_CB_STOP :MNL_CB_ERROR ; -} - -static int mnlg_cb_stop (const struct nlmsghdr *nlh,void *data) -{ -int len = *(int *)NLMSG_DATA (nlh); - -if (len <0 ) { - errno = -len; -nl_dump_ext_ack_done (nlh, len); -return MNL_CB_ERROR ; - } -return MNL_CB_STOP ; -} - -static mnl_cb_t mnlg_cb_array[NLMSG_MIN_TYPE ] = { - [NLMSG_NOOP ] = mnlg_cb_noop, - [NLMSG_ERROR ] = mnlg_cb_error, - [NLMSG_DONE ] = mnlg_cb_stop, - [NLMSG_OVERRUN ] = mnlg_cb_noop, -}; -int mnlg_socket_recv_run (struct mnlg_socket *nlg,mnl_cb_t data_cb,void *data) { -int err; - -do { - err =mnl_socket_recvfrom (nlg->nl, nlg->buf, -MNL_SOCKET_BUFFER_SIZE ); -if (err <=0 ) -break ; - err =mnl_cb_run2 (nlg->buf, err, nlg->seq, nlg->portid, - data_cb, data, mnlg_cb_array, -ARRAY_SIZE (mnlg_cb_array)); - }while (err >0 ); - -return err; +return mnlu_socket_recv_run (nlg->nl, nlg->seq, nlg->buf,MNL_SOCKET_BUFFER_SIZE , + data_cb, data); }struct group_info {
include/mnl_utils.h +2 -0
@@ -5,5 +5,7 @@struct mnl_socket *mnlu_socket_open (int bus);struct nlmsghdr *mnlu_msg_prepare (void *buf,uint32_t nlmsg_type,uint16_t flags,void *extra_header,size_t extra_header_size); +int mnlu_socket_recv_run (struct mnl_socket *nl,unsigned int seq,void *buf,size_t buf_size, +mnl_cb_t cb,void *data);#endif /* __MNL_UTILS_H__ */
lib/mnl_utils.c +61 -0
75 lines not on this page · raw message
Signature · 1 line
2.25.1
PATCH 14/15 Add skeleton of a new tool, dcb
In reply to Petr MachataThe Linux DCB interface allows configuration of a broad range of hardware-specific attributes, such as TC scheduling, flow control, per-port buffer configuration, TC rate, etc. Add a new tool to show that configuration and tweak it.
DCB allows configuration of several objects, and possibly could expand to pre-standard CEE interfaces. Therefore the tool itself is a lean shell that dispatches to subtools each dedicated to one of the objects.
--- Makefile | 2 +- dcb/Makefile | 24 ++++ dcb/dcb.c | 377 +++++++++++++++++++++++++++++++++++++++++++++++++ dcb/dcb.h | 32 +++++ man/man8/dcb.8 | 103 ++++++++++++++ 5 files changed, 537 insertions(+), 1 deletion(-) create mode 100644 dcb/Makefile create mode 100644 dcb/dcb.c create mode 100644 dcb/dcb.h create mode 100644 man/man8/dcb.8
Makefile +1 -1
@@ -55,7 +55,7 @@ WFLAGS += -Wmissing-declarations -Wold-style-definition -Wformat=2 CFLAGS := $(WFLAGS) $(CCOPTS) -I../include -I../include/uapi $(DEFINES) $(CFLAGS) YACCFLAGS = -d -t -v -SUBDIRS=lib ip tc bridge misc netem genl tipc devlink rdma man +SUBDIRS=lib ip tc bridge misc netem genl tipc devlink rdma dcb man LIBNETLINK=../lib/libutil.a ../lib/libnetlink.a LDLIBS += $(LIBNETLINK)
dcb/Makefile new file +24 -0
@@ -0,0 +1,24 @@ +# SPDX-License-Identifier: GPL-2.0 +include ../config.mk + +TARGETS := + +ifeq ($(HAVE_MNL),y) + +DCBOBJ = dcb.o +TARGETS += dcb + +endif + +all: $(TARGETS) $(LIBS) + +dcb: $(DCBOBJ) $(LIBNETLINK) + $(QUIET_LINK)$(CC) $^ $(LDFLAGS) $(LDLIBS) -o $@ + +install: all + for i in $(TARGETS); \ + do install -m 0755 $$i $(DESTDIR)$(SBINDIR); \ + done + +clean: + rm -f $(DCBOBJ) $(TARGETS)
dcb/dcb.c new file +377 -0
377 lines not on this page · raw message
dcb/dcb.h new file +32 -0
@@ -0,0 +1,32 @@ +/* SPDX-License-Identifier: GPL-2.0 */ +#ifndef __DCB_H__ +#define __DCB_H__ 1 + +#include <stdbool.h> +#include <stddef.h> + +/* dcb.c */ + +struct dcb { +char *buf; +struct mnl_socket *nl; +bool json_output; +}; + +int dcb_cmd_parse_dev (struct dcb *dcb,int argc,char **argv, +int (*and_then)(struct dcb *dcb,const char *dev, +int argc,char **argv), +void (*help)(void )); + +int dcb_get_attribute (struct dcb *dcb,const char *dev,int attr, +void *data,size_t data_len); +int dcb_set_attribute (struct dcb *dcb,const char *dev,int attr, +const void *data,size_t data_len); + +void dcb_print_named_array (FILE *fp,const char *name,const __u8 *array,size_t size, +void (*print_array)(FILE *,const __u8 *,size_t )); +void dcb_print_array_num (FILE *fp,const __u8 *array,size_t size); +void dcb_print_array_kw (FILE *fp,const __u8 *array,size_t array_size, +const char *const kw[],size_t kw_size); + +#endif /* __DCB_H__ */
man/man8/dcb.8 new file +103 -0
103 lines not on this page · raw message
Signature · 1 line
2.25.1
PATCH 15/15 dcb: Add a subtool for the DCB ETS object
In reply to Petr MachataETS, for "Enhanced Transmission Selection", is a set of configurations that permit configuration of mapping of priorities to traffic classes, traffic selection algorithm to use per traffic class, bandwidth allocation, etc.
Add a dcb subtool to allow showing and tweaking of individual ETS configuration options. For example:
# dcb ets show dev eni1np1
willing on ets_cap 8 cbs off
tc-bw 0:0 1:0 2:0 3:0 4:100 5:0 6:0 7:0
pg-bw 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0
tc-tsa 0:strict 1:strict 2:strict 3:strict 4:ets 5:strict 6:strict 7:strict
prio-tc 0:1 1:3 2:5 3:0 4:0 5:0 6:0 7:0
reco-tc-bw 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0
reco-tc-tsa 0:strict 1:strict 2:strict 3:strict 4:strict 5:strict 6:strict 7:strict
reco-prio-tc 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0--- dcb/Makefile | 2 +- dcb/dcb.c | 4 +- dcb/dcb.h | 4 + dcb/dcb_ets.c | 450 +++++++++++++++++++++++++++++++++++++++++++++ man/man8/dcb-ets.8 | 185 +++++++++++++++++++ man/man8/dcb.8 | 11 ++ 6 files changed, 654 insertions(+), 2 deletions(-) create mode 100644 dcb/dcb_ets.c create mode 100644 man/man8/dcb-ets.8
dcb/Makefile +1 -1
@@ -5,7 +5,7 @@ TARGETS := ifeq ($(HAVE_MNL),y) -DCBOBJ = dcb.o +DCBOBJ = dcb.o dcb_ets.o TARGETS += dcb endif
dcb/dcb.c +3 -1
@@ -262,7 +262,7 @@ static void dcb_help(void)fprintf (stderr,"Usage: dcb [ OPTIONS ] OBJECT { COMMAND | help }\n" " dcb [ -f[orce] ] -b[atch] filename -N[etns] netnsname\n" -"where OBJECT :=\n" +"where OBJECT := ets\n" " OPTIONS := { -V[ersion] | -j[son] | -p[retty] | -v[erbose] }\n" ); }
@@ -271,6 +271,8 @@ static int dcb_cmd(struct dcb *dcb, int argc, char **argv)if (!argc ||matches (*argv,"help" ) ==0 ) {dcb_help ();return 0 ; + }else if (matches (*argv,"ets" ) ==0 ) { +return dcb_cmd_ets (dcb, argc -1 , argv +1 ); }fprintf (stderr,"Object \"%s\" is unknown\n" , *argv);
dcb/dcb.h +4 -0
@@ -29,4 +29,8 @@ void dcb_print_array_num(FILE *fp, const __u8 *array, size_t size);void dcb_print_array_kw (FILE *fp,const __u8 *array,size_t array_size,const char *const kw[],size_t kw_size); +/* dcb_ets.c */ + +int dcb_cmd_ets (struct dcb *dcb,int argc,char **argv); +#endif /* __DCB_H__ */
dcb/dcb_ets.c new file +450 -0
450 lines not on this page · raw message
man/man8/dcb-ets.8 new file +185 -0
185 lines not on this page · raw message
man/man8/dcb.8 +11 -0
@@ -6,6 +6,13 @@ dcb \- show / manipulate DCB (Data Center Bridging) settings .ad l .in +8 +.ti -8 +.B dcb +.RI "[ " OPTIONS " ] " +.B ets +.RI "{ " COMMAND " | " help " }" +.sp + .ti -8 .B dcb .RB "[ " -force " ] "
@@ -46,6 +53,10 @@ When combined with -j generate a pretty JSON output. .SH OBJECTS +.TP +.B ets +- Configuration of ETS (Enhanced Transmission Selection) + .SH COMMANDS A \fICOMMAND\fR specifies the action to perform on the object. The set of
Signature · 1 line
2.25.1
PATCH 5/15 ip: iplink: Convert to use parse_on_off(), parse_flag_on_off()
In reply to Petr MachataInvoke parse_flag_on_off() instead of rolling a custom function. Several places have the on/off logic reversed vs. how the flag is specified (e.g. IFF_NOARP vs. "arp" on command line). For those, invoke parse_on_off() and then set_flag() with a negated value.
--- ip/iplink.c | 182 +++++++++++++++++++--------------------------------- 1 file changed, 66 insertions(+), 116 deletions(-)
ip/iplink.c +66 -116
@@ -135,14 +135,6 @@ static void usage(void)iplink_usage (); } -static int on_off (const char *msg,const char *realval) -{ -fprintf (stderr, -"Error: argument of \"%s\" must be \"on\" or \"off\", not \"%s\"\n" , - msg, realval); -return -1 ; -} -static void *BODY ;/* cached dlopen(NULL) handle */ static struct link_util *linkutil_list;
@@ -351,6 +343,7 @@ static int iplink_parse_vf(int vf, int *argcp, char ***argvp,int len, argc = *argcp;char **argv = *argvp;struct rtattr *vfinfo; +int ret; tivt.min_tx_rate =-1 ; tivt.max_tx_rate =-1 ;
@@ -463,12 +456,9 @@ static int iplink_parse_vf(int vf, int *argcp, char ***argvp,struct ifla_vf_spoofchk ivs;NEXT_ARG (); -if (matches (*argv,"on" ) ==0 ) - ivs.setting =1 ; -else if (matches (*argv,"off" ) ==0 ) - ivs.setting =0 ; -else -return on_off ("spoofchk" , *argv); + ivs.setting =parse_on_off ("spoofchk" , *argv, &ret); +if (ret) +return ret; ivs.vf = vf;addattr_l (&req->n,sizeof (*req),IFLA_VF_SPOOFCHK , &ivs,sizeof (ivs));
@@ -477,12 +467,9 @@ static int iplink_parse_vf(int vf, int *argcp, char ***argvp,struct ifla_vf_rss_query_en ivs;NEXT_ARG (); -if (matches (*argv,"on" ) ==0 ) - ivs.setting =1 ; -else if (matches (*argv,"off" ) ==0 ) - ivs.setting =0 ; -else -return on_off ("query_rss" , *argv); + ivs.setting =parse_on_off ("query_rss" , *argv, &ret); +if (ret) +return ret; ivs.vf = vf;addattr_l (&req->n,sizeof (*req),IFLA_VF_RSS_QUERY_EN , &ivs,sizeof (ivs));
@@ -491,12 +478,9 @@ static int iplink_parse_vf(int vf, int *argcp, char ***argvp,struct ifla_vf_trust ivt;NEXT_ARG (); -if (matches (*argv,"on" ) ==0 ) - ivt.setting =1 ; -else if (matches (*argv,"off" ) ==0 ) - ivt.setting =0 ; -else -invarg ("Invalid \"trust\" value\n" , *argv); + ivt.setting =parse_on_off ("trust" , *argv, &ret); +if (ret) +return ret; ivt.vf = vf;addattr_l (&req->n,sizeof (*req),IFLA_VF_TRUST , &ivt,sizeof (ivt));
@@ -594,6 +578,7 @@ int iplink_parse(int argc, char **argv, struct iplink_req *req, char **type)int index =0 ;int group =-1 ;int addr_len =0 ; +int err; ret = argc;
@@ -687,62 +672,53 @@ int iplink_parse(int argc, char **argv, struct iplink_req *req, char **type)NEXT_ARG (); req->i.ifi_change |=IFF_MULTICAST ; -if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags |=IFF_MULTICAST ; -else if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags &= ~IFF_MULTICAST ; -else -return on_off ("multicast" , *argv); +parse_flag_on_off ("multicast" , *argv, &req->i.ifi_flags, +IFF_MULTICAST , &err); +if (err) +return err; }else if (strcmp (*argv,"allmulticast" ) ==0 ) {NEXT_ARG (); req->i.ifi_change |=IFF_ALLMULTI ; -if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags |=IFF_ALLMULTI ; -else if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags &= ~IFF_ALLMULTI ; -else -return on_off ("allmulticast" , *argv); +parse_flag_on_off ("allmulticast" , *argv, &req->i.ifi_flags, +IFF_ALLMULTI , &err); +if (err) +return err; }else if (strcmp (*argv,"promisc" ) ==0 ) {NEXT_ARG (); req->i.ifi_change |=IFF_PROMISC ; -if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags |=IFF_PROMISC ; -else if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags &= ~IFF_PROMISC ; -else -return on_off ("promisc" , *argv); +parse_flag_on_off ("promisc" , *argv, &req->i.ifi_flags, +IFF_PROMISC , &err); +if (err) +return err; }else if (strcmp (*argv,"trailers" ) ==0 ) { +int on_off; +NEXT_ARG (); req->i.ifi_change |=IFF_NOTRAILERS ; -if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags |=IFF_NOTRAILERS ; -else if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags &= ~IFF_NOTRAILERS ; -else -return on_off ("trailers" , *argv); + on_off =parse_on_off ("trailers" , *argv, &err); +if (err) +return err; +set_flag (&req->i.ifi_flags,IFF_NOTRAILERS , !on_off); }else if (strcmp (*argv,"arp" ) ==0 ) { +int on_off; +NEXT_ARG (); req->i.ifi_change |=IFF_NOARP ; -if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags &= ~IFF_NOARP ; -else if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags |=IFF_NOARP ; -else -return on_off ("arp" , *argv); + on_off =parse_on_off ("arp" , *argv, &err); +if (err) +return err; +set_flag (&req->i.ifi_flags,IFF_NOARP , !on_off); }else if (strcmp (*argv,"carrier" ) ==0 ) {int carrier;NEXT_ARG (); -if (strcmp (*argv,"on" ) ==0 ) - carrier =1 ; -else if (strcmp (*argv,"off" ) ==0 ) - carrier =0 ; -else -return on_off ("carrier" , *argv); + carrier =parse_on_off ("carrier" , *argv, &err); +if (err) +return err;addattr8 (&req->n,sizeof (*req),IFLA_CARRIER , carrier); }else if (strcmp (*argv,"vf" ) ==0 ) {
@@ -793,12 +769,10 @@ int iplink_parse(int argc, char **argv, struct iplink_req *req, char **type)NEXT_ARG (); req->i.ifi_change |=IFF_DYNAMIC ; -if (strcmp (*argv,"on" ) ==0 ) - req->i.ifi_flags |=IFF_DYNAMIC ; -else if (strcmp (*argv,"off" ) ==0 ) - req->i.ifi_flags &= ~IFF_DYNAMIC ; -else -return on_off ("dynamic" , *argv); +parse_flag_on_off ("dynamic" , *argv, &req->i.ifi_flags, +IFF_DYNAMIC , &err); +if (err) +return err; }else if (matches (*argv,"type" ) ==0 ) {NEXT_ARG (); *type = *argv;
@@ -895,12 +869,9 @@ int iplink_parse(int argc, char **argv, struct iplink_req *req, char **type)unsigned int proto_down;NEXT_ARG (); -if (strcmp (*argv,"on" ) ==0 ) - proto_down =1 ; -else if (strcmp (*argv,"off" ) ==0 ) - proto_down =0 ; -else -return on_off ("protodown" , *argv); + proto_down =parse_on_off ("protodown" , *argv, &err); +if (err) +return err;addattr8 (&req->n,sizeof (*req),IFLA_PROTO_DOWN , proto_down); }else if (strcmp (*argv,"gso_max_size" ) ==0 ) {
@@ -1320,6 +1291,7 @@ static int do_set(int argc, char **argv)struct ifreq ifr0, ifr1;char *newname =NULL ;int htype, halen; +int ret;while (argc >0 ) {if (strcmp (*argv,"up" ) ==0 ) {
@@ -1357,63 +1329,41 @@ static int do_set(int argc, char **argv) }else if (strcmp (*argv,"multicast" ) ==0 ) {NEXT_ARG (); mask |=IFF_MULTICAST ; - -if (strcmp (*argv,"on" ) ==0 ) - flags |=IFF_MULTICAST ; -else if (strcmp (*argv,"off" ) ==0 ) - flags &= ~IFF_MULTICAST ; -else -return on_off ("multicast" , *argv); +parse_flag_on_off ("multicast" , *argv, &flags,IFF_MULTICAST , &ret); +if (ret) +return ret; }else if (strcmp (*argv,"allmulticast" ) ==0 ) {NEXT_ARG (); mask |=IFF_ALLMULTI ; - -if (strcmp (*argv,"on" ) ==0 ) - flags |=IFF_ALLMULTI ; -else if (strcmp (*argv,"off" ) ==0 ) - flags &= ~IFF_ALLMULTI ; -else -return on_off ("allmulticast" , *argv); +parse_flag_on_off ("allmulticast" , *argv, &flags,IFF_ALLMULTI , &ret); }else if (strcmp (*argv,"promisc" ) ==0 ) {NEXT_ARG (); mask |=IFF_PROMISC ; - -if (strcmp (*argv,"on" ) ==0 ) - flags |=IFF_PROMISC ; -else if (strcmp (*argv,"off" ) ==0 ) - flags &= ~IFF_PROMISC ; -else -return on_off ("promisc" , *argv); +parse_flag_on_off ("promisc" , *argv, &flags,IFF_PROMISC , &ret); }else if (strcmp (*argv,"trailers" ) ==0 ) { +int on_off; +NEXT_ARG (); mask |=IFF_NOTRAILERS ; - -if (strcmp (*argv,"off" ) ==0 ) - flags |=IFF_NOTRAILERS ; -else if (strcmp (*argv,"on" ) ==0 ) - flags &= ~IFF_NOTRAILERS ; -else -return on_off ("trailers" , *argv); + on_off =parse_on_off ("trailers" , *argv, &ret); +if (ret) +return ret; +set_flag (&flags,IFF_NOTRAILERS , !on_off); }else if (strcmp (*argv,"arp" ) ==0 ) { +int on_off; +NEXT_ARG (); mask |=IFF_NOARP ; - -if (strcmp (*argv,"on" ) ==0 ) - flags &= ~IFF_NOARP ; -else if (strcmp (*argv,"off" ) ==0 ) - flags |=IFF_NOARP ; -else -return on_off ("arp" , *argv); + on_off =parse_on_off ("arp" , *argv, &ret); +if (ret) +return ret; +set_flag (&flags,IFF_NOARP , !on_off); }else if (matches (*argv,"dynamic" ) ==0 ) {NEXT_ARG (); mask |=IFF_DYNAMIC ; - -if (strcmp (*argv,"on" ) ==0 ) - flags |=IFF_DYNAMIC ; -else if (strcmp (*argv,"off" ) ==0 ) - flags &= ~IFF_DYNAMIC ; -else -return on_off ("dynamic" , *argv); +parse_flag_on_off ("dynamic" , *argv, &flags,IFF_DYNAMIC , &ret); +if (ret) +return ret; }else {if (strcmp (*argv,"dev" ) ==0 )NEXT_ARG ();
Signature · 1 line
2.25.1
PATCH 1/15 Unify batch processing across tools
In reply to Petr MachataThe code for handling batches is largely the same across iproute2 tools. Extract a helper to handle the batch, and adjust the tools to dispatch to this helper. Sandwitch the invocation between prologue / epilogue code specific for each tool.
--- bridge/bridge.c | 38 +++++++------------------------------- devlink/devlink.c | 41 +++++++---------------------------------- include/utils.h | 3 +++ ip/ip.c | 46 ++++++++++------------------------------------ lib/utils.c | 40 ++++++++++++++++++++++++++++++++++++++++ rdma/rdma.c | 38 +++++++------------------------------- tc/tc.c | 38 +++++++------------------------------- 7 files changed, 81 insertions(+), 163 deletions(-)
bridge/bridge.c +7 -31
@@ -77,20 +77,14 @@ static int do_cmd(const char *argv0, int argc, char **argv)return -1 ; } -static int batch (const char *name) +static int br_batch_cmd (int argc,char *argv[],void *data) { -char *line =NULL ; -size_t len =0 ; -int ret =EXIT_SUCCESS ; +return do_cmd (argv[0 ], argc, argv); +} -if (name &&strcmp (name,"-" ) !=0 ) { -if (freopen (name,"r" , stdin) ==NULL ) { -fprintf (stderr, -"Cannot open file \"%s\" for reading: %s\n" , - name,strerror (errno)); -return EXIT_FAILURE ; - } - } +static int batch (const char *name) +{ +int ret;if (rtnl_open (&rth,0 ) <0 ) {fprintf (stderr,"Cannot open rtnetlink\n" );
@@ -99,25 +93,7 @@ static int batch(const char *name)rtnl_set_strict_dump (&rth); - cmdlineno =0 ; -while (getcmdline (&line, &len, stdin) !=-1 ) { -char *largv[100 ]; -int largc; - - largc =makeargs (line, largv,100 ); -if (largc ==0 ) -continue ;/* blank line */ - -if (do_cmd (largv[0 ], largc, largv)) { -fprintf (stderr,"Command failed %s:%d\n" , - name, cmdlineno); - ret =EXIT_FAILURE ; -if (!force) -break ; - } - } -if (line) -free (line); + ret =do_batch (name, force, br_batch_cmd,NULL );rtnl_close (&rth);return ret;
devlink/devlink.c +7 -34
50 lines not on this page · raw message
include/utils.h +3 -0
@@ -322,4 +322,7 @@ int get_time64(__s64 *time, const char *str);char *sprint_time (__u32 time,char *buf);char *sprint_time64 (__s64 time,char *buf); +int do_batch (const char *name,bool force, +int (*cmd)(int argc,char *argv[],void *user),void *user); +#endif /* __UTILS_H__ */
ip/ip.c +10 -36
66 lines not on this page · raw message
lib/utils.c +40 -0
@@ -1695,3 +1695,43 @@ char *sprint_time64(__s64 time, char *buf)print_time64 (buf,SPRINT_BSIZE -1 , time);return buf; } + +int do_batch (const char *name,bool force, +int (*cmd)(int argc,char *argv[],void *data),void *data) +{ +char *line =NULL ; +size_t len =0 ; +int ret =EXIT_SUCCESS ; + +if (name &&strcmp (name,"-" ) !=0 ) { +if (freopen (name,"r" , stdin) ==NULL ) { +fprintf (stderr, +"Cannot open file \"%s\" for reading: %s\n" , + name,strerror (errno)); +return EXIT_FAILURE ; + } + } + + cmdlineno =0 ; +while (getcmdline (&line, &len, stdin) !=-1 ) { +char *largv[100 ]; +int largc; + + largc =makeargs (line, largv,100 ); +if (!largc) +continue ;/* blank line */ + +if (cmd (largc, largv, data)) { +fprintf (stderr,"Command failed %s:%d\n" , + name, cmdlineno); + ret =EXIT_FAILURE ; +if (!force) +break ; + } + } + +if (line) +free (line); + +return ret; +}
rdma/rdma.c +7 -31
@@ -41,40 +41,16 @@ static int rd_cmd(struct rd *rd, int argc, char **argv)return rd_exec_cmd (rd, cmds,"object" ); } -static int rd_batch (struct rd *rd,const char *name,bool force) +static int rd_batch_cmd (int argc,char *argv[],void *data) { -char *line =NULL ; -size_t len =0 ; -int ret =0 ; - -if (name &&strcmp (name,"-" ) !=0 ) { -if (!freopen (name,"r" , stdin)) { -pr_err ("Cannot open file \"%s\" for reading: %s\n" , - name,strerror (errno)); -return errno; - } - } +struct rd *rd = data; - cmdlineno =0 ; -while (getcmdline (&line, &len, stdin) !=-1 ) { -char *largv[512 ]; -int largc; - - largc =makeargs (line, largv,ARRAY_SIZE (largv)); -if (!largc) -continue ;/* blank line */ - - ret =rd_cmd (rd, largc, largv); -if (ret) { -pr_err ("Command failed %s:%d\n" , name, cmdlineno); -if (!force) -break ; - } - } - -free (line); +return rd_cmd (rd, argc, argv); +} -return ret; +static int rd_batch (struct rd *rd,const char *name,bool force) +{ +return do_batch (name, force, rd_batch_cmd, rd); }static int rd_init (struct rd *rd,char *filename)
tc/tc.c +7 -31
@@ -231,22 +231,16 @@ static int do_cmd(int argc, char **argv)return -1 ; } +static int tc_batch_cmd (int argc,char *argv[],void *data) +{ +return do_cmd (argc, argv); +} +static int batch (const char *name) { -char *line =NULL ; -size_t len =0 ; -int ret =0 ; +int ret; batch_mode =1 ; -if (name &&strcmp (name,"-" ) !=0 ) { -if (freopen (name,"r" , stdin) ==NULL ) { -fprintf (stderr, -"Cannot open file \"%s\" for reading: %s\n" , - name,strerror (errno)); -return -1 ; - } - } -tc_core_init ();if (rtnl_open (&rth,0 ) <0 ) {
@@ -254,26 +248,8 @@ static int batch(const char *name)return -1 ; } - cmdlineno =0 ; -while (getcmdline (&line, &len, stdin) !=-1 ) { -char *largv[100 ]; -int largc; - - largc =makeargs (line, largv,100 ); -if (largc ==0 ) -continue ;/* blank line */ - -if (do_cmd (largc, largv)) { -fprintf (stderr,"Command failed %s:%d\n" , - name, cmdlineno); - ret =1 ; -if (!force) -break ; - } -fflush (stdout); - } + ret =do_batch (name, force, tc_batch_cmd,NULL ); -free (line);rtnl_close (&rth);return ret; }
Signature · 1 line
2.25.1
PATCH 3/15 bridge: link: Port over to parse_on_off()
In reply to Petr MachataConvert bridge/link.c from a custom on_off parser to the new global one.
--- bridge/link.c | 79 ++++++++++++++++++++++++--------------------------- 1 file changed, 37 insertions(+), 42 deletions(-)
bridge/link.c +37 -42
@@ -275,22 +275,6 @@ static void usage(void)exit (-1 ); } -static bool on_off (char *arg,__s8 *attr,char *val) -{ -if (strcmp (val,"on" ) ==0 ) - *attr =1 ; -else if (strcmp (val,"off" ) ==0 ) - *attr =0 ; -else { -fprintf (stderr, -"Error: argument of \"%s\" must be \"on\" or \"off\"\n" , - arg); -return false; - } - -return true; -} -static int brlink_modify (int argc,char **argv) {struct {
@@ -323,6 +307,7 @@ static int brlink_modify(int argc, char **argv)__s16 mode =-1 ;__u16 flags =0 ;struct rtattr *nest; +int ret;while (argc >0 ) {if (strcmp (*argv,"dev" ) ==0 ) {
@@ -330,40 +315,49 @@ static int brlink_modify(int argc, char **argv) d = *argv; }else if (strcmp (*argv,"guard" ) ==0 ) {NEXT_ARG (); -if (!on_off ("guard" , &bpdu_guard, *argv)) -return -1 ; + bpdu_guard =parse_on_off ("guard" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"hairpin" ) ==0 ) {NEXT_ARG (); -if (!on_off ("hairpin" , &hairpin, *argv)) -return -1 ; + hairpin =parse_on_off ("hairpin" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"fastleave" ) ==0 ) {NEXT_ARG (); -if (!on_off ("fastleave" , &fast_leave, *argv)) -return -1 ; + fast_leave =parse_on_off ("fastleave" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"root_block" ) ==0 ) {NEXT_ARG (); -if (!on_off ("root_block" , &root_block, *argv)) -return -1 ; + root_block =parse_on_off ("root_block" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"learning" ) ==0 ) {NEXT_ARG (); -if (!on_off ("learning" , &learning, *argv)) -return -1 ; + learning =parse_on_off ("learning" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"learning_sync" ) ==0 ) {NEXT_ARG (); -if (!on_off ("learning_sync" , &learning_sync, *argv)) -return -1 ; + learning_sync =parse_on_off ("learning_sync" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"flood" ) ==0 ) {NEXT_ARG (); -if (!on_off ("flood" , &flood, *argv)) -return -1 ; + flood =parse_on_off ("flood" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"mcast_flood" ) ==0 ) {NEXT_ARG (); -if (!on_off ("mcast_flood" , &mcast_flood, *argv)) -return -1 ; + mcast_flood =parse_on_off ("mcast_flood" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"mcast_to_unicast" ) ==0 ) {NEXT_ARG (); -if (!on_off ("mcast_to_unicast" , &mcast_to_unicast, *argv)) -return -1 ; + mcast_to_unicast =parse_on_off ("mcast_to_unicast" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"cost" ) ==0 ) {NEXT_ARG (); cost =atoi (*argv);
@@ -404,18 +398,19 @@ static int brlink_modify(int argc, char **argv) flags |=BRIDGE_FLAGS_MASTER ; }else if (strcmp (*argv,"neigh_suppress" ) ==0 ) {NEXT_ARG (); -if (!on_off ("neigh_suppress" , &neigh_suppress, - *argv)) -return -1 ; + neigh_suppress =parse_on_off ("neigh_suppress" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"vlan_tunnel" ) ==0 ) {NEXT_ARG (); -if (!on_off ("vlan_tunnel" , &vlan_tunnel, - *argv)) -return -1 ; + vlan_tunnel =parse_on_off ("vlan_tunnel" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"isolated" ) ==0 ) {NEXT_ARG (); -if (!on_off ("isolated" , &isolated, *argv)) -return -1 ; + isolated =parse_on_off ("isolated" , *argv, &ret); +if (ret) +return ret; }else if (strcmp (*argv,"backup_port" ) ==0 ) {NEXT_ARG (); backup_port_idx =ll_name_to_index (*argv);
Signature · 1 line
2.25.1
Re: [PATCH iproute2-next 11/15] lib: Extract from iplink_vlan a helper to parse key:value arrays
In reply to Petr MachataPetr Machata <[email protected]> writes:
[...]
ip/iplink_vlan.c static void explain(void) · line 58
Quoted 13 lines
ip/iplink_vlan.c +13
-0+static int parse_qos_mapping (__u32 key,char *value,void *data) +{ +struct nlmsghdr *n = data; +struct ifla_vlan_qos_mapping m = { + .from = key, + }; + +if (get_u32 (&m.to, value,0 )) +return 1 ; + +addattr_l (n,1024 ,IFLA_VLAN_QOS_MAPPING , &m,sizeof (m)); +return 0 ; +}
addatr_l() may fail if netlink buffer size is not sufficient, may be:
return addattr_l(...);
would be better.
Jakub Kicinski
maintainerRe: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
In reply to Petr Machatadcb/dcb_ets.c line 137
Quoted 4 lines · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
dcb/dcb_ets.c new file +4
-0+static void dcb_ets_print_cbs (FILE *fp,const struct ieee_ets *ets) +{ +print_string (PRINT_ANY ,"cbs" ,"cbs %s " , ets->cbs ?"on" :"off" ); +}
I'd personally lean in the direction ethtool is taking and try to limit string values in json output as much as possible. This would be a good fit for bool.
Re: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
Quoted 9 lines · Jakub Kicinski
dcb/dcb_ets.c line 137
Quoted 4 lines · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
dcb/dcb_ets.c new file +4
-0+static void dcb_ets_print_cbs (FILE *fp,const struct ieee_ets *ets) +{ +print_string (PRINT_ANY ,"cbs" ,"cbs %s " , ets->cbs ?"on" :"off" ); +}I'd personally lean in the direction ethtool is taking and try to limit string values in json output as much as possible. This would be a good fit for bool.
Yep, makes sense. The value is not user-toggleable, so the on / off there is just arbitrary.
I'll consider it for "willing" as well. That one is user-toggleable, and the "on" / "off" makes sense for consistency with the command line. But that doesn't mean it can't be a boolean in JSON.
Re: [PATCH iproute2-next 11/15] lib: Extract from iplink_vlan a helper to parse key:value arrays
In reply to Roman MashakQuoted 21 lines · Roman Mashak
Petr Machata <[email protected]> writes:
[...]
ip/iplink_vlan.c static void explain(void) · line 58
Quoted 13 lines
ip/iplink_vlan.c +13
-0+static int parse_qos_mapping (__u32 key,char *value,void *data) +{ +struct nlmsghdr *n = data; +struct ifla_vlan_qos_mapping m = { + .from = key, + }; + +if (get_u32 (&m.to, value,0 )) +return 1 ; + +addattr_l (n,1024 ,IFLA_VLAN_QOS_MAPPING , &m,sizeof (m)); +return 0 ; +}
addatr_l()may fail if netlink buffer size is not sufficient, may be:
Quoted 3 lines
return
addattr_l(...);would be better.
Ack, makes sense to fix this since I'm moving the code around anyway.
Re: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
In reply to Petr MachataQuoted 12 lines · On Tue, 20 Oct 2020 22:43:37 +0200 Petr Machata <[email protected]> wrote:
Quoted 9 lines · Jakub Kicinski
dcb/dcb_ets.c line 137
Quoted 4 lines · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
dcb/dcb_ets.c new file +4
-0+static void dcb_ets_print_cbs (FILE *fp,const struct ieee_ets *ets) +{ +print_string (PRINT_ANY ,"cbs" ,"cbs %s " , ets->cbs ?"on" :"off" ); +}I'd personally lean in the direction ethtool is taking and try to limit string values in json output as much as possible. This would be a good fit for bool.
Quoted 6 lines
Yep, makes sense. The value is not user-toggleable, so the on / off there is just arbitrary.
I'll consider it for "willing" as well. That one is user-toggleable, and the "on" / "off" makes sense for consistency with the command line. But that doesn't mean it can't be a boolean in JSON.
There are three ways of representing a boolean. You chose the worst. Option 1: is to use a json null value to indicate presence.
this works well for a flag.
Option 2: is to use json bool.
this looks awkward in non-json output
Option 3: is to use a string
but this makes the string output something harder to consume in json.
Re: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
Quoted 22 lines · Stephen Hemminger
Quoted 12 lines · On Tue, 20 Oct 2020 22:43:37 +0200 Petr Machata <[email protected]> wrote:
Quoted 9 lines · Jakub Kicinski
dcb/dcb_ets.c line 137
Quoted 4 lines · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
dcb/dcb_ets.c new file +4
-0+static void dcb_ets_print_cbs (FILE *fp,const struct ieee_ets *ets) +{ +print_string (PRINT_ANY ,"cbs" ,"cbs %s " , ets->cbs ?"on" :"off" ); +}I'd personally lean in the direction ethtool is taking and try to limit string values in json output as much as possible. This would be a good fit for bool.
Quoted 6 lines
Yep, makes sense. The value is not user-toggleable, so the on / off there is just arbitrary.
I'll consider it for "willing" as well. That one is user-toggleable, and the "on" / "off" makes sense for consistency with the command line. But that doesn't mean it can't be a boolean in JSON.
Quoted 8 lines
There are three ways of representing a boolean. You chose the worst. Option 1: is to use a json null value to indicate presence.
this works well for a flag.
Option 2: is to use json bool.
this looks awkward in non-json output
Option 3: is to use a string
but this makes the string output something harder to consume in json.
What seems to be used commonly for these on/off toggles is the following pattern:
print_string(PRINT_FP, NULL, "willing %s ", ets->willing ? "on" : "off"); print_bool(PRINT_JSON, "willing", NULL, true);
That way the JSON output is easy to query and the FP output is obvious and compatible with the command line. Does that work for you?
Re: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
Quoted 33 lines · On Thu, 22 Oct 2020 01:48:58 +0200 Petr Machata <[email protected]> wrote:
Quoted 22 lines · Stephen Hemminger
Quoted 12 lines · On Tue, 20 Oct 2020 22:43:37 +0200 Petr Machata <[email protected]> wrote:
Quoted 9 lines · Jakub Kicinski
dcb/dcb_ets.c line 137
Quoted 4 lines · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
dcb/dcb_ets.c new file +4
-0+static void dcb_ets_print_cbs (FILE *fp,const struct ieee_ets *ets) +{ +print_string (PRINT_ANY ,"cbs" ,"cbs %s " , ets->cbs ?"on" :"off" ); +}I'd personally lean in the direction ethtool is taking and try to limit string values in json output as much as possible. This would be a good fit for bool.
Quoted 6 lines
Yep, makes sense. The value is not user-toggleable, so the on / off there is just arbitrary.
I'll consider it for "willing" as well. That one is user-toggleable, and the "on" / "off" makes sense for consistency with the command line. But that doesn't mean it can't be a boolean in JSON.
Quoted 8 lines
There are three ways of representing a boolean. You chose the worst. Option 1: is to use a json null value to indicate presence.
this works well for a flag.
Option 2: is to use json bool.
this looks awkward in non-json output
Option 3: is to use a string
but this makes the string output something harder to consume in json.
Quoted 8 lines
What seems to be used commonly for these on/off toggles is the following pattern:
print_string(PRINT_FP, NULL, "willing %s ", ets->willing ? "on" : "off"); print_bool(PRINT_JSON, "willing", NULL, true);That way the JSON output is easy to query and the FP output is obvious and compatible with the command line. Does that work for you?
Yes, that is hybrid, maybe it should be a helper function?
Re: [PATCH iproute2-next 15/15] dcb: Add a subtool for the DCB ETS object
Quoted 49 lines · Stephen Hemminger
Quoted 9 lines · On Thu, 22 Oct 2020 01:48:58 +0200 Petr Machata <[email protected]> wrote:
Quoted 7 lines · Stephen Hemminger
Quoted 4 lines · On Tue, 20 Oct 2020 22:43:37 +0200 Petr Machata <[email protected]> wrote:
Quoted 2 lines · Jakub Kicinski
Quoted 1 line · On Tue, 20 Oct 2020 02:58:23 +0200 Petr Machata wrote:
+static void dcb_ets_print_cbs(FILE *fp, const struct
ieee_ets*ets)
Quoted 2 lines
Quoted 2 lines
Quoted 2 lines
Quoted 2 lines
Review
Quoted 2 lines
(quoted diff) +2
-0+{ + print_string(PRINT_ANY, "cbs", "cbs %s ", ets->cbs ? "on" :"off");
Quoted 3 lines
Quoted 3 lines
Quoted 3 lines
Quoted 3 lines
Quoted 1 line
+}
I'd personally lean in the direction ethtool is taking and try
to limit
Quoted 1 line
Quoted 1 line
Quoted 1 line
Quoted 1 line
string values in json output as much as possible. This would be
a good
Quoted 3 lines
Quoted 3 lines
Quoted 3 lines
Quoted 1 line
fit for bool.
Yep, makes sense. The value is not user-toggleable, so the on /
off
Quoted 3 lines
Quoted 3 lines
Quoted 3 lines
there is just arbitrary.
I'll consider it for "willing" as well. That one is
user-toggleable, and
Quoted 1 line
Quoted 1 line
Quoted 1 line
the "on" / "off" makes sense for consistency with the command
line. But
Quoted 3 lines
Quoted 3 lines
Quoted 1 line
that doesn't mean it can't be a boolean in JSON.
There are three ways of representing a boolean. You chose the
worst.
Quoted 9 lines
Quoted 7 lines
Option 1: is to use a json null value to indicate presence.
this works well for a flag.
Option 2: is to use json bool.
this looks awkward in non-json output
Option 3: is to use a string
but this makes the string output something harder to consume in json.What seems to be used commonly for these on/off toggles is the
following
Quoted 3 lines
pattern:
print_string(PRINT_FP, NULL, "willing %s ", ets->willing ? "on" :
Quoted 8 lines
"off");
Quoted 3 lines
print_bool(PRINT_JSON, "willing", NULL, true);That way the JSON output is easy to query and the FP output is
obvious
Quoted 1 line
and compatible with the command line. Does that work for you?
Yes, that is hybrid, maybe it should be a helper function?
Yep, I'll do the same dance as for the other helpers in the patch set. Currently this is cut and pasted all over the place.