]> git.ipfire.org Git - thirdparty/iproute2.git/commitdiff
ip: cleanup help message text
authorStephen Hemminger <stephen@networkplumber.org>
Thu, 18 Mar 2021 00:14:13 +0000 (17:14 -0700)
committerStephen Hemminger <stephen@networkplumber.org>
Thu, 18 Mar 2021 18:24:06 +0000 (11:24 -0700)
Wrap help message text at 80 characters, and put list of things
in alpha order.

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
ip/ip.c
ip/ip_common.h
ip/ipaddress.c
ip/ipila.c
ip/iplink.c
ip/ipmonitor.c
ip/ipneigh.c
ip/iprule.c
ip/iptunnel.c

diff --git a/ip/ip.c b/ip/ip.c
index 40d2998ae60bab32ef6ef7bf708e735cf51dd772..c561c01f6810bb5f88e69c37e4219d4e1aade170 100644 (file)
--- a/ip/ip.c
+++ b/ip/ip.c
@@ -64,10 +64,11 @@ static void usage(void)
        fprintf(stderr,
                "Usage: ip [ OPTIONS ] OBJECT { COMMAND | help }\n"
                "       ip [ -force ] -batch filename\n"
-               "where  OBJECT := { link | address | addrlabel | route | rule | neigh | ntable |\n"
-               "                   tunnel | tuntap | maddress | mroute | mrule | monitor | xfrm |\n"
-               "                   netns | l2tp | fou | macsec | tcp_metrics | token | netconf | ila |\n"
-               "                   vrf | sr | nexthop | mptcp }\n"
+               "where  OBJECT := { address | addrlabel | fou | help | ila | l2tp | link |\n"
+               "                   macsec | maddress | monitor | mptcp | mroute | mrule |\n"
+               "                   neighbor | neighbour | netconf | netns | nexthop | ntable |\n"
+               "                   ntbl | route | rule | sr | tap | tcpmetrics |\n"
+               "                   token | tunnel | tuntap | vrf | xfrm }\n"
                "       OPTIONS := { -V[ersion] | -s[tatistics] | -d[etails] | -r[esolve] |\n"
                "                    -h[uman-readable] | -iec | -j[son] | -p[retty] |\n"
                "                    -f[amily] { inet | inet6 | mpls | bridge | link } |\n"
index 9a31e837563f3e1ff18b2d249ac61b8f69f67360..1fd2ed3a21bf561a94a2f84436813e535a24ebc1 100644 (file)
@@ -39,6 +39,7 @@ int print_neigh(struct nlmsghdr *n, void *arg);
 int ipaddr_list_link(int argc, char **argv);
 void ipaddr_get_vf_rate(int, int *, int *, const char *);
 void iplink_usage(void) __attribute__((noreturn));
+void iplink_types_usage(void);
 
 void iproute_reset_filter(int ifindex);
 void ipmroute_reset_filter(int ifindex);
index 0bbcee2b3bb2f7ffce9e5f165acb5a76b8672318..cfb24f5c1e341f3d35cf511be39c2ab14d9f1e5f 100644 (file)
@@ -73,12 +73,8 @@ static void usage(void)
                "CONFFLAG-LIST := [ CONFFLAG-LIST ] CONFFLAG\n"
                "CONFFLAG  := [ home | nodad | mngtmpaddr | noprefixroute | autojoin ]\n"
                "LIFETIME := [ valid_lft LFT ] [ preferred_lft LFT ]\n"
-               "LFT := forever | SECONDS\n"
-               "TYPE := { vlan | veth | vcan | vxcan | dummy | ifb | macvlan | macvtap |\n"
-               "          bridge | bond | ipoib | ip6tnl | ipip | sit | vxlan | lowpan |\n"
-               "          gre | gretap | erspan | ip6gre | ip6gretap | ip6erspan | vti |\n"
-               "          nlmon | can | bond_slave | ipvlan | geneve | bridge_slave |\n"
-               "          hsr | macsec | netdevsim }\n");
+               "LFT := forever | SECONDS\n");
+       iplink_types_usage();
 
        exit(-1);
 }
index 739ee4e1aaed07b97c356d592cc33a25d73e3761..475c35b5c4b09549288d2eab0edbf08a307d2cb6 100644 (file)
@@ -31,7 +31,8 @@ static void usage(void)
                "Usage: ip ila add loc_match LOCATOR_MATCH loc LOCATOR [ dev DEV ] OPTIONS\n"
                "       ip ila del loc_match LOCATOR_MATCH [ loc LOCATOR ] [ dev DEV ]\n"
                "       ip ila list\n"
-               "OPTIONS := [ csum-mode { adj-transport | neutral-map | neutral-map-auto | no-action } ]\n"
+               "OPTIONS := [ csum-mode { adj-transport | neutral-map |\n"
+               "                         neutral-map-auto | no-action } ]\n"
                "           [ ident-type { luid | use-format } ]\n");
 
        exit(-1);
index 27c9be442a7ab9369ceadb88b1323b7fd8a73dbe..faafd7e89d6c1cf4350bfcd4e23186afe2d268f5 100644 (file)
 static void usage(void) __attribute__((noreturn));
 static int iplink_have_newlink(void);
 
+void iplink_types_usage(void)
+{
+       /* Remember to add new entry here if new type is added. */
+       fprintf(stderr,
+               "TYPE := { bareudp | bond | bond_slave | bridge | bridge_slave |\n"
+               "          dummy | erspan | geneve | gre | gretap | ifb |\n"
+               "          ip6erspan | ip6gre | ip6gretap | ip6tnl |\n"
+               "          ipip | ipoib | ipvlan | ipvtap |\n"
+               "          macsec | macvlan | macvtap |\n"
+               "          netdevsim | nlmon | rmnet | sit | team | team_slave |\n"
+               "          vcan | veth | vlan | vrf | vti | vxcan | vxlan | xfrm }\n");
+}
+
 void iplink_usage(void)
 {
        if (iplink_have_newlink()) {
@@ -117,13 +130,8 @@ void iplink_usage(void)
                fprintf(stderr,
                        "\n"
                        "       ip link help [ TYPE ]\n"
-                       "\n"
-                       "TYPE := { vlan | veth | vcan | vxcan | dummy | ifb | macvlan | macvtap |\n"
-                       "          bridge | bond | team | ipoib | ip6tnl | ipip | sit | vxlan |\n"
-                       "          gre | gretap | erspan | ip6gre | ip6gretap | ip6erspan |\n"
-                       "          vti | nlmon | team_slave | bond_slave | bridge_slave |\n"
-                       "          ipvlan | ipvtap | geneve | bareudp | vrf | macsec | netdevsim | rmnet |\n"
-                       "          xfrm }\n");
+                       "\n");
+               iplink_types_usage();
        }
        exit(-1);
 }
index 99f5fda8ba1f685330247662f2685bfb34b6598f..50aa013ee0bc5610dfb63d0f9974efb9e79dc16a 100644 (file)
@@ -30,9 +30,10 @@ int listen_all_nsid;
 static void usage(void)
 {
        fprintf(stderr,
-               "Usage: ip monitor [ all | LISTofOBJECTS ] [ FILE ] [ label ] [all-nsid] [dev DEVICE]\n"
-               "LISTofOBJECTS := link | address | route | mroute | prefix |\n"
-               "                neigh | netconf | rule | nsid | nexthop\n"
+               "Usage: ip monitor [ all | OBJECTS ] [ FILE ] [ label ] [ all-nsid ]\n"
+               "                  [ dev DEVICE ]\n"
+               "OBJECTS :=  address | link | mroute | neigh | netconf |\n"
+               "            nexthop | nsid | prefix | route | rule\n"
                "FILE := file FILENAME\n");
        exit(-1);
 }
index 678b40341539fd81bdc7368e765d01be8668fea3..2d6b7f5873e167dbc8308fc84b6679c310c617dd 100644 (file)
@@ -50,15 +50,15 @@ static void usage(void)
 {
        fprintf(stderr,
                "Usage: ip neigh { add | del | change | replace }\n"
-               "               { ADDR [ lladdr LLADDR ] [ nud STATE ] | proxy ADDR } [ dev DEV ]\n"
-               "               [ router ] [ extern_learn ] [ protocol PROTO ]\n"
+               "               { ADDR [ lladdr LLADDR ] [ nud STATE ] proxy ADDR }\n"
+               "               [ dev DEV ] [ router ] [ extern_learn ] [ protocol PROTO ]\n"
                "\n"
                "       ip neigh { show | flush } [ proxy ] [ to PREFIX ] [ dev DEV ] [ nud STATE ]\n"
                "                                 [ vrf NAME ]\n"
                "       ip neigh get { ADDR | proxy ADDR } dev DEV\n"
                "\n"
-               "STATE := { permanent | noarp | stale | reachable | none |\n"
-               "           incomplete | delay | probe | failed }\n");
+               "STATE := { delay | failed | incomplete | noarp | none |\n"
+               "           permanent | probe | reachable | stale }\n");
        exit(-1);
 }
 
index 9f5d998b788d4ca766abf613b1e460f53d1e6d69..4166073c0ddd129ebd3be1c95b21d83a0c6a2719 100644 (file)
@@ -44,7 +44,8 @@ static void usage(void)
                "Usage: ip rule { add | del } SELECTOR ACTION\n"
                "       ip rule { flush | save | restore }\n"
                "       ip rule [ list [ SELECTOR ]]\n"
-               "SELECTOR := [ not ] [ from PREFIX ] [ to PREFIX ] [ tos TOS ] [ fwmark FWMARK[/MASK] ]\n"
+               "SELECTOR := [ not ] [ from PREFIX ] [ to PREFIX ] [ tos TOS ]\n"
+               "            [ fwmark FWMARK[/MASK] ]\n"
                "            [ iif STRING ] [ oif STRING ] [ pref NUMBER ] [ l3mdev ]\n"
                "            [ uidrange NUMBER-NUMBER ]\n"
                "            [ ipproto PROTOCOL ]\n"
index 696f3b92bff55d691162e3222f16ef8695714df2..2369ee062ced36479beeaa403c402bf32662a5b3 100644 (file)
@@ -34,7 +34,8 @@ static void usage(void)
 {
        fprintf(stderr,
                "Usage: ip tunnel { add | change | del | show | prl | 6rd } [ NAME ]\n"
-               "        [ mode { ipip | gre | sit | isatap | vti } ] [ remote ADDR ] [ local ADDR ]\n"
+               "        [ mode { gre | ipip | isatap | sit | vti } ]\n"
+               "        [ remote ADDR ] [ local ADDR ]\n"
                "        [ [i|o]seq ] [ [i|o]key KEY ] [ [i|o]csum ]\n"
                "        [ prl-default ADDR ] [ prl-nodefault ADDR ] [ prl-delete ADDR ]\n"
                "        [ 6rd-prefix ADDR ] [ 6rd-relay_prefix ADDR ] [ 6rd-reset ]\n"