netlabel: Replace protocol/NetLabel linking with refrerence counts
[linux-2.6.git] / include / net / cipso_ipv4.h
1 /*
2  * CIPSO - Commercial IP Security Option
3  *
4  * This is an implementation of the CIPSO 2.2 protocol as specified in
5  * draft-ietf-cipso-ipsecurity-01.txt with additional tag types as found in
6  * FIPS-188, copies of both documents can be found in the Documentation
7  * directory.  While CIPSO never became a full IETF RFC standard many vendors
8  * have chosen to adopt the protocol and over the years it has become a
9  * de-facto standard for labeled networking.
10  *
11  * Author: Paul Moore <paul.moore@hp.com>
12  *
13  */
14
15 /*
16  * (c) Copyright Hewlett-Packard Development Company, L.P., 2006
17  *
18  * This program is free software;  you can redistribute it and/or modify
19  * it under the terms of the GNU General Public License as published by
20  * the Free Software Foundation; either version 2 of the License, or
21  * (at your option) any later version.
22  *
23  * This program is distributed in the hope that it will be useful,
24  * but WITHOUT ANY WARRANTY;  without even the implied warranty of
25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
26  * the GNU General Public License for more details.
27  *
28  * You should have received a copy of the GNU General Public License
29  * along with this program;  if not, write to the Free Software
30  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
31  *
32  */
33
34 #ifndef _CIPSO_IPV4_H
35 #define _CIPSO_IPV4_H
36
37 #include <linux/types.h>
38 #include <linux/rcupdate.h>
39 #include <linux/list.h>
40 #include <linux/net.h>
41 #include <linux/skbuff.h>
42 #include <net/netlabel.h>
43 #include <asm/atomic.h>
44
45 /* known doi values */
46 #define CIPSO_V4_DOI_UNKNOWN          0x00000000
47
48 /* tag types */
49 #define CIPSO_V4_TAG_INVALID          0
50 #define CIPSO_V4_TAG_RBITMAP          1
51 #define CIPSO_V4_TAG_ENUM             2
52 #define CIPSO_V4_TAG_RANGE            5
53 #define CIPSO_V4_TAG_PBITMAP          6
54 #define CIPSO_V4_TAG_FREEFORM         7
55
56 /* doi mapping types */
57 #define CIPSO_V4_MAP_UNKNOWN          0
58 #define CIPSO_V4_MAP_STD              1
59 #define CIPSO_V4_MAP_PASS             2
60
61 /* limits */
62 #define CIPSO_V4_MAX_REM_LVLS         255
63 #define CIPSO_V4_INV_LVL              0x80000000
64 #define CIPSO_V4_MAX_LOC_LVLS         (CIPSO_V4_INV_LVL - 1)
65 #define CIPSO_V4_MAX_REM_CATS         65534
66 #define CIPSO_V4_INV_CAT              0x80000000
67 #define CIPSO_V4_MAX_LOC_CATS         (CIPSO_V4_INV_CAT - 1)
68
69 /*
70  * CIPSO DOI definitions
71  */
72
73 /* DOI definition struct */
74 #define CIPSO_V4_TAG_MAXCNT           5
75 struct cipso_v4_doi {
76         u32 doi;
77         u32 type;
78         union {
79                 struct cipso_v4_std_map_tbl *std;
80         } map;
81         u8 tags[CIPSO_V4_TAG_MAXCNT];
82
83         atomic_t refcount;
84         struct list_head list;
85         struct rcu_head rcu;
86 };
87
88 /* Standard CIPSO mapping table */
89 /* NOTE: the highest order bit (i.e. 0x80000000) is an 'invalid' flag, if the
90  *       bit is set then consider that value as unspecified, meaning the
91  *       mapping for that particular level/category is invalid */
92 struct cipso_v4_std_map_tbl {
93         struct {
94                 u32 *cipso;
95                 u32 *local;
96                 u32 cipso_size;
97                 u32 local_size;
98         } lvl;
99         struct {
100                 u32 *cipso;
101                 u32 *local;
102                 u32 cipso_size;
103                 u32 local_size;
104         } cat;
105 };
106
107 /*
108  * Sysctl Variables
109  */
110
111 #ifdef CONFIG_NETLABEL
112 extern int cipso_v4_cache_enabled;
113 extern int cipso_v4_cache_bucketsize;
114 extern int cipso_v4_rbm_optfmt;
115 extern int cipso_v4_rbm_strictvalid;
116 #endif
117
118 /*
119  * Helper Functions
120  */
121
122 #define CIPSO_V4_OPTEXIST(x) (IPCB(x)->opt.cipso != 0)
123 #define CIPSO_V4_OPTPTR(x) (skb_network_header(x) + IPCB(x)->opt.cipso)
124
125 /*
126  * DOI List Functions
127  */
128
129 #ifdef CONFIG_NETLABEL
130 int cipso_v4_doi_add(struct cipso_v4_doi *doi_def);
131 void cipso_v4_doi_free(struct cipso_v4_doi *doi_def);
132 int cipso_v4_doi_remove(u32 doi, struct netlbl_audit *audit_info);
133 struct cipso_v4_doi *cipso_v4_doi_getdef(u32 doi);
134 void cipso_v4_doi_putdef(struct cipso_v4_doi *doi_def);
135 int cipso_v4_doi_walk(u32 *skip_cnt,
136                      int (*callback) (struct cipso_v4_doi *doi_def, void *arg),
137                      void *cb_arg);
138 #else
139 static inline int cipso_v4_doi_add(struct cipso_v4_doi *doi_def)
140 {
141         return -ENOSYS;
142 }
143
144 static inline void cipso_v4_doi_free(struct cipso_v4_doi *doi_def)
145 {
146         return;
147 }
148
149 static inline int cipso_v4_doi_remove(u32 doi,
150                                       struct netlbl_audit *audit_info)
151 {
152         return 0;
153 }
154
155 static inline struct cipso_v4_doi *cipso_v4_doi_getdef(u32 doi)
156 {
157         return NULL;
158 }
159
160 static inline int cipso_v4_doi_walk(u32 *skip_cnt,
161                      int (*callback) (struct cipso_v4_doi *doi_def, void *arg),
162                      void *cb_arg)
163 {
164         return 0;
165 }
166
167 static inline int cipso_v4_doi_domhsh_add(struct cipso_v4_doi *doi_def,
168                                           const char *domain)
169 {
170         return -ENOSYS;
171 }
172
173 static inline int cipso_v4_doi_domhsh_remove(struct cipso_v4_doi *doi_def,
174                                              const char *domain)
175 {
176         return 0;
177 }
178 #endif /* CONFIG_NETLABEL */
179
180 /*
181  * Label Mapping Cache Functions
182  */
183
184 #ifdef CONFIG_NETLABEL
185 void cipso_v4_cache_invalidate(void);
186 int cipso_v4_cache_add(const struct sk_buff *skb,
187                        const struct netlbl_lsm_secattr *secattr);
188 #else
189 static inline void cipso_v4_cache_invalidate(void)
190 {
191         return;
192 }
193
194 static inline int cipso_v4_cache_add(const struct sk_buff *skb,
195                                      const struct netlbl_lsm_secattr *secattr)
196 {
197         return 0;
198 }
199 #endif /* CONFIG_NETLABEL */
200
201 /*
202  * Protocol Handling Functions
203  */
204
205 #ifdef CONFIG_NETLABEL
206 void cipso_v4_error(struct sk_buff *skb, int error, u32 gateway);
207 int cipso_v4_sock_setattr(struct sock *sk,
208                           const struct cipso_v4_doi *doi_def,
209                           const struct netlbl_lsm_secattr *secattr);
210 int cipso_v4_sock_getattr(struct sock *sk, struct netlbl_lsm_secattr *secattr);
211 int cipso_v4_skbuff_getattr(const struct sk_buff *skb,
212                             struct netlbl_lsm_secattr *secattr);
213 int cipso_v4_validate(unsigned char **option);
214 #else
215 static inline void cipso_v4_error(struct sk_buff *skb,
216                                   int error,
217                                   u32 gateway)
218 {
219         return;
220 }
221
222 static inline int cipso_v4_sock_setattr(struct sock *sk,
223                                       const struct cipso_v4_doi *doi_def,
224                                       const struct netlbl_lsm_secattr *secattr)
225 {
226         return -ENOSYS;
227 }
228
229 static inline int cipso_v4_sock_getattr(struct sock *sk,
230                                         struct netlbl_lsm_secattr *secattr)
231 {
232         return -ENOSYS;
233 }
234
235 static inline int cipso_v4_skbuff_getattr(const struct sk_buff *skb,
236                                           struct netlbl_lsm_secattr *secattr)
237 {
238         return -ENOSYS;
239 }
240
241 static inline int cipso_v4_validate(unsigned char **option)
242 {
243         return -ENOSYS;
244 }
245 #endif /* CONFIG_NETLABEL */
246
247 #endif /* _CIPSO_IPV4_H */