xref: /illumos-gate/usr/src/lib/libdladm/common/libdladm_impl.h (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1 /*
2  * CDDL HEADER START
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) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
23  * Copyright 2015, Joyent, Inc.
24  */
25 
26 /*
27  * Copyright 2019 OmniOS Community Edition (OmniOSce) Association.
28  */
29 
30 #ifndef _LIBDLADM_IMPL_H
31 #define	_LIBDLADM_IMPL_H
32 
33 #include <sys/types.h>
34 #include <sys/mac.h>
35 #include <sys/mac_flow.h>
36 #include <libdladm.h>
37 #include <stdio.h>
38 
39 #ifdef	__cplusplus
40 extern "C" {
41 #endif
42 
43 #define	MAXLINELEN		1024
44 #define	BUFLEN(lim, ptr)	(((lim) > (ptr)) ? ((lim) - (ptr)) : 0)
45 #define	V4_PART_OF_V6(v6)	((v6)._S6_un._S6_u32[3])
46 
47 /*
48  * The handle contains file descriptors to DLD_CONTROL_DEV and
49  * DLMGMT_DOOR.  Rather than opening the file descriptor each time
50  * it is required, the handle is opened by consumers of libdladm
51  * (e.g., dladm) and then passed to libdladm.
52  */
53 struct dladm_handle {
54 	int dld_fd;	/* file descriptor to DLD_CONTROL_DEV */
55 	int door_fd;	/* file descriptor to DLMGMT_DOOR */
56 	kstat_ctl_t *dld_kcp;	/* for kstat consumers */
57 };
58 
59 /* DLMGMT_DOOR can only be accessed by libdladm and dlmgmtd */
60 extern dladm_status_t	dladm_door_fd(dladm_handle_t, int *);
61 
62 extern dladm_status_t	dladm_errno2status(int);
63 extern dladm_status_t   i_dladm_rw_db(dladm_handle_t, const char *, mode_t,
64 			    dladm_status_t (*)(dladm_handle_t, void *, FILE *,
65 			    FILE *), void *, boolean_t);
66 extern dladm_status_t	dladm_get_state(dladm_handle_t, datalink_id_t,
67 			    link_state_t *);
68 extern void		dladm_find_setbits32(uint32_t, uint32_t *, uint32_t *);
69 extern dladm_status_t	dladm_parse_args(char *, dladm_arg_list_t **,
70 			    boolean_t);
71 extern void		dladm_free_args(dladm_arg_list_t *);
72 
73 /*
74  * Link attributes persisted by dlmgmtd.
75  */
76 /*
77  * Set for VLANs only
78  */
79 #define	FVLANID		"vid"		/* uint64_t */
80 #define	FLINKOVER	"linkover"	/* uint64_t */
81 
82 /*
83  * Set for AGGRs only
84  */
85 #define	FKEY		"key"		/* uint64_t */
86 #define	FNPORTS		"nports"	/* uint64_t */
87 #define	FPORTS		"portnames"	/* string */
88 #define	FPOLICY		"policy"	/* uint64_t */
89 #define	FFIXMACADDR	"fix_macaddr"	/* boolean_t */
90 #define	FFORCE		"force"		/* boolean_t */
91 #define	FLACPMODE	"lacp_mode"	/* uint64_t */
92 #define	FLACPTIMER	"lacp_timer"	/* uint64_t */
93 
94 /*
95  * Set for VNICs only
96  */
97 #define	FMADDRTYPE	"maddrtype"	/* uint64_t */
98 #define	FMADDRLEN	"maddrlen"	/* uint64_t */
99 #define	FMADDRSLOT	"maddrslot"	/* uint64_t */
100 #define	FMADDRPREFIXLEN	"maddrpreflen"	/* uint64_t */
101 #define	FVRID		"vrid"		/* uint64_t */
102 #define	FVRAF		"vraf"		/* uint64_t */
103 
104 /*
105  * Set for simlinks only
106  */
107 #define	FSIMNETTYPE	"simnettype"	/* uint64_t */
108 #define	FSIMNETPEER	"simnetpeer"	/* uint64_t */
109 
110 /*
111  * Set for IB partitions only
112  */
113 #define	FPORTPKEY	"pkey"		/* uint64_t */
114 
115 /*
116  * Common fields
117  */
118 #define	FMACADDR	"macaddr"	/* string */
119 
120 /*
121  * List of all the above attributes.
122  */
123 #define	DLADM_ATTR_NAMES	FVLANID, FLINKOVER, \
124 				FKEY, FNPORTS, FPORTS, FPOLICY, \
125 				FFIXMACADDR, FFORCE, FLACPMODE, FLACPTIMER, \
126 				FMADDRTYPE, FMADDRLEN, FMADDRSLOT, \
127 				FMADDRPREFIXLEN, FVRID, FVRAF,	\
128 				FMACADDR, FSIMNETTYPE, FSIMNETPEER
129 
130 /*
131  * Data structures used for implementing temporary properties
132  */
133 
134 typedef struct val_desc {
135 	char		*vd_name;
136 	uintptr_t	vd_val;
137 } val_desc_t;
138 
139 #define	VALCNT(vals)	(sizeof ((vals)) / sizeof (val_desc_t))
140 
141 extern dladm_status_t	dladm_link_proplist_extract(dladm_handle_t,
142 			    dladm_arg_list_t *, mac_resource_props_t *,
143 			    uint_t);
144 
145 extern dladm_status_t	dladm_flow_proplist_extract(dladm_arg_list_t *,
146 			    mac_resource_props_t *);
147 
148 /*
149  * The prop extract() callback.
150  *
151  * rp_extract extracts the kernel structure from the val_desc_t created
152  * by the pd_check function.
153  */
154 typedef	dladm_status_t	rp_extractf_t(val_desc_t *, uint_t, void *);
155 extern rp_extractf_t	extract_maxbw, extract_priority,
156 			extract_cpus, extract_protection,
157 			extract_allowedips, extract_allowedcids,
158 			extract_rxrings, extract_txrings, extract_pool;
159 
160 typedef struct resource_prop_s {
161 	/*
162 	 * resource property name
163 	 */
164 	char		*rp_name;
165 
166 	/*
167 	 * callback to extract kernel structure
168 	 */
169 	rp_extractf_t	*rp_extract;
170 } resource_prop_t;
171 
172 /*
173  * Set for bridged links only
174  */
175 #define	FBRIDGE		"bridge"	/* string */
176 
177 /*
178  * For error lists
179  */
180 extern dladm_status_t	dladm_errlist_append(dladm_errlist_t *,
181     const char *, ...);
182 
183 #ifdef	__cplusplus
184 }
185 #endif
186 
187 #endif	/* _LIBDLADM_IMPL_H */
188