GNU Linux-libre 4.14.266-gnu1
[releases.git] / net / netlabel / netlabel_mgmt.h
1 /*
2  * NetLabel Management Support
3  *
4  * This file defines the management functions for the NetLabel system.  The
5  * NetLabel system manages static and dynamic label mappings for network
6  * protocols such as CIPSO and RIPSO.
7  *
8  * Author: Paul Moore <paul@paul-moore.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, see <http://www.gnu.org/licenses/>.
27  *
28  */
29
30 #ifndef _NETLABEL_MGMT_H
31 #define _NETLABEL_MGMT_H
32
33 #include <net/netlabel.h>
34 #include <linux/atomic.h>
35
36 /*
37  * The following NetLabel payloads are supported by the management interface.
38  *
39  * o ADD:
40  *   Sent by an application to add a domain mapping to the NetLabel system.
41  *
42  *   Required attributes:
43  *
44  *     NLBL_MGMT_A_DOMAIN
45  *     NLBL_MGMT_A_PROTOCOL
46  *
47  *   If IPv4 is specified the following attributes are required:
48  *
49  *     NLBL_MGMT_A_IPV4ADDR
50  *     NLBL_MGMT_A_IPV4MASK
51  *
52  *   If IPv6 is specified the following attributes are required:
53  *
54  *     NLBL_MGMT_A_IPV6ADDR
55  *     NLBL_MGMT_A_IPV6MASK
56  *
57  *   If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required:
58  *
59  *     NLBL_MGMT_A_CV4DOI
60  *
61  *   If using NETLBL_NLTYPE_UNLABELED no other attributes are required,
62  *   however the following attribute may optionally be sent:
63  *
64  *     NLBL_MGMT_A_FAMILY
65  *
66  * o REMOVE:
67  *   Sent by an application to remove a domain mapping from the NetLabel
68  *   system.
69  *
70  *   Required attributes:
71  *
72  *     NLBL_MGMT_A_DOMAIN
73  *
74  * o LISTALL:
75  *   This message can be sent either from an application or by the kernel in
76  *   response to an application generated LISTALL message.  When sent by an
77  *   application there is no payload and the NLM_F_DUMP flag should be set.
78  *   The kernel should respond with a series of the following messages.
79  *
80  *   Required attributes:
81  *
82  *     NLBL_MGMT_A_DOMAIN
83  *     NLBL_MGMT_A_FAMILY
84  *
85  *   If the IP address selectors are not used the following attribute is
86  *   required:
87  *
88  *     NLBL_MGMT_A_PROTOCOL
89  *
90  *   If the IP address selectors are used then the following attritbute is
91  *   required:
92  *
93  *     NLBL_MGMT_A_SELECTORLIST
94  *
95  *   If the mapping is using the NETLBL_NLTYPE_CIPSOV4 type then the following
96  *   attributes are required:
97  *
98  *     NLBL_MGMT_A_CV4DOI
99  *
100  *   If the mapping is using the NETLBL_NLTYPE_UNLABELED type no other
101  *   attributes are required.
102  *
103  * o ADDDEF:
104  *   Sent by an application to set the default domain mapping for the NetLabel
105  *   system.
106  *
107  *   Required attributes:
108  *
109  *     NLBL_MGMT_A_PROTOCOL
110  *
111  *   If using NETLBL_NLTYPE_CIPSOV4 the following attributes are required:
112  *
113  *     NLBL_MGMT_A_CV4DOI
114  *
115  *   If using NETLBL_NLTYPE_UNLABELED no other attributes are required,
116  *   however the following attribute may optionally be sent:
117  *
118  *     NLBL_MGMT_A_FAMILY
119  *
120  * o REMOVEDEF:
121  *   Sent by an application to remove the default domain mapping from the
122  *   NetLabel system, there is no payload.
123  *
124  * o LISTDEF:
125  *   This message can be sent either from an application or by the kernel in
126  *   response to an application generated LISTDEF message.  When sent by an
127  *   application there may be an optional payload.
128  *
129  *     NLBL_MGMT_A_FAMILY
130  *
131  *   On success the kernel should send a response using the following format:
132  *
133  *   If the IP address selectors are not used the following attributes are
134  *   required:
135  *
136  *     NLBL_MGMT_A_PROTOCOL
137  *     NLBL_MGMT_A_FAMILY
138  *
139  *   If the IP address selectors are used then the following attritbute is
140  *   required:
141  *
142  *     NLBL_MGMT_A_SELECTORLIST
143  *
144  *   If the mapping is using the NETLBL_NLTYPE_CIPSOV4 type then the following
145  *   attributes are required:
146  *
147  *     NLBL_MGMT_A_CV4DOI
148  *
149  *   If the mapping is using the NETLBL_NLTYPE_UNLABELED type no other
150  *   attributes are required.
151  *
152  * o PROTOCOLS:
153  *   Sent by an application to request a list of configured NetLabel protocols
154  *   in the kernel.  When sent by an application there is no payload and the
155  *   NLM_F_DUMP flag should be set.  The kernel should respond with a series of
156  *   the following messages.
157  *
158  *   Required attributes:
159  *
160  *     NLBL_MGMT_A_PROTOCOL
161  *
162  * o VERSION:
163  *   Sent by an application to request the NetLabel version.  When sent by an
164  *   application there is no payload.  This message type is also used by the
165  *   kernel to respond to an VERSION request.
166  *
167  *   Required attributes:
168  *
169  *     NLBL_MGMT_A_VERSION
170  *
171  */
172
173 /* NetLabel Management commands */
174 enum {
175         NLBL_MGMT_C_UNSPEC,
176         NLBL_MGMT_C_ADD,
177         NLBL_MGMT_C_REMOVE,
178         NLBL_MGMT_C_LISTALL,
179         NLBL_MGMT_C_ADDDEF,
180         NLBL_MGMT_C_REMOVEDEF,
181         NLBL_MGMT_C_LISTDEF,
182         NLBL_MGMT_C_PROTOCOLS,
183         NLBL_MGMT_C_VERSION,
184         __NLBL_MGMT_C_MAX,
185 };
186
187 /* NetLabel Management attributes */
188 enum {
189         NLBL_MGMT_A_UNSPEC,
190         NLBL_MGMT_A_DOMAIN,
191         /* (NLA_NUL_STRING)
192          * the NULL terminated LSM domain string */
193         NLBL_MGMT_A_PROTOCOL,
194         /* (NLA_U32)
195          * the NetLabel protocol type (defined by NETLBL_NLTYPE_*) */
196         NLBL_MGMT_A_VERSION,
197         /* (NLA_U32)
198          * the NetLabel protocol version number (defined by
199          * NETLBL_PROTO_VERSION) */
200         NLBL_MGMT_A_CV4DOI,
201         /* (NLA_U32)
202          * the CIPSOv4 DOI value */
203         NLBL_MGMT_A_IPV6ADDR,
204         /* (NLA_BINARY, struct in6_addr)
205          * an IPv6 address */
206         NLBL_MGMT_A_IPV6MASK,
207         /* (NLA_BINARY, struct in6_addr)
208          * an IPv6 address mask */
209         NLBL_MGMT_A_IPV4ADDR,
210         /* (NLA_BINARY, struct in_addr)
211          * an IPv4 address */
212         NLBL_MGMT_A_IPV4MASK,
213         /* (NLA_BINARY, struct in_addr)
214          * and IPv4 address mask */
215         NLBL_MGMT_A_ADDRSELECTOR,
216         /* (NLA_NESTED)
217          * an IP address selector, must contain an address, mask, and protocol
218          * attribute plus any protocol specific attributes */
219         NLBL_MGMT_A_SELECTORLIST,
220         /* (NLA_NESTED)
221          * the selector list, there must be at least one
222          * NLBL_MGMT_A_ADDRSELECTOR attribute */
223         NLBL_MGMT_A_FAMILY,
224         /* (NLA_U16)
225          * The address family */
226         NLBL_MGMT_A_CLPDOI,
227         /* (NLA_U32)
228          * the CALIPSO DOI value */
229         __NLBL_MGMT_A_MAX,
230 };
231 #define NLBL_MGMT_A_MAX (__NLBL_MGMT_A_MAX - 1)
232
233 /* NetLabel protocol functions */
234 int netlbl_mgmt_genl_init(void);
235
236 /* NetLabel configured protocol reference counter */
237 extern atomic_t netlabel_mgmt_protocount;
238
239 #endif