xref: /freebsd/sys/netinet/libalias/alias_local.h (revision 8a272653d9fbd9fc37691c9aad6a05089b4ecb4d)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2001 Charles Mott <cm@linktel.net>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  * $FreeBSD$
29  */
30 
31 /*
32  * Alias_local.h contains the function prototypes for alias.c,
33  * alias_db.c, alias_util.c and alias_ftp.c, alias_irc.c (as well
34  * as any future add-ons).  It also includes macros, globals and
35  * struct definitions shared by more than one alias*.c file.
36  *
37  * This include file is intended to be used only within the aliasing
38  * software.  Outside world interfaces are defined in alias.h
39  *
40  * This software is placed into the public domain with no restrictions
41  * on its distribution.
42  *
43  * Initial version:  August, 1996  (cjm)
44  *
45  * <updated several times by original author and Eivind Eklund>
46  */
47 
48 #ifndef _ALIAS_LOCAL_H_
49 #define	_ALIAS_LOCAL_H_
50 
51 #include <sys/types.h>
52 #include <sys/sysctl.h>
53 
54 #ifdef _KERNEL
55 #include <sys/malloc.h>
56 #include <sys/param.h>
57 #include <sys/lock.h>
58 #include <sys/mutex.h>
59 
60 /* XXX: LibAliasSetTarget() uses this constant. */
61 #define	INADDR_NONE	0xffffffff
62 
63 #include <netinet/libalias/alias_sctp.h>
64 #else
65 #include "alias_sctp.h"
66 #endif
67 
68 /* Sizes of input and output link tables */
69 #define LINK_TABLE_OUT_SIZE        4001
70 #define LINK_TABLE_IN_SIZE         4001
71 
72 #define	GET_ALIAS_PORT		-1
73 #define	GET_ALIAS_ID		GET_ALIAS_PORT
74 
75 #ifdef _KERNEL
76 #define INET_NTOA_BUF(buf) (buf)
77 #else
78 #define INET_NTOA_BUF(buf) (buf), sizeof(buf)
79 #endif
80 
81 struct proxy_entry;
82 
83 struct libalias {
84 	LIST_ENTRY(libalias) instancelist;
85 
86 	int		packetAliasMode;	/* Mode flags                      */
87 	/* - documented in alias.h  */
88 
89 	struct in_addr	aliasAddress;	/* Address written onto source     */
90 	/* field of IP packet.           */
91 
92 	struct in_addr	targetAddress;	/* IP address incoming packets     */
93 	/* are sent to if no aliasing    */
94 	/* link already exists           */
95 
96 	struct in_addr	nullAddress;	/* Used as a dummy parameter for   */
97 	/* some function calls           */
98 
99 			LIST_HEAD     (, alias_link) linkTableOut[LINK_TABLE_OUT_SIZE];
100 	/* Lookup table of pointers to     */
101 	/* chains of link records. Each  */
102 
103 			LIST_HEAD     (, alias_link) linkTableIn[LINK_TABLE_IN_SIZE];
104 	/* link record is doubly indexed */
105 	/* into input and output lookup  */
106 	/* tables.                       */
107 
108 	/* Link statistics                 */
109 	int		icmpLinkCount;
110 	int		udpLinkCount;
111 	int		tcpLinkCount;
112 	int		pptpLinkCount;
113 	int		protoLinkCount;
114 	int		fragmentIdLinkCount;
115 	int		fragmentPtrLinkCount;
116 	int		sockCount;
117 
118 	int		cleanupIndex;	/* Index to chain of link table    */
119 	/* being inspected for old links   */
120 
121 	int		timeStamp;	/* System time in seconds for      */
122 	/* current packet                  */
123 
124 	int		lastCleanupTime;	/* Last time
125 						 * IncrementalCleanup()  */
126 	/* was called                      */
127 
128 	int		deleteAllLinks;	/* If equal to zero, DeleteLink()  */
129 	/* will not remove permanent links */
130 
131 	/* log descriptor        */
132 #ifdef  _KERNEL
133 	char           *logDesc;
134 #else
135 	FILE           *logDesc;
136 #endif
137 	/* statistics monitoring */
138 
139 	int		newDefaultLink;	/* Indicates if a new aliasing     */
140 	/* link has been created after a   */
141 	/* call to PacketAliasIn/Out().    */
142 
143 #ifndef NO_FW_PUNCH
144 	int		fireWallFD;	/* File descriptor to be able to   */
145 	/* control firewall.  Opened by    */
146 	/* PacketAliasSetMode on first     */
147 	/* setting the PKT_ALIAS_PUNCH_FW  */
148 	/* flag.                           */
149 	int		fireWallBaseNum;	/* The first firewall entry
150 						 * free for our use */
151 	int		fireWallNumNums;	/* How many entries can we
152 						 * use? */
153 	int		fireWallActiveNum;	/* Which entry did we last
154 						 * use? */
155 	char           *fireWallField;	/* bool array for entries */
156 #endif
157 
158 	unsigned int	skinnyPort;	/* TCP port used by the Skinny     */
159 	/* protocol.                       */
160 
161 	struct proxy_entry *proxyList;
162 
163 	struct in_addr	true_addr;	/* in network byte order. */
164 	u_short		true_port;	/* in host byte order. */
165 
166 	/* Port ranges for aliasing. */
167 	u_short		aliasPortLower;
168 	u_short		aliasPortLength;
169 
170 	/*
171 	 * sctp code support
172 	 */
173 
174 	/* counts associations that have progressed to UP and not yet removed */
175 	int		sctpLinkCount;
176 #ifdef  _KERNEL
177 	/* timing queue for keeping track of association timeouts */
178 	struct sctp_nat_timer sctpNatTimer;
179 
180 	/* size of hash table used in this instance */
181 	u_int sctpNatTableSize;
182 
183 /*
184  * local look up table sorted by l_vtag/l_port
185  */
186 	LIST_HEAD(sctpNatTableL, sctp_nat_assoc) *sctpTableLocal;
187 /*
188  * global look up table sorted by g_vtag/g_port
189  */
190 	LIST_HEAD(sctpNatTableG, sctp_nat_assoc) *sctpTableGlobal;
191 
192 	/*
193 	 * avoid races in libalias: every public function has to use it.
194 	 */
195 	struct mtx mutex;
196 #endif
197 };
198 
199 /* Macros */
200 
201 #ifdef _KERNEL
202 #define LIBALIAS_LOCK_INIT(l) \
203         mtx_init(&l->mutex, "per-instance libalias mutex", NULL, MTX_DEF)
204 #define LIBALIAS_LOCK_ASSERT(l) mtx_assert(&l->mutex, MA_OWNED)
205 #define LIBALIAS_LOCK(l) mtx_lock(&l->mutex)
206 #define LIBALIAS_UNLOCK(l) mtx_unlock(&l->mutex)
207 #define LIBALIAS_LOCK_DESTROY(l)	mtx_destroy(&l->mutex)
208 #else
209 #define LIBALIAS_LOCK_INIT(l)
210 #define LIBALIAS_LOCK_ASSERT(l)
211 #define LIBALIAS_LOCK(l)
212 #define LIBALIAS_UNLOCK(l)
213 #define LIBALIAS_LOCK_DESTROY(l)
214 #endif
215 
216 /*
217  * The following macro is used to update an
218  * internet checksum.  "delta" is a 32-bit
219  * accumulation of all the changes to the
220  * checksum (adding in new 16-bit words and
221  * subtracting out old words), and "cksum"
222  * is the checksum value to be updated.
223  */
224 #define	ADJUST_CHECKSUM(acc, cksum) \
225 	do { \
226 		acc += cksum; \
227 		if (acc < 0) { \
228 			acc = -acc; \
229 			acc = (acc >> 16) + (acc & 0xffff); \
230 			acc += acc >> 16; \
231 			cksum = (u_short) ~acc; \
232 		} else { \
233 			acc = (acc >> 16) + (acc & 0xffff); \
234 			acc += acc >> 16; \
235 			cksum = (u_short) acc; \
236 		} \
237 	} while (0)
238 
239 /* Prototypes */
240 
241 /*
242  * SctpFunction prototypes
243  *
244  */
245 void AliasSctpInit(struct libalias *la);
246 void AliasSctpTerm(struct libalias *la);
247 int SctpAlias(struct libalias *la, struct ip *ip, int direction);
248 
249 /*
250  * We do not calculate TCP checksums when libalias is a kernel
251  * module, since it has no idea about checksum offloading.
252  * If TCP data has changed, then we just set checksum to zero,
253  * and caller must recalculate it himself.
254  * In case if libalias will edit UDP data, the same approach
255  * should be used.
256  */
257 #ifndef _KERNEL
258 u_short		IpChecksum(struct ip *_pip);
259 u_short		TcpChecksum(struct ip *_pip);
260 #endif
261 void
262 DifferentialChecksum(u_short * _cksum, void * _new, void * _old, int _n);
263 
264 /* Internal data access */
265 struct alias_link *
266 AddLink(struct libalias *la, struct in_addr src_addr, struct in_addr dst_addr,
267     struct in_addr alias_addr, u_short src_port, u_short dst_port,
268     int alias_param, int link_type);
269 struct alias_link *
270 FindIcmpIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
271     u_short _id_alias, int _create);
272 struct alias_link *
273 FindIcmpOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
274     u_short _id, int _create);
275 struct alias_link *
276 FindFragmentIn1(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
277     u_short _ip_id);
278 struct alias_link *
279 FindFragmentIn2(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
280     u_short _ip_id);
281 struct alias_link *
282 		AddFragmentPtrLink(struct libalias *la, struct in_addr _dst_addr, u_short _ip_id);
283 struct alias_link *
284 		FindFragmentPtr(struct libalias *la, struct in_addr _dst_addr, u_short _ip_id);
285 struct alias_link *
286 FindProtoIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
287     u_char _proto);
288 struct alias_link *
289 FindProtoOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
290     u_char _proto);
291 struct alias_link *
292 FindUdpTcpIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
293     u_short _dst_port, u_short _alias_port, u_char _proto, int _create);
294 struct alias_link *
295 FindUdpTcpOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
296     u_short _src_port, u_short _dst_port, u_char _proto, int _create);
297 struct alias_link *
298 AddPptp(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
299     struct in_addr _alias_addr, u_int16_t _src_call_id);
300 struct alias_link *
301 FindPptpOutByCallId(struct libalias *la, struct in_addr _src_addr,
302     struct in_addr _dst_addr, u_int16_t _src_call_id);
303 struct alias_link *
304 FindPptpInByCallId(struct libalias *la, struct in_addr _dst_addr,
305     struct in_addr _alias_addr, u_int16_t _dst_call_id);
306 struct alias_link *
307 FindPptpOutByPeerCallId(struct libalias *la, struct in_addr _src_addr,
308     struct in_addr _dst_addr, u_int16_t _dst_call_id);
309 struct alias_link *
310 FindPptpInByPeerCallId(struct libalias *la, struct in_addr _dst_addr,
311     struct in_addr _alias_addr, u_int16_t _alias_call_id);
312 struct alias_link *
313 FindRtspOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
314     u_short _src_port, u_short _alias_port, u_char _proto);
315 struct in_addr
316 		FindOriginalAddress(struct libalias *la, struct in_addr _alias_addr);
317 struct in_addr
318 		FindAliasAddress(struct libalias *la, struct in_addr _original_addr);
319 struct in_addr
320 FindSctpRedirectAddress(struct libalias *la,  struct sctp_nat_msg *sm);
321 
322 /* External data access/modification */
323 int
324 FindNewPortGroup(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
325     u_short _src_port, u_short _dst_port, u_short _port_count,
326     u_char _proto, u_char _align);
327 void		GetFragmentAddr(struct alias_link *_lnk, struct in_addr *_src_addr);
328 void		SetFragmentAddr(struct alias_link *_lnk, struct in_addr _src_addr);
329 void		GetFragmentPtr(struct alias_link *_lnk, void **_fptr);
330 void		SetFragmentPtr(struct alias_link *_lnk, void *fptr);
331 void		SetStateIn(struct alias_link *_lnk, int _state);
332 void		SetStateOut(struct alias_link *_lnk, int _state);
333 int		GetStateIn (struct alias_link *_lnk);
334 int		GetStateOut(struct alias_link *_lnk);
335 struct in_addr
336 		GetOriginalAddress(struct alias_link *_lnk);
337 struct in_addr
338 		GetDestAddress(struct alias_link *_lnk);
339 struct in_addr
340 		GetAliasAddress(struct alias_link *_lnk);
341 struct in_addr
342 		GetDefaultAliasAddress(struct libalias *la);
343 void		SetDefaultAliasAddress(struct libalias *la, struct in_addr _alias_addr);
344 u_short		GetOriginalPort(struct alias_link *_lnk);
345 u_short		GetAliasPort(struct alias_link *_lnk);
346 struct in_addr
347 		GetProxyAddress(struct alias_link *_lnk);
348 void		SetProxyAddress(struct alias_link *_lnk, struct in_addr _addr);
349 u_short		GetProxyPort(struct alias_link *_lnk);
350 void		SetProxyPort(struct alias_link *_lnk, u_short _port);
351 void		SetAckModified(struct alias_link *_lnk);
352 int		GetAckModified(struct alias_link *_lnk);
353 int		GetDeltaAckIn(u_long, struct alias_link *_lnk);
354 int             GetDeltaSeqOut(u_long, struct alias_link *lnk);
355 void            AddSeq(struct alias_link *lnk, int delta, u_int ip_hl,
356 		    u_short ip_len, u_long th_seq, u_int th_off);
357 void		SetExpire (struct alias_link *_lnk, int _expire);
358 void		ClearCheckNewLink(struct libalias *la);
359 void		SetProtocolFlags(struct alias_link *_lnk, int _pflags);
360 int		GetProtocolFlags(struct alias_link *_lnk);
361 void		SetDestCallId(struct alias_link *_lnk, u_int16_t _cid);
362 
363 #ifndef NO_FW_PUNCH
364 void		PunchFWHole(struct alias_link *_lnk);
365 
366 #endif
367 
368 /* Housekeeping function */
369 void		HouseKeeping(struct libalias *);
370 
371 /* Tcp specific routines */
372 /* lint -save -library Suppress flexelint warnings */
373 
374 /* Transparent proxy routines */
375 int
376 ProxyCheck(struct libalias *la, struct in_addr *proxy_server_addr,
377     u_short * proxy_server_port, struct in_addr src_addr,
378     struct in_addr dst_addr, u_short dst_port, u_char ip_p);
379 void
380 ProxyModify(struct libalias *la, struct alias_link *_lnk, struct ip *_pip,
381     int _maxpacketsize, int _proxy_type);
382 
383 enum alias_tcp_state {
384 	ALIAS_TCP_STATE_NOT_CONNECTED,
385 	ALIAS_TCP_STATE_CONNECTED,
386 	ALIAS_TCP_STATE_DISCONNECTED
387 };
388 
389 #if defined(_NETINET_IP_H_)
390 static __inline void *
391 ip_next(struct ip *iphdr)
392 {
393 	char *p = (char *)iphdr;
394 	return (&p[iphdr->ip_hl * 4]);
395 }
396 #endif
397 
398 #if defined(_NETINET_TCP_H_)
399 static __inline void *
400 tcp_next(struct tcphdr *tcphdr)
401 {
402 	char *p = (char *)tcphdr;
403 	return (&p[tcphdr->th_off * 4]);
404 }
405 #endif
406 
407 #if defined(_NETINET_UDP_H_)
408 static __inline void *
409 udp_next(struct udphdr *udphdr)
410 {
411 	return ((void *)(udphdr + 1));
412 }
413 #endif
414 
415 #endif				/* !_ALIAS_LOCAL_H_ */
416