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