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 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 /* 27 * gld - Generic LAN Driver support system for DLPI drivers. 28 */ 29 30 #ifndef _SYS_GLD_H 31 #define _SYS_GLD_H 32 33 #pragma ident "%Z%%M% %I% %E% SMI" 34 35 #include <sys/ethernet.h> 36 37 #ifdef __cplusplus 38 extern "C" { 39 #endif 40 41 /* 42 * Media specific MIB-II counters/statistics 43 * 44 * This only includes those that aren't in the legacy counters. 45 */ 46 47 typedef union media_stats { 48 struct dot3stat { 49 /* Ethernet: RFC1643 Dot3Stats (subset) */ 50 uint32_t first_coll; /* SingleCollisionFrames */ 51 uint32_t multi_coll; /* MultipleCollisionFrames */ 52 uint32_t sqe_error; /* SQETestErrors */ 53 uint32_t mac_xmt_error; /* InternalMacTransmitErrors */ 54 uint32_t frame_too_long; /* FrameTooLongs */ 55 uint32_t mac_rcv_error; /* InternalMacReceiveErrors */ 56 } dot3; 57 struct dot5stat { 58 /* Token Ring: RFC1748 Dot5Stats (subset) */ 59 uint32_t ace_error; 60 uint32_t internal_error; 61 uint32_t lost_frame_error; 62 uint32_t frame_copied_error; 63 uint32_t token_error; 64 uint32_t freq_error; 65 } dot5; 66 struct fddistat { 67 /* FDDI: RFC1512 (subset) */ 68 uint32_t mac_error; 69 uint32_t mac_lost; 70 uint32_t mac_token; 71 uint32_t mac_tvx_expired; 72 uint32_t mac_late; 73 uint32_t mac_ring_op; 74 } fddi; 75 uint32_t pad[16]; 76 } media_stats_t; 77 78 #define glds_dot3_first_coll glds_media_specific.dot3.first_coll 79 #define glds_dot3_multi_coll glds_media_specific.dot3.multi_coll 80 #define glds_dot3_sqe_error glds_media_specific.dot3.sqe_error 81 #define glds_dot3_mac_xmt_error glds_media_specific.dot3.mac_xmt_error 82 #define glds_dot3_mac_rcv_error glds_media_specific.dot3.mac_rcv_error 83 #define glds_dot3_frame_too_long glds_media_specific.dot3.frame_too_long 84 85 #define glds_dot5_line_error glds_crc 86 #define glds_dot5_burst_error glds_frame 87 #define glds_dot5_ace_error glds_media_specific.dot5.ace_error 88 #define glds_dot5_internal_error glds_media_specific.dot5.internal_error 89 #define glds_dot5_lost_frame_error glds_media_specific.dot5.lost_frame_error 90 #define glds_dot5_frame_copied_error glds_media_specific.dot5.frame_copied_error 91 #define glds_dot5_token_error glds_media_specific.dot5.token_error 92 #define glds_dot5_signal_loss glds_nocarrier 93 #define glds_dot5_freq_error glds_media_specific.dot5.freq_error 94 95 #define glds_fddi_mac_error glds_media_specific.fddi.mac_error 96 #define glds_fddi_mac_lost glds_media_specific.fddi.mac_lost 97 #define glds_fddi_mac_token glds_media_specific.fddi.mac_token 98 #define glds_fddi_mac_tvx_expired glds_media_specific.fddi.mac_tvx_expired 99 #define glds_fddi_mac_late glds_media_specific.fddi.mac_late 100 #define glds_fddi_mac_ring_op glds_media_specific.fddi.mac_ring_op 101 102 /* 103 * structure for driver statistics 104 */ 105 struct gld_stats { 106 ulong_t glds_multixmt; /* (G) ifOutMulticastPkts */ 107 ulong_t glds_multircv; /* (G) ifInMulticastPkts */ 108 ulong_t glds_brdcstxmt; /* (G) ifOutBroadcastPkts */ 109 ulong_t glds_brdcstrcv; /* (G) ifInBroadcastPkts */ 110 uint32_t glds_blocked; /* (G) discard: upstream flow cntrl */ 111 uint32_t glds_reserved1; 112 uint32_t glds_reserved2; 113 uint32_t glds_reserved3; 114 uint32_t glds_reserved4; 115 uint32_t glds_errxmt; /* (D) ifOutErrors */ 116 uint32_t glds_errrcv; /* (D) ifInErrors */ 117 uint32_t glds_collisions; /* (e) Sun MIB's rsIfCollisions */ 118 uint32_t glds_excoll; /* (e) dot3StatsExcessiveCollisions */ 119 uint32_t glds_defer; /* (e) dot3StatsDeferredTransmissions */ 120 uint32_t glds_frame; /* (e) dot3StatsAlignErrors */ 121 uint32_t glds_crc; /* (e) dot3StatsFCSErrors */ 122 uint32_t glds_overflow; /* (D) */ 123 uint32_t glds_underflow; /* (D) */ 124 uint32_t glds_short; /* (e) */ 125 uint32_t glds_missed; /* (D) */ 126 uint32_t glds_xmtlatecoll; /* (e) dot3StatsLateCollisions */ 127 uint32_t glds_nocarrier; /* (e) dot3StatsCarrierSenseErrors */ 128 uint32_t glds_noxmtbuf; /* (G) ifOutDiscards */ 129 uint32_t glds_norcvbuf; /* (D) ifInDiscards */ 130 uint32_t glds_intr; /* (D) */ 131 uint32_t glds_xmtretry; /* (G) */ 132 uint64_t glds_pktxmt64; /* (G) 64-bit rsIfOutPackets */ 133 uint64_t glds_pktrcv64; /* (G) 64-bit rsIfInPackets */ 134 uint64_t glds_bytexmt64; /* (G) ifHCOutOctets */ 135 uint64_t glds_bytercv64; /* (G) ifHCInOctets */ 136 uint64_t glds_speed; /* (D) ifSpeed */ 137 uint32_t glds_duplex; /* (e) Invented for GLD */ 138 uint32_t glds_media; /* (D) Invented for GLD */ 139 uint32_t glds_unknowns; /* (G) ifInUnknownProtos */ 140 uint32_t reserved[19]; 141 media_stats_t glds_media_specific; 142 uint32_t glds_xmtbadinterp; /* (G) bad packet len/format */ 143 uint32_t glds_rcvbadinterp; /* (G) bad packet len/format */ 144 uint32_t glds_gldnorcvbuf; /* (G) norcvbuf from inside GLD */ 145 }; 146 147 /* 148 * gld_mac_info structure. Used to define the per-board data for all 149 * drivers. 150 * 151 * The below definition of gld_mac_info contains GLD PRIVATE entries that must 152 * not be used by the device driver. Only entries marked SET BY DRIVER should 153 * be modified. 154 */ 155 156 #define GLD_STATS_SIZE_ORIG (sizeof (uint32_t) * 26) /* don't change */ 157 #define GLD_KSTAT_SIZE_ORIG (sizeof (kstat_named_t) * 26) /* don't change */ 158 #define GLD_PAD ((int)GLD_KSTAT_SIZE_ORIG + (int)GLD_STATS_SIZE_ORIG) 159 160 typedef union gld_lock { 161 kmutex_t reserved; 162 krwlock_t gldl_rw_lock; 163 } gld_lock_t; 164 165 typedef struct gld_mac_info { 166 struct gld_mac_info *gldm_next; /* GLD PRIVATE */ 167 struct gld_mac_info *gldm_prev; /* GLD PRIVATE */ 168 caddr_t reserved1; /* GLD PRIVATE */ 169 caddr_t reserved2; /* GLD PRIVATE */ 170 uint16_t gldm_driver_version; /* GLD PRIVATE */ 171 uint16_t gldm_GLD_version; /* GLD PRIVATE */ 172 uint16_t gldm_GLD_flags; /* GLD PRIVATE */ 173 uint16_t gldm_options; /* GLD_PRIVATE */ 174 dev_info_t *gldm_devinfo; /* SET BY DRIVER */ 175 uchar_t *gldm_vendor_addr; /* SET BY DRIVER */ 176 uchar_t *gldm_broadcast_addr; /* SET BY DRIVER */ 177 gld_lock_t gldm_lock; /* GLD PRIVATE */ 178 ddi_iblock_cookie_t gldm_cookie; /* SET BY DRIVER */ 179 uint32_t gldm_margin; /* SET BY DRIVER */ 180 uint32_t reserved4; /* GLD PRIVATE */ 181 uint32_t gldm_maxpkt; /* SET BY DRIVER */ 182 uint32_t gldm_minpkt; /* SET BY DRIVER */ 183 char *gldm_ident; /* SET BY DRIVER */ 184 uint32_t gldm_type; /* SET BY DRIVER */ 185 uint32_t reserved5; /* GLD PRIVATE */ 186 uint32_t gldm_addrlen; /* SET BY DRIVER */ 187 int32_t gldm_saplen; /* SET BY DRIVER */ 188 /* NOTE: MUST BE -2 */ 189 unsigned char reserved7[ETHERADDRL]; /* GLD PRIVATE */ 190 unsigned char reserved8[ETHERADDRL]; /* GLD PRIVATE */ 191 unsigned char reserved9[ETHERADDRL]; /* GLD PRIVATE */ 192 t_uscalar_t gldm_ppa; /* SET BY DRIVER */ 193 int32_t reserved10; /* GLD PRIVATE */ 194 uint32_t gldm_capabilities; /* SET BY DRIVER */ 195 int32_t gldm_linkstate; /* GLD PRIVATE */ 196 uint32_t reserved11; /* GLD PRIVATE */ 197 caddr_t reserved12; /* GLD PRIVATE */ 198 int32_t reserved13; /* GLD PRIVATE */ 199 uint32_t reserved14; /* GLD PRIVATE */ 200 int32_t reserved15; /* GLD PRIVATE */ 201 caddr_t gldm_mac_pvt; /* GLD PRIVATE */ 202 caddr_t reserved16; /* GLD PRIVATE */ 203 char reserved17[GLD_PAD]; /* GLD PRIVATE */ 204 caddr_t reserved18; /* GLD PRIVATE */ 205 caddr_t gldm_private; /* GLD PRIVATE */ 206 int (*gldm_reset)(); /* SET BY DRIVER */ 207 int (*gldm_start)(); /* SET BY DRIVER */ 208 int (*gldm_stop)(); /* SET BY DRIVER */ 209 int (*gldm_set_mac_addr)(); /* SET BY DRIVER */ 210 int (*gldm_send)(); /* SET BY DRIVER */ 211 int (*gldm_set_promiscuous)(); /* SET BY DRIVER */ 212 int (*gldm_get_stats)(); /* SET BY DRIVER */ 213 int (*gldm_ioctl)(); /* SET BY DRIVER */ 214 int (*gldm_set_multicast)(); /* SET BY DRIVER */ 215 uint_t (*gldm_intr)(); /* SET BY DRIVER */ 216 int (*gldm_mctl)(); /* SET BY DRIVER */ 217 int (*gldm_send_tagged)(); /* SET BY DRIVER */ 218 /* 219 * The following MDT related entry points are Sun private, 220 * meant only for use by Sun's IPoIB (ibd) driver. 221 */ 222 int (*gldm_mdt_pre)(); /* SET BY DRIVER */ 223 void (*gldm_mdt_send)(); /* SET BY DRIVER */ 224 void (*gldm_mdt_post)(); /* SET BY DRIVER */ 225 int gldm_mdt_sgl; /* SET BY DRIVER */ 226 int gldm_mdt_segs; /* SET BY DRIVER */ 227 } gld_mac_info_t; 228 229 /* flags for physical promiscuous state */ 230 #define GLD_MAC_PROMISC_NOOP -1 /* leave mode unchanged */ 231 #define GLD_MAC_PROMISC_NONE 0 /* promiscuous mode(s) OFF */ 232 #define GLD_MAC_PROMISC_PHYS 1 /* receive all packets */ 233 #define GLD_MAC_PROMISC_MULTI 2 /* receive all multicast packets */ 234 235 #define GLD_MULTI_ENABLE 1 236 #define GLD_MULTI_DISABLE 0 237 238 /* flags for gldm_capabilities */ 239 #define GLD_CAP_LINKSTATE 0x00000001 /* will call gld_linkstate() */ 240 #define GLD_CAP_CKSUM_IPHDR 0x00000008 /* IP checksum offload */ 241 #define GLD_CAP_CKSUM_PARTIAL 0x00000010 /* TCP/UDP partial */ 242 #define GLD_CAP_CKSUM_FULL_V4 0x00000020 /* TCP/UDP full for IPv4 */ 243 #define GLD_CAP_ZEROCOPY 0x00000040 /* zerocopy */ 244 #define GLD_CAP_CKSUM_FULL_V6 0x00000080 /* TCP/UDP full for IPv6 */ 245 #define GLD_CAP_CKSUM_ANY \ 246 (GLD_CAP_CKSUM_IPHDR|GLD_CAP_CKSUM_PARTIAL| \ 247 GLD_CAP_CKSUM_FULL_V4|GLD_CAP_CKSUM_FULL_V6) 248 249 /* values of gldm_linkstate, as passed to gld_linkstate() */ 250 #define GLD_LINKSTATE_DOWN -1 251 #define GLD_LINKSTATE_UNKNOWN 0 252 #define GLD_LINKSTATE_UP 1 253 254 /* 255 * media type: this identifies the media/connector currently used by the 256 * driver. Possible types will be defined for each DLPI type defined in 257 * gldm_type. The below definitions should be used by the device dependent 258 * drivers to set glds_media. 259 */ 260 261 /* if driver cannot determine media/connector type */ 262 #define GLDM_UNKNOWN 0 263 264 #define GLDM_AUI 1 265 #define GLDM_BNC 2 266 #define GLDM_TP 3 267 #define GLDM_FIBER 4 268 #define GLDM_100BT 5 269 #define GLDM_VGANYLAN 6 270 #define GLDM_10BT 7 271 #define GLDM_RING4 8 272 #define GLDM_RING16 9 273 #define GLDM_PHYMII 10 274 #define GLDM_100BTX 11 275 #define GLDM_100BT4 12 276 #define GLDM_IB 14 277 278 /* defines for possible duplex states (glds_duplex) */ 279 #define GLD_DUPLEX_UNKNOWN 0 280 #define GLD_DUPLEX_HALF 1 281 #define GLD_DUPLEX_FULL 2 282 283 /* Values returned from driver entry points */ 284 #define GLD_SUCCESS 0 285 #define GLD_NORESOURCES 1 286 #define GLD_NOTSUPPORTED 2 287 #define GLD_BADARG 3 288 #define GLD_NOLINK 4 289 #define GLD_RETRY 5 290 #define GLD_FAILURE (-1) 291 292 #if defined(_KERNEL) 293 /* Functions exported to drivers */ 294 extern gld_mac_info_t *gld_mac_alloc(dev_info_t *); 295 extern void gld_mac_free(gld_mac_info_t *); 296 extern int gld_register(dev_info_t *, char *, gld_mac_info_t *); 297 extern int gld_unregister(gld_mac_info_t *); 298 extern void gld_recv(gld_mac_info_t *, mblk_t *); 299 extern void gld_recv_tagged(gld_mac_info_t *, mblk_t *, uint32_t); 300 extern void gld_linkstate(gld_mac_info_t *, int32_t); 301 extern void gld_sched(gld_mac_info_t *); 302 extern uint_t gld_intr(); 303 304 extern int gld_getinfo(dev_info_t *, ddi_info_cmd_t, void *, void **); 305 extern int gld_open(queue_t *, dev_t *, int, int, cred_t *); 306 extern int gld_close(queue_t *, int, cred_t *); 307 extern int gld_wput(queue_t *, mblk_t *); 308 extern int gld_wsrv(queue_t *); 309 extern int gld_rsrv(queue_t *); 310 #endif 311 312 /* 313 * VLAN tag macros 314 * 315 * Per IEEE802.1Q, a VLAN tag is made up of a 2-byte Tagged Protocol 316 * Identifier (TPID) and two bytes of Tag/Control information (TCI). 317 * All fields should be treated as unsigned, and so a VTAG is held as 318 * a 'uint32_t' 319 */ 320 #define VTAG_SIZE 4 /* bytes (octets) */ 321 322 #define VLAN_TPID_MASK 0xffff0000u 323 #define VLAN_TPID_SHIFT 16 324 #define VLAN_TCI_MASK 0x0000ffffu 325 #define VLAN_TCI_SHIFT 0 326 327 #define VLAN_PRI_MASK 0x0000e000u 328 #define VLAN_PRI_SHIFT 13 329 #define VLAN_CFI_MASK 0x00001000u 330 #define VLAN_CFI_SHIFT 12 331 #define VLAN_VID_MASK 0x00000fffu 332 #define VLAN_VID_SHIFT 0 333 334 #define VLAN_TPID 0x8100u /* Per IEEE 802.1Q standard */ 335 #define VLAN_CFI_ETHER 0 /* CFI on Ethernet must be 0 */ 336 #define VLAN_PRI_DFLT 0 337 #define VLAN_PRI_MAX 7 338 #define VLAN_VID_NONE 0 /* Not a valid VID */ 339 #define VLAN_VID_MIN 1 340 #define VLAN_VID_MAX 4094 /* IEEE std; 4095 is reserved */ 341 342 #define VLAN_VTAG_NONE 0 /* Special case: "untagged" */ 343 344 /* 345 * Macros to construct a TCI or VTAG. The user must ensure values are in 346 * range. Note that in the special case of priority tag, VLAN_VID_NONE 347 * is also a valid argument to these constructor macros. 348 */ 349 #define GLD_MAKE_TCI(pri, cfi, vid) (((pri) << VLAN_PRI_SHIFT) | \ 350 ((cfi) << VLAN_CFI_SHIFT) | \ 351 ((vid) << VLAN_VID_SHIFT)) 352 353 #define GLD_MAKE_VTAG(pri, cfi, vid) \ 354 (((uint32_t)ETHERTYPE_VLAN << VLAN_TPID_SHIFT) | \ 355 ((pri) << VLAN_PRI_SHIFT) | \ 356 ((cfi) << VLAN_CFI_SHIFT) | \ 357 ((vid) << VLAN_VID_SHIFT)) 358 359 #define GLD_TCI2VTAG(tci) \ 360 (((uint32_t)ETHERTYPE_VLAN << VLAN_TPID_SHIFT) | (tci)) 361 362 /* 363 * Macros to construct a prototype TCI/VTAG and then convert it to a real one 364 */ 365 #define GLD_MK_PTCI(cfi, vid) GLD_MAKE_TCI(VLAN_PRI_MAX, cfi, vid) 366 #define GLD_MK_PTAG(cfi, vid) GLD_MAKE_VTAG(VLAN_PRI_MAX, cfi, vid) 367 #define GLD_MK_PMSK(pri) (((pri) << VLAN_PRI_SHIFT) | ~VLAN_PRI_MASK) 368 #define GLD_MK_VTAG(ptag, pri) ((ptag) & GLD_MK_PMSK(pri)) 369 370 /* 371 * Deconstruct a VTAG ... 372 */ 373 #define GLD_VTAG_TPID(vtag) (((vtag) & VLAN_TPID_MASK) >> VLAN_TPID_SHIFT) 374 #define GLD_VTAG_TCI(vtag) (((vtag) & VLAN_TCI_MASK) >> VLAN_TCI_SHIFT) 375 376 #define GLD_VTAG_PRI(vtag) (((vtag) & VLAN_PRI_MASK) >> VLAN_PRI_SHIFT) 377 #define GLD_VTAG_CFI(vtag) (((vtag) & VLAN_CFI_MASK) >> VLAN_CFI_SHIFT) 378 #define GLD_VTAG_VID(vtag) (((vtag) & VLAN_VID_MASK) >> VLAN_VID_SHIFT) 379 380 #ifdef __cplusplus 381 } 382 #endif 383 384 #endif /* _SYS_GLD_H */ 385