1 '\" te
   2 .\" Copyright (c) 2001-2007 by Garrett D'Amore.
   3 .\" Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
   4 .\" 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the author nor the names of any co-contributors may be used to endorse
   5 .\" or promote products derived from this software    without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
   6 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
   7 .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
   8 .\" Portions Copyright (c) 2007 by Sun Microsystems, Inc.  All Rights Reserved.
   9 .TH MXFE 7D "Aug 31, 2007"
  10 .SH NAME
  11 mxfe \- MXFE Fast Ethernet device driver
  12 .SH SYNOPSIS
  13 .LP
  14 .nf
  15 \fB/dev/mxfe*\fR
  16 .fi
  17 
  18 .SH DESCRIPTION
  19 .sp
  20 .LP
  21 The \fBmxfe\fR is a Solaris STREAMS hardware driver supporting the Data Link
  22 Provider Interface (\fBdlpi\fR(7P)) over the Macronix 98715 family (including
  23 the Lite-On PNIC-II) of Fast Ethernet controllers.
  24 .SH DLPI SPECIFICATIONS
  25 .sp
  26 .LP
  27 The \fBmxfe\fR driver supports both style 1 and style 2 modes of operation.
  28 Physical points of attachment (PPAs) are interpreted as the instance number of
  29 the  \fBmxfe\fR controller as assigned by the operating system.
  30 .sp
  31 .LP
  32 The  relevant  fields  returned  as part of a DL_INFO_ACK response are:
  33 .RS +4
  34 .TP
  35 .ie t \(bu
  36 .el o
  37 Maximum SDU is 1500.
  38 .RE
  39 .RS +4
  40 .TP
  41 .ie t \(bu
  42 .el o
  43 Minimum SDU is 0.
  44 .RE
  45 .RS +4
  46 .TP
  47 .ie t \(bu
  48 .el o
  49 DLSAP address length is 8.
  50 .RE
  51 .RS +4
  52 .TP
  53 .ie t \(bu
  54 .el o
  55 MAC type is \fBDL_ETHER\fR.
  56 .RE
  57 .RS +4
  58 .TP
  59 .ie t \(bu
  60 .el o
  61 \fBSAP\fR length value is \fI-2\fR, meaning the physical address component is
  62 followed immediately by a 2-byte \fBSAP\fR component within the \fBDLSAP\fR
  63 address.
  64 .RE
  65 .RS +4
  66 .TP
  67 .ie t \(bu
  68 .el o
  69 Service mode is DL_CLDLS.
  70 .RE
  71 .RS +4
  72 .TP
  73 .ie t \(bu
  74 .el o
  75 Broadcast address value is the 6-byte Ethernet/IEEE broadcast address
  76 (ff:ff:ff:ff:ff:ff).
  77 .RE
  78 .sp
  79 .LP
  80 If the SAP provided is zero, \fIIEEE 802.3\fR mode is assumed and outbound
  81 frames will have the frame payload length written into the type field Likewise,
  82 inbound  frames with a SAP between zero and 1500 are interpreted as \fIIEEE
  83 802.3\fR frames and delivered to streams that have bound to SAP zero (the
  84 \fI802.3\fR SAP).
  85 .SH FILES
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB/dev/mxfe*\fR\fR
  90 .ad
  91 .RS 28n
  92 Special character device
  93 .RE
  94 
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB/kernel/drv/mxfe\fR\fR
  99 .ad
 100 .RS 28n
 101 32-bit driver binary (x86).
 102 .RE
 103 
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB/kernel/drv/amd64/mxfe\fR\fR
 108 .ad
 109 .RS 28n
 110 64-bit ELF kernel module (x86).
 111 .RE
 112 
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB/kernel/drv/sparcv9/mxfe\fR\fR
 117 .ad
 118 .RS 28n
 119 Driver binary (SPARC).
 120 .RE
 121 
 122 .SH ATTRIBUTES
 123 .sp
 124 .LP
 125 See \fBattributes\fR(5) for a description of the following attributes:
 126 .sp
 127 
 128 .sp
 129 .TS
 130 box;
 131 c | c
 132 l | l .
 133 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 134 _
 135 Architecture    SPARC, x86
 136 .TE
 137 
 138 .SH SEE ALSO
 139 .sp
 140 .LP
 141 \fBifconfig\fR(1M), \fBndd\fR(1M), \fBattributes\fR(5), \fBdlpi\fR(7P)
 142 .sp
 143 .LP
 144 \fIIEEE 802.3\fR \(em Institute of Electrical and Electronics Engineers, 2002

   1 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
   2 .\" Redistribution and use in source and binary forms, with or without
   3 .\" modification, are permitted provided that the following conditions
   4 .\" are met:
   5 .\" 1. Redistributions of source code must retain the above copyright
   6 .\"    notice, this list of conditions and the following disclaimer.
   7 .\" 2. Redistributions in binary form must reproduce the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer in the
   9 .\"    documentation and/or other materials provided with the distribution.
  10 .\"
  11 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS
  12 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  13 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  14 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  15 .\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  16 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  17 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  18 .\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  19 .\" ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  20 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  21 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
  22 .\"
  23 .Dd "Aug 7, 2014"
  24 .Dt MXFE 7D
  25 .Os
  26 .Sh NAME
  27 .Nm mxfe
  28 .Nd Macronix Fast Ethernet device driver
  29 .Sh SYNOPSIS
  30 .Pa /dev/mxfe
  31 .Sh DESCRIPTION
  32 The
  33 .Nm
  34 driver provides support for the
  35 Macronix 98715 family (including the Lite-On PNIC-II) of Fast Ethernet
  36 PCI controllers.
  37 .Lp
  38 These devices generally support the standard Fast Ethernet features, including
  39 10BASE-T and 100BASE-TX, both full and half duplex operation, IEEE 802.3
  40 autonegotiation, etc.  They also support full size MTUs (1500 bytes),
  41 even when used with VLANs.
  42 .
  43 .Lp
  44 The device driver supports the
  45 .Xr ieee802.3 5
  46 properties, which can be configured with
  47 .Xr dladm 1M .
  48 .Sh FILES
  49 .Bl -tag -width /dev/mxfe
  50 .It Pa /dev/mxfe
  51 Special character device.
  52 .El
  53 .Sh SEE ALSO
  54 .Xr dladm 1M ,
  55 .Xr ifconfig 1M ,
  56 .Xr pci 4 ,
  57 .Xr ieee802.3 5 ,
  58 .Xr dlpi 7P
  59 .Rs
  60 .%T IEEE 802.3: Ethernet
  61 .%Q IEEE Standards Association
  62 .Re