blob: 0bc8dc3f9e3cbdb74c8d846fc919904ada484b6f [file] [log] [blame]
Paul Moored15c3452006-08-03 16:48:37 -07001/*
2 * NetLabel Unlabeled Support
3 *
4 * This file defines functions for dealing with unlabeled packets for the
5 * NetLabel system. The NetLabel system manages static and dynamic label
6 * mappings for network protocols such as CIPSO and RIPSO.
7 *
8 * Author: Paul Moore <paul.moore@hp.com>
9 *
10 */
11
12/*
13 * (c) Copyright Hewlett-Packard Development Company, L.P., 2006
14 *
15 * This program is free software; you can redistribute it and/or modify
16 * it under the terms of the GNU General Public License as published by
17 * the Free Software Foundation; either version 2 of the License, or
18 * (at your option) any later version.
19 *
20 * This program is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
23 * the GNU General Public License for more details.
24 *
25 * You should have received a copy of the GNU General Public License
26 * along with this program; if not, write to the Free Software
27 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28 *
29 */
30
31#ifndef _NETLABEL_UNLABELED_H
32#define _NETLABEL_UNLABELED_H
33
34#include <net/netlabel.h>
35
36/*
37 * The following NetLabel payloads are supported by the Unlabeled subsystem.
38 *
Paul Moore8cc44572008-01-29 08:44:21 -050039 * o STATICADD
40 * This message is sent from an application to add a new static label for
41 * incoming unlabeled connections.
42 *
43 * Required attributes:
44 *
45 * NLBL_UNLABEL_A_IFACE
46 * NLBL_UNLABEL_A_SECCTX
47 *
48 * If IPv4 is specified the following attributes are required:
49 *
50 * NLBL_UNLABEL_A_IPV4ADDR
51 * NLBL_UNLABEL_A_IPV4MASK
52 *
53 * If IPv6 is specified the following attributes are required:
54 *
55 * NLBL_UNLABEL_A_IPV6ADDR
56 * NLBL_UNLABEL_A_IPV6MASK
57 *
58 * o STATICREMOVE
59 * This message is sent from an application to remove an existing static
60 * label for incoming unlabeled connections.
61 *
62 * Required attributes:
63 *
64 * NLBL_UNLABEL_A_IFACE
65 *
66 * If IPv4 is specified the following attributes are required:
67 *
68 * NLBL_UNLABEL_A_IPV4ADDR
69 * NLBL_UNLABEL_A_IPV4MASK
70 *
71 * If IPv6 is specified the following attributes are required:
72 *
73 * NLBL_UNLABEL_A_IPV6ADDR
74 * NLBL_UNLABEL_A_IPV6MASK
75 *
76 * o STATICLIST
77 * This message can be sent either from an application or by the kernel in
78 * response to an application generated STATICLIST message. When sent by an
79 * application there is no payload and the NLM_F_DUMP flag should be set.
80 * The kernel should response with a series of the following messages.
81 *
82 * Required attributes:
83 *
84 * NLBL_UNLABEL_A_IFACE
85 * NLBL_UNLABEL_A_SECCTX
86 *
87 * If IPv4 is specified the following attributes are required:
88 *
89 * NLBL_UNLABEL_A_IPV4ADDR
90 * NLBL_UNLABEL_A_IPV4MASK
91 *
92 * If IPv6 is specified the following attributes are required:
93 *
94 * NLBL_UNLABEL_A_IPV6ADDR
95 * NLBL_UNLABEL_A_IPV6MASK
96 *
97 * o STATICADDDEF
98 * This message is sent from an application to set the default static
99 * label for incoming unlabeled connections.
100 *
101 * Required attribute:
102 *
103 * NLBL_UNLABEL_A_SECCTX
104 *
105 * If IPv4 is specified the following attributes are required:
106 *
107 * NLBL_UNLABEL_A_IPV4ADDR
108 * NLBL_UNLABEL_A_IPV4MASK
109 *
110 * If IPv6 is specified the following attributes are required:
111 *
112 * NLBL_UNLABEL_A_IPV6ADDR
113 * NLBL_UNLABEL_A_IPV6MASK
114 *
115 * o STATICREMOVEDEF
116 * This message is sent from an application to remove the existing default
117 * static label for incoming unlabeled connections.
118 *
119 * If IPv4 is specified the following attributes are required:
120 *
121 * NLBL_UNLABEL_A_IPV4ADDR
122 * NLBL_UNLABEL_A_IPV4MASK
123 *
124 * If IPv6 is specified the following attributes are required:
125 *
126 * NLBL_UNLABEL_A_IPV6ADDR
127 * NLBL_UNLABEL_A_IPV6MASK
128 *
129 * o STATICLISTDEF
130 * This message can be sent either from an application or by the kernel in
131 * response to an application generated STATICLISTDEF message. When sent by
132 * an application there is no payload and the NLM_F_DUMP flag should be set.
133 * The kernel should response with the following message.
134 *
135 * Required attribute:
136 *
137 * NLBL_UNLABEL_A_SECCTX
138 *
139 * If IPv4 is specified the following attributes are required:
140 *
141 * NLBL_UNLABEL_A_IPV4ADDR
142 * NLBL_UNLABEL_A_IPV4MASK
143 *
144 * If IPv6 is specified the following attributes are required:
145 *
146 * NLBL_UNLABEL_A_IPV6ADDR
147 * NLBL_UNLABEL_A_IPV6MASK
148 *
Paul Moored15c3452006-08-03 16:48:37 -0700149 * o ACCEPT
150 * This message is sent from an application to specify if the kernel should
151 * allow unlabled packets to pass if they do not match any of the static
152 * mappings defined in the unlabeled module.
153 *
Paul Moorefd385852006-09-25 15:56:37 -0700154 * Required attributes:
Paul Moored15c3452006-08-03 16:48:37 -0700155 *
Paul Moorefd385852006-09-25 15:56:37 -0700156 * NLBL_UNLABEL_A_ACPTFLG
Paul Moored15c3452006-08-03 16:48:37 -0700157 *
158 * o LIST
159 * This message can be sent either from an application or by the kernel in
160 * response to an application generated LIST message. When sent by an
161 * application there is no payload. The kernel should respond to a LIST
Paul Moorefd385852006-09-25 15:56:37 -0700162 * message with a LIST message on success.
Paul Moored15c3452006-08-03 16:48:37 -0700163 *
Paul Moorefd385852006-09-25 15:56:37 -0700164 * Required attributes:
Paul Moored15c3452006-08-03 16:48:37 -0700165 *
Paul Moorefd385852006-09-25 15:56:37 -0700166 * NLBL_UNLABEL_A_ACPTFLG
Paul Moored15c3452006-08-03 16:48:37 -0700167 *
168 */
169
170/* NetLabel Unlabeled commands */
171enum {
172 NLBL_UNLABEL_C_UNSPEC,
Paul Moored15c3452006-08-03 16:48:37 -0700173 NLBL_UNLABEL_C_ACCEPT,
174 NLBL_UNLABEL_C_LIST,
Paul Moore8cc44572008-01-29 08:44:21 -0500175 NLBL_UNLABEL_C_STATICADD,
176 NLBL_UNLABEL_C_STATICREMOVE,
177 NLBL_UNLABEL_C_STATICLIST,
178 NLBL_UNLABEL_C_STATICADDDEF,
179 NLBL_UNLABEL_C_STATICREMOVEDEF,
180 NLBL_UNLABEL_C_STATICLISTDEF,
Paul Moored15c3452006-08-03 16:48:37 -0700181 __NLBL_UNLABEL_C_MAX,
182};
Paul Moored15c3452006-08-03 16:48:37 -0700183
Paul Moorefd385852006-09-25 15:56:37 -0700184/* NetLabel Unlabeled attributes */
185enum {
186 NLBL_UNLABEL_A_UNSPEC,
187 NLBL_UNLABEL_A_ACPTFLG,
188 /* (NLA_U8)
189 * if true then unlabeled packets are allowed to pass, else unlabeled
190 * packets are rejected */
Paul Moore8cc44572008-01-29 08:44:21 -0500191 NLBL_UNLABEL_A_IPV6ADDR,
192 /* (NLA_BINARY, struct in6_addr)
193 * an IPv6 address */
194 NLBL_UNLABEL_A_IPV6MASK,
195 /* (NLA_BINARY, struct in6_addr)
196 * an IPv6 address mask */
197 NLBL_UNLABEL_A_IPV4ADDR,
198 /* (NLA_BINARY, struct in_addr)
199 * an IPv4 address */
200 NLBL_UNLABEL_A_IPV4MASK,
201 /* (NLA_BINARY, struct in_addr)
202 * and IPv4 address mask */
203 NLBL_UNLABEL_A_IFACE,
204 /* (NLA_NULL_STRING)
205 * network interface */
206 NLBL_UNLABEL_A_SECCTX,
207 /* (NLA_BINARY)
208 * a LSM specific security context */
Paul Moorefd385852006-09-25 15:56:37 -0700209 __NLBL_UNLABEL_A_MAX,
210};
211#define NLBL_UNLABEL_A_MAX (__NLBL_UNLABEL_A_MAX - 1)
212
Paul Moored15c3452006-08-03 16:48:37 -0700213/* NetLabel protocol functions */
214int netlbl_unlabel_genl_init(void);
215
Paul Moore8cc44572008-01-29 08:44:21 -0500216/* Unlabeled connection hash table size */
217/* XXX - currently this number is an uneducated guess */
218#define NETLBL_UNLHSH_BITSIZE 7
219
220/* General Unlabeled init function */
221int netlbl_unlabel_init(u32 size);
222
Paul Moore6c2e8ac2008-12-31 12:54:11 -0500223/* Static/Fallback label management functions */
224int netlbl_unlhsh_add(struct net *net,
225 const char *dev_name,
226 const void *addr,
227 const void *mask,
228 u32 addr_len,
229 u32 secid,
230 struct netlbl_audit *audit_info);
231int netlbl_unlhsh_remove(struct net *net,
232 const char *dev_name,
233 const void *addr,
234 const void *mask,
235 u32 addr_len,
236 struct netlbl_audit *audit_info);
237
Paul Moored15c3452006-08-03 16:48:37 -0700238/* Process Unlabeled incoming network packets */
Paul Moore8cc44572008-01-29 08:44:21 -0500239int netlbl_unlabel_getattr(const struct sk_buff *skb,
240 u16 family,
241 struct netlbl_lsm_secattr *secattr);
Paul Moored15c3452006-08-03 16:48:37 -0700242
243/* Set the default configuration to allow Unlabeled packets */
244int netlbl_unlabel_defconf(void);
245
246#endif