summaryrefslogtreecommitdiffstats
path: root/share/man/man4/utopia.4
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-08 10:31:12 +0000
committerru <ru@FreeBSD.org>2004-07-08 10:31:12 +0000
commit54adde43e3db43893e9824235a81823cf679c051 (patch)
tree9633dc5aa9a7c09ac83bb96f74d275b65d77e839 /share/man/man4/utopia.4
parent64c32415ce9ffa8cd1c9daad2badb08c90241e48 (diff)
downloadFreeBSD-src-54adde43e3db43893e9824235a81823cf679c051.zip
FreeBSD-src-54adde43e3db43893e9824235a81823cf679c051.tar.gz
Markup fixes.
Diffstat (limited to 'share/man/man4/utopia.4')
-rw-r--r--share/man/man4/utopia.459
1 files changed, 30 insertions, 29 deletions
diff --git a/share/man/man4/utopia.4 b/share/man/man4/utopia.4
index 2ea9c98..08f530d 100644
--- a/share/man/man4/utopia.4
+++ b/share/man/man4/utopia.4
@@ -23,15 +23,16 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" Author: Hartmut Brandt <harti@freebsd.org>
+.\" Author: Hartmut Brandt <harti@FreeBSD.org>
.\"
.\" $FreeBSD$
+.\"
.Dd May 8, 2003
.Dt UTOPIA 4
.Os
.Sh NAME
.Nm utopia
-.Nd Driver module for ATM PHY chips
+.Nd "driver module for ATM PHY chips"
.Sh SYNOPSIS
.Cd device utopia
.Sh DESCRIPTION
@@ -43,85 +44,85 @@ in either interrupt or polling mode, media option handling and application
access to chip registers.
.Pp
The driver implements several sysctls that are accessible under the
-.Cm hw.atm.XXX
+.Va hw.atm. Ns Ao Ar iface Ac Ns Va .\&
tree, where
-.Cm XXX
+.Ar iface
is the name of the ATM interface:
-.Bl -tag -width XXX
-.It Cm phy_regs
+.Bl -tag -width indent
+.It Va phy_regs
When reading this sysctl an array of 8-bit unsigned integers is returned
containing all accessible chip registers starting at register 0.
A register can be written by writing three 8-bit unsigned integers to the
sysctl: the register number, the new value and a bit mask.
This changes all bits in the register for which the corresponding bit in the
mask is one to the bit values from value.
-Note, that not all registers may
+Note that not all registers may
be writeable.
-.It Cm phy_loopback
+.It Va phy_loopback
allows to put the interface in one of several loopback modes.
Not all modes and all combinations of modes are supported on all chips.
The possible modes are:
-.Bl -tag -width XXX
-.It Dv UTP_LOOP_NONE (0x00)
+.Bl -tag -width indent
+.It Dv UTP_LOOP_NONE Pq No 0x00
No loopback, normal operation.
-.It Dv UTP_LOOP_TIME (0x01)
+.It Dv UTP_LOOP_TIME Pq No 0x01
Timing source loopback.
When this is set the transmitter's clock is
derived from the receiver's clock.
-.It Dv UTP_LOOP_DIAG (0x02)
+.It Dv UTP_LOOP_DIAG Pq No 0x02
Diagnostic loopback.
In this mode the receiver's input is connected to the
transmitter's output.
The receiver gets back everything that is sent.
The
transmitter operates normally.
-.It Dv UTP_LOOP_LINE (0x04)
+.It Dv UTP_LOOP_LINE Pq No 0x04
Serial line loopback.
This connects the line receiver to the line transmitter.
The chip transmits all cells back that it receives.
The receiver operates
normally.
-.It Dv UTP_LOOP_PARAL (0x08)
+.It Dv UTP_LOOP_PARAL Pq No 0x08
Parallel diagnostic loopback.
This feeds back all transmitted cells into the
receiver between the parallel/serial converters.
The transmitter
operates normally.
-.It Dv UTP_LOOP_TWIST (0x10)
+.It Dv UTP_LOOP_TWIST Pq No 0x10
Twisted pair diagnostic loopback.
Connects the high speed receive data to the
high speed transmit data.
All received data is sent back.
The receiver
operates normally.
-.It Dv UTP_LOOP_PATH (0x20)
+.It Dv UTP_LOOP_PATH Pq No 0x20
Diagnostic path loopback.
This connects the receiver input to the transmitter
output just between the path overhead processor and the byte mux.
The
transmitter operates normally.
.El
-.It Cm phy_type
+.It Va phy_type
This is the detected type of the phy chip.
Currently the following chips are
supported:
-.Bl -tag -width XXX
-.It Dv UTP_TYPE_UNKNOWN (0)
+.Bl -tag -width indent
+.It Dv UTP_TYPE_UNKNOWN Pq No 0
The module could not determine the type of the PHY chip.
-.It Dv UTP_TYPE_SUNI_LITE (1)
+.It Dv UTP_TYPE_SUNI_LITE Pq No 1
PMC-5346 (S/Uni-Lite)
-.It Dv UTP_TYPE_SUNI_ULTRA (2)
+.It Dv UTP_TYPE_SUNI_ULTRA Pq No 2
PMC-5350 (S/Uni-Ultra)
-.It Dv UTP_TYPE_SUNI_622 (3)
+.It Dv UTP_TYPE_SUNI_622 Pq No 3
PMC-5355 (S/Uni-622)
-.It Dv UTP_TYPE_IDT77105 (4)
+.It Dv UTP_TYPE_IDT77105 Pq No 4
IDT77105 (25.6MBit UTP interface)
-.It Dv UTP_TYPE_IDT77155 (5)
+.It Dv UTP_TYPE_IDT77155 Pq No 5
IDT77155 (155MBit interface)
.El
-.It Cm phy_name
+.It Va phy_name
This is a string describing the type of the PHY chip.
-.It Cm phy_stats
+.It Va phy_stats
Physical and some ATM layer statistics.
These are the statistics usually
provided by the chip.
@@ -159,7 +160,7 @@ module also interfaces with the ifmedia system.
The module reports the current state of the carrier and will issue a
warning message when the carrier state changes.
While the physical media itself cannot be changed, several media options can:
-.Bl -tag -width XXX
+.Bl -tag -width indent
.It Cm SDH
If the PHY is a Sonet/SDH chip this flag switches the interface into SDH mode.
If this option is not set (the default) the interface is in Sonet mode.
@@ -179,5 +180,5 @@ may be needed for interworking with public networks.
.Xr hatm 4 ,
.Xr patm 4 ,
.Xr utopia 9
-.Sh AUTHOR
-.An Harti Brandt Aq harti@freebsd.org .
+.Sh AUTHORS
+.An Harti Brandt Aq harti@FreeBSD.org
OpenPOWER on IntegriCloud