Sun Microsystems Ethernet Device Driver none User manual

2550 Garcia Avenue
Mountain View, CA 94043 USA
415 960-1300 fax [phone]
Sun Microsystems Computer Company
PlatformNotes:ThehmeFast
EthernetDeviceDriver
Part No: 802-5333-10
Revision A, May 1996

Please
Recycle
Copyright 1996 Sun Microsystems, Inc., 2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A. All rights reserved.
This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and
decompilation. No part of this product or document may be reproduced in any form by any means without prior written
authorization of Sun and its licensors, if any.
Portions of this product may be derived from the UNIX®system, licensed from Novell, Inc., and from the Berkeley 4.3 BSD
system, licensed from the University of California. UNIX is a registered trademark in the United States and other countries and is
exclusively licensed by X/Open Company Ltd. Third-party software, including font technology in this product, is protected by
copyright and licensed from Sun’s suppliers.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR 52.227-19.
Sun, Sun Microsystems, the Sun logo, Solaris, NFS,Online Backup, Online: DiskSuite, Solstice DiskSuite, X11/NeWS,
JumpStart, Sun-4, SunSwift, SunFastEthernet , Enterprise, and Ultra are trademarks or registered trademarks of Sun
Microsystems, Inc. in the United States and other countries. All SPARC trademarks are used under license and are trademarks or
registered trademarksof SPARC International, Inc. in the United Statesand other countries. Productsbearing SPARCtrademarks
are based upon an architecture developed by Sun Microsystems, Inc.
The OPEN LOOK®and Sun™ Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees.
Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user
interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which
license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license
agreements.
X Window System is a trademark of X Consortium, Inc.
THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

Copyright 1996 Sun Microsystems Inc., 2550 Garcia Avenue, Mountain View, Californie 94043-1100, U.S.A.Tous droits
réservés.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie,
la distribution, et la décompilation. Aucune partie de ce produit ou de sa documentation associée ne peut être reproduite sous
aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il
y en a.
Des parties de ce produit pourront être dérivées du système UNIX®licencié par Novell, Inc. et du système Berkeley 4.3 BSD
licencié par l’Université de Californie. UNIX est une marque enregistrée aux Etats-Unis et dans d’autres pays et licenciée
exclusivement par X/Open Company Ltd. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices
de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.
Sun, Sun Microsystems, le logo Sun,NFS,Online Backup, Online: DiskSuite, Solstice DiskSuite, X11/NeWS, JumpStart, Sun-4,
SunSwift, SunFastEthernet , Enterprise, et Ultra sont des marques déposées ou enregistrées de Sun Microsystems, Inc. aux Etats-
Unis et dans d’autres pays. Toutes les marques SPARC, utilisées sous licence, sont des marques déposées ou enregistrées de
SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une
architecture développée par Sun Microsystems, Inc.
Les interfaces d’utilisation graphique OPEN LOOK®et Sun™ ont été développées par Sun Microsystems, Inc. pour ses
utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des
interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de
Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant aussi les licenciés de Sun qui mettent en place
l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun.
Le système X Window est un produit du X Consortium, Inc.
CETTE PUBLICATION EST FOURNIE “EN L’ETAT” SANS GARANTIE D’AUCUNE SORTE, NI EXPRESSE NI IMPLICITE,
Y COMPRIS, ET SANS QUE CETTE LISTE NE SOIT LIMITATIVE, DES GARANTIES CONCERNANT LA VALEUR
MARCHANDE, L’APTITUDE DES PRODUITS A RÉPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ILS
NE SOIENT PAS CONTREFAISANTS DE PRODUITS DE TIERS.

v
Contents
1. Introduction to the hme Fast Ethernet Device Driver . . . . . . . 1
Related Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Typographic Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Ordering Sun Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The hme Device Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Hardware Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Operating Speeds and Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Auto-Negotiation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Internal Transceiver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
External Transceiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3. Parameter Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Driver Parameter Values and Definitions . . . . . . . . . . . . . . . . . . 9
Defining the Current Status . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Inter-Packet Gap Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 11
et Using lance_mode and ipg0
Packet Using lance_mode and ipg0. . . . . . . . . . . . . . . 12

vi Platform Notes: The hme Fast Ethernet Device Driver—May 1996
Operational Mode Parameters . . . . . . . . . . . . . . . . . . . . . . . . 13
Defining the Number of Back-to-Back Packets To Transmit 15
Reporting Transceiver Capabilities . . . . . . . . . . . . . . . . . . . . 15
Reporting the Link Partner Capabilities . . . . . . . . . . . . . . . . 16
4. Setting Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Parameter Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Setting Parameters Using ndd . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Identifying Device Instances . . . . . . . . . . . . . . . . . . . . . . . . . 20
▼To specify the device instance for the ndd utility 20
Non-Interactive and Interactive Modes . . . . . . . . . . . . . . . . 21
▼To modify a parameter value . . . . . . . . . . . . . . . . . 21
▼To display the value of a parameter . . . . . . . . . . . 22
▼To modify a parameter value in interactive mode 22
▼To list all the parameters supported by the
hme driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
▼To select one of the five local transceiver
capabilities and set the mode to forced mode . . . 24
▼To set the mode to auto-negotiation . . . . . . . . . . . 24
Configuring TCP/IP for Maximum Performance . . . . . . . . 25
▼To benchmark the TCP/IP throughput. . . . . . . . . 25
▼To set the TCP hiwater marks for best
performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Contents vii
Setting Parameters in the /etc/system File . . . . . . . . . . . . . . 25
▼To set the ipg1 to 10 and ipg2 to 5 when you reboot . 26
Setting Parameters Using the hme.conf File. . . . . . . . . . . . . . . 27
▼To set ipg1 to 20 and ipg2 to 10 for the SUNW,hme
device in SBus slot 0xe . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

viii Platform Notes: The hme Fast Ethernet Device Driver—May 1996

1
IntroductiontothehmeFast
EthernetDeviceDriver 1
This book describes how to configure the hme driver for the SunUltra1
Series systems, the Sun Ultra 2 Series system, the UltraEnterprise3000,
4000, 5000, and 6000 systems, the SunSwiftSBus Adapter, and the
SunFastEthernetAdapter 2.0. To configure the hme driver you can use the
ndd utility to set the parameters. If you use the ndd utility, the parameter
values are effective until you reboot the system. To keep the values in effect
even after rebooting the system, enter the parameter values into the
/etc/system file or the hme.conf file in the /kernel/drv directory.
Chapter 2 describes the hme device driver and includes topics such as
operating speeds and modes, auto-negotiation, the internal transceiver, and the
external transceiver. Chapter 3 describes the parameters and settings for the
hme device driver. Chapter 4 describes how to set the hme device driver
parameter values using the ndd utility and also in the /etc/system and
hme.conf files.
Related Documentation
The following related books provide an overview of the hme driver and the
FEPS ASIC, give more information on the Ethernet standard, and list man
pages for the hme driver.
•SMCC SPARC Hardware Platform Guide: Provides an overview of the hme
driver and the Fast Ethernet Parallel Port SCSI (FEPS) ASIC
•IEEE 802.3u Ethernet Standard: Provides additional information about the
Ethernet standard

2Platform Notes: The hme Fast Ethernet Device Driver—May 1996
1
•Solaris Reference Manual for SMCC-Specific Software: Explains the following
man pages:
•ndd (1M) man page summarizes information on how to use the ndd utility
•prtconf (1M), system (4), and driver.conf (4) man pages describe
information about entering parameter values into the /etc/system file
and the hme.conf file
Typographic Conventions
Table 1-1 describes the typographic conventions used in this book.
Table 1-1 Typographic Conventions
Typeface or
Symbol Meaning Example
AaBbCc123 The names of commands,
files, and directories;
on-screen computer output
Edit your .login file.
Use ls -a to list all files.
machine_name% You have mail.
AaBbCc123 What you type, contrasted
with on-screen computer
output
machine_name% su
Password:
AaBbCc123 Command-line placeholder:
replace with a real name or
value
To delete a file, type rm filename.
AaBbCc123 Book titles, new words or
terms, or words to be
emphasized
Read Chapter 6 in the User’s Guide.
These are called class options.
You must be root to do this.