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 */