3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21 /*
22 * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
23 */
24
25 #ifndef _IPADM_IPMGMT_H
26 #define _IPADM_IPMGMT_H
27
28 #ifdef __cplusplus
29 extern "C" {
30 #endif
31 #include <sys/types.h>
32 #include <sys/stat.h>
33 #include <fcntl.h>
34 #include <sys/mman.h>
35 #include <door.h>
36 #include <libipadm.h>
37 #include <inet/tunables.h>
38
39 /*
40 * Function declarations and data structures shared by libipadm.so and
41 * the IP management daemon.
42 */
43
44 /* Authorization required to configure network interfaces */
45 #define NETWORK_INTERFACE_CONFIG_AUTH "solaris.network.interface.config"
46
47 /*
48 * Data store read/write utilities related declarations.
49 */
50 /*
51 * For more information on these definitions please refer to the top of
52 * ipadm_persist.c. These are the name of the nvpairs which hold the
53 * respective values. All nvpairs private to ipadm have names that begin
54 * with "_". Note below that 'prefixlen' is an address property and therefore
55 * not a private nvpair name.
56 */
57 #define IPADM_NVP_PROTONAME "_protocol" /* protocol name */
58 #define IPADM_NVP_IFNAME "_ifname" /* interface name */
59 #define IPADM_NVP_AOBJNAME "_aobjname" /* addrobj name */
60 #define IPADM_NVP_FAMILY "_family" /* address family */
61 #define IPADM_NVP_IPV4ADDR "_ipv4addr" /* name of IPv4 addr nvlist */
62 #define IPADM_NVP_IPNUMADDR "_addr" /* local address */
63 #define IPADM_NVP_IPADDRHNAME "_aname" /* local hostname */
64 #define IPADM_NVP_IPDADDRHNAME "_dname" /* remote hostname */
65 #define IPADM_NVP_PREFIXLEN "prefixlen" /* prefixlen */
66 #define IPADM_NVP_IPV6ADDR "_ipv6addr" /* name of IPv6 addr nvlist */
67 #define IPADM_NVP_DHCP "_dhcp" /* name of DHCP nvlist */
68 #define IPADM_NVP_WAIT "_wait" /* DHCP timeout value */
69 #define IPADM_NVP_PRIMARY "_primary" /* DHCP primary interface */
70 #define IPADM_NVP_LIFNUM "_lifnum" /* logical interface number */
71 #define IPADM_NVP_INTFID "_intfid" /* name of IPv6 intfid nvlist */
72 #define IPADM_NVP_STATELESS "_stateless" /* IPv6 autoconf stateless */
73 #define IPADM_NVP_STATEFUL "_stateful" /* IPv6 autoconf dhcpv6 */
74
75 #define IPADM_PRIV_NVP(s) ((s)[0] == '_' && (s)[1] != '_')
76
77 /*
78 * All protocol properties that are private to ipadm are stored in the
89 IPADM_DB_READ /* Read from DB */
90 } ipadm_db_op_t;
91
92 /*
93 * callback arg used by db_wfunc_t that writes to DB. The contents to be
94 * written to DB are captured in `dbw_nvl'.
95 */
96 typedef struct ipadm_dbwrite_cbarg_s {
97 nvlist_t *dbw_nvl;
98 uint_t dbw_flags;
99 } ipadm_dbwrite_cbarg_t;
100
101 /*
102 * door related function declarations and data structures.
103 */
104
105 /* The door file for the ipmgmt (ip-interface management) daemon */
106 #define IPMGMT_DOOR "/etc/svc/volatile/ipadm/ipmgmt_door"
107 #define MAXPROTONAMELEN 32
108
109 /* door call command type */
110 typedef enum {
111 IPMGMT_CMD_SETPROP = 1, /* persist property */
112 IPMGMT_CMD_SETIF, /* persist interface */
113 IPMGMT_CMD_SETADDR, /* persist address */
114 IPMGMT_CMD_GETPROP, /* retrieve persisted property value */
115 IPMGMT_CMD_GETIF, /* retrieve persisted interface conf. */
116 IPMGMT_CMD_GETADDR, /* retrieve persisted addresses */
117 IPMGMT_CMD_RESETIF, /* purge interface configuration */
118 IPMGMT_CMD_RESETADDR, /* purge address configuration */
119 IPMGMT_CMD_RESETPROP, /* purge property configuration */
120 IPMGMT_CMD_INITIF, /* retrieve interfaces to initialize */
121 IPMGMT_CMD_ADDROBJ_LOOKUPADD, /* addr. object lookup & add */
122 IPMGMT_CMD_ADDROBJ_SETLIFNUM, /* set lifnum on the addrobj */
123 IPMGMT_CMD_ADDROBJ_ADD, /* add addr. object to addrobj map */
124 IPMGMT_CMD_LIF2ADDROBJ, /* lifname to addrobj mapping */
125 IPMGMT_CMD_AOBJNAME2ADDROBJ /* aobjname to addrobj mapping */
126 } ipmgmt_door_cmd_type_t;
127
128 /*
129 * Note: We need to keep the size of the structure the same on amd64 and i386
130 * for all door_call arguments and door_return structures.
131 */
132 /* door_call argument */
133 typedef struct ipmgmt_arg {
134 ipmgmt_door_cmd_type_t ia_cmd;
135 } ipmgmt_arg_t;
136
137 /* IPMGMT_CMD_{SETPROP|GETPROP|RESETPROP} door_call argument */
138 typedef struct ipmgmt_prop_arg_s {
139 ipmgmt_door_cmd_type_t ia_cmd;
140 uint32_t ia_flags;
141 char ia_ifname[LIFNAMSIZ];
142 char ia_aobjname[IPADM_AOBJSIZ];
143 char ia_module[MAXPROTONAMELEN];
144 char ia_pname[MAXPROPNAMELEN];
145 char ia_pval[MAXPROPVALLEN];
146 } ipmgmt_prop_arg_t;
147 /*
148 * ia_flags used in ipmgmt_prop_arg_t.
149 * - APPEND updates the multi-valued property entry with a new value
150 * - REDUCE updates the multi-valued property entry by removing a value
151 */
152 #define IPMGMT_APPEND 0x00000001
153 #define IPMGMT_REMOVE 0x00000002
154
155 /* IPMGMT_CMD_GETIF door_call argument structure */
156 typedef struct ipmgmt_getif_arg_s {
157 ipmgmt_door_cmd_type_t ia_cmd;
158 uint32_t ia_flags;
159 char ia_ifname[LIFNAMSIZ];
160 } ipmgmt_getif_arg_t;
161
162 /* IPMGMT_CMD_RESETIF, IPMGMT_CMD_SETIF door_call argument structure */
163 typedef struct ipmgmt_if_arg_s {
164 ipmgmt_door_cmd_type_t ia_cmd;
165 uint32_t ia_flags;
166 char ia_ifname[LIFNAMSIZ];
167 sa_family_t ia_family;
168 } ipmgmt_if_arg_t;
169
170 /* IPMGMT_CMD_INITIF door_call argument structure */
171 typedef struct ipmgmt_initif_arg_s {
172 ipmgmt_door_cmd_type_t ia_cmd;
173 uint32_t ia_flags;
174 sa_family_t ia_family;
175 size_t ia_nvlsize;
176 /* packed nvl follows */
177 } ipmgmt_initif_arg_t;
178
179 /* IPMGMT_CMD_SETADDR door_call argument */
180 typedef struct ipmgmt_setaddr_arg_s {
181 ipmgmt_door_cmd_type_t ia_cmd;
182 uint32_t ia_flags;
183 size_t ia_nvlsize;
184 /* packed nvl follows */
185 } ipmgmt_setaddr_arg_t;
186
187 /* IPMGMT_CMD_GETADDR door_call argument */
188 typedef struct ipmgmt_getaddr_arg_s {
189 ipmgmt_door_cmd_type_t ia_cmd;
190 uint32_t ia_flags;
191 char ia_ifname[LIFNAMSIZ];
192 sa_family_t ia_family;
193 char ia_aobjname[IPADM_AOBJSIZ];
194 } ipmgmt_getaddr_arg_t;
195
196 /* IPMGMT_CMD_RESETADDR door_call argument */
197 typedef struct ipmgmt_addr_arg_s {
198 ipmgmt_door_cmd_type_t ia_cmd;
199 uint32_t ia_flags;
200 char ia_aobjname[IPADM_AOBJSIZ];
201 int32_t ia_lnum;
202 } ipmgmt_addr_arg_t;
203
204 /*
205 * IPMGMT_CMD_{ADDROBJ_ADD|ADDROBJ_LOOKUPADD|LIFNUM2ADDROBJ|
206 * ADDROBJ2LIFNUM} door_call argument.
207 */
208 typedef struct ipmgmt_aobjop_arg_s {
209 ipmgmt_door_cmd_type_t ia_cmd;
210 uint32_t ia_flags;
211 char ia_aobjname[IPADM_AOBJSIZ];
212 char ia_ifname[LIFNAMSIZ];
213 int32_t ia_lnum;
214 sa_family_t ia_family;
215 ipadm_addr_type_t ia_atype;
216 } ipmgmt_aobjop_arg_t;
217
218 /*
219 * ia_flags used inside the arguments for interface/address commands
220 * - ACTIVE updates the running configuration
221 * - PERSIST updates the permanent data store
222 * - INIT indicates that operation being performed is under init
223 * context
224 */
225 #define IPMGMT_ACTIVE 0x00000001
226 #define IPMGMT_PERSIST 0x00000002
227 #define IPMGMT_INIT 0x00000004
228
229 /* door call return value */
230 typedef struct ipmgmt_retval_s {
231 int32_t ir_err;
232 } ipmgmt_retval_t;
233
234 /* IPMGMT_CMD_GETADDR door_return value */
235 typedef struct ipmgmt_get_rval_s {
236 int32_t ir_err;
237 size_t ir_nvlsize;
238 /* packed nvl follows */
239 } ipmgmt_get_rval_t;
240
241 /* IPMGMT_CMD_GETPROP door_return value */
242 typedef struct ipmgmt_getprop_rval_s {
243 int32_t ir_err;
244 char ir_pval[MAXPROPVALLEN];
245 } ipmgmt_getprop_rval_t;
246
247 /* IPMGMT_CMD_GETIF door_return value */
248 typedef struct ipmgmt_getif_rval_s {
|
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21 /*
22 * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
23 * Copyright 2013 Nexenta Systems, Inc. All rights reserved.
24 */
25
26 #ifndef _IPADM_IPMGMT_H
27 #define _IPADM_IPMGMT_H
28
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
32 #include <sys/types.h>
33 #include <sys/stat.h>
34 #include <fcntl.h>
35 #include <sys/mman.h>
36 #include <door.h>
37 #include <libipadm.h>
38 #include <inet/tunables.h>
39
40 /*
41 * Function declarations and data structures shared by libipadm.so and
42 * the IP management daemon.
43 */
44
45 /* Authorization required to configure network interfaces */
46 #define NETWORK_INTERFACE_CONFIG_AUTH "solaris.network.interface.config"
47
48 /*
49 * Data store read/write utilities related declarations.
50 */
51 /*
52 * For more information on these definitions please refer to the top of
53 * ipadm_persist.c. These are the name of the nvpairs which hold the
54 * respective values. All nvpairs private to ipadm have names that begin
55 * with "_". Note below that 'prefixlen' is an address property and therefore
56 * not a private nvpair name.
57 */
58 #define IPADM_NVP_PROTONAME "_protocol" /* protocol name */
59 #define IPADM_NVP_IFNAME "_ifname" /* interface name */
60 #define IPADM_NVP_IFCLASS "_ifclass" /* interface class */
61 #define IPADM_NVP_FAMILIES "_families" /* interface families */
62 #define IPADM_NVP_GIFNAME "_gifname" /* IPMP group interface name */
63 #define IPADM_NVP_MIFNAMES "_mifnames" /* IPMP group members */
64 #define IPADM_NVP_AOBJNAME "_aobjname" /* addrobj name */
65 #define IPADM_NVP_FAMILY "_family" /* address family */
66 #define IPADM_NVP_IPV4ADDR "_ipv4addr" /* name of IPv4 addr nvlist */
67 #define IPADM_NVP_IPNUMADDR "_addr" /* local address */
68 #define IPADM_NVP_IPADDRHNAME "_aname" /* local hostname */
69 #define IPADM_NVP_IPDADDRHNAME "_dname" /* remote hostname */
70 #define IPADM_NVP_PREFIXLEN "prefixlen" /* prefixlen */
71 #define IPADM_NVP_IPV6ADDR "_ipv6addr" /* name of IPv6 addr nvlist */
72 #define IPADM_NVP_DHCP "_dhcp" /* name of DHCP nvlist */
73 #define IPADM_NVP_WAIT "_wait" /* DHCP timeout value */
74 #define IPADM_NVP_PRIMARY "_primary" /* DHCP primary interface */
75 #define IPADM_NVP_LIFNUM "_lifnum" /* logical interface number */
76 #define IPADM_NVP_INTFID "_intfid" /* name of IPv6 intfid nvlist */
77 #define IPADM_NVP_STATELESS "_stateless" /* IPv6 autoconf stateless */
78 #define IPADM_NVP_STATEFUL "_stateful" /* IPv6 autoconf dhcpv6 */
79
80 #define IPADM_PRIV_NVP(s) ((s)[0] == '_' && (s)[1] != '_')
81
82 /*
83 * All protocol properties that are private to ipadm are stored in the
94 IPADM_DB_READ /* Read from DB */
95 } ipadm_db_op_t;
96
97 /*
98 * callback arg used by db_wfunc_t that writes to DB. The contents to be
99 * written to DB are captured in `dbw_nvl'.
100 */
101 typedef struct ipadm_dbwrite_cbarg_s {
102 nvlist_t *dbw_nvl;
103 uint_t dbw_flags;
104 } ipadm_dbwrite_cbarg_t;
105
106 /*
107 * door related function declarations and data structures.
108 */
109
110 /* The door file for the ipmgmt (ip-interface management) daemon */
111 #define IPMGMT_DOOR "/etc/svc/volatile/ipadm/ipmgmt_door"
112 #define MAXPROTONAMELEN 32
113
114 /*
115 * ia_flags used inside the arguments for interface/address commands
116 *
117 * - APPEND updates the multi-valued ipadm DB entry with a new value
118 * - REMOVE updates the multi-valued ipadm DB entry by removing a value
119 * - ACTIVE updates the running configuration
120 * - PERSIST updates the permanent data store
121 * - INIT indicates that operation being performed is under init
122 * context
123 *
124 * These two flags are used by ipmgmt_db_update_if function,
125 * because it can be used to update more that one DB line
126 * and we need to be sure that we finished all operations,
127 * after the operation has finished the related flag is cleared
128 *
129 * - UPDATE_IF - used when we need to update IPADM_NVP_FAMILIES and
130 * IPADM_NVP_MIFNAMES fields
131 * - UPDATE_IPMP - used when we need to update IPADM_NVP_GIFNAME
132 */
133 #define IPMGMT_APPEND 0x00000001
134 #define IPMGMT_REMOVE 0x00000002
135 #define IPMGMT_ACTIVE 0x00000004
136 #define IPMGMT_PERSIST 0x00000008
137 #define IPMGMT_INIT 0x00000010
138 #define IPMGMT_UPDATE_IF 0x00000020
139 #define IPMGMT_UPDATE_IPMP 0x00000040
140
141
142 /* door call command type */
143 typedef enum {
144 IPMGMT_CMD_SETPROP = 1, /* persist property */
145 IPMGMT_CMD_SETIF, /* persist interface */
146 IPMGMT_CMD_SETADDR, /* persist address */
147 IPMGMT_CMD_GETPROP, /* retrieve persisted property value */
148 IPMGMT_CMD_GETIF, /* retrieve persisted interface conf. */
149 IPMGMT_CMD_GETADDR, /* retrieve persisted addresses */
150 IPMGMT_CMD_RESETIF, /* purge interface configuration */
151 IPMGMT_CMD_RESETADDR, /* purge address configuration */
152 IPMGMT_CMD_RESETPROP, /* purge property configuration */
153 IPMGMT_CMD_INITIF, /* retrieve interfaces to initialize */
154 IPMGMT_CMD_ADDROBJ_LOOKUPADD, /* addr. object lookup & add */
155 IPMGMT_CMD_ADDROBJ_SETLIFNUM, /* set lifnum on the addrobj */
156 IPMGMT_CMD_ADDROBJ_ADD, /* add addr. object to addrobj map */
157 IPMGMT_CMD_LIF2ADDROBJ, /* lifname to addrobj mapping */
158 IPMGMT_CMD_AOBJNAME2ADDROBJ, /* aobjname to addrobj mapping */
159 IPMGMT_CMD_IPMP_UPDATE /* update IPMP group members */
160 } ipmgmt_door_cmd_type_t;
161
162 /*
163 * Note: We need to keep the size of the structure the same on amd64 and i386
164 * for all door_call arguments and door_return structures.
165 */
166 /* door_call argument */
167 typedef struct ipmgmt_arg {
168 ipmgmt_door_cmd_type_t ia_cmd;
169 } ipmgmt_arg_t;
170
171 /* IPMGMT_CMD_{SETPROP|GETPROP|RESETPROP} door_call argument */
172 typedef struct ipmgmt_prop_arg_s {
173 ipmgmt_door_cmd_type_t ia_cmd;
174 uint32_t ia_flags;
175 char ia_ifname[LIFNAMSIZ];
176 char ia_aobjname[IPADM_AOBJSIZ];
177 char ia_module[MAXPROTONAMELEN];
178 char ia_pname[MAXPROPNAMELEN];
179 char ia_pval[MAXPROPVALLEN];
180 } ipmgmt_prop_arg_t;
181
182 /* IPMGMT_CMD_GETIF door_call argument structure */
183 typedef struct ipmgmt_getif_arg_s {
184 ipmgmt_door_cmd_type_t ia_cmd;
185 uint32_t ia_flags;
186 char ia_ifname[LIFNAMSIZ];
187 } ipmgmt_getif_arg_t;
188
189 /* IPMGMT_CMD_RESETIF, IPMGMT_CMD_SETIF door_call argument structure */
190 typedef struct ipmgmt_if_arg_s {
191 ipmgmt_door_cmd_type_t ia_cmd;
192 uint32_t ia_flags;
193 char ia_ifname[LIFNAMSIZ];
194 sa_family_t ia_family;
195 ipadm_if_class_t ia_ifclass;
196 } ipmgmt_if_arg_t;
197
198 /* IPMGMT_CMD_INITIF door_call argument structure */
199 typedef struct ipmgmt_initif_arg_s {
200 ipmgmt_door_cmd_type_t ia_cmd;
201 uint32_t ia_flags;
202 sa_family_t ia_family;
203 size_t ia_nvlsize;
204 /* packed nvl follows */
205 } ipmgmt_initif_arg_t;
206
207 /* IPMGMT_CMD_IPMP_UPDATE door_call argument structure */
208 typedef struct ipmgmt_ipmp_update_arg_s {
209 ipmgmt_door_cmd_type_t ia_cmd;
210 uint32_t ia_flags;
211 char ia_gifname[LIFNAMSIZ]; /* group interface name */
212 char ia_mifname[LIFNAMSIZ]; /* group's member interface name */
213 } ipmgmt_ipmp_update_arg_t;
214
215 /* IPMGMT_CMD_SETADDR door_call argument */
216 typedef struct ipmgmt_setaddr_arg_s {
217 ipmgmt_door_cmd_type_t ia_cmd;
218 uint32_t ia_flags;
219 size_t ia_nvlsize;
220 /* packed nvl follows */
221 } ipmgmt_setaddr_arg_t;
222
223 /* IPMGMT_CMD_GETADDR door_call argument */
224 typedef struct ipmgmt_getaddr_arg_s {
225 ipmgmt_door_cmd_type_t ia_cmd;
226 uint32_t ia_flags;
227 char ia_ifname[LIFNAMSIZ];
228 sa_family_t ia_family;
229 char ia_aobjname[IPADM_AOBJSIZ];
230 } ipmgmt_getaddr_arg_t;
231
232 /* IPMGMT_CMD_RESETADDR door_call argument */
233 typedef struct ipmgmt_addr_arg_s {
234 ipmgmt_door_cmd_type_t ia_cmd;
235 uint32_t ia_flags;
236 char ia_aobjname[IPADM_AOBJSIZ];
237 int32_t ia_lnum;
238 } ipmgmt_addr_arg_t;
239
240 /*
241 * IPMGMT_CMD_{ADDROBJ_ADD|ADDROBJ_LOOKUPADD|LIFNUM2ADDROBJ|
242 * ADDROBJ2LIFNUM} door_call argument.
243 */
244 typedef struct ipmgmt_aobjop_arg_s {
245 ipmgmt_door_cmd_type_t ia_cmd;
246 uint32_t ia_flags;
247 char ia_aobjname[IPADM_AOBJSIZ];
248 char ia_ifname[LIFNAMSIZ];
249 int32_t ia_lnum;
250 sa_family_t ia_family;
251 ipadm_addr_type_t ia_atype;
252 } ipmgmt_aobjop_arg_t;
253
254 /* door call return value */
255 typedef struct ipmgmt_retval_s {
256 int32_t ir_err;
257 } ipmgmt_retval_t;
258
259 /* IPMGMT_CMD_GETADDR door_return value */
260 typedef struct ipmgmt_get_rval_s {
261 int32_t ir_err;
262 size_t ir_nvlsize;
263 /* packed nvl follows */
264 } ipmgmt_get_rval_t;
265
266 /* IPMGMT_CMD_GETPROP door_return value */
267 typedef struct ipmgmt_getprop_rval_s {
268 int32_t ir_err;
269 char ir_pval[MAXPROPVALLEN];
270 } ipmgmt_getprop_rval_t;
271
272 /* IPMGMT_CMD_GETIF door_return value */
273 typedef struct ipmgmt_getif_rval_s {
|