Sun Microsystems Ethernet Device Driver none User Manual

Platform Notes: The hme Fast

Ethernet Device Driver

Sun Microsystems Computer Company

2550 Garcia Avenue
Mountain View, CA 94043 USA
415 960-1300 fax [phone]

Part No: 802-5333-10
Revision A, May 1996

Copyright 1996 Sun Microsystems, Inc., 2550 Garcia A venue, Mountain V iew, California 94043-1 100 U.S.A. All rights r eserved.
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 pr otected 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 T echnical Data and Computer Software clause at DF ARS 252.227-7013 and F AR 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 register ed trademarks of Sun
Microsystems, Inc. in the United States and other countries. All SP ARC trademarks are used under license and ar e trademarks or
registered trademarks of SP ARC International, Inc. in the United States and other countries. Products bearing SPARC trademarks
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 Xer ox 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.

Please

Recycle

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 repr oduite 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, X1 1/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. T outes les marques SPARC, utilisées sous licence, sont des marques déposées ou enregistrées de
SP ARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les mar ques SP ARC 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 r echer che 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.

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

v

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

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

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

Contents vii

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

Introduction to thehme Fast

Related Documentation

Ethernet Device Driver

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.

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.

1

• 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

1

1

• Solaris Reference Manual for SMCC-Specific Software: Explains the following

T ypographic Conventions

Table 1-1 describes the typographic conventions used in this book.

Table 1-1 Typographic Conventions

Typeface or
Symbol Meaning Example

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

AaBbCc123 The names of commands,

files, and directories;
on-screen computer output

AaBbCc123 What you type, contrasted

with on-screen computer
output

AaBbCc123 Command-line placeholder:

replace with a real name or
value

AaBbCc123 Book titles, new words or

terms, or words to be
emphasized

Edit your .login file.
Use ls -a to list all files.

machine_name% You have mail.

machine_name% su
Password:

To delete a file, type rm filename.

Read Chapter 6 in the User ’s Guide.
These are called class options.
You must be root to do this.

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

Shell Prompts in Command Examples

Table 1-2 shows the default system prompt and superuser prompt for the C
shell, Bourne shell, and Korn shell.

Table 1-2 Shell Prompts

Shell Prompt

C shell machine_name%
C shell superuser machine_name#
Bourne shell and Korn shell $

1

Bourne shell and Korn shell
superuser

Ordering Sun Documents

The SunDocs Order Desk is a distribution center for Sun Microsystems
technical documentation. You can use major credit cards and company
purchase orders. You can order documentation in the following ways (see
Table 1-3):

Table 1-3 How to Order Sun Documents

Country Telephone Fax

United States 1-800-873-7869 1-800-944-0661
United Kingdom 0-800-89-88-88 0-800-89-88-87
France 05-90-61-57 05-90-61-58
Belgium 02-720-09-09 02-725-88-50
Luxembourg 32-2-720-09-09 32-2-725-88-50
Germany 01-30-81-61-91 01-30-81-61-92
The Netherlands 06-022-34-45 06-022-34-46
Sweden 020-79-57-26 020-79-57-27

#

Switzerland 155-19-26 155-19-27
Japan 0120-33-9096 0120-33-9097

World Wide Web: http://www.sun.com/sunexpress/

Introduction to the hme Fast Ethernet Device Driver 3