[mirror_ubuntu-zesty-kernel.git] / net / tipc / bearer.h

/*
 * net/tipc/bearer.h: Include file for TIPC bearer code
 *
 * Copyright (c) 1996-2006, 2013-2016, Ericsson AB
 * Copyright (c) 2005, 2010-2011, Wind River Systems
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the names of the copyright holders nor the names of its
 *    contributors may be used to endorse or promote products derived from
 *    this software without specific prior written permission.
 *
 * Alternatively, this software may be distributed under the terms of the
 * GNU General Public License ("GPL") version 2 as published by the Free
 * Software Foundation.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _TIPC_BEARER_H
#define _TIPC_BEARER_H

#include "netlink.h"
#include "core.h"
#include "msg.h"
#include <net/genetlink.h>

#define MAX_MEDIA	3

/* Identifiers associated with TIPC message header media address info
 * - address info field is 32 bytes long
 * - the field's actual content and length is defined per media
 * - remaining unused bytes in the field are set to zero
 */
#define TIPC_MEDIA_INFO_SIZE	32
#define TIPC_MEDIA_TYPE_OFFSET	3
#define TIPC_MEDIA_ADDR_OFFSET	4

/*
 * Identifiers of supported TIPC media types
 */
#define TIPC_MEDIA_TYPE_ETH	1
#define TIPC_MEDIA_TYPE_IB	2
#define TIPC_MEDIA_TYPE_UDP	3

/* minimum bearer MTU */
#define TIPC_MIN_BEARER_MTU	(MAX_H_SIZE + INT_H_SIZE)

/**
 * struct tipc_media_addr - destination address used by TIPC bearers
 * @value: address info (format defined by media)
 * @media_id: TIPC media type identifier
 * @broadcast: non-zero if address is a broadcast address
 */
struct tipc_media_addr {
	u8 value[TIPC_MEDIA_INFO_SIZE];
	u8 media_id;
	u8 broadcast;
};

struct tipc_bearer;

/**
 * struct tipc_media - Media specific info exposed to generic bearer layer
 * @send_msg: routine which handles buffer transmission
 * @enable_media: routine which enables a media
 * @disable_media: routine which disables a media
 * @addr2str: convert media address format to string
 * @addr2msg: convert from media addr format to discovery msg addr format
 * @msg2addr: convert from discovery msg addr format to media addr format
 * @raw2addr: convert from raw addr format to media addr format
 * @priority: default link (and bearer) priority
 * @tolerance: default time (in ms) before declaring link failure
 * @window: default window (in packets) before declaring link congestion
 * @type_id: TIPC media identifier
 * @hwaddr_len: TIPC media address len
 * @name: media name
 */
struct tipc_media {
	int (*send_msg)(struct net *net, struct sk_buff *buf,
			struct tipc_bearer *b,
			struct tipc_media_addr *dest);
	int (*enable_media)(struct net *net, struct tipc_bearer *b,
			    struct nlattr *attr[]);
	void (*disable_media)(struct tipc_bearer *b);
	int (*addr2str)(struct tipc_media_addr *addr,
			char *strbuf,
			int bufsz);
	int (*addr2msg)(char *msg, struct tipc_media_addr *addr);
	int (*msg2addr)(struct tipc_bearer *b,
			struct tipc_media_addr *addr,
			char *msg);
	int (*raw2addr)(struct tipc_bearer *b,
			struct tipc_media_addr *addr,
			char *raw);
	u32 priority;
	u32 tolerance;
	u32 window;
	u32 type_id;
	u32 hwaddr_len;
	char name[TIPC_MAX_MEDIA_NAME];
};

/**
 * struct tipc_bearer - Generic TIPC bearer structure
 * @media_ptr: pointer to additional media-specific information about bearer
 * @mtu: max packet size bearer can support
 * @addr: media-specific address associated with bearer
 * @name: bearer name (format = media:interface)
 * @media: ptr to media structure associated with bearer
 * @bcast_addr: media address used in broadcasting
 * @rcu: rcu struct for tipc_bearer
 * @priority: default link priority for bearer
 * @window: default window size for bearer
 * @tolerance: default link tolerance for bearer
 * @domain: network domain to which links can be established
 * @identity: array index of this bearer within TIPC bearer array
 * @link_req: ptr to (optional) structure making periodic link setup requests
 * @net_plane: network plane ('A' through 'H') currently associated with bearer
 *
 * Note: media-specific code is responsible for initialization of the fields
 * indicated below when a bearer is enabled; TIPC's generic bearer code takes
 * care of initializing all other fields.
 */
struct tipc_bearer {
	void __rcu *media_ptr;			/* initalized by media */
	u32 mtu;				/* initalized by media */
	struct tipc_media_addr addr;		/* initalized by media */
	char name[TIPC_MAX_BEARER_NAME];
	struct tipc_media *media;
	struct tipc_media_addr bcast_addr;
	struct rcu_head rcu;
	u32 priority;
	u32 window;
	u32 tolerance;
	u32 domain;
	u32 identity;
	struct tipc_link_req *link_req;
	char net_plane;
	unsigned long up;
};

struct tipc_bearer_names {
	char media_name[TIPC_MAX_MEDIA_NAME];
	char if_name[TIPC_MAX_IF_NAME];
};

/*
 * TIPC routines available to supported media types
 */

void tipc_rcv(struct net *net, struct sk_buff *skb, struct tipc_bearer *b);

/*
 * Routines made available to TIPC by supported media types
 */
extern struct tipc_media eth_media_info;

#ifdef CONFIG_TIPC_MEDIA_IB
extern struct tipc_media ib_media_info;
#endif
#ifdef CONFIG_TIPC_MEDIA_UDP
extern struct tipc_media udp_media_info;
#endif

int tipc_nl_bearer_disable(struct sk_buff *skb, struct genl_info *info);
int tipc_nl_bearer_enable(struct sk_buff *skb, struct genl_info *info);
int tipc_nl_bearer_dump(struct sk_buff *skb, struct netlink_callback *cb);
int tipc_nl_bearer_get(struct sk_buff *skb, struct genl_info *info);
int tipc_nl_bearer_set(struct sk_buff *skb, struct genl_info *info);
int tipc_nl_bearer_add(struct sk_buff *skb, struct genl_info *info);

int tipc_nl_media_dump(struct sk_buff *skb, struct netlink_callback *cb);
int tipc_nl_media_get(struct sk_buff *skb, struct genl_info *info);
int tipc_nl_media_set(struct sk_buff *skb, struct genl_info *info);

int tipc_media_set_priority(const char *name, u32 new_value);
int tipc_media_set_window(const char *name, u32 new_value);
void tipc_media_addr_printf(char *buf, int len, struct tipc_media_addr *a);
int tipc_enable_l2_media(struct net *net, struct tipc_bearer *b,
			 struct nlattr *attrs[]);
void tipc_disable_l2_media(struct tipc_bearer *b);
int tipc_l2_send_msg(struct net *net, struct sk_buff *buf,
		     struct tipc_bearer *b, struct tipc_media_addr *dest);

void tipc_bearer_add_dest(struct net *net, u32 bearer_id, u32 dest);
void tipc_bearer_remove_dest(struct net *net, u32 bearer_id, u32 dest);
struct tipc_bearer *tipc_bearer_find(struct net *net, const char *name);
int tipc_bearer_get_name(struct net *net, char *name, u32 bearer_id);
struct tipc_media *tipc_media_find(const char *name);
void tipc_bearer_reset_all(struct net *net);
int tipc_bearer_setup(void);
void tipc_bearer_cleanup(void);
void tipc_bearer_stop(struct net *net);
int tipc_bearer_mtu(struct net *net, u32 bearer_id);
void tipc_bearer_xmit_skb(struct net *net, u32 bearer_id,
			  struct sk_buff *skb,
			  struct tipc_media_addr *dest);
void tipc_bearer_xmit(struct net *net, u32 bearer_id,
		      struct sk_buff_head *xmitq,
		      struct tipc_media_addr *dst);
void tipc_bearer_bc_xmit(struct net *net, u32 bearer_id,
			 struct sk_buff_head *xmitq);

/* check if device MTU is too low for tipc headers */
static inline bool tipc_mtu_bad(struct net_device *dev, unsigned int reserve)
{
	if (dev->mtu >= TIPC_MIN_BEARER_MTU + reserve)
		return false;
	netdev_warn(dev, "MTU too low for tipc bearer\n");
	return true;
}

#endif	/* _TIPC_BEARER_H */
Commit	Line	Data
b97bf3fd PL	1	/*
b97bf3fd PL	2	* net/tipc/bearer.h: Include file for TIPC bearer code
c4307285	3	*
35c55c98	4	* Copyright (c) 1996-2006, 2013-2016, Ericsson AB
2d627b92	5	* Copyright (c) 2005, 2010-2011, Wind River Systems
b97bf3fd PL	6	* All rights reserved.
b97bf3fd PL	7	*
9ea1fd3c	8	* Redistribution and use in source and binary forms, with or without
b97bf3fd PL	9	* modification, are permitted provided that the following conditions are met:
b97bf3fd PL	10	*
9ea1fd3c PL	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.
b97bf3fd	19	*
9ea1fd3c PL	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.
	23	*
	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
b97bf3fd PL	34	* POSSIBILITY OF SUCH DAMAGE.
	35	*/
	36
	37	#ifndef _TIPC_BEARER_H
	38	#define _TIPC_BEARER_H
	39
0655f6a8	40	#include "netlink.h"
a6bf70f7	41	#include "core.h"
3de81b75	42	#include "msg.h"
0655f6a8	43	#include <net/genetlink.h>
b97bf3fd	44
d0f91938	45	#define MAX_MEDIA 3
b97bf3fd	46
38504c28 JPM	47	/* Identifiers associated with TIPC message header media address info
	48	* - address info field is 32 bytes long
	49	* - the field's actual content and length is defined per media
	50	* - remaining unused bytes in the field are set to zero
4d163a32	51	*/
91e2eb56	52	#define TIPC_MEDIA_INFO_SIZE 32
4d163a32	53	#define TIPC_MEDIA_TYPE_OFFSET 3
d76a436d	54	#define TIPC_MEDIA_ADDR_OFFSET 4
4d163a32	55
d265fef6 AS	56	/*
	57	* Identifiers of supported TIPC media types
	58	*/
	59	#define TIPC_MEDIA_TYPE_ETH 1
a29a194a	60	#define TIPC_MEDIA_TYPE_IB 2
d0f91938	61	#define TIPC_MEDIA_TYPE_UDP 3
d265fef6	62
3de81b75 MK	63	/* minimum bearer MTU */
	64	#define TIPC_MIN_BEARER_MTU (MAX_H_SIZE + INT_H_SIZE)
	65
2c53040f	66	/**
3d749a6a AS	67	* struct tipc_media_addr - destination address used by TIPC bearers
	68	* @value: address info (format defined by media)
	69	* @media_id: TIPC media type identifier
	70	* @broadcast: non-zero if address is a broadcast address
d265fef6 AS	71	*/
d265fef6 AS	72	struct tipc_media_addr {
91e2eb56	73	u8 value[TIPC_MEDIA_INFO_SIZE];
3d749a6a AS	74	u8 media_id;
3d749a6a AS	75	u8 broadcast;
d265fef6 AS	76	};
d265fef6 AS	77
2d627b92	78	struct tipc_bearer;
b97bf3fd PL	79
b97bf3fd PL	80	/**
ef72a7e0	81	* struct tipc_media - Media specific info exposed to generic bearer layer
b97bf3fd	82	* @send_msg: routine which handles buffer transmission
4babbaa8 YX	83	* @enable_media: routine which enables a media
4babbaa8 YX	84	* @disable_media: routine which disables a media
38504c28 JPM	85	* @addr2str: convert media address format to string
	86	* @addr2msg: convert from media addr format to discovery msg addr format
	87	* @msg2addr: convert from discovery msg addr format to media addr format
	88	* @raw2addr: convert from raw addr format to media addr format
b97bf3fd PL	89	* @priority: default link (and bearer) priority
	90	* @tolerance: default time (in ms) before declaring link failure
	91	* @window: default window (in packets) before declaring link congestion
d265fef6	92	* @type_id: TIPC media identifier
e4d050cb	93	* @hwaddr_len: TIPC media address len
b97bf3fd PL	94	* @name: media name
b97bf3fd PL	95	*/
358a0d1c	96	struct tipc_media {
1da46568	97	int (send_msg)(struct net net, struct sk_buff *buf,
1a90632d	98	struct tipc_bearer *b,
b97bf3fd	99	struct tipc_media_addr *dest);
1a90632d	100	int (enable_media)(struct net net, struct tipc_bearer *b,
d0f91938	101	struct nlattr *attr[]);
1a90632d	102	void (disable_media)(struct tipc_bearer b);
38504c28 JPM	103	int (addr2str)(struct tipc_media_addr addr,
	104	char *strbuf,
	105	int bufsz);
	106	int (addr2msg)(char msg, struct tipc_media_addr *addr);
	107	int (msg2addr)(struct tipc_bearer b,
	108	struct tipc_media_addr *addr,
	109	char *msg);
	110	int (raw2addr)(struct tipc_bearer b,
	111	struct tipc_media_addr *addr,
	112	char *raw);
b97bf3fd PL	113	u32 priority;
	114	u32 tolerance;
	115	u32 window;
	116	u32 type_id;
e4d050cb	117	u32 hwaddr_len;
b97bf3fd PL	118	char name[TIPC_MAX_MEDIA_NAME];
	119	};
	120
	121	/**
ef72a7e0	122	* struct tipc_bearer - Generic TIPC bearer structure
a8304529	123	* @media_ptr: pointer to additional media-specific information about bearer
2d627b92	124	* @mtu: max packet size bearer can support
2d627b92 AS	125	* @addr: media-specific address associated with bearer
2d627b92 AS	126	* @name: bearer name (format = media:interface)
b97bf3fd	127	* @media: ptr to media structure associated with bearer
ef72a7e0	128	* @bcast_addr: media address used in broadcasting
f8322dfc	129	* @rcu: rcu struct for tipc_bearer
b97bf3fd	130	* @priority: default link priority for bearer
5c216e1d AS	131	* @window: default window size for bearer
5c216e1d AS	132	* @tolerance: default link tolerance for bearer
a21a584d	133	* @domain: network domain to which links can be established
b97bf3fd PL	134	* @identity: array index of this bearer within TIPC bearer array
b97bf3fd PL	135	* @link_req: ptr to (optional) structure making periodic link setup requests
b97bf3fd	136	* @net_plane: network plane ('A' through 'H') currently associated with bearer
2d627b92 AS	137	*
	138	* Note: media-specific code is responsible for initialization of the fields
	139	* indicated below when a bearer is enabled; TIPC's generic bearer code takes
	140	* care of initializing all other fields.
b97bf3fd	141	*/
2d627b92	142	struct tipc_bearer {
2231c5af	143	void __rcu media_ptr; / initalized by media */
2d627b92	144	u32 mtu; /* initalized by media */
2d627b92 AS	145	struct tipc_media_addr addr; /* initalized by media */
2d627b92 AS	146	char name[TIPC_MAX_BEARER_NAME];
358a0d1c	147	struct tipc_media *media;
8aeb89f2	148	struct tipc_media_addr bcast_addr;
f8322dfc	149	struct rcu_head rcu;
b97bf3fd	150	u32 priority;
5c216e1d AS	151	u32 window;
5c216e1d AS	152	u32 tolerance;
a21a584d	153	u32 domain;
b97bf3fd	154	u32 identity;
a18c4bc3	155	struct tipc_link_req *link_req;
b97bf3fd	156	char net_plane;
0d051bf9	157	unsigned long up;
b97bf3fd PL	158	};
b97bf3fd PL	159
f19765f4	160	struct tipc_bearer_names {
b97bf3fd PL	161	char media_name[TIPC_MAX_MEDIA_NAME];
	162	char if_name[TIPC_MAX_IF_NAME];
	163	};
	164
d265fef6 AS	165	/*
	166	* TIPC routines available to supported media types
	167	*/
d265fef6	168
1a90632d	169	void tipc_rcv(struct net net, struct sk_buff skb, struct tipc_bearer *b);
d265fef6 AS	170
	171	/*
	172	* Routines made available to TIPC by supported media types
	173	*/
5702dbab	174	extern struct tipc_media eth_media_info;
d265fef6	175
a29a194a	176	#ifdef CONFIG_TIPC_MEDIA_IB
5702dbab	177	extern struct tipc_media ib_media_info;
a29a194a	178	#endif
d0f91938 EH	179	#ifdef CONFIG_TIPC_MEDIA_UDP
	180	extern struct tipc_media udp_media_info;
	181	#endif
a29a194a	182
0655f6a8 RA	183	int tipc_nl_bearer_disable(struct sk_buff skb, struct genl_info info);
0655f6a8 RA	184	int tipc_nl_bearer_enable(struct sk_buff skb, struct genl_info info);
35b9dd76 RA	185	int tipc_nl_bearer_dump(struct sk_buff skb, struct netlink_callback cb);
35b9dd76 RA	186	int tipc_nl_bearer_get(struct sk_buff skb, struct genl_info info);
315c00bc	187	int tipc_nl_bearer_set(struct sk_buff skb, struct genl_info info);
ef20cd4d	188	int tipc_nl_bearer_add(struct sk_buff skb, struct genl_info info);
0655f6a8	189
46f15c67 RA	190	int tipc_nl_media_dump(struct sk_buff skb, struct netlink_callback cb);
46f15c67 RA	191	int tipc_nl_media_get(struct sk_buff skb, struct genl_info info);
1e55417d	192	int tipc_nl_media_set(struct sk_buff skb, struct genl_info info);
46f15c67	193
5c216e1d AS	194	int tipc_media_set_priority(const char *name, u32 new_value);
5c216e1d AS	195	int tipc_media_set_window(const char *name, u32 new_value);
dc1aed37	196	void tipc_media_addr_printf(char buf, int len, struct tipc_media_addr a);
d0f91938 EH	197	int tipc_enable_l2_media(struct net net, struct tipc_bearer b,
d0f91938 EH	198	struct nlattr *attrs[]);
e4d050cb	199	void tipc_disable_l2_media(struct tipc_bearer *b);
1da46568 YX	200	int tipc_l2_send_msg(struct net net, struct sk_buff buf,
1da46568 YX	201	struct tipc_bearer b, struct tipc_media_addr dest);
b97bf3fd	202
7f9f95d9 YX	203	void tipc_bearer_add_dest(struct net *net, u32 bearer_id, u32 dest);
	204	void tipc_bearer_remove_dest(struct net *net, u32 bearer_id, u32 dest);
	205	struct tipc_bearer tipc_bearer_find(struct net net, const char *name);
ff0d3e78	206	int tipc_bearer_get_name(struct net net, char name, u32 bearer_id);
358a0d1c	207	struct tipc_media tipc_media_find(const char name);
1fc07f3e	208	void tipc_bearer_reset_all(struct net *net);
6e967adf YX	209	int tipc_bearer_setup(void);
6e967adf YX	210	void tipc_bearer_cleanup(void);
f2f9800d	211	void tipc_bearer_stop(struct net *net);
959e1781	212	int tipc_bearer_mtu(struct net *net, u32 bearer_id);
60852d67 JPM	213	void tipc_bearer_xmit_skb(struct net *net, u32 bearer_id,
	214	struct sk_buff *skb,
	215	struct tipc_media_addr *dest);
af9b028e JPM	216	void tipc_bearer_xmit(struct net *net, u32 bearer_id,
	217	struct sk_buff_head *xmitq,
	218	struct tipc_media_addr *dst);
b06b281e JPM	219	void tipc_bearer_bc_xmit(struct net *net, u32 bearer_id,
b06b281e JPM	220	struct sk_buff_head *xmitq);
b97bf3fd	221
3de81b75 MK	222	/* check if device MTU is too low for tipc headers */
	223	static inline bool tipc_mtu_bad(struct net_device *dev, unsigned int reserve)
	224	{
	225	if (dev->mtu >= TIPC_MIN_BEARER_MTU + reserve)
	226	return false;
	227	netdev_warn(dev, "MTU too low for tipc bearer\n");
	228	return true;
	229	}
	230
b274f4ab	231	#endif /* _TIPC_BEARER_H */