xref: /illumos-gate/usr/src/uts/common/sys/mac_provider.h (revision 45948e49c407e4fc264fdd289ed632d6639e009d)
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 /*
23  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Copyright (c) 2018, Joyent, Inc.
25  */
26 
27 #ifndef	_SYS_MAC_PROVIDER_H
28 #define	_SYS_MAC_PROVIDER_H
29 
30 #include <sys/types.h>
31 #include <sys/ddi.h>
32 #include <sys/sunddi.h>
33 #include <sys/stream.h>
34 #include <sys/mkdev.h>
35 #include <sys/mac.h>
36 #include <sys/mac_flow.h>
37 
38 /*
39  * MAC Provider Interface
40  */
41 
42 #ifdef	__cplusplus
43 extern "C" {
44 #endif
45 
46 /*
47  * MAC version identifiers. Drivers compiled against the stable V1 version
48  * of the API should register with MAC_VERSION_V1. ON drivers should use
49  * MAC_VERSION. This is used by mac_alloc() mac_register() to
50  * verify that incompatible drivers don't register.
51  */
52 #define	MAC_VERSION_V1	0x1
53 #define	MAC_VERSION	MAC_VERSION_V1
54 
55 /*
56  * Possible values for ETHER_STAT_XCVR_INUSE statistic.
57  */
58 
59 #define	XCVR_UNDEFINED		0
60 #define	XCVR_NONE		1
61 #define	XCVR_10			2
62 #define	XCVR_100T4		3
63 #define	XCVR_100X		4
64 #define	XCVR_100T2		5
65 #define	XCVR_1000X		6
66 #define	XCVR_1000T		7
67 
68 #ifdef	_KERNEL
69 
70 /*
71  * Definitions for MAC Drivers Capabilities
72  */
73 /*
74  * MAC layer capabilities.  These capabilities are handled by the drivers'
75  * mc_capab_get() callbacks.  Some capabilities require the driver to fill
76  * in a given data structure, and others are simply boolean capabilities.
77  * Note that capability values must be powers of 2 so that consumers and
78  * providers of this interface can keep track of which capabilities they
79  * care about by keeping a bitfield of these things around somewhere.
80  */
81 typedef enum {
82 	/*
83 	 * Public Capabilities (MAC_VERSION_V1)
84 	 */
85 	MAC_CAPAB_HCKSUM	= 0x00000001, /* data is a uint32_t */
86 	MAC_CAPAB_LSO		= 0x00000008, /* data is mac_capab_lso_t */
87 
88 	/*
89 	 * Reserved capabilities, do not use
90 	 */
91 	MAC_CAPAB_RESERVED1	= 0x00000002,
92 	MAC_CAPAB_RESERVED2	= 0x00000004,
93 
94 	/*
95 	 * Private driver capabilities
96 	 */
97 	MAC_CAPAB_RINGS		= 0x00000010, /* data is mac_capab_rings_t */
98 	MAC_CAPAB_SHARES	= 0x00000020, /* data is mac_capab_share_t */
99 	MAC_CAPAB_MULTIFACTADDR = 0x00000040, /* mac_data_multifactaddr_t */
100 
101 	/*
102 	 * Private driver capabilities for use by the GLDv3 framework only
103 	 */
104 	MAC_CAPAB_VNIC		= 0x00010000, /* data is mac_capab_vnic_t */
105 	MAC_CAPAB_ANCHOR_VNIC	= 0x00020000, /* boolean only, no data */
106 	MAC_CAPAB_AGGR		= 0x00040000, /* data is mac_capab_aggr_t */
107 	MAC_CAPAB_NO_NATIVEVLAN	= 0x00080000, /* boolean only, no data */
108 	MAC_CAPAB_NO_ZCOPY	= 0x00100000, /* boolean only, no data */
109 	MAC_CAPAB_LEGACY	= 0x00200000, /* data is mac_capab_legacy_t */
110 	MAC_CAPAB_VRRP		= 0x00400000, /* data is mac_capab_vrrp_t */
111 	MAC_CAPAB_TRANSCEIVER	= 0x01000000, /* mac_capab_transciever_t */
112 	MAC_CAPAB_LED		= 0x02000000  /* data is mac_capab_led_t */
113 } mac_capab_t;
114 
115 /*
116  * LSO capability
117  */
118 typedef struct lso_basic_tcp_ipv4_s {
119 	t_uscalar_t	lso_max;		/* maximum payload */
120 } lso_basic_tcp_ipv4_t;
121 
122 /*
123  * Currently supported flags for LSO.
124  */
125 #define	LSO_TX_BASIC_TCP_IPV4	0x01		/* TCP LSO capability */
126 
127 /*
128  * Future LSO capabilities can be added at the end of the mac_capab_lso_t.
129  * When such capability is added to the GLDv3 framework, the size of the
130  * mac_capab_lso_t it allocates and passes to the drivers increases. Older
131  * drivers wil access only the (upper) sections of that structure, that is the
132  * sections carrying the capabilities they understand. This ensures the
133  * interface can be safely extended in a binary compatible way.
134  */
135 typedef	struct mac_capab_lso_s {
136 	t_uscalar_t		lso_flags;
137 	lso_basic_tcp_ipv4_t	lso_basic_tcp_ipv4;
138 	/* Add future lso capabilities here */
139 } mac_capab_lso_t;
140 
141 /*
142  * Multiple Factory MAC Addresses Capability
143  */
144 typedef struct mac_capab_multifactaddr_s {
145 	/*
146 	 * Number of factory addresses
147 	 */
148 	uint_t		mcm_naddr;
149 
150 	/*
151 	 * Callbacks to query all the factory addresses.
152 	 */
153 	void		(*mcm_getaddr)(void *, uint_t, uint8_t *);
154 } mac_capab_multifactaddr_t;
155 
156 /*
157  * Info and callbacks of legacy devices.
158  */
159 typedef struct mac_capab_legacy_s {
160 	/*
161 	 * Notifications that the legacy device does not support.
162 	 */
163 	uint32_t	ml_unsup_note;
164 	/*
165 	 * dev_t of the legacy device; can be held to force attach.
166 	 */
167 	dev_t		ml_dev;
168 	boolean_t	(*ml_active_set)(void *);
169 	void		(*ml_active_clear)(void *);
170 	int		(*ml_fastpath_disable)(void *);
171 	void		(*ml_fastpath_enable)(void *);
172 } mac_capab_legacy_t;
173 
174 typedef struct __mac_prop_info_handle *mac_prop_info_handle_t;
175 
176 /*
177  * MAC driver entry point types.
178  */
179 typedef int		(*mac_getstat_t)(void *, uint_t, uint64_t *);
180 typedef	int		(*mac_start_t)(void *);
181 typedef void		(*mac_stop_t)(void *);
182 typedef int		(*mac_setpromisc_t)(void *, boolean_t);
183 typedef int		(*mac_multicst_t)(void *, boolean_t, const uint8_t *);
184 typedef int		(*mac_unicst_t)(void *, const uint8_t *);
185 typedef void		(*mac_ioctl_t)(void *, queue_t *, mblk_t *);
186 typedef void		(*mac_resources_t)(void *);
187 typedef mblk_t		*(*mac_tx_t)(void *, mblk_t *);
188 typedef	boolean_t	(*mac_getcapab_t)(void *, mac_capab_t, void *);
189 typedef	int		(*mac_open_t)(void *);
190 typedef void		(*mac_close_t)(void *);
191 typedef	int		(*mac_set_prop_t)(void *, const char *, mac_prop_id_t,
192 			    uint_t, const void *);
193 typedef	int		(*mac_get_prop_t)(void *, const char *, mac_prop_id_t,
194 			    uint_t, void *);
195 typedef void		(*mac_prop_info_t)(void *, const char *, mac_prop_id_t,
196 			    mac_prop_info_handle_t);
197 
198 /*
199  * Driver callbacks. The following capabilities are optional, and if
200  * implemented by the driver, must have a corresponding MC_ flag set
201  * in the mc_callbacks field.
202  *
203  * Any future additions to this list must also be accompanied by an
204  * associated mc_callbacks flag so that the framework can grow without
205  * affecting the binary compatibility of the interface.
206  */
207 typedef struct mac_callbacks_s {
208 	uint_t		mc_callbacks;	/* Denotes which callbacks are set */
209 	mac_getstat_t	mc_getstat;	/* Get the value of a statistic */
210 	mac_start_t	mc_start;	/* Start the device */
211 	mac_stop_t	mc_stop;	/* Stop the device */
212 	mac_setpromisc_t mc_setpromisc;	/* Enable or disable promiscuous mode */
213 	mac_multicst_t	mc_multicst;	/* Enable or disable a multicast addr */
214 	mac_unicst_t	mc_unicst;	/* Set the unicast MAC address */
215 	mac_tx_t	mc_tx;		/* Transmit a packet */
216 	void		*mc_reserved;	/* Reserved, do not use */
217 	mac_ioctl_t	mc_ioctl;	/* Process an unknown ioctl */
218 	mac_getcapab_t	mc_getcapab;	/* Get capability information */
219 	mac_open_t	mc_open;	/* Open the device */
220 	mac_close_t	mc_close;	/* Close the device */
221 	mac_set_prop_t	mc_setprop;
222 	mac_get_prop_t	mc_getprop;
223 	mac_prop_info_t	mc_propinfo;
224 } mac_callbacks_t;
225 
226 /*
227  * Flags for mc_callbacks.  Requiring drivers to set the flags associated
228  * with optional callbacks initialized in the structure allows the mac
229  * module to add optional callbacks in the future without requiring drivers
230  * to recompile.
231  */
232 #define	MC_RESERVED	0x0001
233 #define	MC_IOCTL	0x0002
234 #define	MC_GETCAPAB	0x0004
235 #define	MC_OPEN		0x0008
236 #define	MC_CLOSE	0x0010
237 #define	MC_SETPROP	0x0020
238 #define	MC_GETPROP	0x0040
239 #define	MC_PROPINFO	0x0080
240 #define	MC_PROPERTIES	(MC_SETPROP | MC_GETPROP | MC_PROPINFO)
241 
242 /*
243  * Virtualization Capabilities
244  */
245 
246 /*
247  * The type of ring classification. This is used by MAC to determine
248  * what, if any, processing it has to do upon receiving traffic on a
249  * particular Rx ring.
250  *
251  * MAC_NO_CLASSIFIER
252  *
253  *	No classification has been set. No traffic should cross an Rx
254  *	ring in this state.
255  *
256  * MAC_SW_CLASSIFIER
257  *
258  *	The driver delivers traffic for multiple clients to this ring.
259  *	All traffic must be software classified by MAC to guarantee
260  *	delivery to the correct client. This classification type may
261  *	be chosen for several reasons.
262  *
263  *	o The driver provides only one group and there are multiple
264  *	  clients using the MAC.
265  *
266  *	o The driver provides some hardware filtering but not enough
267  *	  to fully classify the traffic. E.g., a VLAN VNIC requires L2
268  *	  unicast address filtering as well as VLAN filtering, but
269  *	  some drivers may only support the former.
270  *
271  *	o The ring belongs to the default group. The default group
272  *	  acts as a spillover for all clients that can't reserve an
273  *	  exclusive group. It also handles multicast traffic for all
274  *	  clients. For these reasons, the default group's rings are
275  *	  always software classified.
276  *
277  * MAC_HW_CLASSIFIER
278  *
279  *	The driver delivers traffic for a single MAC client across
280  *	this ring. With this guarantee, MAC can simply pass the
281  *	traffic up the stack or even allow polling of the ring.
282  *
283  * MAC_PASSTHRU_CLASSIFIER
284  *
285  *	The ring is in "passthru" mode. In this mode we bypass all of
286  *	the typical MAC processing and pass the traffic directly to
287  *	the mr_pt_fn callback, see mac_rx_common(). This is used in
288  *	cases where there is another module acting as MAC provider on
289  *	behalf of the driver. E.g., link aggregations use this mode to
290  *	take full control of the port's rings; allowing it to enforce
291  *	LACP protocols and aggregate rings across discrete drivers.
292  */
293 typedef enum {
294 	MAC_NO_CLASSIFIER = 0,
295 	MAC_SW_CLASSIFIER,
296 	MAC_HW_CLASSIFIER,
297 	MAC_PASSTHRU_CLASSIFIER
298 } mac_classify_type_t;
299 
300 typedef	void	(*mac_rx_func_t)(void *, mac_resource_handle_t, mblk_t *,
301     boolean_t);
302 
303 /*
304  * The virtualization level conveys the extent of the NIC hardware assistance
305  * for traffic steering employed for virtualization:
306  *
307  * MAC_VIRT_NONE:	No assist for v12n.
308  *
309  * MAC_VIRT_LEVEL1:	Multiple Rx rings with MAC address level
310  *			classification between groups of rings.
311  *			Requires the support of the MAC_CAPAB_RINGS
312  *			capability.
313  *
314  * MAC_VIRT_HIO:	Hybrid I/O capable MAC. Require the support
315  *			of the MAC_CAPAB_SHARES capability.
316  */
317 #define	MAC_VIRT_NONE		0x0
318 #define	MAC_VIRT_LEVEL1		0x1
319 #define	MAC_VIRT_HIO		0x2
320 
321 typedef enum {
322 	MAC_RING_TYPE_RX = 1,	/* Receive ring */
323 	MAC_RING_TYPE_TX	/* Transmit ring */
324 } mac_ring_type_t;
325 
326 /*
327  * The value VLAN_ID_NONE (VID 0) means a client does not have
328  * membership to any VLAN. However, this statement is true for both
329  * untagged packets and priority tagged packets leading to confusion
330  * over what semantic is intended. To the provider, VID 0 is a valid
331  * VID when priority tagging is in play. To MAC and everything above
332  * VLAN_ID_NONE almost universally implies untagged traffic. Thus, we
333  * convert VLAN_ID_NONE to a sentinel value (MAC_VLAN_UNTAGGED) at the
334  * border between MAC and MAC provider. This informs the provider that
335  * the client is interested in untagged traffic and the provider
336  * should set any relevant bits to receive such traffic.
337  *
338  * Currently, the API between MAC and the provider passes the VID as a
339  * unit16_t. In the future this could actually be the entire TCI mask
340  * (PCP, DEI, and VID). This current scheme is safe in that potential
341  * future world as well; as 0xFFFF is not a valid TCI (the 0xFFF VID
342  * is reserved and never transmitted across networks).
343  */
344 #define	MAC_VLAN_UNTAGGED		UINT16_MAX
345 #define	MAC_VLAN_UNTAGGED_VID(vid)	\
346 	(((vid) == VLAN_ID_NONE) ? MAC_VLAN_UNTAGGED : (vid))
347 
348 /*
349  * Grouping type of a ring group
350  *
351  * MAC_GROUP_TYPE_STATIC: The ring group can not be re-grouped.
352  * MAC_GROUP_TYPE_DYNAMIC: The ring group support dynamic re-grouping
353  */
354 typedef enum {
355 	MAC_GROUP_TYPE_STATIC = 1,	/* Static ring group */
356 	MAC_GROUP_TYPE_DYNAMIC		/* Dynamic ring group */
357 } mac_group_type_t;
358 
359 typedef	struct __mac_ring_driver	*mac_ring_driver_t;
360 typedef	struct __mac_group_driver	*mac_group_driver_t;
361 
362 typedef	struct mac_ring_info_s mac_ring_info_t;
363 typedef	struct mac_group_info_s mac_group_info_t;
364 
365 typedef void	(*mac_get_ring_t)(void *, mac_ring_type_t, const int, const int,
366     mac_ring_info_t *, mac_ring_handle_t);
367 typedef void	(*mac_get_group_t)(void *, mac_ring_type_t, const int,
368     mac_group_info_t *, mac_group_handle_t);
369 
370 typedef void	(*mac_group_add_ring_t)(mac_group_driver_t,
371     mac_ring_driver_t, mac_ring_type_t);
372 typedef void	(*mac_group_rem_ring_t)(mac_group_driver_t,
373     mac_ring_driver_t, mac_ring_type_t);
374 
375 /*
376  * Multiple Rings Capability
377  */
378 typedef struct	mac_capab_rings_s {
379 	mac_ring_type_t		mr_type;	/* Ring type: Rx vs Tx */
380 	mac_group_type_t	mr_group_type;	/* Dynamic vs static grouping */
381 	uint_t			mr_rnum;	/* Number of rings */
382 	uint_t			mr_gnum;	/* Number of ring groups */
383 	mac_get_ring_t		mr_rget;	/* Get ring from driver */
384 	mac_get_group_t		mr_gget;	/* Get ring group from driver */
385 	mac_group_add_ring_t	mr_gaddring;	/* Add ring into a group */
386 	mac_group_rem_ring_t	mr_gremring;	/* Remove ring from a group */
387 } mac_capab_rings_t;
388 
389 /*
390  * Common ring functions and driver interfaces
391  */
392 typedef	int	(*mac_ring_start_t)(mac_ring_driver_t, uint64_t);
393 typedef	void	(*mac_ring_stop_t)(mac_ring_driver_t);
394 
395 typedef	mblk_t	*(*mac_ring_send_t)(void *, mblk_t *);
396 typedef	mblk_t	*(*mac_ring_poll_t)(void *, int);
397 
398 typedef int	(*mac_ring_stat_t)(mac_ring_driver_t, uint_t, uint64_t *);
399 
400 typedef struct mac_ring_info_s {
401 	mac_ring_driver_t	mri_driver;
402 	mac_ring_start_t	mri_start;
403 	mac_ring_stop_t		mri_stop;
404 	mac_intr_t		mri_intr;
405 	union {
406 		mac_ring_send_t	send;
407 		mac_ring_poll_t	poll;
408 	} mrfunion;
409 	mac_ring_stat_t		mri_stat;
410 
411 	/*
412 	 * mri_flags will have some bits set to indicate some special
413 	 * property/feature of a ring like serialization needed for a
414 	 * Tx ring or packets should always need enqueuing on Rx side,
415 	 * etc.
416 	 */
417 	uint_t			mri_flags;
418 } mac_ring_info_s;
419 
420 #define	mri_tx			mrfunion.send
421 #define	mri_poll		mrfunion.poll
422 
423 /*
424  * #defines for mri_flags. The flags are temporary flags that are provided
425  * only to workaround issues in specific drivers, and they will be
426  * removed in the future.
427  *
428  * These are consumed only by sun4v and neptune (nxge).
429  */
430 #define	MAC_RING_TX_SERIALIZE		0x1
431 #define	MAC_RING_RX_ENQUEUE		0x2
432 
433 typedef	int	(*mac_group_start_t)(mac_group_driver_t);
434 typedef	void	(*mac_group_stop_t)(mac_group_driver_t);
435 typedef	int	(*mac_add_mac_addr_t)(void *, const uint8_t *);
436 typedef	int	(*mac_rem_mac_addr_t)(void *, const uint8_t *);
437 typedef int	(*mac_add_vlan_filter_t)(mac_group_driver_t, uint16_t);
438 typedef int	(*mac_rem_vlan_filter_t)(mac_group_driver_t, uint16_t);
439 
440 struct mac_group_info_s {
441 	mac_group_driver_t	mgi_driver;	/* Driver reference */
442 	mac_group_start_t	mgi_start;	/* Start the group */
443 	mac_group_stop_t	mgi_stop;	/* Stop the group */
444 	uint_t			mgi_count;	/* Count of rings */
445 	mac_intr_t		mgi_intr;	/* Optional per-group intr */
446 
447 	/* Only used for Rx groups */
448 	mac_add_mac_addr_t	mgi_addmac;	/* Add a MAC address */
449 	mac_rem_mac_addr_t	mgi_remmac;	/* Remove a MAC address */
450 	mac_add_vlan_filter_t	mgi_addvlan;	/* Add a VLAN filter */
451 	mac_rem_vlan_filter_t	mgi_remvlan;	/* Remove a VLAN filter */
452 };
453 
454 /*
455  * Share management functions.
456  */
457 typedef uint64_t mac_share_handle_t;
458 
459 /*
460  * Allocate and free a share. Returns ENOSPC if all shares have been
461  * previously allocated.
462  */
463 typedef int (*mac_alloc_share_t)(void *, mac_share_handle_t *);
464 typedef void (*mac_free_share_t)(mac_share_handle_t);
465 
466 /*
467  * Bind and unbind a share. Binding a share allows a domain
468  * to have direct access to the groups and rings associated with
469  * that share.
470  */
471 typedef int (*mac_bind_share_t)(mac_share_handle_t, uint64_t, uint64_t *);
472 typedef void (*mac_unbind_share_t)(mac_share_handle_t);
473 
474 /*
475  * Return information on about a share.
476  */
477 typedef void (*mac_share_query_t)(mac_share_handle_t, mac_ring_type_t,
478     mac_ring_handle_t *, uint_t *);
479 
480 /*
481  * Basic idea, bind previously created ring groups to shares
482  * for them to be exported (or shared) by another domain.
483  * These interfaces bind/unbind the ring group to a share.
484  * The groups and their rings will be shared with the guest
485  * as soon as the share is bound.
486  */
487 typedef int (*mac_share_add_group_t)(mac_share_handle_t,
488     mac_group_driver_t);
489 typedef int (*mac_share_rem_group_t)(mac_share_handle_t,
490     mac_group_driver_t);
491 
492 typedef struct  mac_capab_share_s {
493 	uint_t			ms_snum;	/* Number of shares (vr's) */
494 	void			*ms_handle;	/* Handle to driver. */
495 	mac_alloc_share_t	ms_salloc;	/* Get a share from driver. */
496 	mac_free_share_t	ms_sfree;	/* Return a share to driver. */
497 	mac_share_add_group_t	ms_sadd;	/* Add a group to the share. */
498 	mac_share_rem_group_t	ms_sremove;	/* Remove group from share. */
499 	mac_share_query_t	ms_squery;	/* Query share constraints */
500 	mac_bind_share_t	ms_sbind;	/* Bind a share */
501 	mac_unbind_share_t	ms_sunbind;	/* Unbind a share */
502 } mac_capab_share_t;
503 
504 typedef struct mac_capab_vrrp_s {
505 	/* IPv6 or IPv4? */
506 	int		mcv_af;
507 } mac_capab_vrrp_t;
508 
509 /*
510  * Transceiver capability
511  */
512 typedef struct mac_transceiver_info mac_transceiver_info_t;
513 
514 typedef struct mac_capab_transceiver {
515 	uint_t	mct_flags;
516 	uint_t	mct_ntransceivers;
517 	int	(*mct_info)(void *, uint_t, mac_transceiver_info_t *);
518 	int	(*mct_read)(void *, uint_t, uint_t, void *, size_t, off_t,
519 		    size_t *);
520 } mac_capab_transceiver_t;
521 
522 /*
523  * LED capability
524  */
525 typedef struct mac_capab_led {
526 	uint_t		mcl_flags;
527 	mac_led_mode_t	mcl_modes;
528 	int		(*mcl_set)(void *, mac_led_mode_t, uint_t);
529 } mac_capab_led_t;
530 
531 /*
532  * MAC registration interface
533  */
534 typedef struct mac_register_s {
535 	uint_t			m_version;	/* set by mac_alloc() */
536 	const char		*m_type_ident;
537 	void			*m_driver;	/* Driver private data */
538 	dev_info_t		*m_dip;
539 	uint_t			m_instance;
540 	uint8_t			*m_src_addr;
541 	uint8_t			*m_dst_addr;
542 	mac_callbacks_t		*m_callbacks;
543 	uint_t			m_min_sdu;
544 	uint_t			m_max_sdu;
545 	void			*m_pdata;
546 	size_t			m_pdata_size;
547 	char			**m_priv_props;
548 	uint32_t		m_margin;
549 	uint32_t		m_v12n;		/* Virtualization level */
550 	uint_t			m_multicast_sdu;
551 } mac_register_t;
552 
553 /*
554  * Driver interface functions.
555  */
556 extern mac_protect_t		*mac_protect_get(mac_handle_t);
557 extern void			mac_sdu_get(mac_handle_t, uint_t *, uint_t *);
558 extern void			mac_sdu_get2(mac_handle_t, uint_t *, uint_t *,
559 				    uint_t *);
560 extern int			mac_maxsdu_update(mac_handle_t, uint_t);
561 extern int			mac_maxsdu_update2(mac_handle_t, uint_t,
562 				    uint_t);
563 
564 extern mac_register_t		*mac_alloc(uint_t);
565 extern void			mac_free(mac_register_t *);
566 extern int			mac_register(mac_register_t *, mac_handle_t *);
567 extern int			mac_disable_nowait(mac_handle_t);
568 extern int			mac_disable(mac_handle_t);
569 extern int			mac_unregister(mac_handle_t);
570 extern void			mac_rx(mac_handle_t, mac_resource_handle_t,
571 				    mblk_t *);
572 extern void			mac_rx_ring(mac_handle_t, mac_ring_handle_t,
573 				    mblk_t *, uint64_t);
574 extern void			mac_link_update(mac_handle_t, link_state_t);
575 extern void			mac_link_redo(mac_handle_t, link_state_t);
576 extern void			mac_unicst_update(mac_handle_t,
577 				    const uint8_t *);
578 extern void			mac_dst_update(mac_handle_t, const uint8_t *);
579 extern void			mac_tx_update(mac_handle_t);
580 extern void			mac_tx_ring_update(mac_handle_t,
581 				    mac_ring_handle_t);
582 extern void			mac_capab_update(mac_handle_t);
583 extern int			mac_pdata_update(mac_handle_t, void *,
584 				    size_t);
585 extern void			mac_multicast_refresh(mac_handle_t,
586 				    mac_multicst_t, void *, boolean_t);
587 extern void			mac_unicst_refresh(mac_handle_t, mac_unicst_t,
588 				    void *);
589 extern void			mac_promisc_refresh(mac_handle_t,
590 				    mac_setpromisc_t, void *);
591 extern boolean_t		mac_margin_update(mac_handle_t, uint32_t);
592 extern void			mac_margin_get(mac_handle_t, uint32_t *);
593 extern int			mac_margin_remove(mac_handle_t, uint32_t);
594 extern int			mac_margin_add(mac_handle_t, uint32_t *,
595 				    boolean_t);
596 extern void			mac_init_ops(struct dev_ops *, const char *);
597 extern void			mac_fini_ops(struct dev_ops *);
598 extern int			mac_devt_to_instance(dev_t);
599 extern minor_t			mac_private_minor(void);
600 extern void			mac_ring_intr_set(mac_ring_handle_t,
601 				    ddi_intr_handle_t);
602 
603 
604 extern mactype_register_t	*mactype_alloc(uint_t);
605 extern void			mactype_free(mactype_register_t *);
606 extern int			mactype_register(mactype_register_t *);
607 extern int			mactype_unregister(const char *);
608 
609 extern boolean_t		mac_unicst_verify(mac_handle_t,
610 				    const uint8_t *, uint_t);
611 
612 extern int			mac_group_add_ring(mac_group_handle_t, int);
613 extern void			mac_group_rem_ring(mac_group_handle_t,
614 				    mac_ring_handle_t);
615 extern mac_ring_handle_t	mac_find_ring(mac_group_handle_t, int);
616 
617 extern void			mac_prop_info_set_default_uint8(
618 				    mac_prop_info_handle_t, uint8_t);
619 extern void			mac_prop_info_set_default_str(
620 				    mac_prop_info_handle_t, const char *);
621 extern void			mac_prop_info_set_default_uint64(
622 				    mac_prop_info_handle_t, uint64_t);
623 extern void			mac_prop_info_set_default_uint32(
624 				    mac_prop_info_handle_t, uint32_t);
625 extern void			mac_prop_info_set_default_link_flowctrl(
626 				    mac_prop_info_handle_t, link_flowctrl_t);
627 extern void			mac_prop_info_set_range_uint32(
628 				    mac_prop_info_handle_t,
629 				    uint32_t, uint32_t);
630 extern void			mac_prop_info_set_perm(mac_prop_info_handle_t,
631 				    uint8_t);
632 
633 extern void			mac_hcksum_get(mblk_t *, uint32_t *,
634 				    uint32_t *, uint32_t *, uint32_t *,
635 				    uint32_t *);
636 extern void			mac_hcksum_set(mblk_t *, uint32_t, uint32_t,
637 				    uint32_t, uint32_t, uint32_t);
638 
639 extern void			mac_lso_get(mblk_t *, uint32_t *, uint32_t *);
640 
641 extern void			mac_transceiver_info_set_present(
642 				    mac_transceiver_info_t *,
643 				    boolean_t);
644 extern void			mac_transceiver_info_set_usable(
645 				    mac_transceiver_info_t *,
646 				    boolean_t);
647 
648 #endif	/* _KERNEL */
649 
650 #ifdef	__cplusplus
651 }
652 #endif
653 
654 #endif /* _SYS_MAC_PROVIDER_H */
655