1 /* 2 * L2TP internal definitions. 3 * 4 * Copyright (c) 2008,2009 Katalix Systems Ltd 5 * 6 * This program is free software; you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License version 2 as 8 * published by the Free Software Foundation. 9 */ 10 11 #ifndef _L2TP_CORE_H_ 12 #define _L2TP_CORE_H_ 13 14 /* Just some random numbers */ 15 #define L2TP_TUNNEL_MAGIC 0x42114DDA 16 #define L2TP_SESSION_MAGIC 0x0C04EB7D 17 18 /* Per tunnel, session hash table size */ 19 #define L2TP_HASH_BITS 4 20 #define L2TP_HASH_SIZE (1 << L2TP_HASH_BITS) 21 22 /* System-wide, session hash table size */ 23 #define L2TP_HASH_BITS_2 8 24 #define L2TP_HASH_SIZE_2 (1 << L2TP_HASH_BITS_2) 25 26 /* Debug message categories for the DEBUG socket option */ 27 enum { 28 L2TP_MSG_DEBUG = (1 << 0), /* verbose debug (if 29 * compiled in) */ 30 L2TP_MSG_CONTROL = (1 << 1), /* userspace - kernel 31 * interface */ 32 L2TP_MSG_SEQ = (1 << 2), /* sequence numbers */ 33 L2TP_MSG_DATA = (1 << 3), /* data packets */ 34 }; 35 36 struct sk_buff; 37 38 struct l2tp_stats { 39 u64 tx_packets; 40 u64 tx_bytes; 41 u64 tx_errors; 42 u64 rx_packets; 43 u64 rx_bytes; 44 u64 rx_seq_discards; 45 u64 rx_oos_packets; 46 u64 rx_errors; 47 u64 rx_cookie_discards; 48 struct u64_stats_sync syncp; 49 }; 50 51 struct l2tp_tunnel; 52 53 /* Describes a session. Contains information to determine incoming 54 * packets and transmit outgoing ones. 55 */ 56 struct l2tp_session_cfg { 57 enum l2tp_pwtype pw_type; 58 unsigned int data_seq:2; /* data sequencing level 59 * 0 => none, 1 => IP only, 60 * 2 => all 61 */ 62 unsigned int recv_seq:1; /* expect receive packets with 63 * sequence numbers? */ 64 unsigned int send_seq:1; /* send packets with sequence 65 * numbers? */ 66 unsigned int lns_mode:1; /* behave as LNS? LAC enables 67 * sequence numbers under 68 * control of LNS. */ 69 int debug; /* bitmask of debug message 70 * categories */ 71 u16 vlan_id; /* VLAN pseudowire only */ 72 u16 offset; /* offset to payload */ 73 u16 l2specific_len; /* Layer 2 specific length */ 74 u16 l2specific_type; /* Layer 2 specific type */ 75 u8 cookie[8]; /* optional cookie */ 76 int cookie_len; /* 0, 4 or 8 bytes */ 77 u8 peer_cookie[8]; /* peer's cookie */ 78 int peer_cookie_len; /* 0, 4 or 8 bytes */ 79 int reorder_timeout; /* configured reorder timeout 80 * (in jiffies) */ 81 int mtu; 82 int mru; 83 char *ifname; 84 }; 85 86 struct l2tp_session { 87 int magic; /* should be 88 * L2TP_SESSION_MAGIC */ 89 90 struct l2tp_tunnel *tunnel; /* back pointer to tunnel 91 * context */ 92 u32 session_id; 93 u32 peer_session_id; 94 u8 cookie[8]; 95 int cookie_len; 96 u8 peer_cookie[8]; 97 int peer_cookie_len; 98 u16 offset; /* offset from end of L2TP header 99 to beginning of data */ 100 u16 l2specific_len; 101 u16 l2specific_type; 102 u16 hdr_len; 103 u32 nr; /* session NR state (receive) */ 104 u32 ns; /* session NR state (send) */ 105 struct sk_buff_head reorder_q; /* receive reorder queue */ 106 struct hlist_node hlist; /* Hash list node */ 107 atomic_t ref_count; 108 109 char name[32]; /* for logging */ 110 char ifname[IFNAMSIZ]; 111 unsigned int data_seq:2; /* data sequencing level 112 * 0 => none, 1 => IP only, 113 * 2 => all 114 */ 115 unsigned int recv_seq:1; /* expect receive packets with 116 * sequence numbers? */ 117 unsigned int send_seq:1; /* send packets with sequence 118 * numbers? */ 119 unsigned int lns_mode:1; /* behave as LNS? LAC enables 120 * sequence numbers under 121 * control of LNS. */ 122 int debug; /* bitmask of debug message 123 * categories */ 124 int reorder_timeout; /* configured reorder timeout 125 * (in jiffies) */ 126 int mtu; 127 int mru; 128 enum l2tp_pwtype pwtype; 129 struct l2tp_stats stats; 130 struct hlist_node global_hlist; /* Global hash list node */ 131 132 int (*build_header)(struct l2tp_session *session, void *buf); 133 void (*recv_skb)(struct l2tp_session *session, struct sk_buff *skb, int data_len); 134 void (*session_close)(struct l2tp_session *session); 135 void (*ref)(struct l2tp_session *session); 136 void (*deref)(struct l2tp_session *session); 137 #if defined(CONFIG_L2TP_DEBUGFS) || defined(CONFIG_L2TP_DEBUGFS_MODULE) 138 void (*show)(struct seq_file *m, void *priv); 139 #endif 140 uint8_t priv[0]; /* private data */ 141 }; 142 143 /* Describes the tunnel. It contains info to track all the associated 144 * sessions so incoming packets can be sorted out 145 */ 146 struct l2tp_tunnel_cfg { 147 int debug; /* bitmask of debug message 148 * categories */ 149 enum l2tp_encap_type encap; 150 151 /* Used only for kernel-created sockets */ 152 struct in_addr local_ip; 153 struct in_addr peer_ip; 154 #if IS_ENABLED(CONFIG_IPV6) 155 struct in6_addr *local_ip6; 156 struct in6_addr *peer_ip6; 157 #endif 158 u16 local_udp_port; 159 u16 peer_udp_port; 160 unsigned int use_udp_checksums:1; 161 }; 162 163 struct l2tp_tunnel { 164 int magic; /* Should be L2TP_TUNNEL_MAGIC */ 165 rwlock_t hlist_lock; /* protect session_hlist */ 166 struct hlist_head session_hlist[L2TP_HASH_SIZE]; 167 /* hashed list of sessions, 168 * hashed by id */ 169 u32 tunnel_id; 170 u32 peer_tunnel_id; 171 int version; /* 2=>L2TPv2, 3=>L2TPv3 */ 172 173 char name[20]; /* for logging */ 174 int debug; /* bitmask of debug message 175 * categories */ 176 enum l2tp_encap_type encap; 177 struct l2tp_stats stats; 178 179 struct list_head list; /* Keep a list of all tunnels */ 180 struct net *l2tp_net; /* the net we belong to */ 181 182 atomic_t ref_count; 183 #ifdef CONFIG_DEBUG_FS 184 void (*show)(struct seq_file *m, void *arg); 185 #endif 186 int (*recv_payload_hook)(struct sk_buff *skb); 187 void (*old_sk_destruct)(struct sock *); 188 struct sock *sock; /* Parent socket */ 189 int fd; 190 191 uint8_t priv[0]; /* private data */ 192 }; 193 194 struct l2tp_nl_cmd_ops { 195 int (*session_create)(struct net *net, u32 tunnel_id, u32 session_id, u32 peer_session_id, struct l2tp_session_cfg *cfg); 196 int (*session_delete)(struct l2tp_session *session); 197 }; 198 199 static inline void *l2tp_tunnel_priv(struct l2tp_tunnel *tunnel) 200 { 201 return &tunnel->priv[0]; 202 } 203 204 static inline void *l2tp_session_priv(struct l2tp_session *session) 205 { 206 return &session->priv[0]; 207 } 208 209 static inline struct l2tp_tunnel *l2tp_sock_to_tunnel(struct sock *sk) 210 { 211 struct l2tp_tunnel *tunnel; 212 213 if (sk == NULL) 214 return NULL; 215 216 sock_hold(sk); 217 tunnel = (struct l2tp_tunnel *)(sk->sk_user_data); 218 if (tunnel == NULL) { 219 sock_put(sk); 220 goto out; 221 } 222 223 BUG_ON(tunnel->magic != L2TP_TUNNEL_MAGIC); 224 225 out: 226 return tunnel; 227 } 228 229 extern struct l2tp_session *l2tp_session_find(struct net *net, struct l2tp_tunnel *tunnel, u32 session_id); 230 extern struct l2tp_session *l2tp_session_find_nth(struct l2tp_tunnel *tunnel, int nth); 231 extern struct l2tp_session *l2tp_session_find_by_ifname(struct net *net, char *ifname); 232 extern struct l2tp_tunnel *l2tp_tunnel_find(struct net *net, u32 tunnel_id); 233 extern struct l2tp_tunnel *l2tp_tunnel_find_nth(struct net *net, int nth); 234 235 extern int l2tp_tunnel_create(struct net *net, int fd, int version, u32 tunnel_id, u32 peer_tunnel_id, struct l2tp_tunnel_cfg *cfg, struct l2tp_tunnel **tunnelp); 236 extern int l2tp_tunnel_delete(struct l2tp_tunnel *tunnel); 237 extern struct l2tp_session *l2tp_session_create(int priv_size, struct l2tp_tunnel *tunnel, u32 session_id, u32 peer_session_id, struct l2tp_session_cfg *cfg); 238 extern int l2tp_session_delete(struct l2tp_session *session); 239 extern void l2tp_session_free(struct l2tp_session *session); 240 extern void l2tp_recv_common(struct l2tp_session *session, struct sk_buff *skb, unsigned char *ptr, unsigned char *optr, u16 hdrflags, int length, int (*payload_hook)(struct sk_buff *skb)); 241 extern int l2tp_udp_encap_recv(struct sock *sk, struct sk_buff *skb); 242 243 extern int l2tp_xmit_skb(struct l2tp_session *session, struct sk_buff *skb, int hdr_len); 244 245 extern int l2tp_nl_register_ops(enum l2tp_pwtype pw_type, const struct l2tp_nl_cmd_ops *ops); 246 extern void l2tp_nl_unregister_ops(enum l2tp_pwtype pw_type); 247 248 /* Session reference counts. Incremented when code obtains a reference 249 * to a session. 250 */ 251 static inline void l2tp_session_inc_refcount_1(struct l2tp_session *session) 252 { 253 atomic_inc(&session->ref_count); 254 } 255 256 static inline void l2tp_session_dec_refcount_1(struct l2tp_session *session) 257 { 258 if (atomic_dec_and_test(&session->ref_count)) 259 l2tp_session_free(session); 260 } 261 262 #ifdef L2TP_REFCNT_DEBUG 263 #define l2tp_session_inc_refcount(_s) do { \ 264 printk(KERN_DEBUG "l2tp_session_inc_refcount: %s:%d %s: cnt=%d\n", __func__, __LINE__, (_s)->name, atomic_read(&_s->ref_count)); \ 265 l2tp_session_inc_refcount_1(_s); \ 266 } while (0) 267 #define l2tp_session_dec_refcount(_s) do { \ 268 printk(KERN_DEBUG "l2tp_session_dec_refcount: %s:%d %s: cnt=%d\n", __func__, __LINE__, (_s)->name, atomic_read(&_s->ref_count)); \ 269 l2tp_session_dec_refcount_1(_s); \ 270 } while (0) 271 #else 272 #define l2tp_session_inc_refcount(s) l2tp_session_inc_refcount_1(s) 273 #define l2tp_session_dec_refcount(s) l2tp_session_dec_refcount_1(s) 274 #endif 275 276 #endif /* _L2TP_CORE_H_ */ 277