bsd/netinet6/ip6_fw.h

   1 /*
   2  * Copyright (c) 2002 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
   7  *
   8  * This file contains Original Code and/or Modifications of Original Code
   9  * as defined in and that are subject to the Apple Public Source License
  10  * Version 2.0 (the 'License'). You may not use this file except in
  11  * compliance with the License. Please obtain a copy of the License at
  12  * http://www.opensource.apple.com/apsl/ and read it before using this
  13  * file.
  14  *
  15  * The Original Code and all software distributed under the License are
  16  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  17  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  18  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  20  * Please see the License for the specific language governing rights and
  21  * limitations under the License.
  22  *
  23  * @APPLE_LICENSE_HEADER_END@
  24  */
  25 /*
  26  * Copyright (c) 1993 Daniel Boulet
  27  * Copyright (c) 1994 Ugen J.S.Antsilevich
  28  *
  29  * Redistribution and use in source forms, with and without modification,
  30  * are permitted provided that this entire comment appears intact.
  31  *
  32  * Redistribution in binary form may occur without any restrictions.
  33  * Obviously, it would be nice if you gave credit where credit is due
  34  * but requiring it would be too onerous.
  35  *
  36  * This software is provided ``AS IS'' without any warranties of any kind.
  37  *
  38  */
  39
  40 #ifndef _IP6_FW_H
  41 #define _IP6_FW_H
  42 #include <sys/appleapiopts.h>
  43
  44 #include <net/if.h>
  45 #ifdef __APPLE_API_PRIVATE
  46
  47 #define IP6_FW_CURRENT_API_VERSION 20   /* Version of this API */
  48
  49
  50 /*
  51  * This union structure identifies an interface, either explicitly
  52  * by name or implicitly by IP address. The flags IP_FW_F_IIFNAME
  53  * and IP_FW_F_OIFNAME say how to interpret this structure. An
  54  * interface unit number of -1 matches any unit number, while an
  55  * IP address of 0.0.0.0 indicates matches any interface.
  56  *
  57  * The receive and transmit interfaces are only compared against the
  58  * the packet if the corresponding bit (IP_FW_F_IIFACE or IP_FW_F_OIFACE)
  59  * is set. Note some packets lack a receive or transmit interface
  60  * (in which case the missing "interface" never matches).
  61  */
  62
  63 union ip6_fw_if {
  64     struct in6_addr fu_via_ip6; /* Specified by IPv6 address */
  65     struct {                    /* Specified by interface name */
  66 #define IP6FW_IFNLEN     IFNAMSIZ
  67             char  name[IP6FW_IFNLEN];
  68             short unit;         /* -1 means match any unit */
  69     } fu_via_if;
  70 };
  71
  72 /*
  73  * Format of an IP firewall descriptor
  74  *
  75  * fw_src, fw_dst, fw_smsk, fw_dmsk are always stored in network byte order.
  76  * fw_flg and fw_n*p are stored in host byte order (of course).
  77  * Port numbers are stored in HOST byte order.
  78  * Warning: setsockopt() will fail if sizeof(struct ip_fw) > MLEN (108)
  79  */
  80
  81 struct ip6_fw {
  82         u_int32_t version;              /* Version of this structure.  Should always be */
  83                                                         /* set to IP6_FW_CURRENT_API_VERSION by clients. */
  84         void *context;                  /* Context that is usable by user processes to */
  85                                                         /* identify this rule. */
  86     u_long fw_pcnt,fw_bcnt;             /* Packet and byte counters */
  87     struct in6_addr fw_src, fw_dst;     /* Source and destination IPv6 addr */
  88     struct in6_addr fw_smsk, fw_dmsk;   /* Mask for src and dest IPv6 addr */
  89     u_short fw_number;                  /* Rule number */
  90     u_short fw_flg;                     /* Flags word */
  91 #define IPV6_FW_MAX_PORTS       10      /* A reasonable maximum */
  92     u_int fw_ipflg;                     /* IP flags word */
  93     u_short fw_pts[IPV6_FW_MAX_PORTS];  /* Array of port numbers to match */
  94     u_char fw_ip6opt,fw_ip6nopt;        /* IPv6 options set/unset */
  95     u_char fw_tcpf,fw_tcpnf;            /* TCP flags set/unset */
  96 #define IPV6_FW_ICMPTYPES_DIM (256 / (sizeof(unsigned) * 8))
  97     unsigned fw_icmp6types[IPV6_FW_ICMPTYPES_DIM]; /* ICMP types bitmap */
  98     long timestamp;                     /* timestamp (tv_sec) of last match */
  99     union ip6_fw_if fw_in_if, fw_out_if;/* Incoming and outgoing interfaces */
 100     union {
 101         u_short fu_divert_port;         /* Divert/tee port (options IP6DIVERT) */
 102         u_short fu_skipto_rule;         /* SKIPTO command rule number */
 103         u_short fu_reject_code;         /* REJECT response code */
 104     } fw_un;
 105     u_char fw_prot;                     /* IPv6 protocol */
 106     u_char fw_nports;                   /* N'of src ports and # of dst ports */
 107                                         /* in ports array (dst ports follow */
 108                                         /* src ports; max of 10 ports in all; */
 109                                         /* count of 0 means match all ports) */
 110 };
 111
 112 #define IPV6_FW_GETNSRCP(rule)          ((rule)->fw_nports & 0x0f)
 113 #define IPV6_FW_SETNSRCP(rule, n)               do {                            \
 114                                           (rule)->fw_nports &= ~0x0f;   \
 115                                           (rule)->fw_nports |= (n);     \
 116                                         } while (0)
 117 #define IPV6_FW_GETNDSTP(rule)          ((rule)->fw_nports >> 4)
 118 #define IPV6_FW_SETNDSTP(rule, n)               do {                            \
 119                                           (rule)->fw_nports &= ~0xf0;   \
 120                                           (rule)->fw_nports |= (n) << 4;\
 121                                         } while (0)
 122
 123 #define fw_divert_port  fw_un.fu_divert_port
 124 #define fw_skipto_rule  fw_un.fu_skipto_rule
 125 #define fw_reject_code  fw_un.fu_reject_code
 126
 127 struct ip6_fw_chain {
 128         LIST_ENTRY(ip6_fw_chain) chain;
 129         struct ip6_fw    *rule;
 130 };
 131
 132 /*
 133  * Values for "flags" field .
 134  */
 135 #define IPV6_FW_F_IN    0x0001  /* Check inbound packets                */
 136 #define IPV6_FW_F_OUT   0x0002  /* Check outbound packets               */
 137 #define IPV6_FW_F_IIFACE        0x0004  /* Apply inbound interface test         */
 138 #define IPV6_FW_F_OIFACE        0x0008  /* Apply outbound interface test        */
 139
 140 #define IPV6_FW_F_COMMAND 0x0070        /* Mask for type of chain entry:        */
 141 #define IPV6_FW_F_DENY  0x0000  /* This is a deny rule                  */
 142 #define IPV6_FW_F_REJECT        0x0010  /* Deny and send a response packet      */
 143 #define IPV6_FW_F_ACCEPT        0x0020  /* This is an accept rule               */
 144 #define IPV6_FW_F_COUNT 0x0030  /* This is a count rule                 */
 145 #define IPV6_FW_F_DIVERT        0x0040  /* This is a divert rule                */
 146 #define IPV6_FW_F_TEE   0x0050  /* This is a tee rule                   */
 147 #define IPV6_FW_F_SKIPTO        0x0060  /* This is a skipto rule                */
 148
 149 #define IPV6_FW_F_PRN   0x0080  /* Print if this rule matches           */
 150
 151 #define IPV6_FW_F_SRNG  0x0100  /* The first two src ports are a min    *
 152                                  * and max range (stored in host byte   *
 153                                  * order).                              */
 154
 155 #define IPV6_FW_F_DRNG  0x0200  /* The first two dst ports are a min    *
 156                                  * and max range (stored in host byte   *
 157                                  * order).                              */
 158
 159 #define IPV6_FW_F_IIFNAME       0x0400  /* In interface by name/unit (not IP)   */
 160 #define IPV6_FW_F_OIFNAME       0x0800  /* Out interface by name/unit (not IP)  */
 161
 162 #define IPV6_FW_F_INVSRC        0x1000  /* Invert sense of src check            */
 163 #define IPV6_FW_F_INVDST        0x2000  /* Invert sense of dst check            */
 164
 165 #define IPV6_FW_F_FRAG  0x4000  /* Fragment                             */
 166
 167 #define IPV6_FW_F_ICMPBIT 0x8000        /* ICMP type bitmap is valid            */
 168
 169 #define IPV6_FW_F_MASK  0xFFFF  /* All possible flag bits mask          */
 170
 171 /*
 172  * Flags for the 'fw_ipflg' field, for comparing values of ip and its protocols. */
 173 #define IPV6_FW_IF_TCPEST 0x00000020    /* established TCP connection   */
 174 #define IPV6_FW_IF_TCPMSK 0x00000020    /* mask of all TCP values */
 175
 176 /*
 177  * For backwards compatibility with rules specifying "via iface" but
 178  * not restricted to only "in" or "out" packets, we define this combination
 179  * of bits to represent this configuration.
 180  */
 181
 182 #define IF6_FW_F_VIAHACK        (IPV6_FW_F_IN|IPV6_FW_F_OUT|IPV6_FW_F_IIFACE|IPV6_FW_F_OIFACE)
 183
 184 /*
 185  * Definitions for REJECT response codes.
 186  * Values less than 256 correspond to ICMP unreachable codes.
 187  */
 188 #define IPV6_FW_REJECT_RST      0x0100          /* TCP packets: send RST */
 189
 190 /*
 191  * Definitions for IPv6 option names.
 192  */
 193 #define IPV6_FW_IP6OPT_HOPOPT   0x01
 194 #define IPV6_FW_IP6OPT_ROUTE    0x02
 195 #define IPV6_FW_IP6OPT_FRAG     0x04
 196 #define IPV6_FW_IP6OPT_ESP      0x08
 197 #define IPV6_FW_IP6OPT_AH       0x10
 198 #define IPV6_FW_IP6OPT_NONXT    0x20
 199 #define IPV6_FW_IP6OPT_OPTS     0x40
 200
 201 /*
 202  * Definitions for TCP flags.
 203  */
 204 #define IPV6_FW_TCPF_FIN        TH_FIN
 205 #define IPV6_FW_TCPF_SYN        TH_SYN
 206 #define IPV6_FW_TCPF_RST        TH_RST
 207 #define IPV6_FW_TCPF_PSH        TH_PUSH
 208 #define IPV6_FW_TCPF_ACK        TH_ACK
 209 #define IPV6_FW_TCPF_URG        TH_URG
 210
 211 /*
 212  * Main firewall chains definitions and global var's definitions.
 213  */
 214 #ifdef KERNEL
 215
 216 #define M_IP6FW M_IPFW
 217
 218
 219 /*
 220  * Function definitions.
 221  */
 222 void ip6_fw_init(void);
 223
 224 /* Firewall hooks */
 225 struct ip6_hdr;
 226 typedef int ip6_fw_chk_t __P((struct ip6_hdr**, struct ifnet*,
 227                                 u_short *, struct mbuf**));
 228 typedef int ip6_fw_ctl_t __P((int, struct mbuf**));
 229 extern  ip6_fw_chk_t *ip6_fw_chk_ptr;
 230 extern  ip6_fw_ctl_t *ip6_fw_ctl_ptr;
 231 extern  int ip6_fw_enable;
 232
 233 #endif /* KERNEL */
 234 #endif /* __APPLE_API_PRIVATE */
 235
 236 #endif /* _IP6_FW_H */