[src/trunk]: src/usr.sbin/lmcconfig New version from David Boggs.

To: source-changes-hg%NetBSD.org@localhost
Subject: [src/trunk]: src/usr.sbin/lmcconfig New version from David Boggs.
From: christos <christos%NetBSD.org@localhost>
Date: Fri, 24 Jan 2020 18:18:51 +0000
details:   https://anonhg.NetBSD.org/src/rev/384a809b09d6
branches:  trunk
changeset: 588210:384a809b09d6
user:      christos <christos%NetBSD.org@localhost>
date:      Sat Feb 11 23:01:10 2006 +0000

description:
New version from David Boggs.

diffstat:

 usr.sbin/lmcconfig/lmcconfig.8 |  800 ++++++++++++++++++++++------------------
 usr.sbin/lmcconfig/lmcconfig.c |  784 ++++++++++++++++++++-------------------
 2 files changed, 851 insertions(+), 733 deletions(-)

diffs (truncated from 2596 to 300 lines):

diff -r 368453316c38 -r 384a809b09d6 usr.sbin/lmcconfig/lmcconfig.8
--- a/usr.sbin/lmcconfig/lmcconfig.8    Sat Feb 11 23:00:06 2006 +0000
+++ b/usr.sbin/lmcconfig/lmcconfig.8    Sat Feb 11 23:01:10 2006 +0000
@@ -1,7 +1,6 @@
-.\" $NetBSD: lmcconfig.8,v 1.1 2005/12/06 03:12:35 christos Exp $
-.\"
-.\" Copyright (c) 2003 David Boggs. (boggs%boggs.palo-alto.ca.us@localhost)
-.\" All rights reserved.
+.\"-
+.\" Copyright (c) 2003-2006 David Boggs. (boggs%boggs.palo-alto.ca.us@localhost)
+.\" All rights reserved.  I wrote this man page from scratch.
 .\"
 .\" BSD License:
 .\"
@@ -28,107 +27,124 @@
 .\"
 .\" GNU General Public License:
 .\"
-.\" This program is free software; you can redistribute it and/or modify it 
-.\" under the terms of the GNU General Public License as published by the Free 
-.\" Software Foundation; either version 2 of the License, or (at your option) 
+.\" This program is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License as published by the Free
+.\" Software Foundation; either version 2 of the License, or (at your option)
 .\" any later version.
-.\" 
-.\" This program is distributed in the hope that it will be useful, but WITHOUT 
-.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
-.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for 
+.\"
+.\" This program is distributed in the hope that it will be useful, but WITHOUT
+.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 .\" more details.
 .\"
 .\" You should have received a copy of the GNU General Public License along with
-.\" this program; if not, write to the Free Software Foundation, Inc., 59 
+.\" this program; if not, write to the Free Software Foundation, Inc., 59
 .\" Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 .\"
-.\" I forget these things:
-.\" groff -Tascii -mdoc lmcconfig.8 > lmcconfig.txt
-.\" groff -Tps    -mdoc lmcconfig.8 > lmcconfig.ps
-.\" groff -Thtml  -mdoc lmcconfig.8 > lmcconfig.html (buggy)
+.\" $Id: lmcconfig.8,v 1.2 2006/02/11 23:01:10 christos Exp $
 .\"
-.Dd October 2005
+.Dd February 1, 2006
 .Dt LMCCONFIG 8
 .Os
-.Sp
+.ie (\n(.y < 19) .nr ssfix 1
+.el .nr ssfix 0
+.\" Is the OS name FreeBSD?
+.ie "\*[operating-system]"" .ds aa \*(oS
+.el .ds aa \*[operating-system]
+.substring aa (0+\n[ssfix] (6+\n[ssfix])
+.ie "\*(aa"FreeBSD" .nr fbsd 1
+.el .nr fbsd 0
+.\" Is the OS name BSD (i.e. Linux)?
+.ie "\*[operating-system]"" .ds aa \*(oS
+.el .ds aa \*[operating-system]
+.ie "\*(aa"BSD" .nr linux 1
+.el .nr linux 0
+.\"
 .Sh NAME
-.Sp
+.\"
 .Nm lmcconfig
 .Nd configuration program for
-.Tn SBE
-(formerly
-.Tn LMC )
-wide-area network interface cards.
-.Sp
+.Tn LMC
+(and some
+.Tn SBE )
+wide-area network interface cards
+.\"
 .Sh SYNOPSIS
-.Sp
+.\"
 .Nm
 .Ar interface
-.Op Fl abBcCdDeEfhLmMpPrsStTuwxXyYzZ?
-.br
+.Op Fl abBcCdDeEfgGhiLmMpPsStTuUvVwxXyY?
 .Nm
 .Ar interface
 .Fl 1
-.Op Fl aABceEfFgiIlLpPstTuUxX
-.br
+.Op Fl aABcdeEfFgiIlLpPstTuUxX
 .Nm
 .Ar interface
 .Fl 3
-.Op Fl aABcefFlLsSv
-.Sp
+.Op Fl aABcefFlLsSV
+.\"
 .Sh DESCRIPTION
-.Sp
+.\"
+The
 .Nm
-is the configuration program for the
+utility is the configuration program for the
 .Xr lmc 4
 wide-area network device driver.
 It sets control values, such as T3 framing format,
 and it displays status, such as that of integrated modems,
-that are beyond the scope of
+which are beyond the scope of
 .Xr ifconfig 8 .
 .Pp
+The
 .Nm
-displays the interface status when no parameters are specified;
-see example below.
+utility displays the interface status when no parameters are specified;
+see the
+.Sx EXAMPLES
+section.
 For this case only, if no
 .Ar interface
 is specified, it defaults to
-.Ic lmc0 .
+.ie \n[linux] .Dq Li hdlc0 .
+.el .Dq Li lmc0 .
 .Pp
 Only the super-user may modify the configuration of a network interface.
 .Pp
 The following options are available:
-.Bl -tag -width indent
+.Bl -tag -width "interface"
 .It Ar interface
 This is the name of the interface; the default is
-.Cm lmc0 .
+.ie \n[linux] .Dq Li hdlc0 .
+.el .Dq Li lmc0 .
+.if \n[fbsd] \{\
 If
 .Xr netgraph 4
 is present and the interface name ends with a colon
-then netgraph control messages are used,
+then Netgraph control messages are used,
 otherwise the
 .Xr ifnet 9
 kernel interface and socket
 .Xr ioctl 2
 system calls are used.
+.\}
 .It Fl 1
 All parameters after this apply to the T1E1 card.
 .It Fl 3
 All parameters after this apply to the T3 card.
 .El
-.Sp
-.Ss Commands for all cards
-.Sp
+.\"
+.Ss Parameters for all cards
+.\"
 The following parameters apply to more then one card type.
-.Bl -tag -width indent
+.Bl -tag -width "-W addr data"
 .It Fl a Ar number
 Set Transmitter clock source to
 .Ar number .
-.Bl -column "1" "External connector" "T1E1, HSSIc" -offset 2m -compact
-.It "1" Ta "TxClk from modem"   Ta "T1E1, HSSI"  Ta "default"
-.It "2" Ta "Internal source"    Ta "T1E1, HSSI"
-.It "3" Ta "RxClk from modem"   Ta "T1E1, HSSIc" Ta "loop timed"
-.It "4" Ta "External connector" Ta "T1E1, HSSIc"
+.Pp
+.Bl -column "1" "External connector" "T1E1, HSSIc" -compact
+.It 1 Ta "TxClk from modem"   Ta "T1E1, HSSI"  Ta "(default)"
+.It 2 Ta "Internal source"    Ta "T1E1, HSSI"
+.It 3 Ta "RxClk from modem"   Ta "T1E1, HSSIc" Ta "(loop timed)"
+.It 4 Ta "External connector" Ta "T1E1, HSSIc"
 .El
 .Pp
 An HSSI card normally takes its Tx clock from the modem connector
@@ -145,32 +161,31 @@
 .Pp
 TxClk source is not applicable to other card types.
 .It Fl b
-Read BIOS rom.
+Read BIOS ROM.
 Print the first 256 locations.
-The BIOS rom is not used and not present on some cards.
+The BIOS ROM is not used and not present on some cards.
 .It Fl B
-Write BIOS rom.
+Write BIOS ROM.
 Write the first 256 locations with an address pattern.
 .It Fl c
-Use HDLC's 16-bit CRC polynomial: X^16+X^12+X^5+1 (default)
-.Bd -ragged -compact
+Use HDLC's 16-bit Cyclic Redundancy Checksum (CRC).
 .It Fl C
-Use HDLC's 32-bit CRC polynomial:
-X^32+X^26+X^23+X^22+X^16+X^12+X^11+X^10+X^8+X^7+X^5+X^4+X^2+X+1
-.Ed
+Use HDLC's 32-bit Cyclic Redundancy Checksum (CRC).
 .It Fl d
-Clear the driver-level debug flag.  Non-critical log messages are suppressed.
+Clear the driver-level debug flag.
+Non-critical log messages are suppressed.
 .It Fl D
-Set the driver-level debug flag.  The driver generates more log messages.
-The driver also generates more log messages if the interface-level debug
-flag is set by
+Set the driver-level debug flag.
+The driver generates more log messages.
+The driver also generates more log messages if
+the interface-level debug flag is set by
 .Xr ifconfig 8 .
 .It Fl e
 Set DTE (Data Terminal Equipment) mode (default).
-An SSI card transmitter uses the Tx clock signal from the modem connector
-and receives the Data Carrier Detect pin (DCD).
-DTE/DCE is not applicable to other card types except
-a few rare CompactPCI/HSSI cards.
+An SSI card transmitter uses the Tx clock signal from the
+modem connector and receives the Data Carrier Detect pin (DCD).
+DTE/DCE is not applicable to other card types
+except a few rare CompactPCI/HSSI cards.
 .It Fl E
 Set DCE (Data Communication Equipment) mode.
 An SSI card transmitter uses an on-board synthesized oscillator
@@ -181,28 +196,34 @@
 bits/second.
 The nearest frequency that the synthesizer can generate will be used.
 Only SSI cards and a few rare CompactPCI/HSSI cards have synthesizers.
-.It Fl F
-Set SPPP line protocol to Frame-Relay.
-Only works for FreeBSD-5.4 and later.
-Not applicable to Linux, NetBSD, OpenBSD. or BSD/OS.
+.It Fl g
+Load gate array microcode from on-board ROM; see also
+.Fl U.
+.It Fl G Ar filename
+Load gate array microcode from
+.Ar filename ;
+see also
+.Fl U.
 .It Fl h
 Print help (usage message).
 .It Fl i
-Set interface name (eg. 'lmc0').
+Set interface name (e.g.\&
+.Dq Li lmc0 ) .
 .It Fl L Ar number
 Set loopback mode to
 .Ar number .
-.Bl -column "99" "payload" "inward thru drvrs/rcvrsxxx" "HSSI, SSI" -offset 1m -compact 
-.It  "1" Ta "none"    Ta "default"
-.It  "2" Ta "payload" Ta "outward thru framer"     Ta "T1E1. T3"
-.It  "3" Ta "line"    Ta "outward thru line if"    Ta "T1E1, T3, HSSIc"
-.It  "4" Ta "other"   Ta "inward thru line if"     Ta "T1E1, T3"
-.It  "5" Ta "inward"  Ta "inward thru framer"      Ta "T1E1, T3"
-.It  "6" Ta "dual"    Ta "inward and outward"      Ta "T1E1, T3"
-.It "16" Ta "tulip"   Ta "inward thru Tulip chip"  Ta "all cards"
-.It "17" Ta "pins"    Ta "inward thru drvrs/rcvrs" Ta "SSI"
-.It "18" Ta "LA/LL"   Ta "assert LA/LL modem pin"  Ta "HSSI, SSI"
-.It "19" Ta "LB/RL"   Ta "assert LB/RL modem pin"  Ta "HSSI, SSI"
+.Pp
+.Bl -column "99" "payload" "inward thru drvrs/rcvrs" -compact
+.It  1 Ta "none"    Ta "default"
+.It  2 Ta "payload" Ta "outward thru framer"     Ta "T1E1. T3"
+.It  3 Ta "line"    Ta "outward thru line if"    Ta "T1E1, T3"
+.It  4 Ta "other"   Ta "inward thru line if"     Ta "T1E1, T3"
+.It  5 Ta "inward"  Ta "inward thru framer"      Ta "T1E1, T3"
+.It  6 Ta "dual"    Ta "inward and outward"      Ta "T1E1, T3"
+.It 16 Ta "tulip"   Ta "inward thru Tulip chip"  Ta "all cards"
+.It 17 Ta "pins"    Ta "inward thru drvrs/rcvrs" Ta "SSI"
+.It 18 Ta "LA/LL"   Ta "assert LA/LL modem pin"  Ta "HSSI, SSI"
+.It 19 Ta "LB/RL"   Ta "assert LB/RL modem pin"  Ta "HSSI, SSI"
 .El
 .It Fl m
 Read Tulip MII registers.
@@ -230,15 +251,17 @@
 Write Tulip SROM.
 Initializes the Tulip SROM to card type
 .Ar number .
-.Bl -tag -width 1m -offset 1m -compact
-.It 3 Ta HSSI
-.It 4 Ta T3
-.It 5 Ta SSI
-.It 6 Ta T1E1
-.It 7 Ta HSSIc
-.It 8 Ta SDSL
-.It 0 Ta auto-set from MII PHYID
+.Pp
+.Bl -column "9" -compact
+.It 3 Ta "HSSI"
+.It 4 Ta "T3"
+.It 5 Ta "SSI"
Prev by Date: [src/trunk]: src/usr.sbin/lmcconfig rcsids.
Next by Date: [src/trunk]: src/gnu/usr.bin/groff/contrib/mom/examples Find penguin.ps with -I
Previous by Thread: [src/trunk]: src/usr.sbin/lmcconfig rcsids.
Next by Thread: [src/trunk]: src/gnu/usr.bin/groff/contrib/mom/examples Find penguin.ps with -I
Indexes:
Home | Main Index | Thread Index | Old Index