libdllink.h revision 10491:8893b747ecdf
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 2009 Sun Microsystems, Inc.  All rights reserved.
23 * Use is subject to license terms.
24 */
25
26#ifndef _LIBDLLINK_H
27#define	_LIBDLLINK_H
28
29/*
30 * This file includes structures, macros and routines used by general
31 * link administration (i.e. not limited to one specific type of link).
32 */
33
34#include <stdio.h>
35#include <sys/types.h>
36#include <sys/param.h>
37#include <sys/mac.h>
38#include <sys/dld.h>
39#include <libdladm.h>
40
41#ifdef	__cplusplus
42extern "C" {
43#endif
44
45typedef struct dladm_attr {
46	uint_t			da_max_sdu;
47} dladm_attr_t;
48
49typedef struct dladm_phys_attr {
50	char		dp_dev[MAXLINKNAMELEN];
51	/*
52	 * Whether this physical link supports vanity naming (links with media
53	 * types not supported by GLDv3 don't have vanity naming support).
54	 */
55	boolean_t	dp_novanity;
56} dladm_phys_attr_t;
57
58typedef enum {
59	DLADM_PROP_VAL_CURRENT = 1,
60	DLADM_PROP_VAL_DEFAULT,
61	DLADM_PROP_VAL_PERM,
62	DLADM_PROP_VAL_MODIFIABLE,
63	DLADM_PROP_VAL_PERSISTENT
64} dladm_prop_type_t;
65
66/*
67 * Maximum size of secobj value. Note that it should not be greater than
68 * DLD_SECOBJ_VAL_MAX.
69 */
70#define	DLADM_SECOBJ_VAL_MAX	256
71
72/*
73 * Maximum size of secobj name. Note that it should not be greater than
74 * DLD_SECOBJ_NAME_MAX.
75 */
76#define	DLADM_SECOBJ_NAME_MAX	32
77
78#define	DLADM_MAX_PROP_VALCNT	32
79/*
80 * Size of prop_val buffer passed to pd_get function must be at
81 * least DLADM_PROP_VAL_MAX
82 */
83#define	DLADM_PROP_VAL_MAX	128
84
85#define		DLADM_SECOBJ_CLASS_WEP	0
86#define		DLADM_SECOBJ_CLASS_WPA	1
87typedef int	dladm_secobj_class_t;
88
89typedef int (dladm_walkcb_t)(const char *, void *);
90
91/* possible flags for ma_flags below */
92#define	DLADM_MACADDR_USED	0x1
93
94typedef enum {
95	DLADM_HWGRP_TYPE_RX = 0x1,
96	DLADM_HWGRP_TYPE_TX
97} dladm_hwgrp_type_t;
98
99typedef struct dladm_hwgrp_attr {
100	char		hg_link_name[MAXLINKNAMELEN];
101	uint_t		hg_grp_num;
102	dladm_hwgrp_type_t	hg_grp_type;
103	uint_t		hg_n_rings;
104	uint_t		hg_n_clnts;
105	char		hg_client_names[MAXCLIENTNAMELEN];
106} dladm_hwgrp_attr_t;
107
108typedef struct dladm_macaddr_attr {
109	uint_t		ma_slot;
110	uint_t		ma_flags;
111	uchar_t		ma_addr[MAXMACADDRLEN];
112	uint_t		ma_addrlen;
113	char		ma_client_name[MAXNAMELEN];
114	datalink_id_t	ma_client_linkid;
115} dladm_macaddr_attr_t;
116
117extern dladm_status_t	dladm_walk(dladm_walkcb_t *, dladm_handle_t, void *,
118			    datalink_class_t, datalink_media_t, uint32_t);
119extern dladm_status_t	dladm_mac_walk(dladm_walkcb_t *, void *);
120extern dladm_status_t	dladm_info(dladm_handle_t, datalink_id_t,
121			    dladm_attr_t *);
122extern dladm_status_t	dladm_setzid(dladm_handle_t, const char *, char *);
123
124extern dladm_status_t	dladm_rename_link(dladm_handle_t, const char *,
125			    const char *);
126
127extern dladm_status_t	dladm_set_linkprop(dladm_handle_t, datalink_id_t,
128			    const char *, char **, uint_t, uint_t);
129extern dladm_status_t	dladm_get_linkprop(dladm_handle_t, datalink_id_t,
130			    dladm_prop_type_t, const char *, char **, uint_t *);
131extern dladm_status_t	dladm_get_linkprop_values(dladm_handle_t, datalink_id_t,
132			    dladm_prop_type_t, const char *, uint_t *,
133			    uint_t *);
134extern dladm_status_t	dladm_walk_linkprop(dladm_handle_t, datalink_id_t,
135			    void *, int (*)(dladm_handle_t, datalink_id_t,
136			    const char *, void *));
137extern boolean_t	dladm_attr_is_linkprop(const char *name);
138
139extern dladm_status_t	dladm_set_secobj(dladm_handle_t, const char *,
140			    dladm_secobj_class_t, uint8_t *, uint_t, uint_t);
141extern dladm_status_t	dladm_get_secobj(dladm_handle_t, const char *,
142			    dladm_secobj_class_t *, uint8_t *, uint_t *,
143			    uint_t);
144extern dladm_status_t	dladm_unset_secobj(dladm_handle_t, const char *,
145			    uint_t);
146extern dladm_status_t	dladm_walk_secobj(dladm_handle_t, void *,
147			    boolean_t (*)(dladm_handle_t, void *, const char *),
148			    uint_t);
149
150extern const char	*dladm_linkstate2str(link_state_t, char *);
151extern const char	*dladm_linkduplex2str(link_duplex_t, char *);
152extern const char	*dladm_secobjclass2str(dladm_secobj_class_t, char *);
153extern dladm_status_t	dladm_str2secobjclass(const char *,
154			    dladm_secobj_class_t *);
155
156extern dladm_status_t	dladm_init_linkprop(dladm_handle_t, datalink_id_t,
157			    boolean_t);
158extern dladm_status_t	dladm_init_secobj(dladm_handle_t);
159extern boolean_t	dladm_valid_secobj_name(const char *);
160
161extern dladm_status_t	dladm_create_datalink_id(dladm_handle_t, const char *,
162			    datalink_class_t, uint_t, uint32_t,
163			    datalink_id_t *);
164extern dladm_status_t	dladm_destroy_datalink_id(dladm_handle_t, datalink_id_t,
165			    uint32_t);
166extern dladm_status_t	dladm_remap_datalink_id(dladm_handle_t, datalink_id_t,
167			    const char *);
168extern dladm_status_t	dladm_up_datalink_id(dladm_handle_t, datalink_id_t);
169extern dladm_status_t	dladm_name2info(dladm_handle_t, const char *,
170			    datalink_id_t *, uint32_t *, datalink_class_t *,
171			    uint32_t *);
172extern dladm_status_t	dladm_datalink_id2info(dladm_handle_t, datalink_id_t,
173			    uint32_t *, datalink_class_t *, uint32_t *, char *,
174			    size_t);
175extern dladm_status_t	dladm_walk_datalink_id(int (*)(dladm_handle_t,
176			    datalink_id_t, void *), dladm_handle_t, void *,
177			    datalink_class_t, datalink_media_t, uint32_t);
178extern dladm_status_t	dladm_create_conf(dladm_handle_t, const char *,
179			    datalink_id_t, datalink_class_t, uint32_t,
180			    dladm_conf_t *);
181extern dladm_status_t	dladm_read_conf(dladm_handle_t, datalink_id_t,
182			    dladm_conf_t *);
183extern dladm_status_t	dladm_write_conf(dladm_handle_t, dladm_conf_t);
184extern dladm_status_t	dladm_remove_conf(dladm_handle_t, datalink_id_t);
185extern void		dladm_destroy_conf(dladm_handle_t, dladm_conf_t);
186extern dladm_status_t	dladm_get_conf_field(dladm_handle_t, dladm_conf_t,
187			    const char *, void *, size_t);
188extern dladm_status_t	dladm_getnext_conf_linkprop(dladm_handle_t,
189			    dladm_conf_t, const char *, char *, void *,
190			    size_t, size_t *);
191extern dladm_status_t	dladm_set_conf_field(dladm_handle_t, dladm_conf_t,
192			    const char *, dladm_datatype_t, const void *);
193extern dladm_status_t	dladm_unset_conf_field(dladm_handle_t, dladm_conf_t,
194			    const char *);
195
196extern dladm_status_t	dladm_dev2linkid(dladm_handle_t, const char *,
197			    datalink_id_t *);
198extern dladm_status_t	dladm_linkid2legacyname(dladm_handle_t, datalink_id_t,
199			    char *, size_t);
200extern dladm_status_t	dladm_phys_delete(dladm_handle_t, datalink_id_t);
201
202extern dladm_status_t	dladm_phys_info(dladm_handle_t, datalink_id_t,
203			    dladm_phys_attr_t *, uint32_t);
204extern dladm_status_t	dladm_parselink(const char *, char *, uint_t *);
205
206extern int		dladm_walk_macaddr(dladm_handle_t, datalink_id_t,
207			    void *,
208			    boolean_t (*)(void *, dladm_macaddr_attr_t *));
209extern int		dladm_walk_hwgrp(dladm_handle_t, datalink_id_t, void *,
210			    boolean_t (*)(void *, dladm_hwgrp_attr_t *));
211
212extern dladm_status_t	dladm_link_get_proplist(dladm_handle_t, datalink_id_t,
213			    dladm_arg_list_t **);
214
215extern dladm_status_t	i_dladm_set_link_proplist_db(char *,
216			    dladm_arg_list_t *);
217
218#ifdef	__cplusplus
219}
220#endif
221
222#endif	/* _LIBDLLINK_H */
223