xref: /titanic_44/usr/src/man/man7d/afe.7d (revision f05d7fc81533be643136e12ce92516d1d4292921)
te
Copyright (c) 2001-2007 by Garrett D'Amore.
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.
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
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
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;
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
Portions Copyright (c) 2007 by Sun Microsystems, Inc. All Rights Reserved.
AFE 7D "Apr 1, 2007"
NAME
afe - ADMtek Fast Ethernet device driver
SYNOPSIS

/dev/afe
DESCRIPTION

The afe driver is a multi-threaded, loadable, clonable, GLD-based STREAMS driver supporting the Data Link Provider Interface dlpi(7P) on ADMtek (now Infineon) Centaur and Comet Fast Ethernet controllers.

APPLICATION PROGRAMMING INTERFACE

The afe driver can be used as either a "style 1" or a "style 2" Data Link Service Provider. Physical points of attachment (PPAs) are interpreted as the instance number of the afe controller as assigned by the Solaris operating environment.

The relevant fields returned as part of a DL_INFO_ACK response are:

Maximum SDU is 1500.

Minimum SDU is 0.

The dlsap address length is 8.

MAC type is DL_ETHER.

SAP length is -2. The 6-byte physical address is followed immediately by a 2-byte SAP.

Service mode is DL_CLDLS.

Broadcast address is the 6-byte Ethernet broadcast address (ff:ff:ff:ff:ff:ff).

If the SAP provided is zero, then IEEE 802.3 mode is assumed and outbound frames will have the frame payload length written into the type field. Likewise, inbound frames with a SAP between zero and 1500 are interpreted as IEEE 802.3 frames and delivered to any streams that are bound to SAP zero (the 802.3 SAP).

PROPERTIES

The following properties may be configured using either ndd(1M) or the afe.conf configuration file as described by driver.conf(4): adv_autoneg_cap

Enables (default) or disables IEEE 802.3u auto-negotiation of link speed and duplex settings. If enabled, the device negotiates among the supported (and configured, see below) link options with the link partner. If disabled, at least one of the link options below must be specified. The driver selects the first enabled link option according to the IEEE 802.3u specified preferences.

adv_100T4_cap

Enables the 100 BaseT4 link option. (Note that most hardware does not support this unusual link style. Also, this uses two pairs of wires for data, rather than one.)

adv_100fdx_cap

Enables the 100 Base TX full-duplex link option. (This is generally the fastest mode if both link partners support it. Most modern equipment supports this mode.)

adv_100hdx_cap

Enables the 100 Base TX half-duplex link option. (Typically used when the link partner is a 100 Mbps hub.)

adv_10fdx_cap

Enables the 10 Base-T full-duplex link option. (This less-frequently used mode is typically used when the link partner is a 10 Mbps switch.)

adv_10hdx_cap

Enables the 10 Base-T half-duplex link option. (This is the fall-back when no other option is available. It is typically used when the link partner is a 10 Mbps hub or is an older network card.)

ATTRIBUTES

See attributes(5) for a description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Architecture SPARC, x86
Interface Stability Committed
FILES
/dev/afe

Special character device.

/kernel/drv/afe

32-bit driver binary (x86).

/kernel/drv/amd64/afe

64-bit driver binary (x86).

/kernel/drv/sparcv9/afe

64-bit driver binary (SPARC).

/kernel/drv/afe.conf

Configuration file.

SEE ALSO

ndd(1M), driver.conf(4), attributes(5), streamio(7I), dlpi(7P)

IEEE 802.3 \(em Institute of Electrical and Electronics Engineers, 2002