Commit 01fd12bb authored by Jon Paul Maloy's avatar Jon Paul Maloy Committed by David S. Miller
Browse files

tipc: make replicast a user selectable option 



If the bearer carrying multicast messages supports broadcast, those
messages will be sent to all cluster nodes, irrespective of whether
these nodes host any actual destinations socket or not. This is clearly
wasteful if the cluster is large and there are only a few real
destinations for the message being sent.

In this commit we extend the eligibility of the newly introduced
"replicast" transmit option. We now make it possible for a user to
select which method he wants to be used, either as a mandatory setting
via setsockopt(), or as a relative setting where we let the broadcast
layer decide which method to use based on the ratio between cluster
size and the message's actual number of destination nodes.

In the latter case, a sending socket must stick to a previously
selected method until it enters an idle period of at least 5 seconds.
This eliminates the risk of message reordering caused by method change,
i.e., when changes to cluster size or number of destinations would
otherwise mandate a new method to be used.

Reviewed-by: default avatarParthasarathy Bhuvaragan <parthasarathy.bhuvaragan@ericsson.com>
Acked-by: default avatarYing Xue <ying.xue@windriver.com>
Signed-off-by: default avatarJon Maloy <jon.maloy@ericsson.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent a853e4c6

include/uapi/linux/tipc.h

+4 −2
Original line number Diff line number Diff line 
/*

 * include/uapi/linux/tipc.h: Header for TIPC socket interface

 *

 * Copyright (c) 2003-2006, Ericsson AB

 * Copyright (c) 2003-2006, 2015-2016 Ericsson AB

 * Copyright (c) 2005, 2010-2011, Wind River Systems

 * All rights reserved.

 *
@@ -220,7 +220,7 @@ struct sockaddr_tipc { 
#define TIPC_DESTNAME	3	/* destination name */



/*

 * TIPC-specific socket option values

 * TIPC-specific socket option names

 */



#define TIPC_IMPORTANCE		127	/* Default: TIPC_LOW_IMPORTANCE */
@@ -229,6 +229,8 @@ struct sockaddr_tipc { 
#define TIPC_CONN_TIMEOUT	130	/* Default: 8000 (ms)  */

#define TIPC_NODE_RECVQ_DEPTH	131	/* Default: none (read only) */

#define TIPC_SOCK_RECVQ_DEPTH	132	/* Default: none (read only) */

#define TIPC_MCAST_BROADCAST    133     /* Default: TIPC selects. No arg */

#define TIPC_MCAST_REPLICAST    134     /* Default: TIPC selects. No arg */



/*

 * Maximum sizes of TIPC bearer-related names (including terminating NULL)

net/tipc/bcast.c

+56 −6
Original line number Diff line number Diff line
@@ -54,6 +54,9 @@ const char tipc_bclink_name[] = "broadcast-link"; 
 * @dest: array keeping number of reachable destinations per bearer

 * @primary_bearer: a bearer having links to all broadcast destinations, if any

 * @bcast_support: indicates if primary bearer, if any, supports broadcast

 * @rcast_support: indicates if all peer nodes support replicast

 * @rc_ratio: dest count as percentage of cluster size where send method changes

 * @bc_threshold: calculated drom rc_ratio; if dests > threshold use broadcast

 */

struct tipc_bc_base {

	struct tipc_link *link;
@@ -61,6 +64,9 @@ struct tipc_bc_base { 
	int dests[MAX_BEARERS];

	int primary_bearer;

	bool bcast_support;

	bool rcast_support;

	int rc_ratio;

	int bc_threshold;

};



static struct tipc_bc_base *tipc_bc_base(struct net *net)
@@ -73,6 +79,19 @@ int tipc_bcast_get_mtu(struct net *net) 
	return tipc_link_mtu(tipc_bc_sndlink(net)) - INT_H_SIZE;

}



void tipc_bcast_disable_rcast(struct net *net)

{

	tipc_bc_base(net)->rcast_support = false;

}



static void tipc_bcbase_calc_bc_threshold(struct net *net)

{

	struct tipc_bc_base *bb = tipc_bc_base(net);

	int cluster_size = tipc_link_bc_peers(tipc_bc_sndlink(net));



	bb->bc_threshold = 1 + (cluster_size * bb->rc_ratio / 100);

}



/* tipc_bcbase_select_primary(): find a bearer with links to all destinations,

 *                               if any, and make it primary bearer

 */
@@ -175,6 +194,31 @@ static void tipc_bcbase_xmit(struct net *net, struct sk_buff_head *xmitq) 
	__skb_queue_purge(&_xmitq);

}



static void tipc_bcast_select_xmit_method(struct net *net, int dests,

					  struct tipc_mc_method *method)

{

	struct tipc_bc_base *bb = tipc_bc_base(net);

	unsigned long exp = method->expires;



	/* Broadcast supported by used bearer/bearers? */

	if (!bb->bcast_support) {

		method->rcast = true;

		return;

	}

	/* Any destinations which don't support replicast ? */

	if (!bb->rcast_support) {

		method->rcast = false;

		return;

	}

	/* Can current method be changed ? */

	method->expires = jiffies + TIPC_METHOD_EXPIRE;

	if (method->mandatory || time_before(jiffies, exp))

		return;



	/* Determine method to use now */

	method->rcast = dests <= bb->bc_threshold;

}



/* tipc_bcast_xmit - broadcast the buffer chain to all external nodes

 * @net: the applicable net namespace

 * @pkts: chain of buffers containing message
@@ -237,16 +281,16 @@ static int tipc_rcast_xmit(struct net *net, struct sk_buff_head *pkts, 
 *                   and to identified node local sockets

 * @net: the applicable net namespace

 * @pkts: chain of buffers containing message

 * @dests: destination nodes for message. Not consumed.

 * @method: send method to be used

 * @dests: destination nodes for message.

 * @cong_link_cnt: returns number of encountered congested destination links

 * @cong_links: returns identities of congested links

 * Consumes buffer chain.

 * Returns 0 if success, otherwise errno

 */

int tipc_mcast_xmit(struct net *net, struct sk_buff_head *pkts,

		    struct tipc_nlist *dests, u16 *cong_link_cnt)

		    struct tipc_mc_method *method, struct tipc_nlist *dests,

		    u16 *cong_link_cnt)

{

	struct tipc_bc_base *bb = tipc_bc_base(net);

	struct sk_buff_head inputq, localq;

	int rc = 0;
@@ -258,9 +302,10 @@ int tipc_mcast_xmit(struct net *net, struct sk_buff_head *pkts, 
		rc = -ENOMEM;

		goto exit;

	}



	/* Send according to determined transmit method */

	if (dests->remote) {

		if (!bb->bcast_support)

		tipc_bcast_select_xmit_method(net, dests->remote, method);

		if (method->rcast)

			rc = tipc_rcast_xmit(net, pkts, dests, cong_link_cnt);

		else

			rc = tipc_bcast_xmit(net, pkts, cong_link_cnt);
@@ -269,6 +314,7 @@ int tipc_mcast_xmit(struct net *net, struct sk_buff_head *pkts, 
	if (dests->local)

		tipc_sk_mcast_rcv(net, &localq, &inputq);

exit:

	/* This queue should normally be empty by now */

	__skb_queue_purge(pkts);

	return rc;

}
@@ -377,6 +423,7 @@ void tipc_bcast_add_peer(struct net *net, struct tipc_link *uc_l, 
	tipc_bcast_lock(net);

	tipc_link_add_bc_peer(snd_l, uc_l, xmitq);

	tipc_bcbase_select_primary(net);

	tipc_bcbase_calc_bc_threshold(net);

	tipc_bcast_unlock(net);

}
@@ -395,6 +442,7 @@ void tipc_bcast_remove_peer(struct net *net, struct tipc_link *rcv_l) 
	tipc_bcast_lock(net);

	tipc_link_remove_bc_peer(snd_l, rcv_l, &xmitq);

	tipc_bcbase_select_primary(net);

	tipc_bcbase_calc_bc_threshold(net);

	tipc_bcast_unlock(net);



	tipc_bcbase_xmit(net, &xmitq);
@@ -477,6 +525,8 @@ int tipc_bcast_init(struct net *net) 
		goto enomem;

	bb->link = l;

	tn->bcl = l;

	bb->rc_ratio = 25;

	bb->rcast_support = true;

	return 0;

enomem:

	kfree(bb);

net/tipc/bcast.h

+16 −1
Original line number Diff line number Diff line
@@ -46,6 +46,8 @@ struct tipc_nlist; 
struct tipc_nitem;

extern const char tipc_bclink_name[];



#define TIPC_METHOD_EXPIRE msecs_to_jiffies(5000)



struct tipc_nlist {

	struct list_head list;

	u32 self;
@@ -58,6 +60,17 @@ void tipc_nlist_purge(struct tipc_nlist *nl); 
void tipc_nlist_add(struct tipc_nlist *nl, u32 node);

void tipc_nlist_del(struct tipc_nlist *nl, u32 node);



/* Cookie to be used between socket and broadcast layer

 * @rcast: replicast (instead of broadcast) was used at previous xmit

 * @mandatory: broadcast/replicast indication was set by user

 * @expires: re-evaluate non-mandatory transmit method if we are past this

 */

struct tipc_mc_method {

	bool rcast;

	bool mandatory;

	unsigned long expires;

};



int tipc_bcast_init(struct net *net);

void tipc_bcast_stop(struct net *net);

void tipc_bcast_add_peer(struct net *net, struct tipc_link *l,
@@ -66,8 +79,10 @@ void tipc_bcast_remove_peer(struct net *net, struct tipc_link *rcv_bcl); 
void tipc_bcast_inc_bearer_dst_cnt(struct net *net, int bearer_id);

void tipc_bcast_dec_bearer_dst_cnt(struct net *net, int bearer_id);

int  tipc_bcast_get_mtu(struct net *net);

void tipc_bcast_disable_rcast(struct net *net);

int tipc_mcast_xmit(struct net *net, struct sk_buff_head *pkts,

		    struct tipc_nlist *dests, u16 *cong_link_cnt);

		    struct tipc_mc_method *method, struct tipc_nlist *dests,

		    u16 *cong_link_cnt);

int tipc_bcast_rcv(struct net *net, struct tipc_link *l, struct sk_buff *skb);

void tipc_bcast_ack_rcv(struct net *net, struct tipc_link *l,

			struct tipc_msg *hdr);

net/tipc/link.c

+4 −0
Original line number Diff line number Diff line
@@ -515,6 +515,10 @@ bool tipc_link_bc_create(struct net *net, u32 ownnode, u32 peer, 
	if (link_is_bc_sndlink(l))

		l->state = LINK_ESTABLISHED;



	/* Disable replicast if even a single peer doesn't support it */

	if (link_is_bc_rcvlink(l) && !(peer_caps & TIPC_BCAST_RCAST))

		tipc_bcast_disable_rcast(net);



	return true;

}

net/tipc/node.h

+3 −1
Original line number Diff line number Diff line
@@ -47,11 +47,13 @@ 
enum {

	TIPC_BCAST_SYNCH      = (1 << 1),

	TIPC_BCAST_STATE_NACK = (1 << 2),

	TIPC_BLOCK_FLOWCTL    = (1 << 3)

	TIPC_BLOCK_FLOWCTL    = (1 << 3),

	TIPC_BCAST_RCAST      = (1 << 4)

};



#define TIPC_NODE_CAPABILITIES (TIPC_BCAST_SYNCH | \

				TIPC_BCAST_STATE_NACK | \

				TIPC_BCAST_RCAST | \

				TIPC_BLOCK_FLOWCTL)

#define INVALID_BEARER_ID -1

CRA Git | Maintained and supported by SUSTech CRA and CCSE