core.h 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265
  1. /*
  2. * net/tipc/core.h: Include file for TIPC global declarations
  3. *
  4. * Copyright (c) 2005-2006, Ericsson AB
  5. * Copyright (c) 2005-2007, 2010-2011, Wind River Systems
  6. * All rights reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions are met:
  10. *
  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.
  19. *
  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
  34. * POSSIBILITY OF SUCH DAMAGE.
  35. */
  36. #ifndef _TIPC_CORE_H
  37. #define _TIPC_CORE_H
  38. #include <linux/tipc.h>
  39. #include <linux/tipc_config.h>
  40. #include <linux/types.h>
  41. #include <linux/kernel.h>
  42. #include <linux/errno.h>
  43. #include <linux/mm.h>
  44. #include <linux/timer.h>
  45. #include <linux/string.h>
  46. #include <asm/uaccess.h>
  47. #include <linux/interrupt.h>
  48. #include <linux/atomic.h>
  49. #include <asm/hardirq.h>
  50. #include <linux/netdevice.h>
  51. #include <linux/in.h>
  52. #include <linux/list.h>
  53. #include <linux/slab.h>
  54. #include <linux/vmalloc.h>
  55. #define TIPC_MOD_VER "2.0.0"
  56. struct tipc_msg; /* msg.h */
  57. struct print_buf; /* log.h */
  58. /*
  59. * TIPC system monitoring code
  60. */
  61. /*
  62. * TIPC's print buffer subsystem supports the following print buffers:
  63. *
  64. * TIPC_NULL : null buffer (i.e. print nowhere)
  65. * TIPC_CONS : system console
  66. * TIPC_LOG : TIPC log buffer
  67. * &buf : user-defined buffer (struct print_buf *)
  68. *
  69. * Note: TIPC_LOG is configured to echo its output to the system console;
  70. * user-defined buffers can be configured to do the same thing.
  71. */
  72. extern struct print_buf *const TIPC_NULL;
  73. extern struct print_buf *const TIPC_CONS;
  74. extern struct print_buf *const TIPC_LOG;
  75. void tipc_printf(struct print_buf *, const char *fmt, ...);
  76. /*
  77. * TIPC_OUTPUT is the destination print buffer for system messages.
  78. */
  79. #ifndef TIPC_OUTPUT
  80. #define TIPC_OUTPUT TIPC_LOG
  81. #endif
  82. #define err(fmt, arg...) tipc_printf(TIPC_OUTPUT, \
  83. KERN_ERR "TIPC: " fmt, ## arg)
  84. #define warn(fmt, arg...) tipc_printf(TIPC_OUTPUT, \
  85. KERN_WARNING "TIPC: " fmt, ## arg)
  86. #define info(fmt, arg...) tipc_printf(TIPC_OUTPUT, \
  87. KERN_NOTICE "TIPC: " fmt, ## arg)
  88. #ifdef CONFIG_TIPC_DEBUG
  89. /*
  90. * DBG_OUTPUT is the destination print buffer for debug messages.
  91. */
  92. #ifndef DBG_OUTPUT
  93. #define DBG_OUTPUT TIPC_LOG
  94. #endif
  95. #define dbg(fmt, arg...) tipc_printf(DBG_OUTPUT, KERN_DEBUG fmt, ## arg);
  96. #define msg_dbg(msg, txt) tipc_msg_dbg(DBG_OUTPUT, msg, txt);
  97. void tipc_msg_dbg(struct print_buf *, struct tipc_msg *, const char *);
  98. #else
  99. #define dbg(fmt, arg...) do {} while (0)
  100. #define msg_dbg(msg, txt) do {} while (0)
  101. #define tipc_msg_dbg(buf, msg, txt) do {} while (0)
  102. #endif
  103. /*
  104. * TIPC-specific error codes
  105. */
  106. #define ELINKCONG EAGAIN /* link congestion <=> resource unavailable */
  107. /*
  108. * Global configuration variables
  109. */
  110. extern u32 tipc_own_addr;
  111. extern int tipc_max_ports;
  112. extern int tipc_max_subscriptions;
  113. extern int tipc_max_publications;
  114. extern int tipc_net_id;
  115. extern int tipc_remote_management;
  116. /*
  117. * Other global variables
  118. */
  119. extern int tipc_random;
  120. extern const char tipc_alphabet[];
  121. /*
  122. * Routines available to privileged subsystems
  123. */
  124. extern int tipc_core_start_net(unsigned long);
  125. extern int tipc_handler_start(void);
  126. extern void tipc_handler_stop(void);
  127. extern int tipc_netlink_start(void);
  128. extern void tipc_netlink_stop(void);
  129. extern int tipc_socket_init(void);
  130. extern void tipc_socket_stop(void);
  131. /*
  132. * TIPC timer and signal code
  133. */
  134. typedef void (*Handler) (unsigned long);
  135. u32 tipc_k_signal(Handler routine, unsigned long argument);
  136. /**
  137. * k_init_timer - initialize a timer
  138. * @timer: pointer to timer structure
  139. * @routine: pointer to routine to invoke when timer expires
  140. * @argument: value to pass to routine when timer expires
  141. *
  142. * Timer must be initialized before use (and terminated when no longer needed).
  143. */
  144. static inline void k_init_timer(struct timer_list *timer, Handler routine,
  145. unsigned long argument)
  146. {
  147. setup_timer(timer, routine, argument);
  148. }
  149. /**
  150. * k_start_timer - start a timer
  151. * @timer: pointer to timer structure
  152. * @msec: time to delay (in ms)
  153. *
  154. * Schedules a previously initialized timer for later execution.
  155. * If timer is already running, the new timeout overrides the previous request.
  156. *
  157. * To ensure the timer doesn't expire before the specified delay elapses,
  158. * the amount of delay is rounded up when converting to the jiffies
  159. * then an additional jiffy is added to account for the fact that
  160. * the starting time may be in the middle of the current jiffy.
  161. */
  162. static inline void k_start_timer(struct timer_list *timer, unsigned long msec)
  163. {
  164. mod_timer(timer, jiffies + msecs_to_jiffies(msec) + 1);
  165. }
  166. /**
  167. * k_cancel_timer - cancel a timer
  168. * @timer: pointer to timer structure
  169. *
  170. * Cancels a previously initialized timer.
  171. * Can be called safely even if the timer is already inactive.
  172. *
  173. * WARNING: Must not be called when holding locks required by the timer's
  174. * timeout routine, otherwise deadlock can occur on SMP systems!
  175. */
  176. static inline void k_cancel_timer(struct timer_list *timer)
  177. {
  178. del_timer_sync(timer);
  179. }
  180. /**
  181. * k_term_timer - terminate a timer
  182. * @timer: pointer to timer structure
  183. *
  184. * Prevents further use of a previously initialized timer.
  185. *
  186. * WARNING: Caller must ensure timer isn't currently running.
  187. *
  188. * (Do not "enhance" this routine to automatically cancel an active timer,
  189. * otherwise deadlock can arise when a timeout routine calls k_term_timer.)
  190. */
  191. static inline void k_term_timer(struct timer_list *timer)
  192. {
  193. }
  194. /*
  195. * TIPC message buffer code
  196. *
  197. * TIPC message buffer headroom reserves space for the worst-case
  198. * link-level device header (in case the message is sent off-node).
  199. *
  200. * Note: Headroom should be a multiple of 4 to ensure the TIPC header fields
  201. * are word aligned for quicker access
  202. */
  203. #define BUF_HEADROOM LL_MAX_HEADER
  204. struct tipc_skb_cb {
  205. void *handle;
  206. };
  207. #define TIPC_SKB_CB(__skb) ((struct tipc_skb_cb *)&((__skb)->cb[0]))
  208. static inline struct tipc_msg *buf_msg(struct sk_buff *skb)
  209. {
  210. return (struct tipc_msg *)skb->data;
  211. }
  212. extern struct sk_buff *tipc_buf_acquire(u32 size);
  213. #endif