1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _IPMP_QUERY_H
#define _IPMP_QUERY_H
#include <sys/types.h>
#include <sys/socket.h> /* needed by <net/if.h> */
#include <net/if.h> /* for LIF*NAMSIZ */
#include <ipmp.h>
/*
* IPMP query interfaces.
*
* These interfaces may only be used within ON or after signing a contract
* with ON. For documentation, refer to PSARC/2002/615 and PSARC/2007/272.
*/
#ifdef __cplusplus
extern "C" {
#endif
/*
* Assorted enumerations used in the data types described below.
*/
typedef enum ipmp_if_probestate {
IPMP_PROBE_OK, /* probes detect no problems */
IPMP_PROBE_FAILED, /* probes detect failure */
IPMP_PROBE_UNKNOWN, /* probe detection unavailable */
IPMP_PROBE_DISABLED /* probe detection disabled */
} ipmp_if_probestate_t;
typedef enum ipmp_if_linkstate {
IPMP_LINK_UP, /* link detects up */
IPMP_LINK_DOWN, /* link detects down */
IPMP_LINK_UNKNOWN /* link detection unavailable */
} ipmp_if_linkstate_t;
typedef enum ipmp_if_flags {
IPMP_IFFLAG_INACTIVE = 0x1,
IPMP_IFFLAG_HWADDRDUP = 0x2,
IPMP_IFFLAG_ACTIVE = 0x4,
IPMP_IFFLAG_DOWN = 0x8
} ipmp_if_flags_t;
typedef enum ipmp_addr_state {
IPMP_ADDR_UP, /* address is up */
IPMP_ADDR_DOWN /* address is down */
} ipmp_addr_state_t;
typedef enum ipmp_if_targmode {
IPMP_TARG_DISABLED, /* use of targets is disabled */
IPMP_TARG_ROUTES, /* route-learned targets */
IPMP_TARG_MULTICAST /* multicast-learned targets */
} ipmp_if_targmode_t;
#define IPMP_LIST_SIZE(listtype, elsize, nel) \
((sizeof (ipmp_ ## listtype ## _t) - (elsize)) + ((nel) * (elsize)))
/*
* Data type describing a list of IPMP groups.
*/
typedef struct ipmp_grouplist {
uint64_t gl_sig;
unsigned int gl_ngroup;
char gl_groups[1][LIFGRNAMSIZ];
} ipmp_grouplist_t;
#define IPMP_GROUPLIST_SIZE(ngr) \
IPMP_LIST_SIZE(grouplist, LIFGRNAMSIZ, ngr)
/*
* Data type describing a list of interfaces.
*/
typedef struct ipmp_iflist {
unsigned int il_nif;
char il_ifs[1][LIFNAMSIZ];
} ipmp_iflist_t;
#define IPMP_IFLIST_SIZE(nif) \
IPMP_LIST_SIZE(iflist, LIFNAMSIZ, nif)
/*
* Data type describing a list of addresses.
*/
typedef struct ipmp_addrlist {
unsigned int al_naddr;
struct sockaddr_storage al_addrs[1];
} ipmp_addrlist_t;
#define IPMP_ADDRLIST_SIZE(naddr) \
IPMP_LIST_SIZE(addrlist, sizeof (struct sockaddr_storage), naddr)
/*
* Data type describing the state of an IPMP group.
*/
typedef struct ipmp_groupinfo {
char gr_name[LIFGRNAMSIZ];
uint64_t gr_sig;
ipmp_group_state_t gr_state;
ipmp_iflist_t *gr_iflistp;
ipmp_addrlist_t *gr_adlistp;
char gr_ifname[LIFNAMSIZ];
char gr_m4ifname[LIFNAMSIZ];
char gr_m6ifname[LIFNAMSIZ];
char gr_bcifname[LIFNAMSIZ];
unsigned int gr_fdt;
} ipmp_groupinfo_t;
/*
* Data type describing IPMP target information for a particular interface.
*/
typedef struct ipmp_targinfo {
char it_name[LIFNAMSIZ];
struct sockaddr_storage it_testaddr;
ipmp_if_targmode_t it_targmode;
ipmp_addrlist_t *it_targlistp;
} ipmp_targinfo_t;
/*
* Data type describing the IPMP-related state of an interface.
*/
typedef struct ipmp_ifinfo {
char if_name[LIFNAMSIZ];
char if_group[LIFGRNAMSIZ];
ipmp_if_state_t if_state;
ipmp_if_type_t if_type;
ipmp_if_linkstate_t if_linkstate;
ipmp_if_probestate_t if_probestate;
ipmp_if_flags_t if_flags;
ipmp_targinfo_t if_targinfo4;
ipmp_targinfo_t if_targinfo6;
} ipmp_ifinfo_t;
/*
* Data type describing an IPMP data address.
*/
typedef struct ipmp_addrinfo {
struct sockaddr_storage ad_addr;
ipmp_addr_state_t ad_state;
char ad_group[LIFGRNAMSIZ];
char ad_binding[LIFNAMSIZ];
} ipmp_addrinfo_t;
typedef enum {
IPMP_QCONTEXT_LIVE,
IPMP_QCONTEXT_SNAP
} ipmp_qcontext_t;
extern int ipmp_setqcontext(ipmp_handle_t, ipmp_qcontext_t);
extern int ipmp_getgrouplist(ipmp_handle_t, ipmp_grouplist_t **);
extern void ipmp_freegrouplist(ipmp_grouplist_t *);
extern int ipmp_getgroupinfo(ipmp_handle_t, const char *, ipmp_groupinfo_t **);
extern void ipmp_freegroupinfo(ipmp_groupinfo_t *);
extern int ipmp_getifinfo(ipmp_handle_t, const char *, ipmp_ifinfo_t **);
extern void ipmp_freeifinfo(ipmp_ifinfo_t *);
extern int ipmp_getaddrinfo(ipmp_handle_t, const char *,
struct sockaddr_storage *, ipmp_addrinfo_t **);
extern void ipmp_freeaddrinfo(ipmp_addrinfo_t *);
#ifdef __cplusplus
}
#endif
#endif /* _IPMP_QUERY_H */
|
