da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * CDDL HEADER START
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * The contents of this file are subject to the terms of the
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Common Development and Distribution License (the "License").
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * You may not use this file except in compliance with the License.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * See the License for the specific language governing permissions
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * and limitations under the License.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * When distributing Covered Code, include this CDDL HEADER in each
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If applicable, add the following below this CDDL HEADER, with the
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * fields enclosed by brackets "[]" replaced with your own identifying
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * information: Portions Copyright [yyyy] [name of copyright owner]
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * CDDL HEADER END
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * MAC Provider Interface.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Interface for GLDv3 compatible NIC drivers.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengstatic void i_mac_notify_thread(void *);
da14cebe459d3275048785f25bd869cb09b5307fEric Chengtypedef void (*mac_notify_default_cb_fn_t)(mac_impl_t *);
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavaistatic const mac_notify_default_cb_fn_t mac_notify_cb_list[MAC_NNOTE] = {
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Driver support functions.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* REGISTRATION */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Make sure there isn't a version mismatch between the driver and
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * the framework. In the future, if multiple versions are
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * supported, this check could become more sophisticated.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mregp = kmem_zalloc(sizeof (mac_register_t), KM_SLEEP);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * mac_register() is how drivers register new MACs with the GLDv3
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * framework. The mregp argument is allocated by drivers using the
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * mac_alloc() function, and can be freed using mac_free() immediately upon
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * return from mac_register(). Upon success (0 return value), the mhp
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * opaque pointer becomes the driver's handle to its MAC interface, and is
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * the argument to all other mac module entry points.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* ARGSUSED */
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_register(mac_register_t *mregp, mac_handle_t *mhp)
ee94b1c37a34b758315666dcd0bc7c46d1aea15cSebastien Roy /* A successful call to mac_init_ops() sets the DN_GLDV3_DRIVER flag. */
ee94b1c37a34b758315666dcd0bc7c46d1aea15cSebastien Roy if (!GLDV3_DRV(ddi_driver_major(mregp->m_dip)))
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Find the required MAC-Type plugin. */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if ((mtype = mactype_getplugin(mregp->m_type_ident)) == NULL)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Create a mac_impl_t to represent this MAC. */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip = kmem_cache_alloc(i_mac_impl_cachep, KM_SLEEP);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * The mac is not ready for open yet.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * When a mac is registered, the m_instance field can be set to:
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * 0: Get the mac's instance number from m_dip.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * This is usually used for physical device dips.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * [1 .. MAC_MAX_MINOR-1]: Use the value as the mac's instance number.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * For example, when an aggregation is created with the key option,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * "key" will be used as the instance number.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * -1: Assign an instance number from [MAC_MAX_MINOR .. MAXMIN-1].
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * This is often used when a MAC of a virtual link is registered
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * (e.g., aggregation when "key" is not specified, or vnic).
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Note that the instance number is used to derive the mi_minor field
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * of mac_impl_t, which will then be used to derive the name of kstats
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * and the devfs nodes. The first 2 cases are needed to preserve
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * backward compatibility.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai /* Set the default IEEE Port VLAN Identifier */
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai /* Default bridge link learning protection values */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Construct the MAC name as <drvname><instance> */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng (void) snprintf(mip->mi_name, sizeof (mip->mi_name), "%s%d",
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip->mi_info.mi_nativemedia = mtype->mt_nativetype;
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark if (mregp->m_multicast_sdu < mregp->m_min_sdu ||
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark mip->mi_sdu_multicast = mregp->m_multicast_sdu;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip->mi_info.mi_addr_length = mip->mi_type->mt_addr_length;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If the media supports a broadcast address, cache a pointer to it
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * in the mac_info_t so that upper layers can use it.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip->mi_info.mi_brdcst_addr = mip->mi_type->mt_brdcst_addr;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Copy the unicast source address into the mac_info_t, but only if
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * the MAC-Type defines a non-zero address length. We need to
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * handle MAC-Types that have an address length of 0
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * (point-to-point protocol MACs for example).
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng kmem_alloc(mip->mi_type->mt_addr_length, KM_SLEEP);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng bcopy(mregp->m_src_addr, mip->mi_info.mi_unicst_addr,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Copy the fixed 'factory' MAC address from the immutable
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * info. This is taken to be the MAC address currently in
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * At this point, we should set up the classification
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * rules etc but we delay it till mac_open() so that
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * the resource discovery has taken place and we
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * know someone wants to use the device. Otherwise
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * memory gets allocated for Rx ring structures even
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * during probe.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Copy the destination address if one is provided. */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * The format of the m_pdata is specific to the plugin. It is
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * passed in as an argument to all of the plugin callbacks. The
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * driver can update this information by calling
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * mac_pdata_update().
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy if (mip->mi_type->mt_ops.mtops_ops & MTOPS_PDATA_VERIFY) {
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * Verify if the supplied plugin data is valid. Note that
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * even if the caller passed in a NULL pointer as plugin data,
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * we still need to verify if that's valid as the plugin may
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * require plugin data to function.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (!mip->mi_type->mt_ops.mtops_pdata_verify(mregp->m_pdata,
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * The caller supplied non-NULL plugin data, but the plugin
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy * does not recognize plugin data.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Register the private properties.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_register_priv_prop(mip, mregp->m_priv_props);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Stash the driver callbacks into the mac_impl_t, but first sanity
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * check to make sure all mandatory callbacks are set.
5d460eafffba936e81c4dd5ebe0f59b238f09121Cathy Zhou if (mac_capab_get((mac_handle_t)mip, MAC_CAPAB_LEGACY,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip->mi_phy_dev = makedevice(ddi_driver_major(mip->mi_dip),
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Allocate a notification thread. thread_create blocks for memory
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * if needed, it never fails.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mip->mi_notify_thread = thread_create(NULL, 0, i_mac_notify_thread,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Initialize the capabilities
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer bzero(&mip->mi_rx_rings_cap, sizeof (mac_capab_rings_t));
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer bzero(&mip->mi_tx_rings_cap, sizeof (mac_capab_rings_t));
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (i_mac_capab_get((mac_handle_t)mip, MAC_CAPAB_VNIC, NULL))
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (i_mac_capab_get((mac_handle_t)mip, MAC_CAPAB_AGGR, NULL))
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Enforce the virtrualization level registered.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (mac_init_rings(mip, MAC_RING_TYPE_RX) != 0 ||
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * The driver needs to register at least rx rings for this
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * virtualization level.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * The driver must set mc_unicst entry point to NULL when it advertises
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * CAP_RINGS for rx groups.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Initialize MAC addresses. Must be called after mac_init_rings().
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng (void) mac_capab_get((mac_handle_t)mip, MAC_CAPAB_SHARES,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Initialize the kstats for this device.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Zero out any properties. */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng bzero(&mip->mi_resource_props, sizeof (mac_resource_props_t));
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Create a style-2 DLPI device */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (ddi_create_minor_node(mip->mi_dip, driver, S_IFCHR, 0,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Create a style-1 DLPI device */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (ddi_create_minor_node(mip->mi_dip, mip->mi_name, S_IFCHR,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng (mod_hash_key_t)mip->mi_name, (mod_hash_val_t)mip) != 0) {
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng DTRACE_PROBE2(mac__register, struct devnames *, dnp,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Mark the MAC to be ready for open.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng cmn_err(CE_NOTE, "!%s registered", mip->mi_name);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng ddi_remove_minor_node(mip->mi_dip, mip->mi_name);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Clean up registered MAC addresses */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Clean up registered rings */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Clean up notification thread */
783f25cedcc2d0e6828b895b5f67e9dabca8cd39Michael Speer * Clear the state before destroying the mac_impl_t
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Unregister from the GLDv3 framework
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Fail the unregister if there are any open references to this mac. */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Clean up notification thread and wait for it to exit.
5d460eafffba936e81c4dd5ebe0f59b238f09121Cathy Zhou * There is still resource properties configured over this mac.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng ddi_remove_minor_node(mip->mi_dip, mip->mi_name);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng ASSERT(mip->mi_nactiveclients == 0 && !(mip->mi_state_flags &
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Free the list of margin request.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng for (mmr = mip->mi_mmrp; mmr != NULL; mmr = nextmmr) {
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai mip->mi_linkstate = mip->mi_lowlinkstate = LINK_STATE_UNKNOWN;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng kmem_free(mip->mi_info.mi_unicst_addr, mip->mi_type->mt_addr_length);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Free the primary MAC address.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * free all rings
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* and the flows */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng cmn_err(CE_NOTE, "!%s unregistered", mip->mi_name);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Reset the perim related fields to default values before
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * kmem_cache_free
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* DATA RECEPTION */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * This function is invoked for packets received by the MAC driver in
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * interrupt context. The ring generation number provided by the driver
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * is matched with the ring generation number held in MAC. If they do not
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * match, received packets are considered stale packets coming from an older
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * assignment of the ring. Drop them.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_rx_ring(mac_handle_t mh, mac_ring_handle_t mrh, mblk_t *mp_chain,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if ((mr != NULL) && (mr->mr_gen_num != mr_gen_num)) {
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng DTRACE_PROBE2(mac__rx__rings__stale__packet, uint64_t,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng mac_rx(mh, (mac_resource_handle_t)mrh, mp_chain);
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * This function is invoked for each packet received by the underlying driver.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_rx(mac_handle_t mh, mac_resource_handle_t mrh, mblk_t *mp_chain)
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Check if the link is part of a bridge. If not, then we don't need
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * to take the lock to remain consistent. Make this common case
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * lock-free and tail-call optimized.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Once we take a reference on the bridge link, the bridge
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * module itself can't unload, so the callback pointers are
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai mac_rx_common((mac_handle_t)mip, mrh, mp_chain);
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Special case function: this allows snooping of packets transmitted and
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * received by TRILL. By design, they go directly into the TRILL module.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavaimac_trill_snoop(mac_handle_t mh, mblk_t *mp)
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * This is the upward reentry point for packets arriving from the bridging
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * module and from mac_rx for links not part of a bridge.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavaimac_rx_common(mac_handle_t mh, mac_resource_handle_t mrh, mblk_t *mp_chain)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If there are any promiscuous mode callbacks defined for
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * this MAC, pass them a copy if appropriate.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If the SRS teardown has started, just return. The 'mr'
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * continues to be valid until the driver unregisters the mac.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Hardware classified packets will not make their way up
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * beyond this point once the teardown has started. The driver
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * is never passed a pointer to a flow entry or SRS or any
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * structure that can be freed much before mac_unregister.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * We check if an SRS is controlling this ring.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If so, we can directly call the srs_lower_proc
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * routine otherwise we need to go through mac_rx_classify
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * to reach the right place.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * This is supposed to be the fast path.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * All packets received though here were steered by
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * the hardware classifier, and share the same
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * MAC header info.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng (mac_resource_handle_t)mac_srs, mp_chain, B_FALSE);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* We'll fall through to software classification */
ae6aa22afeb444ae208c287e7227a4a7c877f17aVenugopal Iyer flent = mip->mi_single_active_client->mci_flent_list;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* DATA TRANSMISSION */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * A driver's notification to resume transmission, in case of a provider
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * without TX rings.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * A driver's notification to resume transmission on the specified TX ring.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_tx_ring_update(mac_handle_t mh, mac_ring_handle_t rh)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* LINK STATE */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Notify the MAC layer about a link state change
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_link_update(mac_handle_t mh, link_state_t link)
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Save the link state.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Send a MAC_NOTE_LOWLINK notification. This tells the notification
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * thread to deliver both lower and upper notifications.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Notify the MAC layer about a link state change due to bridging.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavaimac_link_redo(mac_handle_t mh, link_state_t link)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Save the link state.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Send a MAC_NOTE_LINK notification. Only upper notifications are
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore/* MINOR NODE HANDLING */
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * Given a dev_t, return the instance number (PPA) associated with it.
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * Drivers can use this in their getinfo(9e) implementation to lookup
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * the instance number (i.e. PPA) of the device, to use as an index to
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * their own array of soft state structures.
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * Returns -1 on error.
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * This function returns the first minor number that is available for
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * driver private use. All minor numbers smaller than this are
61af1958c03f88647637805ecf6bdb99b9eef36bGarrett D'Amore * reserved for GLDv3 use.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* OTHER CONTROL INFORMATION */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * A driver notified us that its primary MAC address has changed.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_unicst_update(mac_handle_t mh, const uint8_t *addr)
fd0939ef389f48c901faf4bf0b60b82d4bc58b64David Edmondson * If address changes, freshen the MAC address value and update
fd0939ef389f48c901faf4bf0b60b82d4bc58b64David Edmondson * all MAC clients that share this MAC address.
fd0939ef389f48c901faf4bf0b60b82d4bc58b64David Edmondson if (bcmp(addr, mip->mi_addr, mip->mi_type->mt_addr_length) != 0) {
fd0939ef389f48c901faf4bf0b60b82d4bc58b64David Edmondson mac_freshen_macaddr(mac_find_macaddr(mip, mip->mi_addr),
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Send a MAC_NOTE_UNICST notification.
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roymac_dst_update(mac_handle_t mh, const uint8_t *addr)
2b24ab6b3865caeede9eeb9db6b83e1d89dcd1eaSebastien Roy bcopy(addr, mip->mi_dstaddr, mip->mi_type->mt_addr_length);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * MAC plugin information changed.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_pdata_update(mac_handle_t mh, void *mac_pdata, size_t dsize)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Verify that the plugin supports MAC plugin data and that the
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * supplied data is valid.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (!(mip->mi_type->mt_ops.mtops_ops & MTOPS_PDATA_VERIFY))
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (!mip->mi_type->mt_ops.mtops_pdata_verify(mac_pdata, dsize))
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Since the MAC plugin data is used to construct MAC headers that
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * were cached in fast-path headers, we need to flush fast-path
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * information for links associated with this mac.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Invoked by driver as well as the framework to notify its capability change.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Send MAC_NOTE_CAPAB_CHG notification */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng i_mac_notify((mac_impl_t *)mh, MAC_NOTE_CAPAB_CHG);
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * Used by normal drivers to update the max sdu size.
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * We need to handle the case of a smaller mi_sdu_multicast
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * since this is called by mac_set_mtu() even for drivers that
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * have differing unicast and multicast mtu and we don't want to
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * increase the multicast mtu by accident in that case.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_maxsdu_update(mac_handle_t mh, uint_t sdu_max)
f0f2c3a5cf65a61de34af42edac38b2a7bda3416Girish Moodalbail if (sdu_max == 0 || sdu_max < mip->mi_sdu_min)
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark /* Send a MAC_NOTE_SDU_SIZE notification. */
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * Version of the above function that is used by drivers that have a different
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark * max sdu size for multicast/broadcast vs. unicast.
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmarkmac_maxsdu_update2(mac_handle_t mh, uint_t sdu_max, uint_t sdu_multicast)
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark if (sdu_max == 0 || sdu_max < mip->mi_sdu_min)
1eee170a5f6cf875d905524fea524c7c5c870aa0Erik Nordmark if (sdu_multicast > sdu_max || sdu_multicast < mip->mi_sdu_min)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Send a MAC_NOTE_SDU_SIZE notification. */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_ring_intr_retarget(mac_group_t *group, mac_ring_t *ring)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer if (((mcip = MAC_GROUP_ONLY_CLIENT(group)) != NULL) &&
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* interrupt can be re-targeted */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ASSERT(group->mrg_state == MAC_GROUP_STATE_RESERVED);
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * Clients like aggr create pseudo rings (mac_ring_t) and expose them to
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * their clients. There is a 1-1 mapping pseudo ring and the hardware
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * ring. ddi interrupt handles are exported from the hardware ring to
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * the pseudo ring. Thus when the interrupt handle changes, clients of
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * aggr that are using the handle need to use the new handle and
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * re-target their interrupts.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_pseudo_ring_intr_retarget(mac_impl_t *mip, mac_ring_t *ring,
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer (void) strlcpy(macname, pmip->mi_name, MAXNAMELEN);
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * We need to enter aggr's perimeter. The locking hierarchy
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * dictates that aggr's perimeter should be entered first
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * and then the port's perimeter. So drop the port's
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * perimeter, enter aggr's and then re-enter port's
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * While we know pmip is the aggr's mip, there is a
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * possibility that aggr could have unregistered by
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * the time we exit port's perimeter (mip) and
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * enter aggr's perimeter (pmip). To avoid that
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * scenario, enter aggr's perimeter using its name.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer if (mac_perim_enter_by_macname(macname, &p_mph) != 0)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * Check if the ring got assigned to another aggregation before
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * be could enter aggr's and the port's perimeter. When a ring
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * gets deleted from an aggregation, it calls mac_stop_ring()
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * which increments the generation number. So checking
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * generation number will be enough.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer if (ring->mr_gen_num != saved_gen_num && ring->mr_prh != NULL) {
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* Check if pseudo ring is still present */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * API called by driver to provide new interrupt handle for TX/RX rings.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * This usually happens when IRM (Interrupt Resource Manangement)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * framework either gives the driver more MSI-x interrupts or takes
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * away MSI-x interrupts from the driver.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_ring_intr_set(mac_ring_handle_t mrh, ddi_intr_handle_t ddh)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_group_t *group = (mac_group_t *)ring->mr_gh;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_impl_t *mip = (mac_impl_t *)group->mrg_mh;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* Interrupts being reset */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ring->mr_info.mri_intr.mi_ddi_shared = B_FALSE;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_pseudo_ring_intr_retarget(mip, ring, ddh);
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* New interrupt handle */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_pseudo_ring_intr_retarget(mip, ring, ddh);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng/* PRIVATE FUNCTIONS, FOR INTERNAL USE ONLY */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Updates the mac_impl structure with the current state of the link
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * If no change, then it is not interesting.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai if (mip->mi_lastlowlinkstate == mip->mi_lowlinkstate)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng if (mip->mi_type->mt_ops.mtops_ops & MTOPS_LINK_DETAILS) {
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng cmn_err(CE_NOTE, "!%s link up, %s", mip->mi_name, det);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Only transitions from UP to DOWN are interesting
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai if (mip->mi_lastlowlinkstate != LINK_STATE_UNKNOWN)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * This case is normally not interesting.
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai mip->mi_lastlowlinkstate = mip->mi_lowlinkstate;
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Main routine for the callbacks notifications thread
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng CALLB_CPR_INIT(&cprinfo, mcbi->mcbi_lockp, callb_generic_cpr,
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng "i_mac_notify_thread");
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* request to quit */
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * Log link changes on the actual link, but then do reports on
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai * synthetic state (if part of a bridge).
4eaa471005973e11a6110b69fe990530b3b95a38Rishi Srivatsavai if ((bits & (1 << MAC_NOTE_LOWLINK)) != 0) {
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Do notification callbacks for each notification type.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Walk the list of notifications.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng MAC_CALLBACK_WALKER_INC(&mip->mi_notify_cb_info);
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* CALLB_CPR_EXIT drops the lock */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Signal the i_mac_notify_thread asking it to quit.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Then wait till it is done.
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng /* Necessary clean up before doing kmem_cache_free */
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Entry point invoked by drivers to dynamically add a ring to an
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * existing group.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_group_add_ring(mac_group_handle_t gh, int index)
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * Entry point invoked by drivers to dynamically remove a ring
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * from an existing group. The specified ring handle must no longer
da14cebe459d3275048785f25bd869cb09b5307fEric Cheng * be used by the driver after a call to this function.
da14cebe459d3275048785f25bd869cb09b5307fEric Chengmac_group_rem_ring(mac_group_handle_t gh, mac_ring_handle_t rh)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer i_mac_group_rem_ring(group, (mac_ring_t *)rh, B_TRUE);
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * mac_prop_info_*() callbacks called from the driver's prefix_propinfo()
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer * entry points.
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_default_uint8(mac_prop_info_handle_t ph, uint8_t val)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the default value */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ASSERT(pr->pr_default_size >= sizeof (uint8_t));
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_default_uint64(mac_prop_info_handle_t ph, uint64_t val)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the default value */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ASSERT(pr->pr_default_size >= sizeof (uint64_t));
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_default_uint32(mac_prop_info_handle_t ph, uint32_t val)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the default value */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ASSERT(pr->pr_default_size >= sizeof (uint32_t));
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_default_str(mac_prop_info_handle_t ph, const char *str)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the default value */
f689bed18bbb72c93b14a451e959b18f7ccfb7d1Rishi Srivatsavai (void) strlcpy(pr->pr_default, str, pr->pr_default_size);
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_default_link_flowctrl(mac_prop_info_handle_t ph,
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the default value */
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer ASSERT(pr->pr_default_size >= sizeof (link_flowctrl_t));
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_range_uint32(mac_prop_info_handle_t ph, uint32_t min,
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer /* nothing to do if the caller doesn't want the range info */
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan /* first range */
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan /* all ranges of a property should be of the same type */
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan ASSERT(range->mpr_type == MAC_PROPVAL_UINT32);
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan if (pr->pr_range_cur_count > range->mpr_count) {
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan range32[pr->pr_range_cur_count - 1].mpur_min = min;
0591ddd0694c4d7ab3ad339419da215a732587f8Prakash Jalan range32[pr->pr_range_cur_count - 1].mpur_max = max;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyermac_prop_info_set_perm(mac_prop_info_handle_t ph, uint8_t perm)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer mac_prop_info_state_t *pr = (mac_prop_info_state_t *)ph;
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyervoid mac_hcksum_get(mblk_t *mp, uint32_t *start, uint32_t *stuff,
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer uint32_t *end, uint32_t *value, uint32_t *flags_ptr)
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer if ((flags & (HCK_PARTIALCKSUM | HCK_FULLCKSUM)) != 0) {
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyervoid mac_hcksum_set(mblk_t *mp, uint32_t start, uint32_t stuff,
0dc2366f7b9f9f36e10909b1e95edbf2a261c2acVenugopal Iyer uint32_t end, uint32_t value, uint32_t flags)