2 * net/tipc/subscr.c: TIPC subscription service
4 * Copyright (c) 2000-2006, Ericsson AB
5 * Copyright (c) 2005, Wind River Systems
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are met:
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the names of the copyright holders nor the names of its
17 * contributors may be used to endorse or promote products derived from
18 * this software without specific prior written permission.
20 * Alternatively, this software may be distributed under the terms of the
21 * GNU General Public License ("GPL") version 2 as published by the Free
22 * Software Foundation.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
28 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 * POSSIBILITY OF SUCH DAMAGE.
40 #include "name_table.h"
44 * struct subscriber - TIPC network topology subscriber
45 * @ref: object reference to subscriber object itself
46 * @lock: pointer to spinlock controlling access to subscriber object
47 * @subscriber_list: adjacent subscribers in top. server's list of subscribers
48 * @subscription_list: list of subscription objects for this subscriber
49 * @port_ref: object reference to port used to communicate with subscriber
50 * @swap: indicates if subscriber uses opposite endianness in its messages
56 struct list_head subscriber_list;
57 struct list_head subscription_list;
63 * struct top_srv - TIPC network topology subscription service
64 * @user_ref: TIPC userid of subscription service
65 * @setup_port: reference to TIPC port that handles subscription requests
66 * @subscription_count: number of active subscriptions (not subscribers!)
67 * @subscriber_list: list of ports subscribing to service
68 * @lock: spinlock govering access to subscriber list
74 atomic_t subscription_count;
75 struct list_head subscriber_list;
79 static struct top_srv topsrv = { 0 };
82 * htohl - convert value to endianness used by destination
83 * @in: value to convert
84 * @swap: non-zero if endianness must be reversed
86 * Returns converted value
89 static u32 htohl(u32 in, int swap)
91 char *c = (char *)∈
93 return swap ? ((c[3] << 3) + (c[2] << 2) + (c[1] << 1) + c[0]) : in;
97 * subscr_send_event - send a message containing a tipc_event to the subscriber
100 static void subscr_send_event(struct subscription *sub,
107 struct iovec msg_sect;
109 msg_sect.iov_base = (void *)&sub->evt;
110 msg_sect.iov_len = sizeof(struct tipc_event);
112 sub->evt.event = htohl(event, sub->owner->swap);
113 sub->evt.found_lower = htohl(found_lower, sub->owner->swap);
114 sub->evt.found_upper = htohl(found_upper, sub->owner->swap);
115 sub->evt.port.ref = htohl(port_ref, sub->owner->swap);
116 sub->evt.port.node = htohl(node, sub->owner->swap);
117 tipc_send(sub->owner->port_ref, 1, &msg_sect);
121 * tipc_subscr_overlap - test for subscription overlap with the given values
123 * Returns 1 if there is overlap, otherwise 0.
126 int tipc_subscr_overlap(struct subscription *sub,
131 if (found_lower < sub->seq.lower)
132 found_lower = sub->seq.lower;
133 if (found_upper > sub->seq.upper)
134 found_upper = sub->seq.upper;
135 if (found_lower > found_upper)
141 * tipc_subscr_report_overlap - issue event if there is subscription overlap
143 * Protected by nameseq.lock in name_table.c
146 void tipc_subscr_report_overlap(struct subscription *sub,
154 dbg("Rep overlap %u:%u,%u<->%u,%u\n", sub->seq.type, sub->seq.lower,
155 sub->seq.upper, found_lower, found_upper);
156 if (!tipc_subscr_overlap(sub, found_lower, found_upper))
158 if (!must && (sub->filter != TIPC_SUB_PORTS))
160 subscr_send_event(sub, found_lower, found_upper, event, port_ref, node);
164 * subscr_timeout - subscription timeout has occurred
167 static void subscr_timeout(struct subscription *sub)
169 struct subscriber *subscriber;
172 /* Validate subscriber reference (in case subscriber is terminating) */
174 subscriber_ref = sub->owner->ref;
175 subscriber = (struct subscriber *)tipc_ref_lock(subscriber_ref);
176 if (subscriber == NULL)
179 /* Unlink subscription from name table */
181 tipc_nametbl_unsubscribe(sub);
183 /* Notify subscriber of timeout, then unlink subscription */
185 subscr_send_event(sub,
186 sub->evt.s.seq.lower,
187 sub->evt.s.seq.upper,
191 list_del(&sub->subscription_list);
193 /* Now destroy subscription */
195 tipc_ref_unlock(subscriber_ref);
196 k_term_timer(&sub->timer);
198 atomic_dec(&topsrv.subscription_count);
202 * subscr_terminate - terminate communication with a subscriber
204 * Called with subscriber locked. Routine must temporarily release this lock
205 * to enable subscription timeout routine(s) to finish without deadlocking;
206 * the lock is then reclaimed to allow caller to release it upon return.
207 * (This should work even in the unlikely event some other thread creates
208 * a new object reference in the interim that uses this lock; this routine will
209 * simply wait for it to be released, then claim it.)
212 static void subscr_terminate(struct subscriber *subscriber)
214 struct subscription *sub;
215 struct subscription *sub_temp;
217 /* Invalidate subscriber reference */
219 tipc_ref_discard(subscriber->ref);
220 spin_unlock_bh(subscriber->lock);
222 /* Destroy any existing subscriptions for subscriber */
224 list_for_each_entry_safe(sub, sub_temp, &subscriber->subscription_list,
226 if (sub->timeout != TIPC_WAIT_FOREVER) {
227 k_cancel_timer(&sub->timer);
228 k_term_timer(&sub->timer);
230 tipc_nametbl_unsubscribe(sub);
231 list_del(&sub->subscription_list);
232 dbg("Term: Removed sub %u,%u,%u from subscriber %x list\n",
233 sub->seq.type, sub->seq.lower, sub->seq.upper, subscriber);
235 atomic_dec(&topsrv.subscription_count);
238 /* Sever connection to subscriber */
240 tipc_shutdown(subscriber->port_ref);
241 tipc_deleteport(subscriber->port_ref);
243 /* Remove subscriber from topology server's subscriber list */
245 spin_lock_bh(&topsrv.lock);
246 list_del(&subscriber->subscriber_list);
247 spin_unlock_bh(&topsrv.lock);
249 /* Now destroy subscriber */
251 spin_lock_bh(subscriber->lock);
256 * subscr_subscribe - create subscription for subscriber
258 * Called with subscriber locked
261 static void subscr_subscribe(struct tipc_subscr *s,
262 struct subscriber *subscriber)
264 struct subscription *sub;
266 /* Refuse subscription if global limit exceeded */
268 if (atomic_read(&topsrv.subscription_count) >= tipc_max_subscriptions) {
269 warn("Subscription rejected, subscription limit reached (%u)\n",
270 tipc_max_subscriptions);
271 subscr_terminate(subscriber);
275 /* Allocate subscription object */
277 sub = kmalloc(sizeof(*sub), GFP_ATOMIC);
279 warn("Subscription rejected, no memory\n");
280 subscr_terminate(subscriber);
284 /* Determine/update subscriber's endianness */
286 if ((s->filter == TIPC_SUB_PORTS) || (s->filter == TIPC_SUB_SERVICE))
287 subscriber->swap = 0;
289 subscriber->swap = 1;
291 /* Initialize subscription object */
293 memset(sub, 0, sizeof(*sub));
294 sub->seq.type = htohl(s->seq.type, subscriber->swap);
295 sub->seq.lower = htohl(s->seq.lower, subscriber->swap);
296 sub->seq.upper = htohl(s->seq.upper, subscriber->swap);
297 sub->timeout = htohl(s->timeout, subscriber->swap);
298 sub->filter = htohl(s->filter, subscriber->swap);
299 if ((((sub->filter != TIPC_SUB_PORTS)
300 && (sub->filter != TIPC_SUB_SERVICE)))
301 || (sub->seq.lower > sub->seq.upper)) {
302 warn("Subscription rejected, illegal request\n");
304 subscr_terminate(subscriber);
307 memcpy(&sub->evt.s, s, sizeof(struct tipc_subscr));
308 INIT_LIST_HEAD(&sub->subscription_list);
309 INIT_LIST_HEAD(&sub->nameseq_list);
310 list_add(&sub->subscription_list, &subscriber->subscription_list);
311 atomic_inc(&topsrv.subscription_count);
312 if (sub->timeout != TIPC_WAIT_FOREVER) {
313 k_init_timer(&sub->timer,
314 (Handler)subscr_timeout, (unsigned long)sub);
315 k_start_timer(&sub->timer, sub->timeout);
317 sub->owner = subscriber;
318 tipc_nametbl_subscribe(sub);
322 * subscr_conn_shutdown_event - handle termination request from subscriber
325 static void subscr_conn_shutdown_event(void *usr_handle,
327 struct sk_buff **buf,
328 unsigned char const *data,
332 struct subscriber *subscriber;
333 spinlock_t *subscriber_lock;
335 subscriber = tipc_ref_lock((u32)(unsigned long)usr_handle);
336 if (subscriber == NULL)
339 subscriber_lock = subscriber->lock;
340 subscr_terminate(subscriber);
341 spin_unlock_bh(subscriber_lock);
345 * subscr_conn_msg_event - handle new subscription request from subscriber
348 static void subscr_conn_msg_event(void *usr_handle,
350 struct sk_buff **buf,
354 struct subscriber *subscriber;
355 spinlock_t *subscriber_lock;
357 subscriber = tipc_ref_lock((u32)(unsigned long)usr_handle);
358 if (subscriber == NULL)
361 subscriber_lock = subscriber->lock;
362 if (size != sizeof(struct tipc_subscr))
363 subscr_terminate(subscriber);
365 subscr_subscribe((struct tipc_subscr *)data, subscriber);
367 spin_unlock_bh(subscriber_lock);
371 * subscr_named_msg_event - handle request to establish a new subscriber
374 static void subscr_named_msg_event(void *usr_handle,
376 struct sk_buff **buf,
380 struct tipc_portid const *orig,
381 struct tipc_name_seq const *dest)
383 struct subscriber *subscriber;
384 struct iovec msg_sect = {NULL, 0};
385 spinlock_t *subscriber_lock;
387 dbg("subscr_named_msg_event: orig = %x own = %x,\n",
388 orig->node, tipc_own_addr);
389 if (size && (size != sizeof(struct tipc_subscr))) {
390 warn("Subscriber rejected, invalid subscription size\n");
394 /* Create subscriber object */
396 subscriber = kzalloc(sizeof(struct subscriber), GFP_ATOMIC);
397 if (subscriber == NULL) {
398 warn("Subscriber rejected, no memory\n");
401 INIT_LIST_HEAD(&subscriber->subscription_list);
402 INIT_LIST_HEAD(&subscriber->subscriber_list);
403 subscriber->ref = tipc_ref_acquire(subscriber, &subscriber->lock);
404 if (subscriber->ref == 0) {
405 warn("Subscriber rejected, reference table exhausted\n");
410 /* Establish a connection to subscriber */
412 tipc_createport(topsrv.user_ref,
413 (void *)(unsigned long)subscriber->ref,
417 subscr_conn_shutdown_event,
420 subscr_conn_msg_event,
422 &subscriber->port_ref);
423 if (subscriber->port_ref == 0) {
424 warn("Subscriber rejected, unable to create port\n");
425 tipc_ref_discard(subscriber->ref);
429 tipc_connect2port(subscriber->port_ref, orig);
432 /* Add subscriber to topology server's subscriber list */
434 tipc_ref_lock(subscriber->ref);
435 spin_lock_bh(&topsrv.lock);
436 list_add(&subscriber->subscriber_list, &topsrv.subscriber_list);
437 spin_unlock_bh(&topsrv.lock);
440 * Subscribe now if message contains a subscription,
441 * otherwise send an empty response to complete connection handshaking
444 subscriber_lock = subscriber->lock;
446 subscr_subscribe((struct tipc_subscr *)data, subscriber);
448 tipc_send(subscriber->port_ref, 1, &msg_sect);
450 spin_unlock_bh(subscriber_lock);
453 int tipc_subscr_start(void)
455 struct tipc_name_seq seq = {TIPC_TOP_SRV, TIPC_TOP_SRV, TIPC_TOP_SRV};
458 memset(&topsrv, 0, sizeof (topsrv));
459 spin_lock_init(&topsrv.lock);
460 INIT_LIST_HEAD(&topsrv.subscriber_list);
462 spin_lock_bh(&topsrv.lock);
463 res = tipc_attach(&topsrv.user_ref, NULL, NULL);
465 spin_unlock_bh(&topsrv.lock);
469 res = tipc_createport(topsrv.user_ref,
471 TIPC_CRITICAL_IMPORTANCE,
476 subscr_named_msg_event,
483 res = tipc_nametbl_publish_rsv(topsrv.setup_port, TIPC_NODE_SCOPE, &seq);
487 spin_unlock_bh(&topsrv.lock);
491 err("Failed to create subscription service\n");
492 tipc_detach(topsrv.user_ref);
494 spin_unlock_bh(&topsrv.lock);
498 void tipc_subscr_stop(void)
500 struct subscriber *subscriber;
501 struct subscriber *subscriber_temp;
502 spinlock_t *subscriber_lock;
504 if (topsrv.user_ref) {
505 tipc_deleteport(topsrv.setup_port);
506 list_for_each_entry_safe(subscriber, subscriber_temp,
507 &topsrv.subscriber_list,
509 tipc_ref_lock(subscriber->ref);
510 subscriber_lock = subscriber->lock;
511 subscr_terminate(subscriber);
512 spin_unlock_bh(subscriber_lock);
514 tipc_detach(topsrv.user_ref);
520 int tipc_ispublished(struct tipc_name const *name)
524 return(tipc_nametbl_translate(name->type, name->instance,&domain) != 0);