xref: /titanic_44/usr/src/uts/common/sys/mac.h (revision eb0cc229f19c437a6b538d3ac0d0443268290b7e)
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 2008 Sun Microsystems, Inc.  All rights reserved.
23  * Use is subject to license terms.
24  */
25 
26 #ifndef	_SYS_MAC_H
27 #define	_SYS_MAC_H
28 
29 #pragma ident	"%Z%%M%	%I%	%E% SMI"
30 
31 #include <sys/types.h>
32 #include <sys/ddi.h>
33 #include <sys/sunddi.h>
34 #include <sys/stream.h>
35 #include <sys/dld.h>
36 
37 /*
38  * MAC Services Module
39  */
40 
41 #ifdef	__cplusplus
42 extern "C" {
43 #endif
44 
45 /*
46  * MAC Information (text emitted by modinfo(1m))
47  */
48 #define	MAC_INFO	"MAC Services v%I%"
49 
50 /*
51  * MAC version identifier.  This is used by mac_alloc() mac_register() to
52  * verify that incompatible drivers don't register.
53  */
54 #define	MAC_VERSION	0x1
55 
56 /*
57  * MAC-Type version identifier.  This is used by mactype_alloc() and
58  * mactype_register() to verify that incompatible MAC-Type plugins don't
59  * register.
60  */
61 #define	MACTYPE_VERSION	0x1
62 
63 /*
64  * Statistics
65  */
66 
67 #define	XCVR_UNDEFINED		0
68 #define	XCVR_NONE		1
69 #define	XCVR_10			2
70 #define	XCVR_100T4		3
71 #define	XCVR_100X		4
72 #define	XCVR_100T2		5
73 #define	XCVR_1000X		6
74 #define	XCVR_1000T		7
75 
76 typedef enum {
77 	LINK_STATE_UNKNOWN = -1,
78 	LINK_STATE_DOWN,
79 	LINK_STATE_UP
80 } link_state_t;
81 
82 typedef enum {
83 	LINK_DUPLEX_UNKNOWN = 0,
84 	LINK_DUPLEX_HALF,
85 	LINK_DUPLEX_FULL
86 } link_duplex_t;
87 
88 #define	DATALINK_INVALID_LINKID	0
89 #define	DATALINK_ALL_LINKID	0
90 #define	DATALINK_MAX_LINKID	0xffffffff
91 
92 typedef enum {
93 	LINK_FLOWCTRL_NONE = 0,
94 	LINK_FLOWCTRL_RX,
95 	LINK_FLOWCTRL_TX,
96 	LINK_FLOWCTRL_BI
97 } link_flowctrl_t;
98 
99 /*
100  * Maximum MAC address length
101  */
102 #define	MAXMACADDRLEN	20
103 
104 #ifdef	_KERNEL
105 
106 typedef struct mac_stat_info_s {
107 	uint_t		msi_stat;
108 	char		*msi_name;
109 	uint_t		msi_type;	/* as defined in kstat_named_init(9F) */
110 	uint64_t	msi_default;
111 } mac_stat_info_t;
112 
113 /*
114  * There are three ranges of statistics values.  0 to 1 - MAC_STAT_MIN are
115  * interface statistics maintained by the mac module.  MAC_STAT_MIN to 1 -
116  * MACTYPE_STAT_MIN are common MAC statistics defined by the mac module and
117  * maintained by each driver.  MACTYPE_STAT_MIN and above are statistics
118  * defined by MAC-Type plugins and maintained by each driver.
119  */
120 #define	MAC_STAT_MIN		1000
121 #define	MACTYPE_STAT_MIN	2000
122 
123 #define	IS_MAC_STAT(stat)	\
124 	(stat >= MAC_STAT_MIN && stat < MACTYPE_STAT_MIN)
125 #define	IS_MACTYPE_STAT(stat)	(stat >= MACTYPE_STAT_MIN)
126 
127 /*
128  * Statistics maintained by the mac module, and possibly populated as link
129  * statistics.
130  */
131 enum mac_mod_stat {
132 	MAC_STAT_LINK_STATE,
133 	MAC_STAT_LINK_UP,
134 	MAC_STAT_PROMISC
135 };
136 
137 /*
138  * Do not reorder, and add only to the end of this list.
139  */
140 enum mac_driver_stat {
141 	/* MIB-II stats (RFC 1213 and RFC 1573) */
142 	MAC_STAT_IFSPEED = MAC_STAT_MIN,
143 	MAC_STAT_MULTIRCV,
144 	MAC_STAT_BRDCSTRCV,
145 	MAC_STAT_MULTIXMT,
146 	MAC_STAT_BRDCSTXMT,
147 	MAC_STAT_NORCVBUF,
148 	MAC_STAT_IERRORS,
149 	MAC_STAT_UNKNOWNS,
150 	MAC_STAT_NOXMTBUF,
151 	MAC_STAT_OERRORS,
152 	MAC_STAT_COLLISIONS,
153 	MAC_STAT_RBYTES,
154 	MAC_STAT_IPACKETS,
155 	MAC_STAT_OBYTES,
156 	MAC_STAT_OPACKETS,
157 	MAC_STAT_UNDERFLOWS,
158 	MAC_STAT_OVERFLOWS
159 };
160 
161 #define	MAC_NSTAT	(MAC_STAT_OVERFLOWS - MAC_STAT_IFSPEED + 1)
162 
163 #define	MAC_STAT_ISACOUNTER(_stat) (		\
164 	    (_stat) == MAC_STAT_MULTIRCV ||	\
165 	    (_stat) == MAC_STAT_BRDCSTRCV ||	\
166 	    (_stat) == MAC_STAT_MULTIXMT ||	\
167 	    (_stat) == MAC_STAT_BRDCSTXMT ||	\
168 	    (_stat) == MAC_STAT_NORCVBUF ||	\
169 	    (_stat) == MAC_STAT_IERRORS ||	\
170 	    (_stat) == MAC_STAT_UNKNOWNS ||	\
171 	    (_stat) == MAC_STAT_NOXMTBUF ||	\
172 	    (_stat) == MAC_STAT_OERRORS ||	\
173 	    (_stat) == MAC_STAT_COLLISIONS ||	\
174 	    (_stat) == MAC_STAT_RBYTES ||	\
175 	    (_stat) == MAC_STAT_IPACKETS ||	\
176 	    (_stat) == MAC_STAT_OBYTES ||	\
177 	    (_stat) == MAC_STAT_OPACKETS ||	\
178 	    (_stat) == MAC_STAT_UNDERFLOWS ||	\
179 	    (_stat) == MAC_STAT_OVERFLOWS)
180 
181 /*
182  * Immutable information. (This may not be modified after registration).
183  */
184 typedef struct mac_info_s {
185 	uint_t		mi_media;
186 	uint_t		mi_nativemedia;
187 	uint_t		mi_addr_length;
188 	uint8_t		*mi_unicst_addr;
189 	uint8_t		*mi_brdcst_addr;
190 } mac_info_t;
191 
192 /*
193  * LSO capability
194  */
195 typedef struct lso_basic_tcp_ipv4_s {
196 	t_uscalar_t	lso_max;		/* maximum payload */
197 } lso_basic_tcp_ipv4_t;
198 
199 /*
200  * Future LSO capabilities can be added at the end of the mac_capab_lso_t.
201  * When such capability is added to the GLDv3 framework, the size of the
202  * mac_capab_lso_t it allocates and passes to the drivers increases. Older
203  * drivers wil access only the (upper) sections of that structure, that is the
204  * sections carrying the capabilities they understand. This ensures the
205  * interface can be safely extended in a binary compatible way.
206  */
207 typedef	struct mac_capab_lso_s {
208 	t_uscalar_t		lso_flags;
209 	lso_basic_tcp_ipv4_t	lso_basic_tcp_ipv4;
210 	/* Add future lso capabilities here */
211 } mac_capab_lso_t;
212 
213 /*
214  * Information for legacy devices.
215  */
216 typedef struct mac_capab_legacy_s {
217 	/*
218 	 * Notifications that the legacy device does not support.
219 	 */
220 	uint32_t	ml_unsup_note;
221 	/*
222 	 * dev_t of the legacy device; can be held to force attach.
223 	 */
224 	dev_t		ml_dev;
225 } mac_capab_legacy_t;
226 
227 /*
228  * MAC layer capabilities.  These capabilities are handled by the drivers'
229  * mc_capab_get() callbacks.  Some capabilities require the driver to fill
230  * in a given data structure, and others are simply boolean capabilities.
231  * Note that capability values must be powers of 2 so that consumers and
232  * providers of this interface can keep track of which capabilities they
233  * care about by keeping a bitfield of these things around somewhere.
234  */
235 typedef enum {
236 	MAC_CAPAB_HCKSUM	= 0x01, /* data is a uint32_t for the txflags */
237 	MAC_CAPAB_POLL		= 0x02,	/* boolean only, no data */
238 	MAC_CAPAB_MULTIADDRESS	= 0x04, /* data is multiaddress_capab_t */
239 	MAC_CAPAB_LSO		= 0x08, /* data is mac_capab_lso_t */
240 	MAC_CAPAB_NO_NATIVEVLAN	= 0x10, /* boolean only, no data */
241 	MAC_CAPAB_NO_ZCOPY	= 0x20, /* boolean only, no data */
242 	/* add new capabilities here */
243 
244 	/* The following capabilities are specific to softmac. */
245 	MAC_CAPAB_LEGACY	= 0x8001, /* data is mac_capab_legacy_t */
246 } mac_capab_t;
247 
248 typedef int mac_addr_slot_t;
249 
250 /* mma_flags values */
251 #define	MMAC_SLOT_USED		0x1   /* address slot used */
252 #define	MMAC_SLOT_UNUSED	0x2   /* free address slot */
253 #define	MMAC_VENDOR_ADDR	0x4   /* address returned is vendor supplied */
254 
255 typedef struct mac_multi_address_s {
256 	mac_addr_slot_t	mma_slot;	/* slot for add/remove/get/set */
257 	uint_t		mma_addrlen;
258 	uint8_t		mma_addr[MAXMACADDRLEN];
259 	uint_t		mma_flags;
260 } mac_multi_addr_t;
261 
262 typedef int	(*maddr_reserve_t)(void *, mac_multi_addr_t *);
263 typedef int	(*maddr_add_t)(void *, mac_multi_addr_t *);
264 typedef int	(*maddr_remove_t)(void *, mac_addr_slot_t);
265 typedef int	(*maddr_modify_t)(void *, mac_multi_addr_t *);
266 typedef int	(*maddr_get_t)(void *, mac_multi_addr_t *);
267 
268 /* maddr_flag values */
269 #define	MADDR_VENDOR_ADDR	0x01	/* addr returned is vendor supplied */
270 
271 /* multiple mac address: add/remove/set/get mac address */
272 typedef struct multiaddress_capab_s {
273 	int		maddr_naddr;	/* total addresses */
274 	int		maddr_naddrfree;	/* free address slots */
275 	uint_t		maddr_flag;	/* MADDR_VENDOR_ADDR bit can be set */
276 	/* driver entry points */
277 	void		*maddr_handle;	/* cookie to be used for the calls */
278 	maddr_reserve_t	maddr_reserve;	/* reserve a factory address */
279 	maddr_add_t	maddr_add;	/* add a new unicst address */
280 	maddr_remove_t	maddr_remove;	/* remove an added address */
281 	maddr_modify_t	maddr_modify;	/* modify an added address */
282 	maddr_get_t	maddr_get;	/* get address from specified slot */
283 } multiaddress_capab_t;
284 
285 /*
286  * MAC driver entry point types.
287  */
288 typedef int		(*mac_getstat_t)(void *, uint_t, uint64_t *);
289 typedef	int		(*mac_start_t)(void *);
290 typedef void		(*mac_stop_t)(void *);
291 typedef int		(*mac_setpromisc_t)(void *, boolean_t);
292 typedef int		(*mac_multicst_t)(void *, boolean_t, const uint8_t *);
293 typedef int		(*mac_unicst_t)(void *, const uint8_t *);
294 typedef void		(*mac_ioctl_t)(void *, queue_t *, mblk_t *);
295 typedef void		(*mac_resources_t)(void *);
296 typedef mblk_t		*(*mac_tx_t)(void *, mblk_t *);
297 typedef	boolean_t	(*mac_getcapab_t)(void *, mac_capab_t, void *);
298 typedef	int		(*mac_open_t)(void *);
299 typedef void		(*mac_close_t)(void *);
300 typedef	int		(*mac_set_prop_t)(void *, const char *, mac_prop_id_t,
301     uint_t, const void *);
302 typedef	int		(*mac_get_prop_t)(void *, const char *, mac_prop_id_t,
303     uint_t, void *);
304 
305 /*
306  * Drivers must set all of these callbacks except for mc_resources,
307  * mc_ioctl, and mc_getcapab, which are optional.  If any of these optional
308  * callbacks are set, their appropriate flags must be set in mc_callbacks.
309  * Any future additions to this list must also be accompanied by an
310  * associated mc_callbacks flag so that the framework can grow without
311  * affecting the binary compatibility of the interface.
312  */
313 typedef struct mac_callbacks_s {
314 	uint_t		mc_callbacks;	/* Denotes which callbacks are set */
315 	mac_getstat_t	mc_getstat;	/* Get the value of a statistic */
316 	mac_start_t	mc_start;	/* Start the device */
317 	mac_stop_t	mc_stop;	/* Stop the device */
318 	mac_setpromisc_t mc_setpromisc;	/* Enable or disable promiscuous mode */
319 	mac_multicst_t	mc_multicst;	/* Enable or disable a multicast addr */
320 	mac_unicst_t	mc_unicst;	/* Set the unicast MAC address */
321 	mac_tx_t	mc_tx;		/* Transmit a packet */
322 	mac_resources_t	mc_resources;	/* Get the device resources */
323 	mac_ioctl_t	mc_ioctl;	/* Process an unknown ioctl */
324 	mac_getcapab_t	mc_getcapab;	/* Get capability information */
325 	mac_open_t	mc_open;	/* Open the device */
326 	mac_close_t	mc_close;	/* Close the device */
327 	mac_set_prop_t	mc_setprop;
328 	mac_get_prop_t	mc_getprop;
329 } mac_callbacks_t;
330 
331 /*
332  * Flags for mc_callbacks.  Requiring drivers to set the flags associated
333  * with optional callbacks initialized in the structure allows the mac
334  * module to add optional callbacks in the future without requiring drivers
335  * to recompile.
336  */
337 #define	MC_RESOURCES	0x001
338 #define	MC_IOCTL	0x002
339 #define	MC_GETCAPAB	0x004
340 #define	MC_OPEN		0x008
341 #define	MC_CLOSE	0x010
342 #define	MC_SETPROP	0x020
343 #define	MC_GETPROP	0x040
344 
345 #define	MAC_MAX_MINOR	1000
346 
347 typedef struct mac_register_s {
348 	uint_t		m_version;	/* set by mac_alloc() */
349 	const char	*m_type_ident;
350 	void		*m_driver;	/* Driver private data */
351 	dev_info_t	*m_dip;
352 	uint_t		m_instance;
353 	uint8_t		*m_src_addr;
354 	uint8_t		*m_dst_addr;
355 	mac_callbacks_t	*m_callbacks;
356 	uint_t		m_min_sdu;
357 	uint_t		m_max_sdu;
358 	void		*m_pdata;
359 	size_t		m_pdata_size;
360 	uint32_t	m_margin;
361 } mac_register_t;
362 
363 /*
364  * Opaque handle types.
365  */
366 typedef	struct mac_t			*mac_handle_t;
367 typedef struct __mac_notify_handle	*mac_notify_handle_t;
368 typedef struct __mac_rx_handle		*mac_rx_handle_t;
369 typedef struct __mac_txloop_handle	*mac_txloop_handle_t;
370 typedef struct __mac_resource_handle	*mac_resource_handle_t;
371 
372 /*
373  * MAC interface callback types.
374  */
375 typedef enum {
376 	MAC_NOTE_LINK,
377 	MAC_NOTE_PROMISC,
378 	MAC_NOTE_UNICST,
379 	MAC_NOTE_TX,
380 	MAC_NOTE_RESOURCE,
381 	MAC_NOTE_DEVPROMISC,
382 	MAC_NOTE_FASTPATH_FLUSH,
383 	MAC_NOTE_SDU_SIZE,
384 	MAC_NOTE_VNIC,
385 	MAC_NOTE_MARGIN,
386 	MAC_NNOTE	/* must be the last entry */
387 } mac_notify_type_t;
388 
389 typedef void		(*mac_notify_t)(void *, mac_notify_type_t);
390 typedef void		(*mac_rx_t)(void *, mac_resource_handle_t, mblk_t *);
391 typedef void		(*mac_txloop_t)(void *, mblk_t *);
392 typedef void		(*mac_blank_t)(void *, time_t, uint_t);
393 
394 /*
395  * MAC promiscuous types
396  */
397 typedef enum {
398 	MAC_PROMISC = 0x01,		/* MAC instance is promiscuous */
399 	MAC_DEVPROMISC = 0x02		/* Device is promiscuous */
400 } mac_promisc_type_t;
401 
402 /*
403  * MAC resource types
404  */
405 typedef enum {
406 	MAC_RX_FIFO = 1
407 } mac_resource_type_t;
408 
409 typedef struct mac_rx_fifo_s {
410 	mac_resource_type_t	mrf_type;	/* MAC_RX_FIFO */
411 	mac_blank_t		mrf_blank;
412 	void			*mrf_arg;
413 	time_t			mrf_normal_blank_time;
414 	uint_t			mrf_normal_pkt_count;
415 } mac_rx_fifo_t;
416 
417 typedef struct mac_txinfo_s {
418 	mac_tx_t		mt_fn;
419 	void			*mt_arg;
420 } mac_txinfo_t;
421 
422 typedef union mac_resource_u {
423 	mac_resource_type_t	mr_type;
424 	mac_rx_fifo_t		mr_fifo;
425 } mac_resource_t;
426 
427 typedef mac_resource_handle_t	(*mac_resource_add_t)(void *, mac_resource_t *);
428 
429 typedef enum {
430 	MAC_ADDRTYPE_UNICAST,
431 	MAC_ADDRTYPE_MULTICAST,
432 	MAC_ADDRTYPE_BROADCAST
433 } mac_addrtype_t;
434 
435 typedef struct mac_header_info_s {
436 	size_t		mhi_hdrsize;
437 	size_t		mhi_pktsize;
438 	const uint8_t	*mhi_daddr;
439 	const uint8_t	*mhi_saddr;
440 	uint32_t	mhi_origsap;
441 	uint32_t	mhi_bindsap;
442 	mac_addrtype_t	mhi_dsttype;
443 	uint16_t	mhi_tci;
444 	uint_t		mhi_istagged:1,
445 			mhi_prom_looped:1;
446 } mac_header_info_t;
447 
448 /*
449  * MAC-Type plugin interfaces
450  */
451 
452 typedef int		(*mtops_addr_verify_t)(const void *, void *);
453 typedef boolean_t	(*mtops_sap_verify_t)(uint32_t, uint32_t *, void *);
454 typedef mblk_t		*(*mtops_header_t)(const void *, const void *,
455     uint32_t, void *, mblk_t *, size_t);
456 typedef int		(*mtops_header_info_t)(mblk_t *, void *,
457     mac_header_info_t *);
458 typedef boolean_t	(*mtops_pdata_verify_t)(void *, size_t);
459 typedef	mblk_t		*(*mtops_header_modify_t)(mblk_t *, void *);
460 typedef void		(*mtops_link_details_t)(char *, size_t, mac_handle_t,
461     void *);
462 
463 typedef struct mactype_ops_s {
464 	uint_t			mtops_ops;
465 	/*
466 	 * mtops_unicst_verify() returns 0 if the given address is a valid
467 	 * unicast address, or a non-zero errno otherwise.
468 	 */
469 	mtops_addr_verify_t	mtops_unicst_verify;
470 	/*
471 	 * mtops_multicst_verify() returns 0 if the given address is a
472 	 * valid multicast address, or a non-zero errno otherwise.  If the
473 	 * media doesn't support multicast, ENOTSUP should be returned (for
474 	 * example).
475 	 */
476 	mtops_addr_verify_t	mtops_multicst_verify;
477 	/*
478 	 * mtops_sap_verify() returns B_TRUE if the given SAP is a valid
479 	 * SAP value, or B_FALSE otherwise.
480 	 */
481 	mtops_sap_verify_t	mtops_sap_verify;
482 	/*
483 	 * mtops_header() is used to allocate and construct a MAC header.
484 	 */
485 	mtops_header_t		mtops_header;
486 	/*
487 	 * mtops_header_info() is used to gather information on a given MAC
488 	 * header.
489 	 */
490 	mtops_header_info_t	mtops_header_info;
491 	/*
492 	 * mtops_pdata_verify() is used to verify the validity of MAC
493 	 * plugin data.  It is called by mac_register() if the driver has
494 	 * supplied MAC plugin data, and also by mac_pdata_update() when
495 	 * drivers update the data.
496 	 */
497 	mtops_pdata_verify_t	mtops_pdata_verify;
498 	/*
499 	 * mtops_header_cook() is an optional callback that converts (or
500 	 * "cooks") the given raw header (as sent by a raw DLPI consumer)
501 	 * into one that is appropriate to send down to the MAC driver.
502 	 * Following the example above, an Ethernet header sent down by a
503 	 * DLPI consumer would be converted to whatever header the MAC
504 	 * driver expects.
505 	 */
506 	mtops_header_modify_t	mtops_header_cook;
507 	/*
508 	 * mtops_header_uncook() is an optional callback that does the
509 	 * opposite of mtops_header_cook().  It "uncooks" a given MAC
510 	 * header (as received from the driver) for consumption by raw DLPI
511 	 * consumers.  For example, for a non-Ethernet plugin that wants
512 	 * raw DLPI consumers to be fooled into thinking that the device
513 	 * provides Ethernet access, this callback would modify the given
514 	 * mblk_t such that the MAC header is converted to an Ethernet
515 	 * header.
516 	 */
517 	mtops_header_modify_t	mtops_header_uncook;
518 	/*
519 	 * mtops_link_details() is an optional callback that provides
520 	 * extended information about the link state.  Its primary purpose
521 	 * is to provide type-specific support for syslog contents on
522 	 * link up events.  If no implementation is provided, then a default
523 	 * implementation will be used.
524 	 */
525 	mtops_link_details_t	mtops_link_details;
526 } mactype_ops_t;
527 
528 /*
529  * mtops_ops exists for the plugin to enumerate the optional callback
530  * entrypoints it has defined.  This allows the mac module to define
531  * additional plugin entrypoints in mactype_ops_t without breaking backward
532  * compatibility with old plugins.
533  */
534 #define	MTOPS_PDATA_VERIFY	0x001
535 #define	MTOPS_HEADER_COOK	0x002
536 #define	MTOPS_HEADER_UNCOOK	0x004
537 #define	MTOPS_LINK_DETAILS	0x008
538 
539 typedef struct mactype_register_s {
540 	uint_t		mtr_version;	/* set by mactype_alloc() */
541 	const char	*mtr_ident;
542 	mactype_ops_t	*mtr_ops;
543 	uint_t		mtr_mactype;
544 	uint_t		mtr_nativetype;
545 	uint_t		mtr_addrlen;
546 	uint8_t		*mtr_brdcst_addr;
547 	mac_stat_info_t	*mtr_stats;
548 	size_t		mtr_statcount;
549 } mactype_register_t;
550 
551 typedef struct mac_prop_s {
552 	mac_prop_id_t	mp_id;
553 	char		*mp_name;
554 } mac_prop_t;
555 
556 /*
557  * Client interface functions.
558  */
559 extern int			mac_open(const char *, mac_handle_t *);
560 extern int			mac_open_by_linkid(datalink_id_t,
561 				    mac_handle_t *);
562 extern int			mac_open_by_linkname(const char *,
563 				    mac_handle_t *);
564 extern void			mac_close(mac_handle_t);
565 extern const mac_info_t		*mac_info(mac_handle_t);
566 extern boolean_t		mac_info_get(const char *, mac_info_t *);
567 extern uint64_t			mac_stat_get(mac_handle_t, uint_t);
568 extern int			mac_start(mac_handle_t);
569 extern void			mac_stop(mac_handle_t);
570 extern int			mac_promisc_set(mac_handle_t, boolean_t,
571 				    mac_promisc_type_t);
572 extern boolean_t		mac_promisc_get(mac_handle_t,
573 				    mac_promisc_type_t);
574 extern int 			mac_multicst_add(mac_handle_t, const uint8_t *);
575 extern int 			mac_multicst_remove(mac_handle_t,
576 				    const uint8_t *);
577 extern boolean_t		mac_unicst_verify(mac_handle_t,
578 				    const uint8_t *, uint_t);
579 extern int			mac_unicst_set(mac_handle_t, const uint8_t *);
580 extern void			mac_unicst_get(mac_handle_t, uint8_t *);
581 extern void			mac_dest_get(mac_handle_t, uint8_t *);
582 extern void			mac_sdu_get(mac_handle_t, uint_t *, uint_t *);
583 extern void			mac_resources(mac_handle_t);
584 extern void			mac_ioctl(mac_handle_t, queue_t *, mblk_t *);
585 extern const mac_txinfo_t	*mac_tx_get(mac_handle_t);
586 extern const mac_txinfo_t	*mac_vnic_tx_get(mac_handle_t);
587 extern link_state_t		mac_link_get(mac_handle_t);
588 extern mac_notify_handle_t	mac_notify_add(mac_handle_t, mac_notify_t,
589 				    void *);
590 extern void			mac_notify_remove(mac_handle_t,
591 				    mac_notify_handle_t);
592 extern void			mac_notify(mac_handle_t);
593 extern mac_rx_handle_t		mac_rx_add(mac_handle_t, mac_rx_t, void *);
594 extern mac_rx_handle_t		mac_active_rx_add(mac_handle_t, mac_rx_t,
595 				    void *);
596 extern void			mac_rx_remove(mac_handle_t, mac_rx_handle_t,
597 				    boolean_t);
598 extern void			mac_rx_remove_wait(mac_handle_t);
599 extern mblk_t			*mac_txloop(void *, mblk_t *);
600 extern mac_txloop_handle_t	mac_txloop_add(mac_handle_t, mac_txloop_t,
601 				    void *);
602 extern void			mac_txloop_remove(mac_handle_t,
603 				    mac_txloop_handle_t);
604 extern boolean_t		mac_active_set(mac_handle_t);
605 extern boolean_t		mac_active_shareable_set(mac_handle_t);
606 extern void			mac_active_clear(mac_handle_t);
607 extern void			mac_active_rx(void *, mac_resource_handle_t,
608 				    mblk_t *);
609 extern boolean_t		mac_vnic_set(mac_handle_t, mac_txinfo_t *,
610 				    mac_getcapab_t, void *);
611 extern void			mac_vnic_clear(mac_handle_t);
612 extern void			mac_resource_set(mac_handle_t,
613 				    mac_resource_add_t, void *);
614 extern dev_info_t		*mac_devinfo_get(mac_handle_t);
615 extern const char		*mac_name(mac_handle_t);
616 extern minor_t			mac_minor(mac_handle_t);
617 extern boolean_t		mac_capab_get(mac_handle_t, mac_capab_t,
618 				    void *);
619 extern boolean_t		mac_vnic_capab_get(mac_handle_t, mac_capab_t,
620 				    void *);
621 extern boolean_t		mac_sap_verify(mac_handle_t, uint32_t,
622 				    uint32_t *);
623 extern mblk_t			*mac_header(mac_handle_t, const uint8_t *,
624 				    uint32_t, mblk_t *, size_t);
625 extern int			mac_header_info(mac_handle_t, mblk_t *,
626 				    mac_header_info_t *);
627 extern mblk_t			*mac_header_cook(mac_handle_t, mblk_t *);
628 extern mblk_t			*mac_header_uncook(mac_handle_t, mblk_t *);
629 extern minor_t			mac_minor_hold(boolean_t);
630 extern void			mac_minor_rele(minor_t);
631 
632 /*
633  * Driver interface functions.
634  */
635 extern mac_register_t		*mac_alloc(uint_t);
636 extern void			mac_free(mac_register_t *);
637 extern int			mac_register(mac_register_t *, mac_handle_t *);
638 extern int			mac_disable(mac_handle_t);
639 extern int  			mac_unregister(mac_handle_t);
640 extern void 			mac_rx(mac_handle_t, mac_resource_handle_t,
641 				    mblk_t *);
642 extern void 			mac_link_update(mac_handle_t, link_state_t);
643 extern void 			mac_unicst_update(mac_handle_t,
644 				    const uint8_t *);
645 extern void			mac_tx_update(mac_handle_t);
646 extern void			mac_resource_update(mac_handle_t);
647 extern mac_resource_handle_t	mac_resource_add(mac_handle_t,
648 				    mac_resource_t *);
649 extern int			mac_maxsdu_update(mac_handle_t, uint_t);
650 extern int			mac_pdata_update(mac_handle_t, void *,
651 				    size_t);
652 extern void			mac_multicst_refresh(mac_handle_t,
653 				    mac_multicst_t, void *, boolean_t);
654 extern void			mac_unicst_refresh(mac_handle_t, mac_unicst_t,
655 				    void *);
656 extern void			mac_promisc_refresh(mac_handle_t,
657 				    mac_setpromisc_t, void *);
658 extern boolean_t		mac_margin_update(mac_handle_t, uint32_t);
659 extern void			mac_margin_get(mac_handle_t, uint32_t *);
660 extern int			mac_margin_remove(mac_handle_t, uint32_t);
661 extern int			mac_margin_add(mac_handle_t, uint32_t *,
662 				    boolean_t);
663 extern void			mac_init_ops(struct dev_ops *, const char *);
664 extern void			mac_fini_ops(struct dev_ops *);
665 extern uint32_t			mac_no_notification(mac_handle_t);
666 extern boolean_t		mac_is_legacy(mac_handle_t);
667 extern int			mac_hold_exclusive(mac_handle_t);
668 extern void			mac_rele_exclusive(mac_handle_t);
669 
670 extern mactype_register_t	*mactype_alloc(uint_t);
671 extern void			mactype_free(mactype_register_t *);
672 extern int			mactype_register(mactype_register_t *);
673 extern int			mactype_unregister(const char *);
674 extern int			mac_set_prop(mac_handle_t, mac_prop_t *,
675     void *, uint_t);
676 extern int			mac_get_prop(mac_handle_t, mac_prop_t *,
677     void *, uint_t);
678 
679 #endif	/* _KERNEL */
680 
681 #ifdef	__cplusplus
682 }
683 #endif
684 
685 #endif /* _SYS_MAC_H */
686