net/tipc/bearer.h - arm/linux - Git at Google

 /*
  * 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)

 /* Identifiers for distinguishing between broadcast/multicast and replicast
  */
 #define TIPC_BROADCAST_SUPPORT  1
 #define TIPC_REPLICAST_SUPPORT  2

 /**
  * 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
  * @pt: packet type for bearer
  * @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 packet_type pt;
 	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);
 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);
 bool tipc_bearer_bcast_support(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 */
	/*
	* 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)

	/* Identifiers for distinguishing between broadcast/multicast and replicast
	*/
	#define TIPC_BROADCAST_SUPPORT 1
	#define TIPC_REPLICAST_SUPPORT 2

	/**
	* 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
	* @pt: packet type for bearer
	* @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 packet_type pt;
	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);
	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);
	bool tipc_bearer_bcast_support(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 */