/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License (the "License"). * You may not use this file except in compliance with the License. * * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE * or http://www.opensolaris.org/os/licensing. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at usr/src/OPENSOLARIS.LICENSE. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END */ /* * Copyright 2008 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #ifndef _SYS_MAC_CLIENT_IMPL_H #define _SYS_MAC_CLIENT_IMPL_H #include #include #include #include #include #include #include #ifdef __cplusplus extern "C" { #endif extern kmem_cache_t *mac_client_impl_cache; extern kmem_cache_t *mac_unicast_impl_cache; extern kmem_cache_t *mac_promisc_impl_cache; /* * Need a list to chain all VIDs assigned to a client. Normally, one * MAC client only has one VID. But vsw might need multiple VIDs. */ typedef struct mac_unicast_impl_s { /* Protected by */ struct mac_unicast_impl_s *mui_next; /* SL */ mac_address_t *mui_map; /* SL */ uint16_t mui_vid; /* SL */ } mac_unicast_impl_t; #define MAC_CLIENT_FLAGS_PRIMARY 0X0001 #define MAC_CLIENT_FLAGS_VNIC_PRIMARY 0x0002 /* * One of these is instantiated per MAC client promiscuous callback. * * Each element of this structure belongs to two linked list. One * for the mac_client_impl_t (mci_promisc_list) which created allocated * the callback, the other for the mac_impl_t (mi_promisc_list) corresponding * to the MAC client. * The former allows us to do bookkeeping, the latter allows us * to more efficiently dispatch packets to the promiscuous callbacks. */ typedef struct mac_promisc_impl_s { /* Protected by */ mac_cb_t mpi_mci_link; /* mi_promisc_lock */ mac_cb_t mpi_mi_link; /* mi_promisc_lock */ mac_client_promisc_type_t mpi_type; /* WO */ mac_rx_t mpi_fn; /* WO */ void *mpi_arg; /* WO */ struct mac_client_impl_s *mpi_mcip; /* WO */ boolean_t mpi_no_tx_loop; /* WO */ boolean_t mpi_no_phys; /* WO */ } mac_promisc_impl_t; typedef union mac_tx_percpu_s { struct { kmutex_t _pcpu_tx_lock; uint_t _pcpu_tx_refcnt; } pcpu_lr; uchar_t pcpu_pad[64]; } mac_tx_percpu_t; #define pcpu_tx_lock pcpu_lr._pcpu_tx_lock #define pcpu_tx_refcnt pcpu_lr._pcpu_tx_refcnt /* * One of these is instanciated for each MAC client. */ struct mac_client_impl_s { /* Protected by */ struct mac_client_impl_s *mci_client_next; /* mi_rw_lock */ char mci_name[MAXNAMELEN]; /* mi_rw_lock */ /* * This flow entry will contain all the internal constructs * such as SRS etc. for this MAC client. The MAC client may * have more than one flow corresponding to each upper client * sharing this mac_client_impl_t. */ flow_entry_t *mci_flent; /* mi_rw_lock */ struct mac_impl_s *mci_mip; /* WO */ /* * If this is a client that has a pass thru MAC (e.g. a VNIC), * then we also keep the handle for the client's upper MAC. */ struct mac_impl_s *mci_upper_mip; /* WO */ uint32_t mci_state_flags; /* WO */ mac_rx_t mci_rx_fn; /* Rx Quiescence */ void *mci_rx_arg; /* Rx Quiescence */ mac_direct_rx_t mci_direct_rx_fn; /* SL */ void *mci_direct_rx_arg; /* SL */ mac_cb_t *mci_promisc_list; /* mi_promisc_lock */ mac_address_t *mci_unicast; uint32_t mci_flags; /* SL */ krwlock_t mci_rw_lock; mac_unicast_impl_t *mci_unicast_list; /* mci_rw_lock */ /* * The mac_client_impl_t may be shared by multiple clients, i.e * multiple VLANs sharing the same MAC client. In this case the * address/vid tubles differ and are each associated with their * own flow entry, but the rest underlying components SRS, etc, * are common. */ flow_entry_t *mci_flent_list; /* mci_rw_lock */ uint_t mci_nflents; /* mci_rw_lock */ uint_t mci_nvids; /* mci_rw_lock */ /* Resource Management Functions */ mac_resource_add_t mci_resource_add; /* SL */ mac_resource_remove_t mci_resource_remove; /* SL */ mac_resource_quiesce_t mci_resource_quiesce; /* SL */ mac_resource_restart_t mci_resource_restart; /* SL */ mac_resource_bind_t mci_resource_bind; /* SL */ void *mci_resource_arg; /* SL */ /* Tx notify callback */ kmutex_t mci_tx_cb_lock; mac_cb_info_t mci_tx_notify_cb_info; /* cb list info */ mac_cb_t *mci_tx_notify_cb_list; /* The cb list */ uintptr_t mci_tx_notify_id; /* per MAC client stats */ /* None */ uint64_t mci_stat_multircv; uint64_t mci_stat_brdcstrcv; uint64_t mci_stat_multixmt; uint64_t mci_stat_brdcstxmt; uint64_t mci_stat_obytes; uint64_t mci_stat_opackets; uint64_t mci_stat_oerrors; uint64_t mci_stat_ibytes; uint64_t mci_stat_ipackets; uint64_t mci_stat_ierrors; flow_tab_t *mci_subflow_tab; /* Rx quiescence */ /* * Priority range for this MAC client. This the range * corresponding to the priority configured (nr_flow_priority). */ pri_t mci_min_pri; pri_t mci_max_pri; /* * Hybrid I/O related definitions. */ mac_share_handle_t mci_share; boolean_t mci_share_bound; boolean_t mci_no_hwrings; /* The client requests a hardware group */ boolean_t mci_req_hwrings; /* for multicast support */ struct mac_mcast_addrs_s *mci_mcast_addrs; /* mi_rw_lock */ /* * Protected by mci_tx_pcpu[0].pcpu_tx_lock */ uint_t mci_tx_flag; kcondvar_t mci_tx_cv; /* Must be last in the structure for dynamic sizing */ mac_tx_percpu_t mci_tx_pcpu[1]; /* SL */ }; #define MAC_CLIENT_IMPL_SIZE \ (sizeof (mac_client_impl_t) + \ (mac_tx_percpu_cnt * sizeof (mac_tx_percpu_t))) extern int mac_tx_percpu_cnt; #define MCIP_TX_SRS(mcip) \ ((mcip)->mci_flent == NULL ? NULL : (mcip)->mci_flent->fe_tx_srs) /* Defensive coding, non-null mcip_flent could be an assert */ #define MCIP_DATAPATH_SETUP(mcip) \ ((mcip)->mci_flent == NULL ? B_FALSE : \ !((mcip)->mci_flent->fe_flags & FE_MC_NO_DATAPATH)) #define MCIP_RESOURCE_PROPS(mcip) \ ((mcip)->mci_flent == NULL ? NULL : \ &(mcip)->mci_flent->fe_resource_props) #define MCIP_EFFECTIVE_PROPS(mcip) \ (mcip->mci_flent == NULL ? NULL : \ &(mcip)->mci_flent->fe_effective_props) #define MCIP_RESOURCE_PROPS_MASK(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ (mcip)->mci_flent->fe_resource_props.mrp_mask) #define MCIP_RESOURCE_PROPS_MAXBW(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ (mcip)->mci_flent->fe_resource_props.mrp_maxbw) #define MCIP_RESOURCE_PROPS_PRIORITY(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ (mcip)->mci_flent->fe_resource_props.mrp_priority) #define MCIP_RESOURCE_PROPS_CPUS(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ &(mcip)->mci_flent->fe_resource_props.mrp_cpus) #define MCIP_RESOURCE_PROPS_NCPUS(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ (mcip)->mci_flent->fe_resource_props.mrp_ncpus) #define MCIP_RESOURCE_PROPS_CPU(mcip) \ ((mcip)->mci_flent == NULL ? 0 : \ (mcip)->mci_flent->fe_resource_props.mrp_ncpu) /* * We validate the VLAN id of the packet w.r.t the client's vid, * if required (i.e. !MCIS_DISABLE_TX_VID_CHECK). DLS clients * will have MCIS_DISABLE_TX_VID_CHECK set. * (In the case of aggr when we get back packets, due to * the underlying driver being flow controlled, we won't * drop the packet even if it is VLAN tagged as we * don't set MCIS_DISABLE_TX_VID_CHECK for an aggr.) */ #define MAC_VID_CHECK_NEEDED(mcip) \ (((mcip)->mci_state_flags & MCIS_DISABLE_TX_VID_CHECK) == 0 && \ (mcip)->mci_mip->mi_info.mi_nativemedia == DL_ETHER) #define MAC_VID_CHECK(mcip, mp, err) { \ if (ntohs(((struct ether_header *)(mp)->b_rptr)->ether_type) == \ ETHERTYPE_VLAN) { \ /* \ * err is set to EINVAL (so the caller can take the \ * appropriate action. e.g. freemsg()) for two cases: \ * -client is not responsible for filling in the vid. \ * -client is responsible for filling in the vid, but \ * the vid doesn't match the vid of the MAC client. \ */ \ (err) = EINVAL; \ if (((mcip)->mci_state_flags & MCIS_TAG_DISABLE) != 0) {\ struct ether_vlan_header *evhp; \ uint16_t vlanid; \ \ evhp = (struct ether_vlan_header *)(mp)->b_rptr;\ vlanid = VLAN_ID(ntohs(evhp->ether_tci)); \ if (mac_client_check_flow_vid((mcip), vlanid)) \ (err) = 0; \ } \ } \ } #define MAC_TAG_NEEDED(mcip) \ (((mcip)->mci_state_flags & MCIS_TAG_DISABLE) == 0 && \ (mcip)->mci_nvids == 1) \ /* MCI state flags */ #define MCIS_IS_VNIC 0x0001 #define MCIS_EXCLUSIVE 0x0002 #define MCIS_TAG_DISABLE 0x0004 #define MCIS_STRIP_DISABLE 0x0008 #define MCIS_IS_AGGR_PORT 0x0010 #define MCIS_CLIENT_POLL_CAPABLE 0x0020 #define MCIS_DESC_LOGGED 0x0040 #define MCIS_SHARE_BOUND 0x0080 #define MCIS_NO_HWRINGS 0x0100 #define MCIS_DISABLE_TX_VID_CHECK 0x0200 #define MCIS_USE_DATALINK_NAME 0x0400 /* in mac_client.c */ extern void mac_promisc_client_dispatch(mac_client_impl_t *, mblk_t *); extern void mac_client_init(void); extern void mac_client_fini(void); extern void mac_promisc_dispatch(mac_impl_t *, mblk_t *, mac_client_impl_t *); extern int mac_validate_props(mac_resource_props_t *); extern mac_client_impl_t *mac_vnic_lower(mac_impl_t *); extern mac_client_impl_t *mac_primary_client_handle(mac_impl_t *); extern uint16_t i_mac_flow_vid(flow_entry_t *); extern boolean_t i_mac_capab_get(mac_handle_t, mac_capab_t, void *); extern void mac_unicast_update_clients(mac_impl_t *, mac_address_t *); extern void mac_update_resources(mac_resource_props_t *, mac_resource_props_t *, boolean_t); boolean_t mac_client_check_flow_vid(mac_client_impl_t *, uint16_t); extern boolean_t mac_is_primary_client(mac_client_impl_t *); #ifdef __cplusplus } #endif #endif /* _SYS_MAC_CLIENT_IMPL_H */