]>
git.proxmox.com Git - mirror_ovs.git/blob - lib/netlink-notifier.c
2 * Copyright (c) 2009, 2010, 2011, 2012, 2013, 2016 Nicira, Inc.
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 "netlink-notifier.h"
27 #include "netlink-socket.h"
28 #include "openvswitch/ofpbuf.h"
29 #include "openvswitch/vlog.h"
31 VLOG_DEFINE_THIS_MODULE(netlink_notifier
);
33 COVERAGE_DEFINE(nln_changed
);
36 struct nl_sock
*notify_sock
; /* Netlink socket. */
37 struct ovs_list all_notifiers
; /* All nln notifiers. */
38 bool has_run
; /* Guard for run and wait functions. */
40 /* Passed in by nln_create(). */
41 int protocol
; /* Protocol passed to nl_sock_create(). */
42 nln_parse_func
*parse
; /* Message parsing function. */
43 void *change
; /* Change passed to parse. */
47 struct ovs_list node
; /* In struct nln's 'all_notifiers' list. */
48 struct nln
*nln
; /* Parent nln. */
50 int multicast_group
; /* Multicast group we listen on. */
55 /* Creates an nln handle which may be used to manage change notifications. The
56 * created handle will listen for netlink messages on 'multicast_group' using
57 * netlink protocol 'protocol' (e.g. NETLINK_ROUTE, NETLINK_GENERIC, ...).
58 * Incoming messages will be parsed with 'parse' which will be passed 'change'
61 nln_create(int protocol
, nln_parse_func
*parse
, void *change
)
65 nln
= xzalloc(sizeof *nln
);
66 nln
->notify_sock
= NULL
;
67 nln
->protocol
= protocol
;
72 ovs_list_init(&nln
->all_notifiers
);
76 /* Destroys 'nln' by freeing any memory it has reserved and closing any sockets
79 * The caller is responsible for destroying any notifiers created by this
80 * 'nln' before destroying 'nln'. */
82 nln_destroy(struct nln
*nln
)
85 ovs_assert(ovs_list_is_empty(&nln
->all_notifiers
));
86 nl_sock_destroy(nln
->notify_sock
);
91 /* Registers 'cb' to be called with auxiliary data 'aux' with change
92 * notifications. The notifier is stored in 'notifier', which the caller must
95 * This is probably not the function you want. You should probably be using
96 * message specific notifiers like rtnetlink_link_notifier_register().
98 * Returns an initialized nln_notifier if successful, otherwise NULL. */
100 nln_notifier_create(struct nln
*nln
, int multicast_group
, nln_notify_func
*cb
,
103 struct nln_notifier
*notifier
;
106 if (!nln
->notify_sock
) {
107 struct nl_sock
*sock
;
109 error
= nl_sock_create(nln
->protocol
, &sock
);
111 VLOG_WARN("could not create netlink socket: %s",
112 ovs_strerror(error
));
115 nln
->notify_sock
= sock
;
117 /* Catch up on notification work so that the new notifier won't
118 * receive any stale notifications. */
122 error
= nl_sock_join_mcgroup(nln
->notify_sock
, multicast_group
);
124 VLOG_WARN("could not join netlink multicast group: %s",
125 ovs_strerror(error
));
129 notifier
= xmalloc(sizeof *notifier
);
130 notifier
->multicast_group
= multicast_group
;
135 ovs_list_push_back(&nln
->all_notifiers
, ¬ifier
->node
);
140 /* Destroys 'notifier', which must have previously been created with
141 * nln_notifier_register(). */
143 nln_notifier_destroy(struct nln_notifier
*notifier
)
146 struct nln
*nln
= notifier
->nln
;
147 struct nln_notifier
*iter
;
150 ovs_list_remove(¬ifier
->node
);
152 /* Leave the group if no other notifier is interested in it. */
153 LIST_FOR_EACH (iter
, node
, &nln
->all_notifiers
) {
154 if (iter
->multicast_group
== notifier
->multicast_group
) {
159 nl_sock_leave_mcgroup(nln
->notify_sock
, notifier
->multicast_group
);
162 if (ovs_list_is_empty(&nln
->all_notifiers
)) {
163 nl_sock_destroy(nln
->notify_sock
);
164 nln
->notify_sock
= NULL
;
170 /* Calls all of the registered notifiers, passing along any as-yet-unreported
173 nln_run(struct nln
*nln
)
175 static struct vlog_rate_limit rl
= VLOG_RATE_LIMIT_INIT(1, 5);
177 if (!nln
->notify_sock
|| nln
->has_run
) {
183 uint64_t buf_stub
[4096 / 8];
187 ofpbuf_use_stub(&buf
, buf_stub
, sizeof buf_stub
);
188 error
= nl_sock_recv(nln
->notify_sock
, &buf
, NULL
, false);
190 int group
= nln
->parse(&buf
, nln
->change
);
193 nln_report(nln
, nln
->change
, group
);
195 VLOG_WARN_RL(&rl
, "unexpected netlink message contents");
196 nln_report(nln
, NULL
, 0);
199 } else if (error
== EAGAIN
) {
202 if (error
== ENOBUFS
) {
203 /* The socket buffer might be full, there could be too many
204 * notifications, so it makes sense to call nln_report() */
205 nln_report(nln
, NULL
, 0);
206 VLOG_WARN_RL(&rl
, "netlink receive buffer overflowed");
208 VLOG_WARN_RL(&rl
, "error reading netlink socket: %s",
209 ovs_strerror(error
));
216 /* Causes poll_block() to wake up when change notifications are ready. */
218 nln_wait(struct nln
*nln
)
220 nln
->has_run
= false;
221 if (nln
->notify_sock
) {
222 nl_sock_wait(nln
->notify_sock
, POLLIN
);
227 nln_report(const struct nln
*nln
, void *change
, int group
)
229 struct nln_notifier
*notifier
;
232 COVERAGE_INC(nln_changed
);
235 LIST_FOR_EACH (notifier
, node
, &nln
->all_notifiers
) {
236 if (!change
|| group
== notifier
->multicast_group
) {
237 notifier
->cb(change
, notifier
->aux
);