2 * NetLabel NETLINK Interface
4 * This file defines the NETLINK interface 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.moore@hp.com>
13 * (c) Copyright Hewlett-Packard Development Company, L.P., 2006
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, write to the Free Software
27 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
31 #ifndef _NETLABEL_USER_H
32 #define _NETLABEL_USER_H
34 #include <linux/skbuff.h>
35 #include <linux/capability.h>
36 #include <linux/genetlink.h>
37 #include <net/netlabel.h>
38 #include <net/genetlink.h>
40 /* NetLabel NETLINK helper functions */
43 * netlbl_netlink_cap_check - Check the NETLINK msg capabilities
44 * @skb: the NETLINK buffer
45 * @req_cap: the required capability
48 * Check the NETLINK buffer's capabilities against the required capabilities.
49 * Returns zero on success, negative values on failure.
52 static inline int netlbl_netlink_cap_check(const struct sk_buff
*skb
,
55 if (cap_raised(NETLINK_CB(skb
).eff_cap
, req_cap
))
61 * netlbl_getinc_u8 - Read a u8 value from a nlattr stream and move on
63 * @rem_len: remaining length
66 * Return a u8 value pointed to by @nla and advance it to the next attribute.
69 static inline u8
netlbl_getinc_u8(struct nlattr
**nla
, int *rem_len
)
71 u8 val
= nla_get_u8(*nla
);
72 *nla
= nla_next(*nla
, rem_len
);
77 * netlbl_getinc_u16 - Read a u16 value from a nlattr stream and move on
79 * @rem_len: remaining length
82 * Return a u16 value pointed to by @nla and advance it to the next attribute.
85 static inline u16
netlbl_getinc_u16(struct nlattr
**nla
, int *rem_len
)
87 u16 val
= nla_get_u16(*nla
);
88 *nla
= nla_next(*nla
, rem_len
);
93 * netlbl_getinc_u32 - Read a u32 value from a nlattr stream and move on
95 * @rem_len: remaining length
98 * Return a u32 value pointed to by @nla and advance it to the next attribute.
101 static inline u32
netlbl_getinc_u32(struct nlattr
**nla
, int *rem_len
)
103 u32 val
= nla_get_u32(*nla
);
104 *nla
= nla_next(*nla
, rem_len
);
109 * netlbl_netlink_hdr_put - Write the NETLINK buffers into a sk_buff
111 * @pid: the PID of the receipient
112 * @seq: the sequence number
113 * @type: the generic NETLINK message family type
117 * Write both a NETLINK nlmsghdr structure and a Generic NETLINK genlmsghdr
118 * struct to the packet. Returns a pointer to the start of the payload buffer
119 * on success or NULL on failure.
122 static inline void *netlbl_netlink_hdr_put(struct sk_buff
*skb
,
128 return genlmsg_put(skb
,
135 NETLBL_PROTO_VERSION
);
139 * netlbl_netlink_hdr_push - Write the NETLINK buffers into a sk_buff
141 * @pid: the PID of the receipient
142 * @seq: the sequence number
143 * @type: the generic NETLINK message family type
147 * Write both a NETLINK nlmsghdr structure and a Generic NETLINK genlmsghdr
148 * struct to the packet.
151 static inline void netlbl_netlink_hdr_push(struct sk_buff
*skb
,
158 struct nlmsghdr
*nlh
;
159 struct genlmsghdr
*hdr
;
161 nlh
= (struct nlmsghdr
*)skb_push(skb
, NLMSG_SPACE(GENL_HDRLEN
));
162 nlh
->nlmsg_type
= type
;
163 nlh
->nlmsg_len
= skb
->len
;
164 nlh
->nlmsg_flags
= 0;
165 nlh
->nlmsg_pid
= pid
;
166 nlh
->nlmsg_seq
= seq
;
168 hdr
= nlmsg_data(nlh
);
170 hdr
->version
= NETLBL_PROTO_VERSION
;
175 * netlbl_netlink_payload_len - Return the length of the payload
176 * @skb: the NETLINK buffer
179 * This function returns the length of the NetLabel payload.
182 static inline u32
netlbl_netlink_payload_len(const struct sk_buff
*skb
)
184 return nlmsg_len((struct nlmsghdr
*)skb
->data
) - GENL_HDRLEN
;
188 * netlbl_netlink_payload_data - Returns a pointer to the start of the payload
189 * @skb: the NETLINK buffer
192 * This function returns a pointer to the start of the NetLabel payload.
195 static inline void *netlbl_netlink_payload_data(const struct sk_buff
*skb
)
197 return (unsigned char *)nlmsg_data((struct nlmsghdr
*)skb
->data
) +
201 /* NetLabel common protocol functions */
203 void netlbl_netlink_send_ack(const struct genl_info
*info
,
208 /* NetLabel NETLINK I/O functions */
210 int netlbl_netlink_init(void);
211 int netlbl_netlink_snd(struct sk_buff
*skb
, u32 pid
);
212 int netlbl_netlink_snd_multicast(struct sk_buff
*skb
, u32 pid
, u32 group
);