[NetLabel]: correct improper handling of non-NetLabel peer contexts
[linux-2.6.git] / net / netlabel / netlabel_user.h
1 /*
2  * NetLabel NETLINK Interface
3  *
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.
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_USER_H
32 #define _NETLABEL_USER_H
33
34 #include <linux/types.h>
35 #include <linux/skbuff.h>
36 #include <linux/capability.h>
37 #include <net/netlink.h>
38 #include <net/genetlink.h>
39 #include <net/netlabel.h>
40
41 /* NetLabel NETLINK helper functions */
42
43 /**
44  * netlbl_netlink_cap_check - Check the NETLINK msg capabilities
45  * @skb: the NETLINK buffer
46  * @req_cap: the required capability
47  *
48  * Description:
49  * Check the NETLINK buffer's capabilities against the required capabilities.
50  * Returns zero on success, negative values on failure.
51  *
52  */
53 static inline int netlbl_netlink_cap_check(const struct sk_buff *skb,
54                                            kernel_cap_t req_cap)
55 {
56         if (cap_raised(NETLINK_CB(skb).eff_cap, req_cap))
57                 return 0;
58         return -EPERM;
59 }
60
61 /**
62  * netlbl_getinc_u8 - Read a u8 value from a nlattr stream and move on
63  * @nla: the attribute
64  * @rem_len: remaining length
65  *
66  * Description:
67  * Return a u8 value pointed to by @nla and advance it to the next attribute.
68  *
69  */
70 static inline u8 netlbl_getinc_u8(struct nlattr **nla, int *rem_len)
71 {
72         u8 val = nla_get_u8(*nla);
73         *nla = nla_next(*nla, rem_len);
74         return val;
75 }
76
77 /**
78  * netlbl_getinc_u16 - Read a u16 value from a nlattr stream and move on
79  * @nla: the attribute
80  * @rem_len: remaining length
81  *
82  * Description:
83  * Return a u16 value pointed to by @nla and advance it to the next attribute.
84  *
85  */
86 static inline u16 netlbl_getinc_u16(struct nlattr **nla, int *rem_len)
87 {
88         u16 val = nla_get_u16(*nla);
89         *nla = nla_next(*nla, rem_len);
90         return val;
91 }
92
93 /**
94  * netlbl_getinc_u32 - Read a u32 value from a nlattr stream and move on
95  * @nla: the attribute
96  * @rem_len: remaining length
97  *
98  * Description:
99  * Return a u32 value pointed to by @nla and advance it to the next attribute.
100  *
101  */
102 static inline u32 netlbl_getinc_u32(struct nlattr **nla, int *rem_len)
103 {
104         u32 val = nla_get_u32(*nla);
105         *nla = nla_next(*nla, rem_len);
106         return val;
107 }
108
109 /**
110  * netlbl_netlink_hdr_put - Write the NETLINK buffers into a sk_buff
111  * @skb: the packet
112  * @pid: the PID of the receipient
113  * @seq: the sequence number
114  * @type: the generic NETLINK message family type
115  * @cmd: command
116  *
117  * Description:
118  * Write both a NETLINK nlmsghdr structure and a Generic NETLINK genlmsghdr
119  * struct to the packet.  Returns a pointer to the start of the payload buffer
120  * on success or NULL on failure.
121  *
122  */
123 static inline void *netlbl_netlink_hdr_put(struct sk_buff *skb,
124                                            u32 pid,
125                                            u32 seq,
126                                            int type,
127                                            u8 cmd)
128 {
129         return genlmsg_put(skb,
130                            pid,
131                            seq,
132                            type,
133                            0,
134                            0,
135                            cmd,
136                            NETLBL_PROTO_VERSION);
137 }
138
139 /**
140  * netlbl_netlink_hdr_push - Write the NETLINK buffers into a sk_buff
141  * @skb: the packet
142  * @pid: the PID of the receipient
143  * @seq: the sequence number
144  * @type: the generic NETLINK message family type
145  * @cmd: command
146  *
147  * Description:
148  * Write both a NETLINK nlmsghdr structure and a Generic NETLINK genlmsghdr
149  * struct to the packet.
150  *
151  */
152 static inline void netlbl_netlink_hdr_push(struct sk_buff *skb,
153                                            u32 pid,
154                                            u32 seq,
155                                            int type,
156                                            u8 cmd)
157
158 {
159         struct nlmsghdr *nlh;
160         struct genlmsghdr *hdr;
161
162         nlh = (struct nlmsghdr *)skb_push(skb, NLMSG_SPACE(GENL_HDRLEN));
163         nlh->nlmsg_type = type;
164         nlh->nlmsg_len = skb->len;
165         nlh->nlmsg_flags = 0;
166         nlh->nlmsg_pid = pid;
167         nlh->nlmsg_seq = seq;
168
169         hdr = nlmsg_data(nlh);
170         hdr->cmd = cmd;
171         hdr->version = NETLBL_PROTO_VERSION;
172         hdr->reserved = 0;
173 }
174
175 /**
176  * netlbl_netlink_payload_len - Return the length of the payload
177  * @skb: the NETLINK buffer
178  *
179  * Description:
180  * This function returns the length of the NetLabel payload.
181  *
182  */
183 static inline u32 netlbl_netlink_payload_len(const struct sk_buff *skb)
184 {
185         return nlmsg_len((struct nlmsghdr *)skb->data) - GENL_HDRLEN;
186 }
187
188 /**
189  * netlbl_netlink_payload_data - Returns a pointer to the start of the payload
190  * @skb: the NETLINK buffer
191  *
192  * Description:
193  * This function returns a pointer to the start of the NetLabel payload.
194  *
195  */
196 static inline void *netlbl_netlink_payload_data(const struct sk_buff *skb)
197 {
198   return (unsigned char *)nlmsg_data((struct nlmsghdr *)skb->data) +
199           GENL_HDRLEN;
200 }
201
202 /* NetLabel common protocol functions */
203
204 void netlbl_netlink_send_ack(const struct genl_info *info,
205                              u32 genl_family,
206                              u8 ack_cmd,
207                              u32 ret_code);
208
209 /* NetLabel NETLINK I/O functions */
210
211 int netlbl_netlink_init(void);
212 int netlbl_netlink_snd(struct sk_buff *skb, u32 pid);
213 int netlbl_netlink_snd_multicast(struct sk_buff *skb, u32 pid, u32 group);
214
215 #endif