xref: /freebsd/sys/netinet/libalias/alias_local.h (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
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 	/*
167 	 * sctp code support
168 	 */
169 
170 	/* counts associations that have progressed to UP and not yet removed */
171 	int		sctpLinkCount;
172 #ifdef  _KERNEL
173 	/* timing queue for keeping track of association timeouts */
174 	struct sctp_nat_timer sctpNatTimer;
175 
176 	/* size of hash table used in this instance */
177 	u_int sctpNatTableSize;
178 
179 /*
180  * local look up table sorted by l_vtag/l_port
181  */
182 	LIST_HEAD(sctpNatTableL, sctp_nat_assoc) *sctpTableLocal;
183 /*
184  * global look up table sorted by g_vtag/g_port
185  */
186 	LIST_HEAD(sctpNatTableG, sctp_nat_assoc) *sctpTableGlobal;
187 
188 	/*
189 	 * avoid races in libalias: every public function has to use it.
190 	 */
191 	struct mtx mutex;
192 #endif
193 };
194 
195 /* Macros */
196 
197 #ifdef _KERNEL
198 #define LIBALIAS_LOCK_INIT(l) \
199         mtx_init(&l->mutex, "per-instance libalias mutex", NULL, MTX_DEF)
200 #define LIBALIAS_LOCK_ASSERT(l) mtx_assert(&l->mutex, MA_OWNED)
201 #define LIBALIAS_LOCK(l) mtx_lock(&l->mutex)
202 #define LIBALIAS_UNLOCK(l) mtx_unlock(&l->mutex)
203 #define LIBALIAS_LOCK_DESTROY(l)	mtx_destroy(&l->mutex)
204 #else
205 #define LIBALIAS_LOCK_INIT(l)
206 #define LIBALIAS_LOCK_ASSERT(l)
207 #define LIBALIAS_LOCK(l)
208 #define LIBALIAS_UNLOCK(l)
209 #define LIBALIAS_LOCK_DESTROY(l)
210 #endif
211 
212 /*
213  * The following macro is used to update an
214  * internet checksum.  "delta" is a 32-bit
215  * accumulation of all the changes to the
216  * checksum (adding in new 16-bit words and
217  * subtracting out old words), and "cksum"
218  * is the checksum value to be updated.
219  */
220 #define	ADJUST_CHECKSUM(acc, cksum) \
221 	do { \
222 		acc += cksum; \
223 		if (acc < 0) { \
224 			acc = -acc; \
225 			acc = (acc >> 16) + (acc & 0xffff); \
226 			acc += acc >> 16; \
227 			cksum = (u_short) ~acc; \
228 		} else { \
229 			acc = (acc >> 16) + (acc & 0xffff); \
230 			acc += acc >> 16; \
231 			cksum = (u_short) acc; \
232 		} \
233 	} while (0)
234 
235 /* Prototypes */
236 
237 /*
238  * SctpFunction prototypes
239  *
240  */
241 void AliasSctpInit(struct libalias *la);
242 void AliasSctpTerm(struct libalias *la);
243 int SctpAlias(struct libalias *la, struct ip *ip, int direction);
244 
245 /*
246  * We do not calculate TCP checksums when libalias is a kernel
247  * module, since it has no idea about checksum offloading.
248  * If TCP data has changed, then we just set checksum to zero,
249  * and caller must recalculate it himself.
250  * In case if libalias will edit UDP data, the same approach
251  * should be used.
252  */
253 #ifndef _KERNEL
254 u_short		IpChecksum(struct ip *_pip);
255 u_short		TcpChecksum(struct ip *_pip);
256 #endif
257 void
258 DifferentialChecksum(u_short * _cksum, void * _new, void * _old, int _n);
259 
260 /* Internal data access */
261 struct alias_link *
262 AddLink(struct libalias *la, struct in_addr src_addr, struct in_addr dst_addr,
263     struct in_addr alias_addr, u_short src_port, u_short dst_port,
264     int alias_param, int link_type);
265 struct alias_link *
266 FindIcmpIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
267     u_short _id_alias, int _create);
268 struct alias_link *
269 FindIcmpOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
270     u_short _id, int _create);
271 struct alias_link *
272 FindFragmentIn1(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
273     u_short _ip_id);
274 struct alias_link *
275 FindFragmentIn2(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
276     u_short _ip_id);
277 struct alias_link *
278 		AddFragmentPtrLink(struct libalias *la, struct in_addr _dst_addr, u_short _ip_id);
279 struct alias_link *
280 		FindFragmentPtr(struct libalias *la, struct in_addr _dst_addr, u_short _ip_id);
281 struct alias_link *
282 FindProtoIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
283     u_char _proto);
284 struct alias_link *
285 FindProtoOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
286     u_char _proto);
287 struct alias_link *
288 FindUdpTcpIn(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
289     u_short _dst_port, u_short _alias_port, u_char _proto, int _create);
290 struct alias_link *
291 FindUdpTcpOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
292     u_short _src_port, u_short _dst_port, u_char _proto, int _create);
293 struct alias_link *
294 AddPptp(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
295     struct in_addr _alias_addr, u_int16_t _src_call_id);
296 struct alias_link *
297 FindPptpOutByCallId(struct libalias *la, struct in_addr _src_addr,
298     struct in_addr _dst_addr, u_int16_t _src_call_id);
299 struct alias_link *
300 FindPptpInByCallId(struct libalias *la, struct in_addr _dst_addr,
301     struct in_addr _alias_addr, u_int16_t _dst_call_id);
302 struct alias_link *
303 FindPptpOutByPeerCallId(struct libalias *la, struct in_addr _src_addr,
304     struct in_addr _dst_addr, u_int16_t _dst_call_id);
305 struct alias_link *
306 FindPptpInByPeerCallId(struct libalias *la, struct in_addr _dst_addr,
307     struct in_addr _alias_addr, u_int16_t _alias_call_id);
308 struct alias_link *
309 FindRtspOut(struct libalias *la, struct in_addr _src_addr, struct in_addr _dst_addr,
310     u_short _src_port, u_short _alias_port, u_char _proto);
311 struct in_addr
312 		FindOriginalAddress(struct libalias *la, struct in_addr _alias_addr);
313 struct in_addr
314 		FindAliasAddress(struct libalias *la, struct in_addr _original_addr);
315 struct in_addr
316 FindSctpRedirectAddress(struct libalias *la,  struct sctp_nat_msg *sm);
317 
318 /* External data access/modification */
319 int
320 FindNewPortGroup(struct libalias *la, struct in_addr _dst_addr, struct in_addr _alias_addr,
321     u_short _src_port, u_short _dst_port, u_short _port_count,
322     u_char _proto, u_char _align);
323 void		GetFragmentAddr(struct alias_link *_lnk, struct in_addr *_src_addr);
324 void		SetFragmentAddr(struct alias_link *_lnk, struct in_addr _src_addr);
325 void		GetFragmentPtr(struct alias_link *_lnk, char **_fptr);
326 void		SetFragmentPtr(struct alias_link *_lnk, char *fptr);
327 void		SetStateIn(struct alias_link *_lnk, int _state);
328 void		SetStateOut(struct alias_link *_lnk, int _state);
329 int		GetStateIn (struct alias_link *_lnk);
330 int		GetStateOut(struct alias_link *_lnk);
331 struct in_addr
332 		GetOriginalAddress(struct alias_link *_lnk);
333 struct in_addr
334 		GetDestAddress(struct alias_link *_lnk);
335 struct in_addr
336 		GetAliasAddress(struct alias_link *_lnk);
337 struct in_addr
338 		GetDefaultAliasAddress(struct libalias *la);
339 void		SetDefaultAliasAddress(struct libalias *la, struct in_addr _alias_addr);
340 u_short		GetOriginalPort(struct alias_link *_lnk);
341 u_short		GetAliasPort(struct alias_link *_lnk);
342 struct in_addr
343 		GetProxyAddress(struct alias_link *_lnk);
344 void		SetProxyAddress(struct alias_link *_lnk, struct in_addr _addr);
345 u_short		GetProxyPort(struct alias_link *_lnk);
346 void		SetProxyPort(struct alias_link *_lnk, u_short _port);
347 void		SetAckModified(struct alias_link *_lnk);
348 int		GetAckModified(struct alias_link *_lnk);
349 int		GetDeltaAckIn(u_long, struct alias_link *_lnk);
350 int             GetDeltaSeqOut(u_long, struct alias_link *lnk);
351 void            AddSeq(struct alias_link *lnk, int delta, u_int ip_hl,
352 		    u_short ip_len, u_long th_seq, u_int th_off);
353 void		SetExpire (struct alias_link *_lnk, int _expire);
354 void		ClearCheckNewLink(struct libalias *la);
355 void		SetProtocolFlags(struct alias_link *_lnk, int _pflags);
356 int		GetProtocolFlags(struct alias_link *_lnk);
357 void		SetDestCallId(struct alias_link *_lnk, u_int16_t _cid);
358 
359 #ifndef NO_FW_PUNCH
360 void		PunchFWHole(struct alias_link *_lnk);
361 
362 #endif
363 
364 /* Housekeeping function */
365 void		HouseKeeping(struct libalias *);
366 
367 /* Tcp specific routines */
368 /* lint -save -library Suppress flexelint warnings */
369 
370 /* Transparent proxy routines */
371 int
372 ProxyCheck(struct libalias *la, struct in_addr *proxy_server_addr,
373     u_short * proxy_server_port, struct in_addr src_addr,
374     struct in_addr dst_addr, u_short dst_port, u_char ip_p);
375 void
376 ProxyModify(struct libalias *la, struct alias_link *_lnk, struct ip *_pip,
377     int _maxpacketsize, int _proxy_type);
378 
379 enum alias_tcp_state {
380 	ALIAS_TCP_STATE_NOT_CONNECTED,
381 	ALIAS_TCP_STATE_CONNECTED,
382 	ALIAS_TCP_STATE_DISCONNECTED
383 };
384 
385 #if defined(_NETINET_IP_H_)
386 static __inline void *
387 ip_next(struct ip *iphdr)
388 {
389 	char *p = (char *)iphdr;
390 	return (&p[iphdr->ip_hl * 4]);
391 }
392 #endif
393 
394 #if defined(_NETINET_TCP_H_)
395 static __inline void *
396 tcp_next(struct tcphdr *tcphdr)
397 {
398 	char *p = (char *)tcphdr;
399 	return (&p[tcphdr->th_off * 4]);
400 }
401 #endif
402 
403 #if defined(_NETINET_UDP_H_)
404 static __inline void *
405 udp_next(struct udphdr *udphdr)
406 {
407 	return ((void *)(udphdr + 1));
408 }
409 #endif
410 
411 #endif				/* !_ALIAS_LOCAL_H_ */
412