ofproto: Mark NXT_ACT_SET_CONFIG and NXT_ACT_GET_CONFIG obsolete.
[openvswitch] / utilities / ovs-vsctl.c
index b86d755445df9673d7debd9af8be0eeead4a8374..733536894a73295645be10cc4bc085c01b736a3e 100644 (file)
@@ -36,6 +36,7 @@
 #include "ovsdb-data.h"
 #include "ovsdb-idl.h"
 #include "poll-loop.h"
+#include "process.h"
 #include "svec.h"
 #include "vswitchd/vswitch-idl.h"
 #include "timeval.h"
 #include "vlog.h"
 #define THIS_MODULE VLM_vsctl
 
+struct vsctl_context;
+
+typedef void vsctl_handler_func(struct vsctl_context *);
+
+struct vsctl_command_syntax {
+    const char *name;
+    int min_args;
+    int max_args;
+    vsctl_handler_func *run;
+    vsctl_handler_func *postprocess;
+    const char *options;
+};
+
+struct vsctl_command {
+    /* Data that remains constant after initialization. */
+    const struct vsctl_command_syntax *syntax;
+    int argc;
+    char **argv;
+    struct shash options;
+
+    /* Data modified by commands. */
+    struct ds output;
+};
+
 /* --db: The database server to contact. */
 static const char *db;
 
@@ -59,23 +84,30 @@ static bool wait_for_reload = true;
 /* --timeout: Time to wait for a connection to 'db'. */
 static int timeout = 5;
 
+/* All supported commands. */
+static const struct vsctl_command_syntax all_commands[];
+
 static void vsctl_fatal(const char *, ...) PRINTF_FORMAT(1, 2) NO_RETURN;
 static char *default_db(void);
 static void usage(void) NO_RETURN;
 static void parse_options(int argc, char *argv[]);
 
-static void check_vsctl_command(int argc, char *argv[]);
-static void do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl);
+static struct vsctl_command *parse_commands(int argc, char *argv[],
+                                            size_t *n_commandsp);
+static void parse_command(int argc, char *argv[], struct vsctl_command *);
+static void do_vsctl(const char *args,
+                     struct vsctl_command *, size_t n_commands,
+                     struct ovsdb_idl *);
 
 int
 main(int argc, char *argv[])
 {
     struct ovsdb_idl *idl;
     unsigned int seqno;
-    struct ds args;
-    int start, n_commands;
+    struct vsctl_command *commands;
+    size_t n_commands;
+    char *args;
     int trials;
-    int i;
 
     set_program_name(argv[0]);
     signal(SIGPIPE, SIG_IGN);
@@ -83,34 +115,20 @@ main(int argc, char *argv[])
     vlog_init();
     vlog_set_levels(VLM_ANY_MODULE, VLF_CONSOLE, VLL_WARN);
     vlog_set_levels(VLM_reconnect, VLF_ANY_FACILITY, VLL_WARN);
+
+    /* Log our arguments.  This is often valuable for debugging systems. */
+    args = process_escape_args(argv);
+    VLOG_INFO("Called as %s", args);
+
+    /* Parse command line. */
     parse_options(argc, argv);
+    commands = parse_commands(argc - optind, argv + optind, &n_commands);
 
     if (timeout) {
         time_alarm(timeout);
     }
 
-    /* Log our arguments.  This is often valuable for debugging systems. */
-    ds_init(&args);
-    for (i = 1; i < argc; i++) {
-        ds_put_format(&args, " %s", argv[i]);
-    }
-    VLOG_INFO("Called as%s", ds_cstr(&args));
-    ds_destroy(&args);
-
     /* Do basic command syntax checking. */
-    n_commands = 0;
-    for (start = i = optind; i <= argc; i++) {
-        if (i == argc || !strcmp(argv[i], "--")) {
-            if (i > start) {
-                check_vsctl_command(i - start, &argv[start]);
-                n_commands++;
-            }
-            start = i + 1;
-        }
-    }
-    if (!n_commands) {
-        vsctl_fatal("missing command name (use --help for help)");
-    }
 
     /* Now execute the commands. */
     idl = ovsdb_idl_create(db, &ovsrec_idl_class);
@@ -125,7 +143,7 @@ main(int argc, char *argv[])
             if (++trials > 5) {
                 vsctl_fatal("too many database inconsistency failures");
             }
-            do_vsctl(argc - optind, argv + optind, idl);
+            do_vsctl(args, commands, n_commands, idl);
             seqno = new_seqno;
         }
 
@@ -134,21 +152,6 @@ main(int argc, char *argv[])
     }
 }
 
-static void
-vsctl_fatal(const char *format, ...)
-{
-    char *message;
-    va_list args;
-
-    va_start(args, format);
-    message = xvasprintf(format, args);
-    va_end(args);
-
-    vlog_set_levels(VLM_vsctl, VLF_CONSOLE, VLL_EMER);
-    VLOG_ERR("%s", message);
-    ovs_fatal(0, "%s", message);
-}
-
 static void
 parse_options(int argc, char *argv[])
 {
@@ -233,6 +236,108 @@ parse_options(int argc, char *argv[])
     }
 }
 
+static struct vsctl_command *
+parse_commands(int argc, char *argv[], size_t *n_commandsp)
+{
+    struct vsctl_command *commands;
+    size_t n_commands, allocated_commands;
+    int i, start;
+
+    commands = NULL;
+    n_commands = allocated_commands = 0;
+
+    for (start = i = 0; i <= argc; i++) {
+        if (i == argc || !strcmp(argv[i], "--")) {
+            if (i > start) {
+                if (n_commands >= allocated_commands) {
+                    struct vsctl_command *c;
+
+                    commands = x2nrealloc(commands, &allocated_commands,
+                                          sizeof *commands);
+                    for (c = commands; c < &commands[n_commands]; c++) {
+                        shash_moved(&c->options);
+                    }
+                }
+                parse_command(i - start, &argv[start],
+                              &commands[n_commands++]);
+            }
+            start = i + 1;
+        }
+    }
+    if (!n_commands) {
+        vsctl_fatal("missing command name (use --help for help)");
+    }
+    *n_commandsp = n_commands;
+    return commands;
+}
+
+static void
+parse_command(int argc, char *argv[], struct vsctl_command *command)
+{
+    const struct vsctl_command_syntax *p;
+    int i;
+
+    shash_init(&command->options);
+    for (i = 0; i < argc; i++) {
+        if (argv[i][0] != '-') {
+            break;
+        }
+        if (!shash_add_once(&command->options, argv[i], NULL)) {
+            vsctl_fatal("'%s' option specified multiple times", argv[i]);
+        }
+    }
+    if (i == argc) {
+        vsctl_fatal("missing command name");
+    }
+
+    for (p = all_commands; p->name; p++) {
+        if (!strcmp(p->name, argv[i])) {
+            struct shash_node *node;
+            int n_arg;
+
+            SHASH_FOR_EACH (node, &command->options) {
+                const char *s = strstr(p->options, node->name);
+                int end = s ? s[strlen(node->name)] : EOF;
+                if (end != ',' && end != ' ' && end != '\0') {
+                    vsctl_fatal("'%s' command has no '%s' option",
+                                argv[i], node->name);
+                }
+            }
+
+            n_arg = argc - i - 1;
+            if (n_arg < p->min_args) {
+                vsctl_fatal("'%s' command requires at least %d arguments",
+                            p->name, p->min_args);
+            } else if (n_arg > p->max_args) {
+                vsctl_fatal("'%s' command takes at most %d arguments",
+                            p->name, p->max_args);
+            } else {
+                command->syntax = p;
+                command->argc = n_arg + 1;
+                command->argv = &argv[i];
+                return;
+            }
+        }
+    }
+
+    vsctl_fatal("unknown command '%s'; use --help for help", argv[i]);
+}
+
+static void
+vsctl_fatal(const char *format, ...)
+{
+    char *message;
+    va_list args;
+
+    va_start(args, format);
+    message = xvasprintf(format, args);
+    va_end(args);
+
+    vlog_set_levels(VLM_vsctl, VLF_CONSOLE, VLL_EMER);
+    VLOG_ERR("%s", message);
+    ovs_fatal(0, "%s", message);
+}
+
 static void
 usage(void)
 {
@@ -259,19 +364,11 @@ Port commands:\n\
   add-bond BRIDGE PORT IFACE...  add bonded port PORT in BRIDGE from IFACES\n\
   del-port [BRIDGE] PORT      delete PORT (which may be bonded) from BRIDGE\n\
   port-to-br PORT             print name of bridge that contains PORT\n\
-  port-set-external-id PORT KEY VALUE  set KEY on PORT to VALUE\n\
-  port-set-external-id PORT KEY  unset KEY on PORT\n\
-  port-get-external-id PORT KEY  print value of KEY on PORT\n\
-  port-get-external-id PORT  list key-value pairs on PORT\n\
 A bond is considered to be a single port.\n\
 \n\
 Interface commands (a bond consists of multiple interfaces):\n\
   list-ifaces BRIDGE          print the names of all interfaces on BRIDGE\n\
   iface-to-br IFACE           print name of bridge that contains IFACE\n\
-  iface-set-external-id IFACE KEY VALUE  set KEY on IFACE to VALUE\n\
-  iface-set-external-id IFACE KEY  unset KEY on IFACE\n\
-  iface-get-external-id IFACE KEY  print value of KEY on IFACE\n\
-  iface-get-external-id IFACE list key-value pairs on IFACE\n\
 \n\
 Controller commands:\n\
   get-controller [BRIDGE]     print the controller for BRIDGE\n\
@@ -321,12 +418,16 @@ default_db(void)
 }
 \f
 struct vsctl_context {
+    /* Read-only. */
     int argc;
     char **argv;
+    struct shash options;
+
+    /* Modifiable state. */
+    struct ds output;
     struct ovsdb_idl *idl;
+    struct ovsdb_idl_txn *txn;
     const struct ovsrec_open_vswitch *ovs;
-    struct ds output;
-    struct shash options;
 };
 
 struct vsctl_bridge {
@@ -354,12 +455,6 @@ struct vsctl_info {
     struct ovsrec_controller *ctrl;
 };
 
-static struct ovsdb_idl_txn *
-txn_from_openvswitch(const struct ovsrec_open_vswitch *ovs)
-{
-    return ovsdb_idl_txn_get(&ovs->header_);
-}
-
 static struct vsctl_bridge *
 add_bridge(struct vsctl_info *b,
            struct ovsrec_bridge *br_cfg, const char *name,
@@ -687,14 +782,14 @@ cmd_add_br(struct vsctl_context *ctx)
         struct ovsrec_port *port;
         struct ovsrec_interface *iface;
 
-        iface = ovsrec_interface_insert(txn_from_openvswitch(ctx->ovs));
+        iface = ovsrec_interface_insert(ctx->txn);
         ovsrec_interface_set_name(iface, br_name);
 
-        port = ovsrec_port_insert(txn_from_openvswitch(ctx->ovs));
+        port = ovsrec_port_insert(ctx->txn);
         ovsrec_port_set_name(port, br_name);
         ovsrec_port_set_interfaces(port, &iface, 1);
 
-        br = ovsrec_bridge_insert(txn_from_openvswitch(ctx->ovs));
+        br = ovsrec_bridge_insert(ctx->txn);
         ovsrec_bridge_set_name(br, br_name);
         ovsrec_bridge_set_ports(br, &port, 1);
 
@@ -724,11 +819,11 @@ cmd_add_br(struct vsctl_context *ctx)
         }
         br = parent->br_cfg;
 
-        iface = ovsrec_interface_insert(txn_from_openvswitch(ctx->ovs));
+        iface = ovsrec_interface_insert(ctx->txn);
         ovsrec_interface_set_name(iface, br_name);
         ovsrec_interface_set_type(iface, "internal");
 
-        port = ovsrec_port_insert(txn_from_openvswitch(ctx->ovs));
+        port = ovsrec_port_insert(ctx->txn);
         ovsrec_port_set_name(port, br_name);
         ovsrec_port_set_interfaces(port, &iface, 1);
         ovsrec_port_set_fake_bridge(port, true);
@@ -978,7 +1073,7 @@ cmd_list_ports(struct vsctl_context *ctx)
 }
 
 static void
-add_port(const struct ovsrec_open_vswitch *ovs,
+add_port(struct vsctl_context *ctx,
          const char *br_name, const char *port_name, bool fake_iface,
          char *iface_names[], int n_ifaces)
 {
@@ -988,7 +1083,7 @@ add_port(const struct ovsrec_open_vswitch *ovs,
     struct ovsrec_port *port;
     size_t i;
 
-    get_info(ovs, &info);
+    get_info(ctx->ovs, &info);
     check_conflicts(&info, port_name,
                     xasprintf("cannot create a port named %s", port_name));
     /* XXX need to check for conflicts on interfaces too */
@@ -996,11 +1091,11 @@ add_port(const struct ovsrec_open_vswitch *ovs,
 
     ifaces = xmalloc(n_ifaces * sizeof *ifaces);
     for (i = 0; i < n_ifaces; i++) {
-        ifaces[i] = ovsrec_interface_insert(txn_from_openvswitch(ovs));
+        ifaces[i] = ovsrec_interface_insert(ctx->txn);
         ovsrec_interface_set_name(ifaces[i], iface_names[i]);
     }
 
-    port = ovsrec_port_insert(txn_from_openvswitch(ovs));
+    port = ovsrec_port_insert(ctx->txn);
     ovsrec_port_set_name(port, port_name);
     ovsrec_port_set_interfaces(port, ifaces, n_ifaces);
     ovsrec_port_set_bond_fake_iface(port, fake_iface);
@@ -1020,7 +1115,7 @@ add_port(const struct ovsrec_open_vswitch *ovs,
 static void
 cmd_add_port(struct vsctl_context *ctx)
 {
-    add_port(ctx->ovs, ctx->argv[1], ctx->argv[2], false, &ctx->argv[2], 1);
+    add_port(ctx, ctx->argv[1], ctx->argv[2], false, &ctx->argv[2], 1);
 }
 
 static void
@@ -1028,7 +1123,7 @@ cmd_add_bond(struct vsctl_context *ctx)
 {
     bool fake_iface = shash_find(&ctx->options, "--fake-iface");
 
-    add_port(ctx->ovs, ctx->argv[1], ctx->argv[2], fake_iface,
+    add_port(ctx, ctx->argv[1], ctx->argv[2], fake_iface,
              &ctx->argv[3], ctx->argc - 3);
 }
 
@@ -1076,43 +1171,6 @@ cmd_port_to_br(struct vsctl_context *ctx)
     free_info(&info);
 }
 
-static void
-cmd_port_set_external_id(struct vsctl_context *ctx)
-{
-    struct vsctl_info info;
-    struct vsctl_port *port;
-    char **keys, **values;
-    size_t n;
-
-    get_info(ctx->ovs, &info);
-    port = find_port(&info, ctx->argv[1], true);
-    set_external_id(port->port_cfg->key_external_ids,
-                    port->port_cfg->value_external_ids,
-                    port->port_cfg->n_external_ids,
-                    ctx->argv[2], ctx->argc >= 4 ? ctx->argv[3] : NULL,
-                    &keys, &values, &n);
-    ovsrec_port_set_external_ids(port->port_cfg, keys, values, n);
-    free(keys);
-    free(values);
-
-    free_info(&info);
-}
-
-static void
-cmd_port_get_external_id(struct vsctl_context *ctx)
-{
-    struct vsctl_info info;
-    struct vsctl_port *port;
-
-    get_info(ctx->ovs, &info);
-    port = find_port(&info, ctx->argv[1], true);
-    get_external_id(port->port_cfg->key_external_ids,
-                    port->port_cfg->value_external_ids,
-                    port->port_cfg->n_external_ids,
-                    "",  ctx->argc >= 3 ? ctx->argv[2] : NULL, &ctx->output);
-    free_info(&info);
-}
-
 static void
 cmd_br_to_vlan(struct vsctl_context *ctx)
 {
@@ -1178,43 +1236,6 @@ cmd_iface_to_br(struct vsctl_context *ctx)
     free_info(&info);
 }
 
-static void
-cmd_iface_set_external_id(struct vsctl_context *ctx)
-{
-    struct vsctl_info info;
-    struct vsctl_iface *iface;
-    char **keys, **values;
-    size_t n;
-
-    get_info(ctx->ovs, &info);
-    iface = find_iface(&info, ctx->argv[1], true);
-    set_external_id(iface->iface_cfg->key_external_ids,
-                    iface->iface_cfg->value_external_ids,
-                    iface->iface_cfg->n_external_ids,
-                    ctx->argv[2], ctx->argc >= 4 ? ctx->argv[3] : NULL,
-                    &keys, &values, &n);
-    ovsrec_interface_set_external_ids(iface->iface_cfg, keys, values, n);
-    free(keys);
-    free(values);
-
-    free_info(&info);
-}
-
-static void
-cmd_iface_get_external_id(struct vsctl_context *ctx)
-{
-    struct vsctl_info info;
-    struct vsctl_iface *iface;
-
-    get_info(ctx->ovs, &info);
-    iface = find_iface(&info, ctx->argv[1], true);
-    get_external_id(iface->iface_cfg->key_external_ids,
-                    iface->iface_cfg->value_external_ids,
-                    iface->iface_cfg->n_external_ids,
-                    "",  ctx->argc >= 3 ? ctx->argv[2] : NULL, &ctx->output);
-    free_info(&info);
-}
-
 static void
 cmd_get_controller(struct vsctl_context *ctx)
 {
@@ -1280,7 +1301,7 @@ cmd_set_controller(struct vsctl_context *ctx)
         if (info.ctrl) {
             ovsrec_controller_delete(info.ctrl);
         }
-        ctrl = ovsrec_controller_insert(txn_from_openvswitch(ctx->ovs));
+        ctrl = ovsrec_controller_insert(ctx->txn);
         ovsrec_controller_set_target(ctrl, ctx->argv[1]);
         ovsrec_open_vswitch_set_controller(ctx->ovs, ctrl);
     } else {
@@ -1290,7 +1311,7 @@ cmd_set_controller(struct vsctl_context *ctx)
         if (br->ctrl) {
             ovsrec_controller_delete(br->ctrl);
         }
-        ctrl = ovsrec_controller_insert(txn_from_openvswitch(ctx->ovs));
+        ctrl = ovsrec_controller_insert(ctx->txn);
         ovsrec_controller_set_target(ctrl, ctx->argv[2]);
         ovsrec_bridge_set_controller(br->br_cfg, ctrl);
     }
@@ -1420,7 +1441,7 @@ cmd_set_ssl(struct vsctl_context *ctx)
     if (ssl) {
         ovsrec_ssl_delete(ssl);
     }
-    ssl = ovsrec_ssl_insert(txn_from_openvswitch(ctx->ovs));
+    ssl = ovsrec_ssl_insert(ctx->txn);
 
     ovsrec_ssl_set_private_key(ssl, ctx->argv[1]);
     ovsrec_ssl_set_certificate(ssl, ctx->argv[2]);
@@ -1475,14 +1496,15 @@ struct vsctl_column {
 };
 
 static const struct vsctl_column bridge_columns[] = {
+    {&ovsrec_bridge_col_controller, VSCF_READONLY, NULL},
     {&ovsrec_bridge_col_datapath_id, VSCF_READONLY, NULL},
-    {&ovsrec_bridge_col_name, VSCF_READONLY, NULL},
-    {&ovsrec_bridge_col_mirrors, VSCF_READONLY, NULL},
-    {&ovsrec_bridge_col_other_config, 0, NULL},
+    {&ovsrec_bridge_col_datapath_type, VSCF_READONLY, NULL},
+    {&ovsrec_bridge_col_external_ids, 0, NULL},
     {&ovsrec_bridge_col_flood_vlans, 0, "[1,4095]"},
-    {&ovsrec_bridge_col_controller, VSCF_READONLY, NULL},
+    {&ovsrec_bridge_col_mirrors, VSCF_READONLY, NULL},
+    {&ovsrec_bridge_col_name, VSCF_READONLY, NULL},
     {&ovsrec_bridge_col_netflow, VSCF_READONLY, NULL},
-    {&ovsrec_bridge_col_external_ids, 0, NULL},
+    {&ovsrec_bridge_col_other_config, 0, NULL},
     {&ovsrec_bridge_col_ports, VSCF_READONLY, NULL},
     {NULL, 0, NULL},
 };
@@ -1528,9 +1550,9 @@ static const struct vsctl_column mirror_columns[] = {
 static const struct vsctl_column netflow_columns[] = {
     {&ovsrec_netflow_col_active_timeout, 0, "[-1,]"},
     {&ovsrec_netflow_col_add_id_to_interface, 0, NULL},
-    {&ovsrec_netflow_col_targets, 0, IP_RE":"PORT_RE},
-    {&ovsrec_netflow_col_engine_type, 0, "[0,255]"},
     {&ovsrec_netflow_col_engine_id, 0, "[0,255]"},
+    {&ovsrec_netflow_col_engine_type, 0, "[0,255]"},
+    {&ovsrec_netflow_col_targets, 0, IP_RE":"PORT_RE},
     {NULL, 0, NULL},
 };
 
@@ -1538,7 +1560,6 @@ static const struct vsctl_column open_vswitch_columns[] = {
     {&ovsrec_open_vswitch_col_bridges, VSCF_READONLY, NULL},
     {&ovsrec_open_vswitch_col_controller, VSCF_READONLY, NULL},
     {&ovsrec_open_vswitch_col_cur_cfg, VSCF_HIDDEN, NULL},
-    {&ovsrec_open_vswitch_col_management_id, 0, "[0-9a-fA-F]{12}"},
     {&ovsrec_open_vswitch_col_managers, 0, "p?(ssl|tcp|unix):.*"},
     {&ovsrec_open_vswitch_col_next_cfg, VSCF_HIDDEN, NULL},
     {&ovsrec_open_vswitch_col_ssl, VSCF_READONLY, NULL},
@@ -1546,9 +1567,9 @@ static const struct vsctl_column open_vswitch_columns[] = {
 };
 
 static const struct vsctl_column port_columns[] = {
-    {&ovsrec_port_col_bond_updelay, 0, "[0,]"},
     {&ovsrec_port_col_bond_downdelay, 0, "[0,]"},
     {&ovsrec_port_col_bond_fake_iface, VSCF_READONLY, NULL},
+    {&ovsrec_port_col_bond_updelay, 0, "[0,]"},
     {&ovsrec_port_col_external_ids, 0, NULL},
     {&ovsrec_port_col_fake_bridge, VSCF_READONLY, NULL},
     {&ovsrec_port_col_interfaces, VSCF_READONLY, NULL},
@@ -1724,6 +1745,10 @@ get_row_by_id(struct vsctl_context *ctx, const struct vsctl_table_class *table,
             }
             ovsdb_datum_destroy(&name, &id->name_column->type);
         }
+        if (best_score && !referrer) {
+            ovs_fatal(0, "multiple rows in %s match \"%s\"",
+                      table->class->name, record_id);
+        }
     }
     if (!referrer) {
         return NULL;
@@ -1880,8 +1905,8 @@ parse_column_key_value(const char *arg, const struct vsctl_table_class *table,
             *valuep = NULL;
         }
         if (*p != '\0') {
-            error = xasprintf("%s: trailing garbage in argument at offset %td",
-                              arg, p - arg);
+            error = xasprintf("%s: trailing garbage \"%s\" in argument",
+                              arg, p);
             goto error;
         }
     }
@@ -1905,6 +1930,7 @@ error:
 static void
 cmd_get(struct vsctl_context *ctx)
 {
+    bool if_exists = shash_find(&ctx->options, "--if-exists");
     const char *table_name = ctx->argv[1];
     const char *record_id = ctx->argv[2];
     const struct vsctl_table_class *table;
@@ -1939,14 +1965,15 @@ cmd_get(struct vsctl_context *ctx)
             idx = ovsdb_datum_find_key(&datum, &key,
                                        column->idl->type.key_type);
             if (idx == UINT_MAX) {
-                ovs_fatal(0, "no key %s in %s record \"%s\" column %s",
-                          key_string, table_name, record_id,
-                          column->idl->name);
-
+                if (!if_exists) {
+                    ovs_fatal(0, "no key \"%s\" in %s record \"%s\" column %s",
+                              key_string, table->class->name, record_id,
+                              column->idl->name);
+                }
+            } else {
+                ovsdb_atom_to_string(&datum.values[idx],
+                                     column->idl->type.value_type, out);
             }
-            ovsdb_atom_to_string(&datum.values[idx],
-                                 column->idl->type.value_type, out);
-
             ovsdb_atom_destroy(&key, column->idl->type.key_type);
         } else {
             ovsdb_datum_to_string(&datum, &column->idl->type, out);
@@ -2192,17 +2219,17 @@ cmd_add(struct vsctl_context *ctx)
     table = get_table(table_name);
     row = must_get_row(ctx, table, record_id);
     die_if_error(get_column(table, column_name, &column));
+    if (column->flags & VSCF_READONLY && !force) {
+        ovs_fatal(0, "cannot modify read-only column %s in table %s",
+                   column->idl->name, table->class->name);
+    }
+
     type = &column->idl->type;
     ovsdb_idl_txn_read(row, column->idl, &old);
     for (i = 4; i < ctx->argc; i++) {
         struct ovsdb_type add_type;
         struct ovsdb_datum add;
 
-        if (column->flags & VSCF_READONLY && !force) {
-            ovs_fatal(0, "%s: cannot modify read-only column %s in table %s",
-                      ctx->argv[i], column->idl->name, table_name);
-        }
-
         add_type = *type;
         add_type.n_min = 1;
         add_type.n_max = UINT_MAX;
@@ -2212,10 +2239,10 @@ cmd_add(struct vsctl_context *ctx)
     }
     if (old.n > type->n_max) {
         ovs_fatal(0, "\"add\" operation would put %u %s in column %s of "
-                  "table %s but at most %u are allowed",
+                  "table %s but the maximum number is %u",
                   old.n,
                   type->value_type == OVSDB_TYPE_VOID ? "values" : "pairs",
-                  column->idl->name, table_name, type->n_max);
+                  column->idl->name, table->class->name, type->n_max);
     }
     ovsdb_idl_txn_write(row, column->idl, &old);
 }
@@ -2237,6 +2264,11 @@ cmd_remove(struct vsctl_context *ctx)
     table = get_table(table_name);
     row = must_get_row(ctx, table, record_id);
     die_if_error(get_column(table, column_name, &column));
+    if (column->flags & VSCF_READONLY && !force) {
+        ovs_fatal(0, "cannot modify read-only column %s in table %s",
+                   column->idl->name, table->class->name);
+    }
+
     type = &column->idl->type;
     ovsdb_idl_txn_read(row, column->idl, &old);
     for (i = 4; i < ctx->argc; i++) {
@@ -2244,11 +2276,6 @@ cmd_remove(struct vsctl_context *ctx)
         struct ovsdb_datum rm;
         char *error;
 
-        if (column->flags & VSCF_READONLY && !force) {
-            ovs_fatal(0, "%s: cannot modify read-only column %s in table %s",
-                      ctx->argv[i], column->idl->name, table_name);
-        }
-
         rm_type = *type;
         rm_type.n_min = 1;
         rm_type.n_max = UINT_MAX;
@@ -2263,10 +2290,10 @@ cmd_remove(struct vsctl_context *ctx)
     }
     if (old.n < type->n_min) {
         ovs_fatal(0, "\"remove\" operation would put %u %s in column %s of "
-                  "table %s but at least %u are required",
+                  "table %s but the minimun number is %u",
                   old.n,
                   type->value_type == OVSDB_TYPE_VOID ? "values" : "pairs",
-                  column->idl->name, table_name, type->n_min);
+                  column->idl->name, table->class->name, type->n_min);
     }
     ovsdb_idl_txn_write(row, column->idl, &old);
 }
@@ -2292,12 +2319,12 @@ cmd_clear(struct vsctl_context *ctx)
 
         type = &column->idl->type;
         if (column->flags & VSCF_READONLY && !force) {
-            ovs_fatal(0, "%s: cannot modify read-only column %s in table %s",
-                      ctx->argv[i], column->idl->name, table_name);
+            ovs_fatal(0, "cannot modify read-only column %s in table %s",
+                      column->idl->name, table->class->name);
         } else if (type->n_min > 0) {
             ovs_fatal(0, "\"clear\" operation cannot be applied to column %s "
                       "of table %s, which is not allowed to be empty",
-                      column->idl->name, table_name);
+                      column->idl->name, table->class->name);
         }
 
         ovsdb_datum_init_empty(&datum);
@@ -2319,10 +2346,35 @@ cmd_create(struct vsctl_context *ctx)
     }
 
     table = get_table(table_name);
-    row = ovsdb_idl_txn_insert(txn_from_openvswitch(ctx->ovs), table->class);
+    row = ovsdb_idl_txn_insert(ctx->txn, table->class);
     for (i = 2; i < ctx->argc; i++) {
         set_column(table, row, ctx->argv[i], force);
     }
+    ds_put_format(&ctx->output, UUID_FMT, UUID_ARGS(&row->uuid));
+}
+
+/* This function may be used as the 'postprocess' function for commands that
+ * insert new rows into the database.  It expects that the command's 'run'
+ * function prints the UUID reported by ovsdb_idl_txn_insert() as the command's
+ * sole output.  It replaces that output by the row's permanent UUID assigned
+ * by the database server and appends a new-line.
+ *
+ * Currently we use this only for "create", because the higher-level commands
+ * are supposed to be independent of the actual structure of the vswitch
+ * configuration. */
+static void
+post_create(struct vsctl_context *ctx)
+{
+    const struct uuid *real;
+    struct uuid dummy;
+
+    uuid_from_string(&dummy, ds_cstr(&ctx->output));
+    real = ovsdb_idl_txn_get_insert_uuid(ctx->txn, &dummy);
+    if (real) {
+        ds_clear(&ctx->output);
+        ds_put_format(&ctx->output, UUID_FMT, UUID_ARGS(real));
+    }
+    ds_put_char(&ctx->output, '\n');
 }
 
 static void
@@ -2339,7 +2391,7 @@ cmd_destroy(struct vsctl_context *ctx)
     }
 
     table = get_table(table_name);
-    for (i = 1; i < ctx->argc; i++) {
+    for (i = 2; i < ctx->argc; i++) {
         const struct ovsdb_idl_row *row;
 
         row = (must_exist ? must_get_row : get_row)(ctx, table, ctx->argv[i]);
@@ -2349,20 +2401,6 @@ cmd_destroy(struct vsctl_context *ctx)
     }
 }
 \f
-typedef void vsctl_handler_func(struct vsctl_context *);
-
-struct vsctl_command {
-    const char *name;
-    int min_args;
-    int max_args;
-    vsctl_handler_func *handler;
-    const char *options;
-};
-
-static void run_vsctl_command(int argc, char *argv[],
-                              const struct ovsrec_open_vswitch *,
-                              struct ovsdb_idl *, struct ds *output);
-
 static struct json *
 where_uuid_equals(const struct uuid *uuid)
 {
@@ -2378,28 +2416,46 @@ where_uuid_equals(const struct uuid *uuid)
 }
 
 static void
-do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
+vsctl_context_init(struct vsctl_context *ctx, struct vsctl_command *command,
+                   struct ovsdb_idl *idl, struct ovsdb_idl_txn *txn,
+                   const struct ovsrec_open_vswitch *ovs)
+{
+    ctx->argc = command->argc;
+    ctx->argv = command->argv;
+    ctx->options = command->options;
+
+    ds_swap(&ctx->output, &command->output);
+    ctx->idl = idl;
+    ctx->txn = txn;
+    ctx->ovs = ovs;
+
+}
+
+static void
+vsctl_context_done(struct vsctl_context *ctx, struct vsctl_command *command)
+{
+    ds_swap(&ctx->output, &command->output);
+}
+
+static void
+do_vsctl(const char *args, struct vsctl_command *commands, size_t n_commands,
+         struct ovsdb_idl *idl)
 {
     struct ovsdb_idl_txn *txn;
     const struct ovsrec_open_vswitch *ovs;
     enum ovsdb_idl_txn_status status;
-    struct ds comment, *output;
+    struct vsctl_command *c;
     int64_t next_cfg = 0;
-    int n_output;
-    int i, start;
+    char *comment;
 
     txn = ovsdb_idl_txn_create(idl);
     if (dry_run) {
         ovsdb_idl_txn_set_dry_run(txn);
     }
 
-    ds_init(&comment);
-    ds_put_cstr(&comment, "ovs-vsctl:");
-    for (i = 0; i < argc; i++) {
-        ds_put_format(&comment, " %s", argv[i]);
-    }
-    ovsdb_idl_txn_add_comment(txn, ds_cstr(&comment));
-    ds_destroy(&comment);
+    comment = xasprintf("ovs-vsctl: %s", args);
+    ovsdb_idl_txn_add_comment(txn, comment);
+    free(comment);
 
     ovs = ovsrec_open_vswitch_first(idl);
     if (!ovs) {
@@ -2413,17 +2469,13 @@ do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
         json_destroy(where);
     }
 
-    output = xmalloc(argc * sizeof *output);
-    n_output = 0;
-    for (start = i = 0; i <= argc; i++) {
-        if (i == argc || !strcmp(argv[i], "--")) {
-            if (i > start) {
-                ds_init(&output[n_output]);
-                run_vsctl_command(i - start, &argv[start], ovs, idl,
-                                  &output[n_output++]);
-            }
-            start = i + 1;
-        }
+    for (c = commands; c < &commands[n_commands]; c++) {
+        struct vsctl_context ctx;
+
+        ds_init(&c->output);
+        vsctl_context_init(&ctx, c, idl, txn, ovs);
+        (c->syntax->run)(&ctx);
+        vsctl_context_done(&ctx, c);
     }
 
     while ((status = ovsdb_idl_txn_commit(txn)) == TXN_INCOMPLETE) {
@@ -2435,6 +2487,15 @@ do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
     if (wait_for_reload && status == TXN_SUCCESS) {
         next_cfg = ovsdb_idl_txn_get_increment_new_value(txn);
     }
+    for (c = commands; c < &commands[n_commands]; c++) {
+        if (c->syntax->postprocess) {
+            struct vsctl_context ctx;
+
+            vsctl_context_init(&ctx, c, idl, txn, ovs);
+            (c->syntax->postprocess)(&ctx);
+            vsctl_context_done(&ctx, c);
+        }
+    }
     ovsdb_idl_txn_destroy(txn);
 
     switch (status) {
@@ -2450,8 +2511,8 @@ do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
         break;
 
     case TXN_TRY_AGAIN:
-        for (i = 0; i < n_output; i++) {
-            ds_destroy(&output[i]);
+        for (c = commands; c < &commands[n_commands]; c++) {
+            ds_destroy(&c->output);
         }
         return;
 
@@ -2462,8 +2523,8 @@ do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
         NOT_REACHED();
     }
 
-    for (i = 0; i < n_output; i++) {
-        struct ds *ds = &output[i];
+    for (c = commands; c < &commands[n_commands]; c++) {
+        struct ds *ds = &c->output;
         if (oneline) {
             size_t j;
 
@@ -2508,132 +2569,54 @@ do_vsctl(int argc, char *argv[], struct ovsdb_idl *idl)
     exit(EXIT_SUCCESS);
 }
 
-static vsctl_handler_func *
-get_vsctl_handler(int argc, char *argv[], struct vsctl_context *ctx)
-{
-    static const struct vsctl_command all_commands[] = {
-        /* Open vSwitch commands. */
-        {"init", 0, 0, cmd_init, ""},
-
-        /* Bridge commands. */
-        {"add-br", 1, 3, cmd_add_br, ""},
-        {"del-br", 1, 1, cmd_del_br, "--if-exists"},
-        {"list-br", 0, 0, cmd_list_br, ""},
-        {"br-exists", 1, 1, cmd_br_exists, ""},
-        {"br-to-vlan", 1, 1, cmd_br_to_vlan, ""},
-        {"br-to-parent", 1, 1, cmd_br_to_parent, ""},
-        {"br-set-external-id", 2, 3, cmd_br_set_external_id, ""},
-        {"br-get-external-id", 1, 2, cmd_br_get_external_id, ""},
-
-        /* Port commands. */
-        {"list-ports", 1, 1, cmd_list_ports, ""},
-        {"add-port", 2, 2, cmd_add_port, ""},
-        {"add-bond", 4, INT_MAX, cmd_add_bond, "--fake-iface"},
-        {"del-port", 1, 2, cmd_del_port, "--if-exists"},
-        {"port-to-br", 1, 1, cmd_port_to_br, ""},
-        {"port-set-external-id", 2, 3, cmd_port_set_external_id, ""},
-        {"port-get-external-id", 1, 2, cmd_port_get_external_id, ""},
-
-        /* Interface commands. */
-        {"list-ifaces", 1, 1, cmd_list_ifaces, ""},
-        {"iface-to-br", 1, 1, cmd_iface_to_br, ""},
-        {"iface-set-external-id", 2, 3, cmd_iface_set_external_id, ""},
-        {"iface-get-external-id", 1, 2, cmd_iface_get_external_id, ""},
-
-        /* Controller commands. */
-        {"get-controller", 0, 1, cmd_get_controller, ""},
-        {"del-controller", 0, 1, cmd_del_controller, ""},
-        {"set-controller", 1, 2, cmd_set_controller, ""},
-        {"get-fail-mode", 0, 1, cmd_get_fail_mode, ""},
-        {"del-fail-mode", 0, 1, cmd_del_fail_mode, ""},
-        {"set-fail-mode", 1, 2, cmd_set_fail_mode, ""},
-
-        /* SSL commands. */
-        {"get-ssl", 0, 0, cmd_get_ssl, ""},
-        {"del-ssl", 0, 0, cmd_del_ssl, ""},
-        {"set-ssl", 3, 3, cmd_set_ssl, "--bootstrap"},
-
-        /* Parameter commands. */
-        {"get", 3, INT_MAX, cmd_get, ""},
-        {"list", 1, INT_MAX, cmd_list, ""},
-        {"set", 3, INT_MAX, cmd_set, "--force"},
-        {"add", 4, INT_MAX, cmd_add, "--force"},
-        {"remove", 4, INT_MAX, cmd_remove, "--force"},
-        {"clear", 3, INT_MAX, cmd_clear, "--force"},
-        {"create", 2, INT_MAX, cmd_create, "--force"},
-        {"destroy", 1, INT_MAX, cmd_destroy, "--force,--if-exists"},
-    };
-
-    const struct vsctl_command *p;
-    int i;
-
-    shash_init(&ctx->options);
-    for (i = 0; i < argc; i++) {
-        if (argv[i][0] != '-') {
-            break;
-        }
-        if (!shash_add_once(&ctx->options, argv[i], NULL)) {
-            vsctl_fatal("'%s' option specified multiple times", argv[i]);
-        }
-    }
-    if (i == argc) {
-        vsctl_fatal("missing command name");
-    }
-
-    for (p = all_commands; p < &all_commands[ARRAY_SIZE(all_commands)]; p++) {
-        if (!strcmp(p->name, argv[i])) {
-            struct shash_node *node;
-            int n_arg;
-
-            SHASH_FOR_EACH (node, &ctx->options) {
-                const char *s = strstr(p->options, node->name);
-                int end = s ? s[strlen(node->name)] : EOF;
-                if (end != ',' && end != ' ' && end != '\0') {
-                    vsctl_fatal("'%s' command has no '%s' option",
-                                argv[i], node->name);
-                }
-            }
-
-            n_arg = argc - i - 1;
-            if (n_arg < p->min_args) {
-                vsctl_fatal("'%s' command requires at least %d arguments",
-                            p->name, p->min_args);
-            } else if (n_arg > p->max_args) {
-                vsctl_fatal("'%s' command takes at most %d arguments",
-                            p->name, p->max_args);
-            } else {
-                ctx->argc = n_arg + 1;
-                ctx->argv = &argv[i];
-                return p->handler;
-            }
-        }
-    }
-
-    vsctl_fatal("unknown command '%s'; use --help for help", argv[i]);
-}
-
-static void
-check_vsctl_command(int argc, char *argv[])
-{
-    struct vsctl_context ctx;
-
-    get_vsctl_handler(argc, argv, &ctx);
-    shash_destroy(&ctx.options);
-}
-
-static void
-run_vsctl_command(int argc, char *argv[],
-                  const struct ovsrec_open_vswitch *ovs,
-                  struct ovsdb_idl *idl, struct ds *output)
-{
-    vsctl_handler_func *function;
-    struct vsctl_context ctx;
+static const struct vsctl_command_syntax all_commands[] = {
+    /* Open vSwitch commands. */
+    {"init", 0, 0, cmd_init, NULL, ""},
+
+    /* Bridge commands. */
+    {"add-br", 1, 3, cmd_add_br, NULL, ""},
+    {"del-br", 1, 1, cmd_del_br, NULL, "--if-exists"},
+    {"list-br", 0, 0, cmd_list_br, NULL, ""},
+    {"br-exists", 1, 1, cmd_br_exists, NULL, ""},
+    {"br-to-vlan", 1, 1, cmd_br_to_vlan, NULL, ""},
+    {"br-to-parent", 1, 1, cmd_br_to_parent, NULL, ""},
+    {"br-set-external-id", 2, 3, cmd_br_set_external_id, NULL, ""},
+    {"br-get-external-id", 1, 2, cmd_br_get_external_id, NULL, ""},
+
+    /* Port commands. */
+    {"list-ports", 1, 1, cmd_list_ports, NULL, ""},
+    {"add-port", 2, 2, cmd_add_port, NULL, ""},
+    {"add-bond", 4, INT_MAX, cmd_add_bond, NULL, "--fake-iface"},
+    {"del-port", 1, 2, cmd_del_port, NULL, "--if-exists"},
+    {"port-to-br", 1, 1, cmd_port_to_br, NULL, ""},
+
+    /* Interface commands. */
+    {"list-ifaces", 1, 1, cmd_list_ifaces, NULL, ""},
+    {"iface-to-br", 1, 1, cmd_iface_to_br, NULL, ""},
+
+    /* Controller commands. */
+    {"get-controller", 0, 1, cmd_get_controller, NULL, ""},
+    {"del-controller", 0, 1, cmd_del_controller, NULL, ""},
+    {"set-controller", 1, 2, cmd_set_controller, NULL, ""},
+    {"get-fail-mode", 0, 1, cmd_get_fail_mode, NULL, ""},
+    {"del-fail-mode", 0, 1, cmd_del_fail_mode, NULL, ""},
+    {"set-fail-mode", 1, 2, cmd_set_fail_mode, NULL, ""},
+
+    /* SSL commands. */
+    {"get-ssl", 0, 0, cmd_get_ssl, NULL, ""},
+    {"del-ssl", 0, 0, cmd_del_ssl, NULL, ""},
+    {"set-ssl", 3, 3, cmd_set_ssl, NULL, "--bootstrap"},
+
+    /* Parameter commands. */
+    {"get", 3, INT_MAX, cmd_get, NULL, "--if-exists"},
+    {"list", 1, INT_MAX, cmd_list, NULL, ""},
+    {"set", 3, INT_MAX, cmd_set, NULL, "--force"},
+    {"add", 4, INT_MAX, cmd_add, NULL, "--force"},
+    {"remove", 4, INT_MAX, cmd_remove, NULL, "--force"},
+    {"clear", 3, INT_MAX, cmd_clear, NULL, "--force"},
+    {"create", 2, INT_MAX, cmd_create, post_create, "--force"},
+    {"destroy", 1, INT_MAX, cmd_destroy, NULL, "--force,--if-exists"},
+
+    {NULL, 0, 0, NULL, NULL, NULL},
+};
 
-    function = get_vsctl_handler(argc, argv, &ctx);
-    ctx.ovs = ovs;
-    ctx.idl = idl;
-    ds_init(&ctx.output);
-    function(&ctx);
-    *output = ctx.output;
-    shash_destroy(&ctx.options);
-}