Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
[cascardo/ovs.git] / vswitchd / ovs-brcompatd.c
1 /* Copyright (c) 2008, 2009 Nicira Networks
2  * 
3  * This program is free software: you can redistribute it and/or modify
4  * it under the terms of the GNU General Public License as published by
5  * the Free Software Foundation, either version 3 of the License, or
6  * (at your option) any later version.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
15  *
16  */
17
18 #include <config.h>
19
20 #include <assert.h>
21 #include <errno.h>
22 #include <getopt.h>
23 #include <inttypes.h>
24 #include <limits.h>
25 #include <net/if.h>
26 #include <linux/genetlink.h>
27 #include <linux/rtnetlink.h>
28 #include <signal.h>
29 #include <stdlib.h>
30 #include <string.h>
31 #include <sys/types.h>
32 #include <sys/stat.h>
33 #include <fcntl.h>
34 #include <unistd.h>
35
36 #include "cfg.h"
37 #include "command-line.h"
38 #include "coverage.h"
39 #include "daemon.h"
40 #include "dirs.h"
41 #include "dpif.h"
42 #include "fatal-signal.h"
43 #include "fault.h"
44 #include "leak-checker.h"
45 #include "netdev.h"
46 #include "netlink.h"
47 #include "ofpbuf.h"
48 #include "openvswitch/brcompat-netlink.h"
49 #include "poll-loop.h"
50 #include "process.h"
51 #include "signals.h"
52 #include "svec.h"
53 #include "timeval.h"
54 #include "unixctl.h"
55 #include "util.h"
56
57 #include "vlog.h"
58 #define THIS_MODULE VLM_brcompatd
59
60
61 /* xxx Just hangs if datapath is rmmod/insmod.  Learn to reconnect? */
62
63 /* Actions to modify bridge compatibility configuration. */
64 enum bmc_action {
65     BMC_ADD_DP,
66     BMC_DEL_DP,
67     BMC_ADD_PORT,
68     BMC_DEL_PORT
69 };
70
71 static void parse_options(int argc, char *argv[]);
72 static void usage(void) NO_RETURN;
73
74 static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(5, 60);
75
76 /* Maximum number of milliseconds to wait for the config file to be
77  * unlocked.  If set to zero, no waiting will occur. */
78 static int lock_timeout = 500;
79
80 /* Maximum number of milliseconds to wait before pruning port entries that 
81  * no longer exist.  If set to zero, ports are never pruned. */
82 static int prune_timeout = 5000;
83
84 /* Config file shared with ovs-vswitchd (usually ovs-vswitchd.conf). */
85 static char *config_file;
86
87 /* Command to run (via system()) to reload the ovs-vswitchd configuration
88  * file. */
89 static char *reload_command;
90
91 /* Netlink socket to listen for interface changes. */
92 static struct nl_sock *rtnl_sock;
93
94 /* Netlink socket to bridge compatibility kernel module. */
95 static struct nl_sock *brc_sock;
96
97 /* The Generic Netlink family number used for bridge compatibility. */
98 static int brc_family;
99
100 static const struct nl_policy brc_multicast_policy[] = {
101     [BRC_GENL_A_MC_GROUP] = {.type = NL_A_U32 }
102 };
103
104 static const struct nl_policy rtnlgrp_link_policy[] = {
105     [IFLA_IFNAME] = { .type = NL_A_STRING, .optional = false },
106     [IFLA_MASTER] = { .type = NL_A_U32, .optional = true },
107 };
108
109 static int
110 lookup_brc_multicast_group(int *multicast_group)
111 {
112     struct nl_sock *sock;
113     struct ofpbuf request, *reply;
114     struct nlattr *attrs[ARRAY_SIZE(brc_multicast_policy)];
115     int retval;
116
117     retval = nl_sock_create(NETLINK_GENERIC, 0, 0, 0, &sock);
118     if (retval) {
119         return retval;
120     }
121     ofpbuf_init(&request, 0);
122     nl_msg_put_genlmsghdr(&request, sock, 0, brc_family,
123             NLM_F_REQUEST, BRC_GENL_C_QUERY_MC, 1);
124     retval = nl_sock_transact(sock, &request, &reply);
125     ofpbuf_uninit(&request);
126     if (retval) {
127         nl_sock_destroy(sock);
128         return retval;
129     }
130     if (!nl_policy_parse(reply, NLMSG_HDRLEN + GENL_HDRLEN,
131                          brc_multicast_policy, attrs,
132                          ARRAY_SIZE(brc_multicast_policy))) {
133         nl_sock_destroy(sock);
134         ofpbuf_delete(reply);
135         return EPROTO;
136     }
137     *multicast_group = nl_attr_get_u32(attrs[BRC_GENL_A_MC_GROUP]);
138     nl_sock_destroy(sock);
139     ofpbuf_delete(reply);
140
141     return 0;
142 }
143
144 /* Opens a socket for brcompat notifications.  Returns 0 if successful,
145  * otherwise a positive errno value. */
146 static int
147 brc_open(struct nl_sock **sock)
148 {
149     int multicast_group = 0;
150     int retval;
151
152     retval = nl_lookup_genl_family(BRC_GENL_FAMILY_NAME, &brc_family);
153     if (retval) {
154         return retval;
155     }
156
157     retval = lookup_brc_multicast_group(&multicast_group);
158     if (retval) {
159         return retval;
160     }
161
162     retval = nl_sock_create(NETLINK_GENERIC, multicast_group, 0, 0, sock);
163     if (retval) {
164         return retval;
165     }
166
167     return 0;
168 }
169
170 static const struct nl_policy brc_dp_policy[] = {
171     [BRC_GENL_A_DP_NAME] = { .type = NL_A_STRING },
172 };
173
174 static bool
175 bridge_exists(const char *name)
176 {
177     return cfg_has_section("bridge.%s", name);
178 }
179
180 static int
181 rewrite_and_reload_config(void)
182 {
183     if (cfg_is_dirty()) {
184         int error1 = cfg_write();
185         int error2 = cfg_read();
186         long long int reload_start = time_msec();
187         int error3 = system(reload_command);
188         long long int elapsed = time_msec() - reload_start;
189         COVERAGE_INC(brcompatd_reload);
190         if (elapsed > 0) {
191             VLOG_INFO("reload command executed in %lld ms", elapsed);
192         }
193         if (error3 == -1) {
194             VLOG_ERR("failed to execute reload command: %s", strerror(errno));
195         } else if (error3 != 0) {
196             char *msg = process_status_msg(error3);
197             VLOG_ERR("reload command exited with error (%s)", msg);
198             free(msg);
199         }
200         return error1 ? error1 : error2 ? error2 : error3 ? ECHILD : 0;
201     }
202     return 0;
203 }
204
205 /* Go through the configuration file and remove any ports that no longer
206  * exist associated with a bridge. */
207 static void
208 prune_ports(void)
209 {
210     int i, j;
211     int error;
212     struct svec bridges, delete;
213
214     if (cfg_lock(NULL, 0)) {
215         /* Couldn't lock config file. */
216         return;
217     }
218
219     svec_init(&bridges);
220     svec_init(&delete);
221     cfg_get_subsections(&bridges, "bridge");
222     for (i=0; i<bridges.n; i++) {
223         const char *br_name = bridges.names[i];
224         struct svec ports, ifaces;
225
226         svec_init(&ports);
227
228         /* Get all the interfaces for the given bridge, breaking bonded
229          * interfaces down into their constituent parts. */
230         svec_init(&ifaces);
231         cfg_get_all_keys(&ports, "bridge.%s.port", br_name);
232         for (j=0; j<ports.n; j++) {
233             const char *port_name = ports.names[j];
234             if (cfg_has_section("bonding.%s", port_name)) {
235                 struct svec slaves;
236                 svec_init(&slaves);
237                 cfg_get_all_keys(&slaves, "bonding.%s.slave", port_name);
238                 svec_append(&ifaces, &slaves);
239                 svec_destroy(&slaves);
240             } else {
241                 svec_add(&ifaces, port_name);
242             }
243         }
244         svec_destroy(&ports);
245
246         /* Check that the interfaces exist. */
247         for (j = 0; j < ifaces.n; j++) {
248             const char *iface_name = ifaces.names[j];
249             enum netdev_flags flags;
250
251             /* The local port and internal ports are created and destroyed by
252              * ovs-vswitchd itself, so don't bother checking for them at all.
253              * In practice, they might not exist if ovs-vswitchd hasn't
254              * finished reloading since the configuration file was updated. */
255             if (!strcmp(iface_name, br_name)
256                 || cfg_get_bool(0, "iface.%s.internal", iface_name)) {
257                 continue;
258             }
259
260             error = netdev_nodev_get_flags(iface_name, &flags);
261             if (error == ENODEV) {
262                 VLOG_DBG_RL(&rl, "removing dead interface %s from %s", 
263                         iface_name, br_name);
264                 svec_add(&delete, iface_name);
265             } else if (error) {
266                 VLOG_DBG_RL(&rl, "unknown error %d on interface %s from %s", 
267                         error, iface_name, br_name);
268             }
269         }
270         svec_destroy(&ifaces);
271     }
272     svec_destroy(&bridges);
273
274     if (delete.n) {
275         size_t i;
276
277         for (i = 0; i < delete.n; i++) {
278             cfg_del_match("bridge.*.port=%s", delete.names[i]);
279             cfg_del_match("bonding.*.slave=%s", delete.names[i]);
280         }
281         rewrite_and_reload_config();
282         cfg_unlock();
283     } else {
284         cfg_unlock();
285     }
286     svec_destroy(&delete);
287 }
288
289
290 /* Checks whether a network device named 'name' exists and returns true if so,
291  * false otherwise.
292  *
293  * XXX it is possible that this doesn't entirely accomplish what we want in
294  * context, since ovs-vswitchd.conf may cause vswitchd to create or destroy
295  * network devices based on iface.*.internal settings.
296  *
297  * XXX may want to move this to lib/netdev. */
298 static bool
299 netdev_exists(const char *name)
300 {
301     struct stat s;
302     char *filename;
303     int error;
304
305     filename = xasprintf("/sys/class/net/%s", name);
306     error = stat(filename, &s);
307     free(filename);
308     return !error;
309 }
310
311 static int
312 add_bridge(const char *br_name)
313 {
314     if (bridge_exists(br_name)) {
315         VLOG_WARN("addbr %s: bridge %s exists", br_name, br_name);
316         return EEXIST;
317     } else if (netdev_exists(br_name)) {
318         if (cfg_get_bool(0, "iface.%s.fake-bridge", br_name)) {
319             VLOG_WARN("addbr %s: %s exists as a fake bridge",
320                       br_name, br_name);
321             return 0;
322         } else {
323             VLOG_WARN("addbr %s: cannot create bridge %s because a network "
324                       "device named %s already exists",
325                       br_name, br_name, br_name);
326             return EEXIST;
327         }
328     }
329
330     cfg_add_entry("bridge.%s.port=%s", br_name, br_name);
331     VLOG_INFO("addbr %s: success", br_name);
332
333     return 0;
334 }
335
336 static int 
337 del_bridge(const char *br_name)
338 {
339     if (!bridge_exists(br_name)) {
340         VLOG_WARN("delbr %s: no bridge named %s", br_name, br_name);
341         return ENXIO;
342     }
343
344     cfg_del_section("bridge.%s", br_name);
345     VLOG_INFO("delbr %s: success", br_name);
346
347     return 0;
348 }
349
350 static int
351 parse_command(struct ofpbuf *buffer, uint32_t *seq, const char **br_name,
352               const char **port_name)
353 {
354     static const struct nl_policy policy[] = {
355         [BRC_GENL_A_DP_NAME] = { .type = NL_A_STRING },
356         [BRC_GENL_A_PORT_NAME] = { .type = NL_A_STRING, .optional = true },
357     };
358     struct nlattr *attrs[ARRAY_SIZE(policy)];
359
360     if (!nl_policy_parse(buffer, NLMSG_HDRLEN + GENL_HDRLEN, policy,
361                          attrs, ARRAY_SIZE(policy))
362         || (port_name && !attrs[BRC_GENL_A_PORT_NAME])) {
363         return EINVAL;
364     }
365
366     *seq = ((struct nlmsghdr *) buffer->data)->nlmsg_seq;
367     *br_name = nl_attr_get_string(attrs[BRC_GENL_A_DP_NAME]);
368     if (port_name) {
369         *port_name = nl_attr_get_string(attrs[BRC_GENL_A_PORT_NAME]);
370     }
371     return 0;
372 }
373
374 static void
375 send_reply(uint32_t seq, int error)
376 {
377     struct ofpbuf msg;
378     int retval;
379
380     /* Compose reply. */
381     ofpbuf_init(&msg, 0);
382     nl_msg_put_genlmsghdr(&msg, brc_sock, 32, brc_family, NLM_F_REQUEST,
383                           BRC_GENL_C_DP_RESULT, 1);
384     ((struct nlmsghdr *) msg.data)->nlmsg_seq = seq;
385     nl_msg_put_u32(&msg, BRC_GENL_A_ERR_CODE, error);
386
387     /* Send reply. */
388     retval = nl_sock_send(brc_sock, &msg, false);
389     if (retval) {
390         VLOG_WARN_RL(&rl, "replying to brcompat request: %s",
391                      strerror(retval));
392     }
393     ofpbuf_uninit(&msg);
394 }
395
396 static int
397 handle_bridge_cmd(struct ofpbuf *buffer, bool add)
398 {
399     const char *br_name;
400     uint32_t seq;
401     int error;
402
403     error = parse_command(buffer, &seq, &br_name, NULL);
404     if (!error) {
405         error = add ? add_bridge(br_name) : del_bridge(br_name);
406         if (!error) {
407             error = rewrite_and_reload_config();
408         }
409         send_reply(seq, error);
410     }
411     return error;
412 }
413
414 static const struct nl_policy brc_port_policy[] = {
415     [BRC_GENL_A_DP_NAME] = { .type = NL_A_STRING },
416     [BRC_GENL_A_PORT_NAME] = { .type = NL_A_STRING },
417 };
418
419 static void
420 del_port(const char *br_name, const char *port_name)
421 {
422     cfg_del_entry("bridge.%s.port=%s", br_name, port_name);
423     cfg_del_match("bonding.*.slave=%s", port_name);
424     cfg_del_match("vlan.%s.*", port_name);
425 }
426
427 static int
428 handle_port_cmd(struct ofpbuf *buffer, bool add)
429 {
430     const char *cmd_name = add ? "add-if" : "del-if";
431     const char *br_name, *port_name;
432     uint32_t seq;
433     int error;
434
435     error = parse_command(buffer, &seq, &br_name, &port_name);
436     if (!error) {
437         if (!bridge_exists(br_name)) {
438             VLOG_WARN("%s %s %s: no bridge named %s",
439                       cmd_name, br_name, port_name, br_name);
440             error = EINVAL;
441         } else if (!netdev_exists(port_name)) {
442             VLOG_WARN("%s %s %s: no network device named %s",
443                       cmd_name, br_name, port_name, port_name);
444             error = EINVAL;
445         } else {
446             if (add) {
447                 cfg_add_entry("bridge.%s.port=%s", br_name, port_name);
448             } else {
449                 del_port(br_name, port_name);
450             }
451             VLOG_INFO("%s %s %s: success", cmd_name, br_name, port_name);
452             error = rewrite_and_reload_config();
453         }
454         send_reply(seq, error);
455     }
456
457     return error;
458 }
459
460 static int
461 brc_recv_update(void)
462 {
463     int retval;
464     struct ofpbuf *buffer;
465     struct genlmsghdr *genlmsghdr;
466
467
468     buffer = NULL;
469     do {
470         ofpbuf_delete(buffer);
471         retval = nl_sock_recv(brc_sock, &buffer, false);
472     } while (retval == ENOBUFS
473             || (!retval
474                 && (nl_msg_nlmsgerr(buffer, NULL)
475                     || nl_msg_nlmsghdr(buffer)->nlmsg_type == NLMSG_DONE)));
476     if (retval) {
477         if (retval != EAGAIN) {
478             VLOG_WARN_RL(&rl, "brc_recv_update: %s", strerror(retval));
479         }
480         return retval;
481     }
482
483     genlmsghdr = nl_msg_genlmsghdr(buffer);
484     if (!genlmsghdr) {
485         VLOG_WARN_RL(&rl, "received packet too short for generic NetLink");
486         goto error;
487     }
488
489     if (nl_msg_nlmsghdr(buffer)->nlmsg_type != brc_family) {
490         VLOG_DBG_RL(&rl, "received type (%"PRIu16") != brcompat family (%d)",
491                 nl_msg_nlmsghdr(buffer)->nlmsg_type, brc_family);
492         goto error;
493     }
494
495     if (cfg_lock(NULL, lock_timeout)) {
496         /* Couldn't lock config file. */
497         retval = EAGAIN;
498         goto error;
499     }
500
501     switch (genlmsghdr->cmd) {
502     case BRC_GENL_C_DP_ADD:
503         retval = handle_bridge_cmd(buffer, true);
504         break;
505
506     case BRC_GENL_C_DP_DEL:
507         retval = handle_bridge_cmd(buffer, false);
508         break;
509
510     case BRC_GENL_C_PORT_ADD:
511         retval = handle_port_cmd(buffer, true);
512         break;
513
514     case BRC_GENL_C_PORT_DEL:
515         retval = handle_port_cmd(buffer, false);
516         break;
517
518     default:
519         retval = EPROTO;
520     }
521
522     cfg_unlock();
523
524 error:
525     ofpbuf_delete(buffer);
526     return retval;
527 }
528
529 /* Check for interface configuration changes announced through RTNL. */
530 static void
531 rtnl_recv_update(void)
532 {
533     struct ofpbuf *buf;
534
535     int error = nl_sock_recv(rtnl_sock, &buf, false);
536     if (error == EAGAIN) {
537         /* Nothing to do. */
538     } else if (error == ENOBUFS) {
539         VLOG_WARN_RL(&rl, "network monitor socket overflowed");
540     } else if (error) {
541         VLOG_WARN_RL(&rl, "error on network monitor socket: %s", 
542                 strerror(error));
543     } else {
544         struct nlattr *attrs[ARRAY_SIZE(rtnlgrp_link_policy)];
545         struct nlmsghdr *nlh;
546         struct ifinfomsg *iim;
547
548         nlh = ofpbuf_at(buf, 0, NLMSG_HDRLEN);
549         iim = ofpbuf_at(buf, NLMSG_HDRLEN, sizeof *iim);
550         if (!iim) {
551             VLOG_WARN_RL(&rl, "received bad rtnl message (no ifinfomsg)");
552             ofpbuf_delete(buf);
553             return;
554         } 
555     
556         if (!nl_policy_parse(buf, NLMSG_HDRLEN + sizeof(struct ifinfomsg),
557                              rtnlgrp_link_policy,
558                              attrs, ARRAY_SIZE(rtnlgrp_link_policy))) {
559             VLOG_WARN_RL(&rl,"received bad rtnl message (policy)");
560             ofpbuf_delete(buf);
561             return;
562         }
563         if (nlh->nlmsg_type == RTM_DELLINK && attrs[IFLA_MASTER]) {
564             const char *port_name = nl_attr_get_string(attrs[IFLA_IFNAME]);
565             char br_name[IFNAMSIZ];
566             uint32_t br_idx = nl_attr_get_u32(attrs[IFLA_MASTER]);
567             struct svec ports;
568
569             if (!if_indextoname(br_idx, br_name)) {
570                 ofpbuf_delete(buf);
571                 return;
572             }
573
574             if (cfg_lock(NULL, lock_timeout)) {
575                 /* Couldn't lock config file. */
576                 /* xxx this should try again and print error msg. */
577                 ofpbuf_delete(buf);
578                 return;
579             }
580
581             svec_init(&ports);
582             cfg_get_all_keys(&ports, "bridge.%s.port", br_name);
583             svec_sort(&ports);
584             if (svec_contains(&ports, port_name)) {
585                 del_port(br_name, port_name);
586                 rewrite_and_reload_config();
587             }
588             cfg_unlock();
589         }
590         ofpbuf_delete(buf);
591     }
592 }
593
594 int
595 main(int argc, char *argv[])
596 {
597     struct unixctl_server *unixctl;
598     int retval;
599
600     set_program_name(argv[0]);
601     register_fault_handlers();
602     time_init();
603     vlog_init();
604     parse_options(argc, argv);
605     signal(SIGPIPE, SIG_IGN);
606     process_init();
607
608     die_if_already_running();
609     daemonize();
610
611     retval = unixctl_server_create(NULL, &unixctl);
612     if (retval) {
613         ovs_fatal(retval, "could not listen for vlog connections");
614     }
615
616     if (brc_open(&brc_sock)) {
617         ovs_fatal(0, "could not open brcompat socket.  Check "
618                 "\"brcompat\" kernel module.");
619     }
620
621     if (prune_timeout) {
622         if (nl_sock_create(NETLINK_ROUTE, RTNLGRP_LINK, 0, 0, &rtnl_sock)) {
623             ovs_fatal(0, "could not create rtnetlink socket");
624         }
625     }
626
627     cfg_read();
628
629     for (;;) {
630         unixctl_server_run(unixctl);
631         brc_recv_update();
632
633         /* If 'prune_timeout' is non-zero, we actively prune from the
634          * config file any 'bridge.<br_name>.port' entries that are no 
635          * longer valid.  We use two methods: 
636          *
637          *   1) The kernel explicitly notifies us of removed ports
638          *      through the RTNL messages.
639          *
640          *   2) We periodically check all ports associated with bridges
641          *      to see if they no longer exist.
642          */
643         if (prune_timeout) {
644             rtnl_recv_update();
645             prune_ports();
646
647             nl_sock_wait(rtnl_sock, POLLIN);
648             poll_timer_wait(prune_timeout);
649         }
650
651         nl_sock_wait(brc_sock, POLLIN);
652         unixctl_server_wait(unixctl);
653         poll_block();
654     }
655
656     return 0;
657 }
658
659 static void
660 parse_options(int argc, char *argv[])
661 {
662     enum {
663         OPT_LOCK_TIMEOUT = UCHAR_MAX + 1,
664         OPT_PRUNE_TIMEOUT,
665         OPT_RELOAD_COMMAND,
666         VLOG_OPTION_ENUMS,
667         LEAK_CHECKER_OPTION_ENUMS
668     };
669     static struct option long_options[] = {
670         {"help",             no_argument, 0, 'h'},
671         {"version",          no_argument, 0, 'V'},
672         {"lock-timeout",     required_argument, 0, OPT_LOCK_TIMEOUT},
673         {"prune-timeout",    required_argument, 0, OPT_PRUNE_TIMEOUT},
674         {"reload-command",   required_argument, 0, OPT_RELOAD_COMMAND},
675         DAEMON_LONG_OPTIONS,
676         VLOG_LONG_OPTIONS,
677         LEAK_CHECKER_LONG_OPTIONS,
678         {0, 0, 0, 0},
679     };
680     char *short_options = long_options_to_short_options(long_options);
681     int error;
682
683     reload_command = xasprintf("%s/ovs-appctl -t "
684                                "%s/ovs-vswitchd.`cat %s/ovs-vswitchd.pid`.ctl "
685                                "-e vswitchd/reload 2>&1 "
686                                "| /usr/bin/logger -t brcompatd-reload",
687                                ovs_bindir, ovs_rundir, ovs_rundir);
688     for (;;) {
689         int c;
690
691         c = getopt_long(argc, argv, short_options, long_options, NULL);
692         if (c == -1) {
693             break;
694         }
695
696         switch (c) {
697         case 'H':
698         case 'h':
699             usage();
700
701         case 'V':
702             OVS_PRINT_VERSION(0, 0);
703             exit(EXIT_SUCCESS);
704
705         case OPT_LOCK_TIMEOUT:
706             lock_timeout = atoi(optarg);
707             break;
708
709         case OPT_PRUNE_TIMEOUT:
710             prune_timeout = atoi(optarg) * 1000;
711             break;
712
713         case OPT_RELOAD_COMMAND:
714             reload_command = optarg;
715             break;
716
717         VLOG_OPTION_HANDLERS
718         DAEMON_OPTION_HANDLERS
719         LEAK_CHECKER_OPTION_HANDLERS
720
721         case '?':
722             exit(EXIT_FAILURE);
723
724         default:
725             abort();
726         }
727     }
728     free(short_options);
729
730     argc -= optind;
731     argv += optind;
732
733     if (argc != 1) {
734         ovs_fatal(0, "exactly one non-option argument required; "
735                 "use --help for usage");
736     }
737
738     config_file = argv[0];
739     error = cfg_set_file(config_file);
740     if (error) {
741         ovs_fatal(error, "failed to add configuration file \"%s\"", 
742                 config_file);
743     }
744 }
745
746 static void
747 usage(void)
748 {
749     printf("%s: bridge compatibility front-end for ovs-vswitchd\n"
750            "usage: %s [OPTIONS] CONFIG\n"
751            "CONFIG is the configuration file used by ovs-vswitchd.\n",
752            program_name, program_name);
753     printf("\nConfiguration options:\n"
754            "  --reload-command=COMMAND  shell command to reload ovs-vswitchd\n"
755            "  --prune-timeout=SECS    wait at most SECS before pruning ports\n"
756            "  --lock-timeout=MSECS    wait at most MSECS for CONFIG to unlock\n"
757           );
758     daemon_usage();
759     vlog_usage();
760     printf("\nOther options:\n"
761            "  -h, --help              display this help message\n"
762            "  -V, --version           display version information\n");
763     leak_checker_usage();
764     printf("\nThe default reload command is:\n%s\n", reload_command);
765     exit(EXIT_SUCCESS);
766 }