2 * NetLabel Management Support
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.
8 * Author: Paul Moore <paul@paul-moore.com>
13 * (c) Copyright Hewlett-Packard Development Company, L.P., 2006, 2008
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.
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.
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/>.
30 #include <linux/types.h>
31 #include <linux/socket.h>
32 #include <linux/string.h>
33 #include <linux/skbuff.h>
35 #include <linux/in6.h>
36 #include <linux/slab.h>
38 #include <net/netlink.h>
39 #include <net/genetlink.h>
42 #include <net/netlabel.h>
43 #include <net/cipso_ipv4.h>
44 #include <linux/atomic.h>
46 #include "netlabel_domainhash.h"
47 #include "netlabel_user.h"
48 #include "netlabel_mgmt.h"
50 /* NetLabel configured protocol counter */
51 atomic_t netlabel_mgmt_protocount = ATOMIC_INIT(0);
53 /* Argument struct for netlbl_domhsh_walk() */
54 struct netlbl_domhsh_walk_arg {
55 struct netlink_callback *nl_cb;
60 /* NetLabel Generic NETLINK CIPSOv4 family */
61 static struct genl_family netlbl_mgmt_gnl_family = {
62 .id = GENL_ID_GENERATE,
64 .name = NETLBL_NLTYPE_MGMT_NAME,
65 .version = NETLBL_PROTO_VERSION,
66 .maxattr = NLBL_MGMT_A_MAX,
69 /* NetLabel Netlink attribute policy */
70 static const struct nla_policy netlbl_mgmt_genl_policy[NLBL_MGMT_A_MAX + 1] = {
71 [NLBL_MGMT_A_DOMAIN] = { .type = NLA_NUL_STRING },
72 [NLBL_MGMT_A_PROTOCOL] = { .type = NLA_U32 },
73 [NLBL_MGMT_A_VERSION] = { .type = NLA_U32 },
74 [NLBL_MGMT_A_CV4DOI] = { .type = NLA_U32 },
82 * netlbl_mgmt_add - Handle an ADD message
83 * @info: the Generic NETLINK info block
84 * @audit_info: NetLabel audit information
87 * Helper function for the ADD and ADDDEF messages to add the domain mappings
88 * from the message to the hash table. See netlabel.h for a description of the
89 * message format. Returns zero on success, negative values on failure.
92 static int netlbl_mgmt_add_common(struct genl_info *info,
93 struct netlbl_audit *audit_info)
95 int ret_val = -EINVAL;
96 struct netlbl_domaddr_map *addrmap = NULL;
97 struct cipso_v4_doi *cipsov4 = NULL;
99 struct netlbl_dom_map *entry = kzalloc(sizeof(*entry), GFP_KERNEL);
103 entry->def.type = nla_get_u32(info->attrs[NLBL_MGMT_A_PROTOCOL]);
104 if (info->attrs[NLBL_MGMT_A_DOMAIN]) {
105 size_t tmp_size = nla_len(info->attrs[NLBL_MGMT_A_DOMAIN]);
106 entry->domain = kmalloc(tmp_size, GFP_KERNEL);
107 if (entry->domain == NULL) {
111 nla_strlcpy(entry->domain,
112 info->attrs[NLBL_MGMT_A_DOMAIN], tmp_size);
115 /* NOTE: internally we allow/use a entry->def.type value of
116 * NETLBL_NLTYPE_ADDRSELECT but we don't currently allow users
117 * to pass that as a protocol value because we need to know the
120 switch (entry->def.type) {
121 case NETLBL_NLTYPE_UNLABELED:
123 case NETLBL_NLTYPE_CIPSOV4:
124 if (!info->attrs[NLBL_MGMT_A_CV4DOI])
125 goto add_free_domain;
127 tmp_val = nla_get_u32(info->attrs[NLBL_MGMT_A_CV4DOI]);
128 cipsov4 = cipso_v4_doi_getdef(tmp_val);
130 goto add_free_domain;
131 entry->def.cipso = cipsov4;
134 goto add_free_domain;
137 if (info->attrs[NLBL_MGMT_A_IPV4ADDR]) {
138 struct in_addr *addr;
139 struct in_addr *mask;
140 struct netlbl_domaddr4_map *map;
142 addrmap = kzalloc(sizeof(*addrmap), GFP_KERNEL);
143 if (addrmap == NULL) {
145 goto add_doi_put_def;
147 INIT_LIST_HEAD(&addrmap->list4);
148 INIT_LIST_HEAD(&addrmap->list6);
150 if (nla_len(info->attrs[NLBL_MGMT_A_IPV4ADDR]) !=
151 sizeof(struct in_addr)) {
153 goto add_free_addrmap;
155 if (nla_len(info->attrs[NLBL_MGMT_A_IPV4MASK]) !=
156 sizeof(struct in_addr)) {
158 goto add_free_addrmap;
160 addr = nla_data(info->attrs[NLBL_MGMT_A_IPV4ADDR]);
161 mask = nla_data(info->attrs[NLBL_MGMT_A_IPV4MASK]);
163 map = kzalloc(sizeof(*map), GFP_KERNEL);
166 goto add_free_addrmap;
168 map->list.addr = addr->s_addr & mask->s_addr;
169 map->list.mask = mask->s_addr;
171 map->def.type = entry->def.type;
173 map->def.cipso = cipsov4;
175 ret_val = netlbl_af4list_add(&map->list, &addrmap->list4);
178 goto add_free_addrmap;
181 entry->def.type = NETLBL_NLTYPE_ADDRSELECT;
182 entry->def.addrsel = addrmap;
183 #if IS_ENABLED(CONFIG_IPV6)
184 } else if (info->attrs[NLBL_MGMT_A_IPV6ADDR]) {
185 struct in6_addr *addr;
186 struct in6_addr *mask;
187 struct netlbl_domaddr6_map *map;
189 addrmap = kzalloc(sizeof(*addrmap), GFP_KERNEL);
190 if (addrmap == NULL) {
192 goto add_doi_put_def;
194 INIT_LIST_HEAD(&addrmap->list4);
195 INIT_LIST_HEAD(&addrmap->list6);
197 if (nla_len(info->attrs[NLBL_MGMT_A_IPV6ADDR]) !=
198 sizeof(struct in6_addr)) {
200 goto add_free_addrmap;
202 if (nla_len(info->attrs[NLBL_MGMT_A_IPV6MASK]) !=
203 sizeof(struct in6_addr)) {
205 goto add_free_addrmap;
207 addr = nla_data(info->attrs[NLBL_MGMT_A_IPV6ADDR]);
208 mask = nla_data(info->attrs[NLBL_MGMT_A_IPV6MASK]);
210 map = kzalloc(sizeof(*map), GFP_KERNEL);
213 goto add_free_addrmap;
215 map->list.addr = *addr;
216 map->list.addr.s6_addr32[0] &= mask->s6_addr32[0];
217 map->list.addr.s6_addr32[1] &= mask->s6_addr32[1];
218 map->list.addr.s6_addr32[2] &= mask->s6_addr32[2];
219 map->list.addr.s6_addr32[3] &= mask->s6_addr32[3];
220 map->list.mask = *mask;
222 map->def.type = entry->def.type;
224 ret_val = netlbl_af6list_add(&map->list, &addrmap->list6);
227 goto add_free_addrmap;
230 entry->def.type = NETLBL_NLTYPE_ADDRSELECT;
231 entry->def.addrsel = addrmap;
235 ret_val = netlbl_domhsh_add(entry, audit_info);
237 goto add_free_addrmap;
244 cipso_v4_doi_putdef(cipsov4);
246 kfree(entry->domain);
253 * netlbl_mgmt_listentry - List a NetLabel/LSM domain map entry
254 * @skb: the NETLINK buffer
255 * @entry: the map entry
258 * This function is a helper function used by the LISTALL and LISTDEF command
259 * handlers. The caller is responsible for ensuring that the RCU read lock
260 * is held. Returns zero on success, negative values on failure.
263 static int netlbl_mgmt_listentry(struct sk_buff *skb,
264 struct netlbl_dom_map *entry)
267 struct nlattr *nla_a;
268 struct nlattr *nla_b;
269 struct netlbl_af4list *iter4;
270 #if IS_ENABLED(CONFIG_IPV6)
271 struct netlbl_af6list *iter6;
274 if (entry->domain != NULL) {
275 ret_val = nla_put_string(skb,
276 NLBL_MGMT_A_DOMAIN, entry->domain);
281 switch (entry->def.type) {
282 case NETLBL_NLTYPE_ADDRSELECT:
283 nla_a = nla_nest_start(skb, NLBL_MGMT_A_SELECTORLIST);
287 netlbl_af4list_foreach_rcu(iter4, &entry->def.addrsel->list4) {
288 struct netlbl_domaddr4_map *map4;
289 struct in_addr addr_struct;
291 nla_b = nla_nest_start(skb, NLBL_MGMT_A_ADDRSELECTOR);
295 addr_struct.s_addr = iter4->addr;
296 ret_val = nla_put(skb, NLBL_MGMT_A_IPV4ADDR,
297 sizeof(struct in_addr),
301 addr_struct.s_addr = iter4->mask;
302 ret_val = nla_put(skb, NLBL_MGMT_A_IPV4MASK,
303 sizeof(struct in_addr),
307 map4 = netlbl_domhsh_addr4_entry(iter4);
308 ret_val = nla_put_u32(skb, NLBL_MGMT_A_PROTOCOL,
312 switch (map4->def.type) {
313 case NETLBL_NLTYPE_CIPSOV4:
314 ret_val = nla_put_u32(skb, NLBL_MGMT_A_CV4DOI,
315 map4->def.cipso->doi);
321 nla_nest_end(skb, nla_b);
323 #if IS_ENABLED(CONFIG_IPV6)
324 netlbl_af6list_foreach_rcu(iter6, &entry->def.addrsel->list6) {
325 struct netlbl_domaddr6_map *map6;
327 nla_b = nla_nest_start(skb, NLBL_MGMT_A_ADDRSELECTOR);
331 ret_val = nla_put(skb, NLBL_MGMT_A_IPV6ADDR,
332 sizeof(struct in6_addr),
336 ret_val = nla_put(skb, NLBL_MGMT_A_IPV6MASK,
337 sizeof(struct in6_addr),
341 map6 = netlbl_domhsh_addr6_entry(iter6);
342 ret_val = nla_put_u32(skb, NLBL_MGMT_A_PROTOCOL,
347 nla_nest_end(skb, nla_b);
351 nla_nest_end(skb, nla_a);
353 case NETLBL_NLTYPE_UNLABELED:
354 ret_val = nla_put_u32(skb,NLBL_MGMT_A_PROTOCOL,entry->def.type);
356 case NETLBL_NLTYPE_CIPSOV4:
357 ret_val = nla_put_u32(skb,NLBL_MGMT_A_PROTOCOL,entry->def.type);
360 ret_val = nla_put_u32(skb, NLBL_MGMT_A_CV4DOI,
361 entry->def.cipso->doi);
369 * NetLabel Command Handlers
373 * netlbl_mgmt_add - Handle an ADD message
374 * @skb: the NETLINK buffer
375 * @info: the Generic NETLINK info block
378 * Process a user generated ADD message and add the domains from the message
379 * to the hash table. See netlabel.h for a description of the message format.
380 * Returns zero on success, negative values on failure.
383 static int netlbl_mgmt_add(struct sk_buff *skb, struct genl_info *info)
385 struct netlbl_audit audit_info;
387 if ((!info->attrs[NLBL_MGMT_A_DOMAIN]) ||
388 (!info->attrs[NLBL_MGMT_A_PROTOCOL]) ||
389 (info->attrs[NLBL_MGMT_A_IPV4ADDR] &&
390 info->attrs[NLBL_MGMT_A_IPV6ADDR]) ||
391 (info->attrs[NLBL_MGMT_A_IPV4MASK] &&
392 info->attrs[NLBL_MGMT_A_IPV6MASK]) ||
393 ((info->attrs[NLBL_MGMT_A_IPV4ADDR] != NULL) ^
394 (info->attrs[NLBL_MGMT_A_IPV4MASK] != NULL)) ||
395 ((info->attrs[NLBL_MGMT_A_IPV6ADDR] != NULL) ^
396 (info->attrs[NLBL_MGMT_A_IPV6MASK] != NULL)))
399 netlbl_netlink_auditinfo(skb, &audit_info);
401 return netlbl_mgmt_add_common(info, &audit_info);
405 * netlbl_mgmt_remove - Handle a REMOVE message
406 * @skb: the NETLINK buffer
407 * @info: the Generic NETLINK info block
410 * Process a user generated REMOVE message and remove the specified domain
411 * mappings. Returns zero on success, negative values on failure.
414 static int netlbl_mgmt_remove(struct sk_buff *skb, struct genl_info *info)
417 struct netlbl_audit audit_info;
419 if (!info->attrs[NLBL_MGMT_A_DOMAIN])
422 netlbl_netlink_auditinfo(skb, &audit_info);
424 domain = nla_data(info->attrs[NLBL_MGMT_A_DOMAIN]);
425 return netlbl_domhsh_remove(domain, &audit_info);
429 * netlbl_mgmt_listall_cb - netlbl_domhsh_walk() callback for LISTALL
430 * @entry: the domain mapping hash table entry
431 * @arg: the netlbl_domhsh_walk_arg structure
434 * This function is designed to be used as a callback to the
435 * netlbl_domhsh_walk() function for use in generating a response for a LISTALL
436 * message. Returns the size of the message on success, negative values on
440 static int netlbl_mgmt_listall_cb(struct netlbl_dom_map *entry, void *arg)
442 int ret_val = -ENOMEM;
443 struct netlbl_domhsh_walk_arg *cb_arg = arg;
446 data = genlmsg_put(cb_arg->skb, NETLINK_CB(cb_arg->nl_cb->skb).portid,
447 cb_arg->seq, &netlbl_mgmt_gnl_family,
448 NLM_F_MULTI, NLBL_MGMT_C_LISTALL);
450 goto listall_cb_failure;
452 ret_val = netlbl_mgmt_listentry(cb_arg->skb, entry);
454 goto listall_cb_failure;
457 genlmsg_end(cb_arg->skb, data);
461 genlmsg_cancel(cb_arg->skb, data);
466 * netlbl_mgmt_listall - Handle a LISTALL message
467 * @skb: the NETLINK buffer
468 * @cb: the NETLINK callback
471 * Process a user generated LISTALL message and dumps the domain hash table in
472 * a form suitable for use in a kernel generated LISTALL message. Returns zero
473 * on success, negative values on failure.
476 static int netlbl_mgmt_listall(struct sk_buff *skb,
477 struct netlink_callback *cb)
479 struct netlbl_domhsh_walk_arg cb_arg;
480 u32 skip_bkt = cb->args[0];
481 u32 skip_chain = cb->args[1];
485 cb_arg.seq = cb->nlh->nlmsg_seq;
487 netlbl_domhsh_walk(&skip_bkt,
489 netlbl_mgmt_listall_cb,
492 cb->args[0] = skip_bkt;
493 cb->args[1] = skip_chain;
498 * netlbl_mgmt_adddef - Handle an ADDDEF message
499 * @skb: the NETLINK buffer
500 * @info: the Generic NETLINK info block
503 * Process a user generated ADDDEF message and respond accordingly. Returns
504 * zero on success, negative values on failure.
507 static int netlbl_mgmt_adddef(struct sk_buff *skb, struct genl_info *info)
509 struct netlbl_audit audit_info;
511 if ((!info->attrs[NLBL_MGMT_A_PROTOCOL]) ||
512 (info->attrs[NLBL_MGMT_A_IPV4ADDR] &&
513 info->attrs[NLBL_MGMT_A_IPV6ADDR]) ||
514 (info->attrs[NLBL_MGMT_A_IPV4MASK] &&
515 info->attrs[NLBL_MGMT_A_IPV6MASK]) ||
516 ((info->attrs[NLBL_MGMT_A_IPV4ADDR] != NULL) ^
517 (info->attrs[NLBL_MGMT_A_IPV4MASK] != NULL)) ||
518 ((info->attrs[NLBL_MGMT_A_IPV6ADDR] != NULL) ^
519 (info->attrs[NLBL_MGMT_A_IPV6MASK] != NULL)))
522 netlbl_netlink_auditinfo(skb, &audit_info);
524 return netlbl_mgmt_add_common(info, &audit_info);
528 * netlbl_mgmt_removedef - Handle a REMOVEDEF message
529 * @skb: the NETLINK buffer
530 * @info: the Generic NETLINK info block
533 * Process a user generated REMOVEDEF message and remove the default domain
534 * mapping. Returns zero on success, negative values on failure.
537 static int netlbl_mgmt_removedef(struct sk_buff *skb, struct genl_info *info)
539 struct netlbl_audit audit_info;
541 netlbl_netlink_auditinfo(skb, &audit_info);
543 return netlbl_domhsh_remove_default(&audit_info);
547 * netlbl_mgmt_listdef - Handle a LISTDEF message
548 * @skb: the NETLINK buffer
549 * @info: the Generic NETLINK info block
552 * Process a user generated LISTDEF message and dumps the default domain
553 * mapping in a form suitable for use in a kernel generated LISTDEF message.
554 * Returns zero on success, negative values on failure.
557 static int netlbl_mgmt_listdef(struct sk_buff *skb, struct genl_info *info)
559 int ret_val = -ENOMEM;
560 struct sk_buff *ans_skb = NULL;
562 struct netlbl_dom_map *entry;
564 ans_skb = nlmsg_new(NLMSG_DEFAULT_SIZE, GFP_KERNEL);
567 data = genlmsg_put_reply(ans_skb, info, &netlbl_mgmt_gnl_family,
568 0, NLBL_MGMT_C_LISTDEF);
570 goto listdef_failure;
573 entry = netlbl_domhsh_getentry(NULL);
576 goto listdef_failure_lock;
578 ret_val = netlbl_mgmt_listentry(ans_skb, entry);
581 goto listdef_failure;
583 genlmsg_end(ans_skb, data);
584 return genlmsg_reply(ans_skb, info);
586 listdef_failure_lock:
594 * netlbl_mgmt_protocols_cb - Write an individual PROTOCOL message response
595 * @skb: the skb to write to
596 * @cb: the NETLINK callback
597 * @protocol: the NetLabel protocol to use in the message
600 * This function is to be used in conjunction with netlbl_mgmt_protocols() to
601 * answer a application's PROTOCOLS message. Returns the size of the message
602 * on success, negative values on failure.
605 static int netlbl_mgmt_protocols_cb(struct sk_buff *skb,
606 struct netlink_callback *cb,
609 int ret_val = -ENOMEM;
612 data = genlmsg_put(skb, NETLINK_CB(cb->skb).portid, cb->nlh->nlmsg_seq,
613 &netlbl_mgmt_gnl_family, NLM_F_MULTI,
614 NLBL_MGMT_C_PROTOCOLS);
616 goto protocols_cb_failure;
618 ret_val = nla_put_u32(skb, NLBL_MGMT_A_PROTOCOL, protocol);
620 goto protocols_cb_failure;
622 genlmsg_end(skb, data);
625 protocols_cb_failure:
626 genlmsg_cancel(skb, data);
631 * netlbl_mgmt_protocols - Handle a PROTOCOLS message
632 * @skb: the NETLINK buffer
633 * @cb: the NETLINK callback
636 * Process a user generated PROTOCOLS message and respond accordingly.
639 static int netlbl_mgmt_protocols(struct sk_buff *skb,
640 struct netlink_callback *cb)
642 u32 protos_sent = cb->args[0];
644 if (protos_sent == 0) {
645 if (netlbl_mgmt_protocols_cb(skb,
647 NETLBL_NLTYPE_UNLABELED) < 0)
648 goto protocols_return;
651 if (protos_sent == 1) {
652 if (netlbl_mgmt_protocols_cb(skb,
654 NETLBL_NLTYPE_CIPSOV4) < 0)
655 goto protocols_return;
660 cb->args[0] = protos_sent;
665 * netlbl_mgmt_version - Handle a VERSION message
666 * @skb: the NETLINK buffer
667 * @info: the Generic NETLINK info block
670 * Process a user generated VERSION message and respond accordingly. Returns
671 * zero on success, negative values on failure.
674 static int netlbl_mgmt_version(struct sk_buff *skb, struct genl_info *info)
676 int ret_val = -ENOMEM;
677 struct sk_buff *ans_skb = NULL;
680 ans_skb = nlmsg_new(NLMSG_DEFAULT_SIZE, GFP_KERNEL);
683 data = genlmsg_put_reply(ans_skb, info, &netlbl_mgmt_gnl_family,
684 0, NLBL_MGMT_C_VERSION);
686 goto version_failure;
688 ret_val = nla_put_u32(ans_skb,
690 NETLBL_PROTO_VERSION);
692 goto version_failure;
694 genlmsg_end(ans_skb, data);
695 return genlmsg_reply(ans_skb, info);
704 * NetLabel Generic NETLINK Command Definitions
707 static const struct genl_ops netlbl_mgmt_genl_ops[] = {
709 .cmd = NLBL_MGMT_C_ADD,
710 .flags = GENL_ADMIN_PERM,
711 .policy = netlbl_mgmt_genl_policy,
712 .doit = netlbl_mgmt_add,
716 .cmd = NLBL_MGMT_C_REMOVE,
717 .flags = GENL_ADMIN_PERM,
718 .policy = netlbl_mgmt_genl_policy,
719 .doit = netlbl_mgmt_remove,
723 .cmd = NLBL_MGMT_C_LISTALL,
725 .policy = netlbl_mgmt_genl_policy,
727 .dumpit = netlbl_mgmt_listall,
730 .cmd = NLBL_MGMT_C_ADDDEF,
731 .flags = GENL_ADMIN_PERM,
732 .policy = netlbl_mgmt_genl_policy,
733 .doit = netlbl_mgmt_adddef,
737 .cmd = NLBL_MGMT_C_REMOVEDEF,
738 .flags = GENL_ADMIN_PERM,
739 .policy = netlbl_mgmt_genl_policy,
740 .doit = netlbl_mgmt_removedef,
744 .cmd = NLBL_MGMT_C_LISTDEF,
746 .policy = netlbl_mgmt_genl_policy,
747 .doit = netlbl_mgmt_listdef,
751 .cmd = NLBL_MGMT_C_PROTOCOLS,
753 .policy = netlbl_mgmt_genl_policy,
755 .dumpit = netlbl_mgmt_protocols,
758 .cmd = NLBL_MGMT_C_VERSION,
760 .policy = netlbl_mgmt_genl_policy,
761 .doit = netlbl_mgmt_version,
767 * NetLabel Generic NETLINK Protocol Functions
771 * netlbl_mgmt_genl_init - Register the NetLabel management component
774 * Register the NetLabel management component with the Generic NETLINK
775 * mechanism. Returns zero on success, negative values on failure.
778 int __init netlbl_mgmt_genl_init(void)
780 return genl_register_family_with_ops(&netlbl_mgmt_gnl_family,
781 netlbl_mgmt_genl_ops);