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