Merge commit 'ad3ad82ad2fb99c424a8482bd1908d08b990ccea'
[unleashed.git] / share / man / man7d / chxge.7d
blob6486946be0c7bc50bbb461d85a54947a681ddca4
1 '\" te
2 .\"  Copyright (c) 2005, Sun Microsystems, Inc.  All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH CHXGE 7D "Jan 17, 2005"
7 .SH NAME
8 chxge \- Chelsio Ethernet network interface controllers
9 .SH SYNOPSIS
10 .LP
11 .nf
12 /dev/chxge
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 The \fBchxge\fR Ethernet driver is a  multi-threaded, loadable, clonable,
19 STREAMS hardware driver supporting the connectionless Data Link Provider
20 Interface, \fBdlpi\fR(7P), over Chelsio NIC controllers. Multiple (and  mixed)
21 NIC controllers installed within the  system are supported  by  the driver. The
22 \fBchxge\fR driver provides basic support for the NIC hardware. Functions
23 include chip initialization, frame transmit and receive, and error recovery and
24 reporting.
25 .SH APPLICATION PROGRAMMING INTERFACE
26 .sp
27 .LP
28 The cloning, character-special device \fB/dev/chxge\fR is used to access NIC
29 devices installed within the system.
30 .SH CHXGE AND DLPI
31 .sp
32 .LP
33 The \fBchxge\fR driver is dependent on \fB/kernel/misc/gld\fR, a loadable
34 kernel  module  that  provides the \fBchxge\fR driver with the DLPI and STREAMS
35 functionality required of a LAN driver. See \fBgld\fR(7D) for more details on
36 the primitives supported by the driver.
37 .sp
38 .LP
39 The values returned by the driver in the DL_INFO_ACK primitive in response to
40 the DL_INFO_REQ are:
41 .RS +4
42 .TP
43 .ie t \(bu
44 .el o
45 Default Maximum SDU is 1500 (ETHERMTU).
46 .RE
47 .RS +4
48 .TP
49 .ie t \(bu
50 .el o
51 dlsap address length is 8.
52 .RE
53 .RS +4
54 .TP
55 .ie t \(bu
56 .el o
57 MAC type is DL_ETHER.
58 .RE
59 .RS +4
60 .TP
61 .ie t \(bu
62 .el o
63 The sap length value is  -2, meaning  the  physical address component is
64 followed immediately by a 2-byte sap component within the DLSAP address.
65 .RE
66 .RS +4
67 .TP
68 .ie t \(bu
69 .el o
70 Broadcast address  value is Ethernet/IEEE  broadcast address
71 (FF:FF:FF:FF:FF:FF).
72 .RE
73 .SH FILES
74 .sp
75 .ne 2
76 .na
77 \fB/dev/chxge\fR
78 .ad
79 .RS 29n
80 Character special device.
81 .RE
83 .sp
84 .ne 2
85 .na
86 \fB/kernel/drv/sparcv9/chxge\fR
87 .ad
88 .RS 29n
89 SPARC chxge driver binary.
90 .RE
92 .sp
93 .ne 2
94 .na
95 \fB/kernel/drv/chxge\fR
96 .ad
97 .RS 29n
98 x86 platform kernel module. (32-bit).
99 .RE
102 .ne 2
104 \fB/kernel/drv/amd64/chxge\fR
106 .RS 29n
107 x86 platform kernel module. (64-bit).
110 .SH ATTRIBUTES
113 See \fBattributes\fR(5) for descriptions of the following attributes:
118 box;
119 c | c
120 l | l .
121 ATTRIBUTE TYPE  ATTRIBUTE VALUE
123 Architecture    SPARC, x86
126 .SH SEE ALSO
129 \fBnetstat\fR(8), \fBattributes\fR(5), \fBgld\fR(7D), \fBdlpi\fR(7P),
130 \fBgld\fR(9F), \fBgld_mac_info\fR(9S)