1ab3783e1a
bottom of the manpages and order them consistently. GNU groff doesn't care about the ordering, and doesn't even mention CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put them. Found by: mdocml lint run Reviewed by: ru
283 lines
9.2 KiB
Groff
283 lines
9.2 KiB
Groff
.\"
|
|
.\" Copyright (c) 2001-2003
|
|
.\" Fraunhofer Institute for Open Communication Systems (FhG Fokus).
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" 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.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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.
|
|
.\"
|
|
.\" Author: Hartmut Brandt <harti@FreeBSD.org>
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\" hatm(4) man page
|
|
.\"
|
|
.Dd May 15, 2003
|
|
.Dt HATM 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm hatm
|
|
.Nd "device driver for Fore/Marconi HE155 and HE622 ATM interfaces"
|
|
.Sh SYNOPSIS
|
|
.Cd device hatm
|
|
.Cd device utopia
|
|
.Cd device atm
|
|
.Pp
|
|
.Cd options NATM
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
device driver supports the FORE (now Marconi) HE155 and HE622 ATM interface
|
|
cards.
|
|
The driver interfaces with the
|
|
.Xr natm 4
|
|
framework,
|
|
.Xr netgraph 4
|
|
and the HARP ATM stack.
|
|
It provides only PVC services.
|
|
Signalling, ATMARP, ILMI and other
|
|
higher layer protocols are implemented using
|
|
.Xr netgraph 4
|
|
or HARP.
|
|
.Pp
|
|
For configuring the card for IP see
|
|
.Xr natmip 4 .
|
|
.Pp
|
|
The following sysctls are recognized by the driver additionally to those
|
|
handled by
|
|
.Xr utopia 4 :
|
|
.Bl -tag -width indent
|
|
.It Va hw.atm.hatm.natm_traffic
|
|
This is the traffic type to be used for NATM pvc connections.
|
|
The type of
|
|
this variable is integer and it must have one of the values 0 (UBR) or 1 (CBR).
|
|
.It Va hw.atm.hatm.natm_pcr
|
|
This is the peak cell rate to be used for NATM CBR connections.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .stats
|
|
Contains an array of
|
|
.Vt uint32_t
|
|
with device specific statistics.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .istats
|
|
Contains an array of
|
|
.Vt uint32_t
|
|
with internal driver statistics.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .debug
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
These are the debugging flags.
|
|
See
|
|
.Pa src/sys/dev/hatm/if_hatmvar.h
|
|
for the possible flags.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .tsr
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
This is an array containing all transmission status registers.
|
|
For each of the
|
|
4096 possible VCCs there are 15 32-bit registers.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .tpd
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
This is an array containing all on card current transmission packet descriptors.
|
|
For each of the 4096 possible VCCs there are 16 32-bit registers.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .mbox
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
This is an array containing the mbox registers.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .cm
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
This is an array containing all connection memory registers.
|
|
The first 32-bit integer of this array is the ABR base address.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .heregs
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
This is an array containing all card registers including SUNI and the FLASH ROM.
|
|
.It Va hw.atm.hatm Ns Ar N Ns Va .lbmem
|
|
.Bf Em
|
|
(Only if debugging enabled.)
|
|
.Ef
|
|
Returns the contents of the local memory.
|
|
.El
|
|
.Pp
|
|
The driver supports the media options
|
|
.Cm sdh , noscramb
|
|
and
|
|
.Cm unassigned
|
|
(see
|
|
.Xr utopia 4 ) .
|
|
.Sh ENVIRONMENT
|
|
When attaching to a device the driver checks the kernel environment
|
|
(see
|
|
.Xr kenv 1 )
|
|
to see if the default queues sizes should be overwritten or not.
|
|
The
|
|
following variables are checked and interpreted as unsigned integer
|
|
values (in either radix):
|
|
.Bl -tag -width indent
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbps0_size
|
|
Size of the small receive buffer pool 0.
|
|
This pool is used for all
|
|
except raw AAL connections.
|
|
The pool size must be a power of two between
|
|
4 and 8192 inclusive.
|
|
When attaching the driver allocates this number
|
|
of mbufs.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbps0_thresh
|
|
Interrupt threshold for small receive buffer pool 0.
|
|
When the number of free
|
|
buffers in the pool falls below this threshold it generates an interrupt
|
|
so that the driver can refill the pool.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbpl0_thresh
|
|
Size of the large receive buffer pool 0.
|
|
This pool is used for all
|
|
except raw AAL connections.
|
|
The pool size must be a power of two between
|
|
4 and 8192 inclusive.
|
|
When attaching the driver allocates this number
|
|
of mbufs with clusters.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbpl0_thresh
|
|
Interrupt threshold for large receive buffer pool 0.
|
|
When the number of free
|
|
buffers in the pool falls below this threshold it generates an interrupt
|
|
so that the driver can refill the pool.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq0_size
|
|
Size of receive buffer return queue 0.
|
|
This queue is used to return buffers
|
|
filled with received frames to the driver.
|
|
The size must be a power of 2
|
|
between 1 and 16384 inclusive.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq0_thresh
|
|
Interrupt threshold for receive buffer return queue 0.
|
|
This threshold
|
|
should only be triggered in exceptional cases.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq0_tout
|
|
Interrupt timeout for receive buffer return queue 0.
|
|
An interrupt is generated
|
|
after this time if the queue is not empty.
|
|
The number is in internal card
|
|
ticks.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq0_pcnt
|
|
Packet count threshold for receive buffer return queue 0.
|
|
An interrupt
|
|
is generated if this number of packets is in the queue.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbps1_size
|
|
Size of the small receive buffer pool 1.
|
|
This pool is used for all
|
|
raw AAL connections.
|
|
The pool size must be a power of two between
|
|
4 and 8192 inclusive.
|
|
When attaching the driver allocates this number
|
|
of mbufs.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbps1_thresh
|
|
Interrupt threshold for small receive buffer pool 1.
|
|
When the number of free
|
|
buffers in the pool falls below this threshold it generates an interrupt
|
|
so that the driver can refill the pool.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq1_size
|
|
Size of receive buffer return queue 1.
|
|
This queue is used to return buffers
|
|
filled with received cells to the driver.
|
|
The size must be a power of 2
|
|
between 1 and 16384 inclusive.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq1_thresh
|
|
Interrupt threshold for receive buffer return queue 1.
|
|
This threshold
|
|
should only be triggered in exceptional cases.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq1_tout
|
|
Interrupt timeout for receive buffer return queue 1.
|
|
An interrupt is generated
|
|
after this time if the queue is not empty.
|
|
The number is in internal card
|
|
ticks.
|
|
.It Va hw.hatm Ns Ar N Ns Va .rbrq1_pcnt
|
|
Packet count threshold for receive buffer return queue 0.
|
|
An interrupt
|
|
is generated if this number of cells is in the queue.
|
|
.It Va hw.hatm Ns Ar N Ns Va .irq0_size
|
|
Size of interrupt queue 0.
|
|
This must be a number between 1 and 1023 inclusive.
|
|
.It Va hw.hatm Ns Ar N Ns Va .irq0_thresh
|
|
Interrupt retrigger threshold of interrupt queue 0.
|
|
A new interrupt is trigger
|
|
if the queue fill state reaches this threshold and the interrupt was no
|
|
served.
|
|
.It Va hw.hatm Ns Ar N Ns Va .tbrq0_size
|
|
Transmit buffer return queue 0 size.
|
|
This queue is used to feed back empty
|
|
buffers of transmitted frames back to the driver.
|
|
It must be a power of 2
|
|
between 1 and 4096 inclusive.
|
|
.It Va hw.hatm Ns Ar N Ns Va .tbrq0_thresh
|
|
Transmit buffer return queue 0 threshold.
|
|
An interrupt is generated if the
|
|
queue fill state reaches this point.
|
|
.It Va hw.hatm Ns Ar N Ns Va .tpdrq_size
|
|
Transmit descriptor ready queue size.
|
|
This queue is used by the driver
|
|
to feed transmit descriptors into the card.
|
|
The size must be a power of 2
|
|
between 1 and 16384 inclusive.
|
|
.It Va hw.hatm Ns Ar N Ns Va .tpdmax
|
|
Maximum number of active TPDs per connection.
|
|
This controls the maximum
|
|
number of outstanding packet chunks per connection and thus the maximum
|
|
delay packets can have because of queueing on the adapter.
|
|
If set to 0,
|
|
a connection can eat up all available TPDs.
|
|
.It Va hw.hatm Ns Ar N Ns Va .mbuf_max_pages
|
|
Maximum number of memory pages allocated to small external mbufs.
|
|
This must not be zero and not larger than 65536.
|
|
.El
|
|
.Sh DIAGNOSTICS
|
|
.Bd -literal
|
|
hatm0: <FORE HE> mem 0xd2600000-0xd26fffff irq 9 at device 15.0 on pci2
|
|
hatm0: ForeRunnerHE 622, Rev. D, S/N 2949834, MAC=00:20:48:2d:02:ca
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr natm 4 ,
|
|
.Xr natmip 4 ,
|
|
.Xr utopia 4 ,
|
|
.Xr ifconfig 8 ,
|
|
.Xr route 8
|
|
.Sh AUTHORS
|
|
.An Harti Brandt Aq harti@FreeBSD.org
|
|
.Sh CAVEATS
|
|
When putting a HE155 into a 64-bit 66MHz PCI slot the machine may hang.
|
|
This occurs very early in the POST so that even the display does not turn on.
|
|
The HE155 runs only in 33MHz slots (either 32 or 64-bit).
|
|
HE622 cards work just fine in 64-bit slots.
|
|
.Pp
|
|
The driver may not work with bounce buffer, because of
|
|
.Xr bus_dmamap_sync 9
|
|
missing the
|
|
.Fa offset
|
|
and
|
|
.Fa len
|
|
arguments the
|
|
.Nx
|
|
function has.
|