2 * Copyright (c) 2009, 2010 Nicira Networks.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include "rtnetlink-link.h"
21 #include <sys/socket.h>
22 #include <linux/rtnetlink.h>
27 #include "rtnetlink.h"
29 static struct rtnetlink *rtn = NULL;
30 static struct rtnetlink_link_change rtn_change;
32 /* Parses a rtnetlink message 'buf' into 'change'. If 'buf' is unparseable,
33 * leaves 'change' untouched and returns false. Otherwise, populates 'change'
34 * and returns true. */
36 rtnetlink_link_parse(struct ofpbuf *buf,
37 struct rtnetlink_link_change *change)
41 /* Policy for RTNLGRP_LINK messages.
43 * There are *many* more fields in these messages, but currently we
44 * only care about these fields. */
45 static const struct nl_policy policy[] = {
46 [IFLA_IFNAME] = { .type = NL_A_STRING, .optional = false },
47 [IFLA_MASTER] = { .type = NL_A_U32, .optional = true },
50 static struct nlattr *attrs[ARRAY_SIZE(policy)];
52 parsed = nl_policy_parse(buf, NLMSG_HDRLEN + sizeof(struct ifinfomsg),
53 policy, attrs, ARRAY_SIZE(policy));
56 const struct nlmsghdr *nlmsg;
57 const struct ifinfomsg *ifinfo;
60 ifinfo = ((const struct ifinfomsg *)
61 ((const char *) buf->data + NLMSG_HDRLEN));
63 change->nlmsg_type = nlmsg->nlmsg_type;
64 change->ifi_index = ifinfo->ifi_index;
65 change->ifname = nl_attr_get_string(attrs[IFLA_IFNAME]);
66 change->master_ifindex = (attrs[IFLA_MASTER]
67 ? nl_attr_get_u32(attrs[IFLA_MASTER])
74 /* Registers 'cb' to be called with auxiliary data 'aux' with network device
75 * change notifications. The notifier is stored in 'notifier', which the
76 * caller must not modify or free.
78 * This is probably not the function that you want. You should probably be
79 * using dpif_port_poll() or netdev_monitor_create(), which unlike this
80 * function are not Linux-specific.
82 * Returns 0 if successful, otherwise a positive errno value. */
84 rtnetlink_link_notifier_register(struct rtnetlink_notifier *notifier,
85 rtnetlink_link_notify_func *cb, void *aux)
87 rtnetlink_parse_func *pf = (rtnetlink_parse_func *) rtnetlink_link_parse;
88 rtnetlink_notify_func *nf = (rtnetlink_notify_func *) cb;
91 rtn = rtnetlink_create(RTNLGRP_LINK, pf, &rtn_change);
94 return rtnetlink_notifier_register(rtn, notifier, nf, aux);
97 /* Cancels notification on 'notifier', which must have previously been
98 * registered with rtnetlink_link_notifier_register(). */
100 rtnetlink_link_notifier_unregister(struct rtnetlink_notifier *notifier)
102 rtnetlink_notifier_unregister(rtn, notifier);
105 /* Calls all of the registered notifiers, passing along any as-yet-unreported
106 * netdev change events. */
108 rtnetlink_link_notifier_run(void)
111 rtnetlink_notifier_run(rtn);
115 /* Causes poll_block() to wake up when network device change notifications are
118 rtnetlink_link_notifier_wait(void)
121 rtnetlink_notifier_wait(rtn);