python: Implement write support in Python IDL for OVSDB.
[openvswitch] / ovsdb / ovsdb-server.c
1 /* Copyright (c) 2009, 2010, 2011 Nicira Networks
2  *
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15
16 #include <config.h>
17
18 #include <assert.h>
19 #include <errno.h>
20 #include <getopt.h>
21 #include <signal.h>
22 #include <unistd.h>
23
24 #include "column.h"
25 #include "command-line.h"
26 #include "daemon.h"
27 #include "dirs.h"
28 #include "file.h"
29 #include "hash.h"
30 #include "json.h"
31 #include "jsonrpc.h"
32 #include "jsonrpc-server.h"
33 #include "leak-checker.h"
34 #include "list.h"
35 #include "ovsdb.h"
36 #include "ovsdb-data.h"
37 #include "ovsdb-types.h"
38 #include "ovsdb-error.h"
39 #include "poll-loop.h"
40 #include "process.h"
41 #include "row.h"
42 #include "stream-ssl.h"
43 #include "stream.h"
44 #include "stress.h"
45 #include "sset.h"
46 #include "table.h"
47 #include "timeval.h"
48 #include "transaction.h"
49 #include "trigger.h"
50 #include "util.h"
51 #include "unixctl.h"
52 #include "vlog.h"
53
54 VLOG_DEFINE_THIS_MODULE(ovsdb_server);
55
56 /* SSL configuration. */
57 static char *private_key_file;
58 static char *certificate_file;
59 static char *ca_cert_file;
60 static bool bootstrap_ca_cert;
61
62 static unixctl_cb_func ovsdb_server_exit;
63 static unixctl_cb_func ovsdb_server_compact;
64 static unixctl_cb_func ovsdb_server_reconnect;
65
66 static void parse_options(int argc, char *argv[], char **file_namep,
67                           struct sset *remotes, char **unixctl_pathp,
68                           char **run_command);
69 static void usage(void) NO_RETURN;
70
71 static void reconfigure_from_db(struct ovsdb_jsonrpc_server *jsonrpc,
72                                 const struct ovsdb *db, struct sset *remotes);
73
74 static void update_remote_status(const struct ovsdb_jsonrpc_server *jsonrpc,
75                                  const struct sset *remotes,
76                                  struct ovsdb *db);
77
78 int
79 main(int argc, char *argv[])
80 {
81     char *unixctl_path = NULL;
82     char *run_command = NULL;
83     struct unixctl_server *unixctl;
84     struct ovsdb_jsonrpc_server *jsonrpc;
85     struct sset remotes;
86     struct ovsdb_error *error;
87     struct ovsdb_file *file;
88     struct ovsdb *db;
89     struct process *run_process;
90     char *file_name;
91     bool exiting;
92     int retval;
93     long long int status_timer = LLONG_MIN;
94
95     proctitle_init(argc, argv);
96     set_program_name(argv[0]);
97     stress_init_command();
98     signal(SIGPIPE, SIG_IGN);
99     process_init();
100
101     parse_options(argc, argv, &file_name, &remotes, &unixctl_path,
102                   &run_command);
103
104     daemonize_start();
105
106     error = ovsdb_file_open(file_name, false, &db, &file);
107     if (error) {
108         ovs_fatal(0, "%s", ovsdb_error_to_string(error));
109     }
110     free(file_name);
111
112     jsonrpc = ovsdb_jsonrpc_server_create(db);
113     reconfigure_from_db(jsonrpc, db, &remotes);
114
115     retval = unixctl_server_create(unixctl_path, &unixctl);
116     if (retval) {
117         exit(EXIT_FAILURE);
118     }
119
120     if (run_command) {
121         char *run_argv[4];
122
123         run_argv[0] = "/bin/sh";
124         run_argv[1] = "-c";
125         run_argv[2] = run_command;
126         run_argv[3] = NULL;
127
128         retval = process_start(run_argv, NULL, 0, NULL, 0, &run_process);
129         if (retval) {
130             ovs_fatal(retval, "%s: process failed to start", run_command);
131         }
132     } else {
133         run_process = NULL;
134     }
135
136     daemonize_complete();
137
138     unixctl_command_register("exit", ovsdb_server_exit, &exiting);
139     unixctl_command_register("ovsdb-server/compact", ovsdb_server_compact,
140                              file);
141     unixctl_command_register("ovsdb-server/reconnect", ovsdb_server_reconnect,
142                              jsonrpc);
143
144     exiting = false;
145     while (!exiting) {
146         reconfigure_from_db(jsonrpc, db, &remotes);
147         ovsdb_jsonrpc_server_run(jsonrpc);
148         unixctl_server_run(unixctl);
149         ovsdb_trigger_run(db, time_msec());
150         if (run_process && process_exited(run_process)) {
151             exiting = true;
152         }
153
154         /* update Manager status(es) every 5 seconds */
155         if (time_msec() >= status_timer) {
156             status_timer = time_msec() + 5000;
157             update_remote_status(jsonrpc, &remotes, db);
158         }
159
160         ovsdb_jsonrpc_server_wait(jsonrpc);
161         unixctl_server_wait(unixctl);
162         ovsdb_trigger_wait(db, time_msec());
163         if (run_process) {
164             process_wait(run_process);
165         }
166         if (exiting) {
167             poll_immediate_wake();
168         }
169         poll_timer_wait_until(status_timer);
170         poll_block();
171     }
172     ovsdb_jsonrpc_server_destroy(jsonrpc);
173     ovsdb_destroy(db);
174     sset_destroy(&remotes);
175     unixctl_server_destroy(unixctl);
176
177     if (run_process && process_exited(run_process)) {
178         int status = process_status(run_process);
179         if (status) {
180             ovs_fatal(0, "%s: child exited, %s",
181                       run_command, process_status_msg(status));
182         }
183     }
184
185     return 0;
186 }
187
188 static void
189 parse_db_column(const struct ovsdb *db,
190                 const char *name_,
191                 const struct ovsdb_table **tablep,
192                 const struct ovsdb_column **columnp)
193 {
194     char *name, *table_name, *column_name;
195     const struct ovsdb_column *column;
196     const struct ovsdb_table *table;
197     char *save_ptr = NULL;
198
199     name = xstrdup(name_);
200     strtok_r(name, ":", &save_ptr); /* "db:" */
201     table_name = strtok_r(NULL, ",", &save_ptr);
202     column_name = strtok_r(NULL, ",", &save_ptr);
203     if (!table_name || !column_name) {
204         ovs_fatal(0, "\"%s\": invalid syntax", name_);
205     }
206
207     table = ovsdb_get_table(db, table_name);
208     if (!table) {
209         ovs_fatal(0, "\"%s\": no table named %s", name_, table_name);
210     }
211
212     column = ovsdb_table_schema_get_column(table->schema, column_name);
213     if (!column) {
214         ovs_fatal(0, "\"%s\": table \"%s\" has no column \"%s\"",
215                   name_, table_name, column_name);
216     }
217     free(name);
218
219     *columnp = column;
220     *tablep = table;
221 }
222
223 static void
224 parse_db_string_column(const struct ovsdb *db,
225                        const char *name,
226                        const struct ovsdb_table **tablep,
227                        const struct ovsdb_column **columnp)
228 {
229     const struct ovsdb_column *column;
230     const struct ovsdb_table *table;
231
232     parse_db_column(db, name, &table, &column);
233
234     if (column->type.key.type != OVSDB_TYPE_STRING
235         || column->type.value.type != OVSDB_TYPE_VOID) {
236         ovs_fatal(0, "\"%s\": table \"%s\" column \"%s\" is "
237                   "not string or set of strings",
238                   name, table->schema->name, column->name);
239     }
240
241     *columnp = column;
242     *tablep = table;
243 }
244
245 static OVS_UNUSED const char *
246 query_db_string(const struct ovsdb *db, const char *name)
247 {
248     if (!name || strncmp(name, "db:", 3)) {
249         return name;
250     } else {
251         const struct ovsdb_column *column;
252         const struct ovsdb_table *table;
253         const struct ovsdb_row *row;
254
255         parse_db_string_column(db, name, &table, &column);
256
257         HMAP_FOR_EACH (row, hmap_node, &table->rows) {
258             const struct ovsdb_datum *datum;
259             size_t i;
260
261             datum = &row->fields[column->index];
262             for (i = 0; i < datum->n; i++) {
263                 if (datum->keys[i].string[0]) {
264                     return datum->keys[i].string;
265                 }
266             }
267         }
268         return NULL;
269     }
270 }
271
272 static struct ovsdb_jsonrpc_options *
273 add_remote(struct shash *remotes, const char *target)
274 {
275     struct ovsdb_jsonrpc_options *options;
276
277     options = shash_find_data(remotes, target);
278     if (!options) {
279         options = ovsdb_jsonrpc_default_options();
280         shash_add(remotes, target, options);
281     }
282
283     return options;
284 }
285
286 static struct ovsdb_datum *
287 get_datum(struct ovsdb_row *row, const char *column_name,
288           const enum ovsdb_atomic_type key_type,
289           const enum ovsdb_atomic_type value_type,
290           const size_t n_max)
291 {
292     static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 1);
293     const struct ovsdb_table_schema *schema = row->table->schema;
294     const struct ovsdb_column *column;
295
296     column = ovsdb_table_schema_get_column(schema, column_name);
297     if (!column) {
298         VLOG_DBG_RL(&rl, "Table `%s' has no `%s' column",
299                     schema->name, column_name);
300         return NULL;
301     }
302
303     if (column->type.key.type != key_type
304         || column->type.value.type != value_type
305         || column->type.n_max != n_max) {
306         if (!VLOG_DROP_DBG(&rl)) {
307             char *type_name = ovsdb_type_to_english(&column->type);
308             VLOG_DBG("Table `%s' column `%s' has type %s, not expected "
309                      "key type %s, value type %s, max elements %zd.",
310                      schema->name, column_name, type_name,
311                      ovsdb_atomic_type_to_string(key_type),
312                      ovsdb_atomic_type_to_string(value_type),
313                      n_max);
314             free(type_name);
315         }
316         return NULL;
317     }
318
319     return &row->fields[column->index];
320 }
321
322 static const union ovsdb_atom *
323 read_column(const struct ovsdb_row *row, const char *column_name,
324             enum ovsdb_atomic_type type)
325 {
326     const struct ovsdb_datum *datum;
327
328     datum = get_datum((struct ovsdb_row *) row, column_name, type, OVSDB_TYPE_VOID, 1);
329     return datum && datum->n ? datum->keys : NULL;
330 }
331
332 static bool
333 read_integer_column(const struct ovsdb_row *row, const char *column_name,
334                     long long int *integerp)
335 {
336     const union ovsdb_atom *atom;
337
338     atom = read_column(row, column_name, OVSDB_TYPE_INTEGER);
339     *integerp = atom ? atom->integer : 0;
340     return atom != NULL;
341 }
342
343 static bool
344 read_string_column(const struct ovsdb_row *row, const char *column_name,
345                    const char **stringp)
346 {
347     const union ovsdb_atom *atom;
348
349     atom = read_column(row, column_name, OVSDB_TYPE_STRING);
350     *stringp = atom ? atom->string : NULL;
351     return atom != NULL;
352 }
353
354 static void
355 write_bool_column(struct ovsdb_row *row, const char *column_name, bool value)
356 {
357     struct ovsdb_datum *datum = get_datum(row, column_name, OVSDB_TYPE_BOOLEAN,
358                                           OVSDB_TYPE_VOID, 1);
359
360     if (!datum) {
361         return;
362     }
363     datum->keys[0].boolean = value;
364 }
365
366 static void
367 write_string_string_column(struct ovsdb_row *row, const char *column_name,
368                            char **keys, char **values, size_t n)
369 {
370     const struct ovsdb_column *column;
371     struct ovsdb_datum *datum;
372     size_t i;
373
374     column = ovsdb_table_schema_get_column(row->table->schema, column_name);
375     datum = get_datum(row, column_name, OVSDB_TYPE_STRING, OVSDB_TYPE_STRING,
376                       UINT_MAX);
377     if (!datum) {
378         return;
379     }
380
381     /* Free existing data. */
382     ovsdb_datum_destroy(datum, &column->type);
383
384     /* Allocate space for new values. */
385     datum->n = n;
386     datum->keys = xmalloc(n * sizeof *datum->keys);
387     datum->values = xmalloc(n * sizeof *datum->values);
388
389     for (i = 0; i < n; ++i) {
390         datum->keys[i].string = keys[i];
391         datum->values[i].string = values[i];
392     }
393
394     /* Sort and check constraints. */
395     ovsdb_datum_sort_assert(datum, column->type.key.type);
396 }
397
398 /* Adds a remote and options to 'remotes', based on the Manager table row in
399  * 'row'. */
400 static void
401 add_manager_options(struct shash *remotes, const struct ovsdb_row *row)
402 {
403     static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 1);
404     struct ovsdb_jsonrpc_options *options;
405     long long int max_backoff, probe_interval;
406     const char *target;
407
408     if (!read_string_column(row, "target", &target) || !target) {
409         VLOG_INFO_RL(&rl, "Table `%s' has missing or invalid `target' column",
410                      row->table->schema->name);
411         return;
412     }
413
414     options = add_remote(remotes, target);
415     if (read_integer_column(row, "max_backoff", &max_backoff)) {
416         options->max_backoff = max_backoff;
417     }
418     if (read_integer_column(row, "inactivity_probe", &probe_interval)) {
419         options->probe_interval = probe_interval;
420     }
421 }
422
423 static void
424 query_db_remotes(const char *name, const struct ovsdb *db,
425                  struct shash *remotes)
426 {
427     const struct ovsdb_column *column;
428     const struct ovsdb_table *table;
429     const struct ovsdb_row *row;
430
431     parse_db_column(db, name, &table, &column);
432
433     if (column->type.key.type == OVSDB_TYPE_STRING
434         && column->type.value.type == OVSDB_TYPE_VOID) {
435         HMAP_FOR_EACH (row, hmap_node, &table->rows) {
436             const struct ovsdb_datum *datum;
437             size_t i;
438
439             datum = &row->fields[column->index];
440             for (i = 0; i < datum->n; i++) {
441                 add_remote(remotes, datum->keys[i].string);
442             }
443         }
444     } else if (column->type.key.type == OVSDB_TYPE_UUID
445                && column->type.key.u.uuid.refTable
446                && column->type.value.type == OVSDB_TYPE_VOID) {
447         const struct ovsdb_table *ref_table = column->type.key.u.uuid.refTable;
448         HMAP_FOR_EACH (row, hmap_node, &table->rows) {
449             const struct ovsdb_datum *datum;
450             size_t i;
451
452             datum = &row->fields[column->index];
453             for (i = 0; i < datum->n; i++) {
454                 const struct ovsdb_row *ref_row;
455
456                 ref_row = ovsdb_table_get_row(ref_table, &datum->keys[i].uuid);
457                 if (ref_row) {
458                     add_manager_options(remotes, ref_row);
459                 }
460             }
461         }
462     }
463 }
464
465 static void
466 update_remote_row(const struct ovsdb_row *row, struct ovsdb_txn *txn,
467                   const struct ovsdb_jsonrpc_server *jsonrpc)
468 {
469     struct ovsdb_jsonrpc_remote_status status;
470     struct ovsdb_row *rw_row;
471     const char *target;
472     char *keys[8], *values[8];
473     size_t n = 0;
474
475     /* Get the "target" (protocol/host/port) spec. */
476     if (!read_string_column(row, "target", &target)) {
477         /* Bad remote spec or incorrect schema. */
478         return;
479     }
480     rw_row = ovsdb_txn_row_modify(txn, row);
481     ovsdb_jsonrpc_server_get_remote_status(jsonrpc, target, &status);
482
483     /* Update status information columns. */
484     write_bool_column(rw_row, "is_connected", status.is_connected);
485
486     if (status.state) {
487         keys[n] = xstrdup("state");
488         values[n++] = xstrdup(status.state);
489     }
490     if (status.sec_since_connect != UINT_MAX) {
491         keys[n] = xstrdup("sec_since_connect");
492         values[n++] = xasprintf("%u", status.sec_since_connect);
493     }
494     if (status.sec_since_disconnect != UINT_MAX) {
495         keys[n] = xstrdup("sec_since_disconnect");
496         values[n++] = xasprintf("%u", status.sec_since_disconnect);
497     }
498     if (status.last_error) {
499         keys[n] = xstrdup("last_error");
500         values[n++] =
501             xstrdup(ovs_retval_to_string(status.last_error));
502     }
503     if (status.locks_held && status.locks_held[0]) {
504         keys[n] = xstrdup("locks_held");
505         values[n++] = xstrdup(status.locks_held);
506     }
507     if (status.locks_waiting && status.locks_waiting[0]) {
508         keys[n] = xstrdup("locks_waiting");
509         values[n++] = xstrdup(status.locks_waiting);
510     }
511     if (status.locks_lost && status.locks_lost[0]) {
512         keys[n] = xstrdup("locks_lost");
513         values[n++] = xstrdup(status.locks_lost);
514     }
515     if (status.n_connections > 1) {
516         keys[n] = xstrdup("n_connections");
517         values[n++] = xasprintf("%d", status.n_connections);
518     }
519     write_string_string_column(rw_row, "status", keys, values, n);
520
521     ovsdb_jsonrpc_server_free_remote_status(&status);
522 }
523
524 static void
525 update_remote_rows(const struct ovsdb *db, struct ovsdb_txn *txn,
526                    const char *remote_name,
527                    const struct ovsdb_jsonrpc_server *jsonrpc)
528 {
529     const struct ovsdb_table *table, *ref_table;
530     const struct ovsdb_column *column;
531     const struct ovsdb_row *row;
532
533     if (strncmp("db:", remote_name, 3)) {
534         return;
535     }
536
537     parse_db_column(db, remote_name, &table, &column);
538
539     if (column->type.key.type != OVSDB_TYPE_UUID
540         || !column->type.key.u.uuid.refTable
541         || column->type.value.type != OVSDB_TYPE_VOID) {
542         return;
543     }
544
545     ref_table = column->type.key.u.uuid.refTable;
546
547     HMAP_FOR_EACH (row, hmap_node, &table->rows) {
548         const struct ovsdb_datum *datum;
549         size_t i;
550
551         datum = &row->fields[column->index];
552         for (i = 0; i < datum->n; i++) {
553             const struct ovsdb_row *ref_row;
554
555             ref_row = ovsdb_table_get_row(ref_table, &datum->keys[i].uuid);
556             if (ref_row) {
557                 update_remote_row(ref_row, txn, jsonrpc);
558             }
559         }
560     }
561 }
562
563 static void
564 update_remote_status(const struct ovsdb_jsonrpc_server *jsonrpc,
565                      const struct sset *remotes, struct ovsdb *db)
566 {
567     static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 1);
568     struct ovsdb_txn *txn;
569     const bool durable_txn = false;
570     struct ovsdb_error *error;
571     const char *remote;
572
573     txn = ovsdb_txn_create(db);
574
575     /* Iterate over --remote arguments given on command line. */
576     SSET_FOR_EACH (remote, remotes) {
577         update_remote_rows(db, txn, remote, jsonrpc);
578     }
579
580     error = ovsdb_txn_commit(txn, durable_txn);
581     if (error) {
582         VLOG_ERR_RL(&rl, "Failed to update remote status: %s",
583                     ovsdb_error_to_string(error));
584     }
585 }
586
587 /* Reconfigures ovsdb-server based on information in the database. */
588 static void
589 reconfigure_from_db(struct ovsdb_jsonrpc_server *jsonrpc,
590                     const struct ovsdb *db, struct sset *remotes)
591 {
592     struct shash resolved_remotes;
593     const char *name;
594
595     /* Configure remotes. */
596     shash_init(&resolved_remotes);
597     SSET_FOR_EACH (name, remotes) {
598         if (!strncmp(name, "db:", 3)) {
599             query_db_remotes(name, db, &resolved_remotes);
600         } else {
601             add_remote(&resolved_remotes, name);
602         }
603     }
604     ovsdb_jsonrpc_server_set_remotes(jsonrpc, &resolved_remotes);
605     shash_destroy_free_data(&resolved_remotes);
606
607     /* Configure SSL. */
608     stream_ssl_set_key_and_cert(query_db_string(db, private_key_file),
609                                 query_db_string(db, certificate_file));
610     stream_ssl_set_ca_cert_file(query_db_string(db, ca_cert_file),
611                                 bootstrap_ca_cert);
612 }
613
614 static void
615 ovsdb_server_exit(struct unixctl_conn *conn, const char *args OVS_UNUSED,
616                   void *exiting_)
617 {
618     bool *exiting = exiting_;
619     *exiting = true;
620     unixctl_command_reply(conn, 200, NULL);
621 }
622
623 static void
624 ovsdb_server_compact(struct unixctl_conn *conn, const char *args OVS_UNUSED,
625                      void *file_)
626 {
627     struct ovsdb_file *file = file_;
628     struct ovsdb_error *error;
629
630     VLOG_INFO("compacting database by user request");
631     error = ovsdb_file_compact(file);
632     if (!error) {
633         unixctl_command_reply(conn, 200, NULL);
634     } else {
635         char *s = ovsdb_error_to_string(error);
636         ovsdb_error_destroy(error);
637         unixctl_command_reply(conn, 503, s);
638         free(s);
639     }
640 }
641
642 /* "ovsdb-server/reconnect": makes ovsdb-server drop all of its JSON-RPC
643  * connections and reconnect. */
644 static void
645 ovsdb_server_reconnect(struct unixctl_conn *conn, const char *args OVS_UNUSED,
646                        void *jsonrpc_)
647 {
648     struct ovsdb_jsonrpc_server *jsonrpc = jsonrpc_;
649
650     ovsdb_jsonrpc_server_reconnect(jsonrpc);
651     unixctl_command_reply(conn, 200, NULL);
652 }
653
654 static void
655 parse_options(int argc, char *argv[], char **file_namep,
656               struct sset *remotes, char **unixctl_pathp,
657               char **run_command)
658 {
659     enum {
660         OPT_DUMMY = UCHAR_MAX + 1,
661         OPT_REMOTE,
662         OPT_UNIXCTL,
663         OPT_RUN,
664         OPT_BOOTSTRAP_CA_CERT,
665         VLOG_OPTION_ENUMS,
666         LEAK_CHECKER_OPTION_ENUMS,
667         DAEMON_OPTION_ENUMS
668     };
669     static struct option long_options[] = {
670         {"remote",      required_argument, NULL, OPT_REMOTE},
671         {"unixctl",     required_argument, NULL, OPT_UNIXCTL},
672         {"run",         required_argument, NULL, OPT_RUN},
673         {"help",        no_argument, NULL, 'h'},
674         {"version",     no_argument, NULL, 'V'},
675         DAEMON_LONG_OPTIONS,
676         VLOG_LONG_OPTIONS,
677         LEAK_CHECKER_LONG_OPTIONS,
678         {"bootstrap-ca-cert", required_argument, NULL, OPT_BOOTSTRAP_CA_CERT},
679         {"private-key", required_argument, NULL, 'p'},
680         {"certificate", required_argument, NULL, 'c'},
681         {"ca-cert",     required_argument, NULL, 'C'},
682         {NULL, 0, NULL, 0},
683     };
684     char *short_options = long_options_to_short_options(long_options);
685
686     sset_init(remotes);
687     for (;;) {
688         int c;
689
690         c = getopt_long(argc, argv, short_options, long_options, NULL);
691         if (c == -1) {
692             break;
693         }
694
695         switch (c) {
696         case OPT_REMOTE:
697             sset_add(remotes, optarg);
698             break;
699
700         case OPT_UNIXCTL:
701             *unixctl_pathp = optarg;
702             break;
703
704         case OPT_RUN:
705             *run_command = optarg;
706             break;
707
708         case 'h':
709             usage();
710
711         case 'V':
712             ovs_print_version(0, 0);
713             exit(EXIT_SUCCESS);
714
715         VLOG_OPTION_HANDLERS
716         DAEMON_OPTION_HANDLERS
717         LEAK_CHECKER_OPTION_HANDLERS
718
719         case 'p':
720             private_key_file = optarg;
721             break;
722
723         case 'c':
724             certificate_file = optarg;
725             break;
726
727         case 'C':
728             ca_cert_file = optarg;
729             bootstrap_ca_cert = false;
730             break;
731
732         case OPT_BOOTSTRAP_CA_CERT:
733             ca_cert_file = optarg;
734             bootstrap_ca_cert = true;
735             break;
736
737         case '?':
738             exit(EXIT_FAILURE);
739
740         default:
741             abort();
742         }
743     }
744     free(short_options);
745
746     argc -= optind;
747     argv += optind;
748
749     switch (argc) {
750     case 0:
751         *file_namep = xasprintf("%s/openvswitch/conf.db", ovs_sysconfdir());
752         break;
753
754     case 1:
755         *file_namep = xstrdup(argv[0]);
756         break;
757
758     default:
759         ovs_fatal(0, "database file is only non-option argument; "
760                 "use --help for usage");
761     }
762 }
763
764 static void
765 usage(void)
766 {
767     printf("%s: Open vSwitch database server\n"
768            "usage: %s [OPTIONS] DATABASE\n"
769            "where DATABASE is a database file in ovsdb format.\n",
770            program_name, program_name);
771     printf("\nJSON-RPC options (may be specified any number of times):\n"
772            "  --remote=REMOTE         connect or listen to REMOTE\n");
773     stream_usage("JSON-RPC", true, true, true);
774     daemon_usage();
775     vlog_usage();
776     printf("\nOther options:\n"
777            "  --run COMMAND           run COMMAND as subprocess then exit\n"
778            "  --unixctl=SOCKET        override default control socket name\n"
779            "  -h, --help              display this help message\n"
780            "  -V, --version           display version information\n");
781     leak_checker_usage();
782     exit(EXIT_SUCCESS);
783 }