diff options
Diffstat (limited to 'usr.sbin/ncrcontrol/ncrcontrol.1')
-rw-r--r-- | usr.sbin/ncrcontrol/ncrcontrol.1 | 286 |
1 files changed, 0 insertions, 286 deletions
diff --git a/usr.sbin/ncrcontrol/ncrcontrol.1 b/usr.sbin/ncrcontrol/ncrcontrol.1 deleted file mode 100644 index 11505f0e1624..000000000000 --- a/usr.sbin/ncrcontrol/ncrcontrol.1 +++ /dev/null @@ -1,286 +0,0 @@ -.\" Copyright (c) 1994 Wolfgang Stanglmeier. 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. -.\" 3. The name of the author may not be used to endorse or promote products -.\" derived from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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. -.\" -.\" $Id: ncrcontrol.8,v 1.1 94/10/09 21:25:51 wolf Exp $ -.\" -.Dd September 16, 1994 -.Dt NCRCONTROL 8 -.Os FreeBSD -.Sh NAME -.Nm ncrcontrol -.Nd manually configure the ncr810/825 PCI/SCSI device driver -.Sh SYNOPSIS -.\"-------------------------------------------------------- -.\" ncrcontrol [-Mcore] [-Nsystem] [-u unit] [-v] [-v] -i -.\"-------------------------------------------------------- -.Nm ncrcontrol -.Op Fl M Ar core -.Op Fl N Ar system -.Op Fl u Ar unit -.Op Fl v -.Op Fl v -.Fl i -.\"-------------------------------------------------------- -.\" ncrcontrol [-N system] [-u unit] [-p wait] -.\"-------------------------------------------------------- -.Nm ncrcontrol -.Op Fl N Ar system -.Op Fl u Ar unit -.Op Fl p Ar wait -.\"------------------------------------------------------------ -.\" ncrcontrol [-Nsystem] [-u unit] [-t target] -s name=value -.\"------------------------------------------------------------ -.Nm ncrcontrol -.Op Fl N Ar system -.Op Fl u Ar unit -.Op Fl t Ar target -.Fl s -.Ar name=value -.\"------------------------------------------------------------ -.\" ncrcontrol [-Mcore] [-Nsystem] [-u unit] [-t target] -d pattern -.\"------------------------------------------------------------ -.Nm ncrcontrol -.Op Fl M Ar core -.Op Fl N Ar system -.Op Fl u Ar unit -.Op Fl t Ar target -.Fl d -.Ar debug -.\"------------------------------------------------------------ -.\" ncrcontrol [-Nsystem] [-u unit] -w -k torture -.\"------------------------------------------------------------ -.Nm ncrcontrol -.Op Fl N Ar system -.Op Fl u Ar unit -.Fl w -.Fl k -.Ar torture -.\" -.\"===================================================================== -.\" -.Sh DESCRIPTION -The -.Nm ncrcontrol -command symbolically displays the contents of the ncr810/ncr825 -pci/scsi driver control structure. -There are a number of output formats, -depending on the options for the information presented. -It may be used to set some values, too. - -.\"-------------------------------------------------------- -.\" ncrcontrol [-Mcore] [-Nsystem] [-u unit] [-v] [-v] -i -.\"-------------------------------------------------------- -The first form of the command displays an overview of the -connected targets. The -.Fl v -requests a verbose output. - -.\"-------------------------------------------------------- -.\" ncrcontrol [-N system] [-u unit] [-p wait] -.\"-------------------------------------------------------- -Using the second form, with a -.Ar wait -interval specified, -.Nm ncrcontrol -will continuously display the information regarding data -traffic on the selected scsi bus. - -.\"------------------------------------------------------------ -.\" ncrcontrol [-Nsystem] [-u unit] [-t target] -s name=value -.\"------------------------------------------------------------ -The third form sets a configuration value for one or all -targets of a selected scsi bus. -It normally is not needed, if the device driver options are -correctly set in kernel configuration. - -.\"------------------------------------------------------------ -.\" ncrcontrol [-M core] [-N system] [-u unit] [-t target] -w -d pattern -.\"------------------------------------------------------------ -The forth form presents the content of the drivers control -structure. By the -.Ar pattern -certain parts of the output can be enabled/disabled. -It's only used to debug the driver. - -.\"------------------------------------------------------------ -.\" ncrcontrol [-N system] [-u unit] -w -k torture -.\"------------------------------------------------------------ -With the last form certain driver problems can be forced. -THIS MAY CRASH YOUR SYSTEM. -It's only used to debug the driver. - -.\" -.\"===================================================================== -.\" -.Pp -The options have the following meaning: -.Bl -tag -width flag -.\"------------------------------------------------------------ -.\" -d pattern -.\"------------------------------------------------------------ -.It Fl d -Show the content of the drivers control structure. -The -.Ar pattern -selects the fields, which are displayed. With -.Fl d? -you can get a list of valid flags. - -.\"------------------------------------------------------------ -.\" -i -.\"------------------------------------------------------------ -.It Fl i -Show the configuration state of the connected targets. -With the -.Fl v -option you can request a more verbose information. - -.\"------------------------------------------------------------ -.\" -k torture -.\"------------------------------------------------------------ -.It Fl k -Force certain driver problems to check the error recovery -functions. This option should only be used by the developers. -With -.Fl k? -you can get a list of possible tortures. -This option requires the -.Fl w -option to be set. - -.\"------------------------------------------------------------ -.\" -M core -.\"------------------------------------------------------------ -.It Fl M -Extract values associated with the name list from the specified core -instead of the default -.Pa /dev/kmem . -.\"------------------------------------------------------------ -.\" -N system -.\"------------------------------------------------------------ -.It Fl N -Extract the name list from the specified system instead of the default -.Pa /386bsd . - -.\"------------------------------------------------------------ -.\" -p wait -.\"------------------------------------------------------------ -When -.Nm ncrcontrol -is invoked with a -.Ar wait -interval argument, it displays a running count of statistics related to -the transfers on the selected scsi bus. - -This display consists of the number of transfers and number of transferred -byted for the controller and for each connected target. - -(NOT YET COMPLETE) - -.\"------------------------------------------------------------ -.\" -s field=value -.\"------------------------------------------------------------ -.It Fl s -Set a configuration value for one or more targets. -One ore more targets can be selected by the -.Fl t -option. If no target is selected, then the field is set -for all connect targets. - -(NOT YET COMPLETE) - -.\"------------------------------------------------------------ -.\" -t target -.\"------------------------------------------------------------ -.It Fl t -Select the target for the -.Fl s -option. This option may be given more than one time. - -.\"------------------------------------------------------------ -.\" -u unit -.\"------------------------------------------------------------ -.It Fl u -Select the controller unit. -If this option is not given, then controller 0 is assumed. -Most systems have only one controller. - -.\"------------------------------------------------------------ -.\" -v -.\"------------------------------------------------------------ -.It Fl v -Enable verbose output for the -.Fl i -option. - -.\"------------------------------------------------------------ -.\" -w -.\"------------------------------------------------------------ -.It Fl w -Wizard option. -Enable the usage of the -.Fl k -option. - -.\" -.\"===================================================================== -.\" -.Pp -(NOT YET COMPLETE) - -.\" -.\"===================================================================== -.\" -.Sh SEE ALSO -.Xr scsi 5 - -.\" -.\"===================================================================== -.\" -.Sh HISTORY -The -.Nm ncrcontrol -command was hacked for -.Bx 386 -and ported to version 1.1 of -.Bx Free -by Wolfgang Stanglmeier <wolf@dentaro.GUN.de>. -It was ported to -.Bx Net -by Charles M. Hannum <mycroft@gnu.ai.mit.edu> -and to version 2.0 of -.Bx Free -by Stefan Esser <se@zpr.Uni-Koeln.DE>. - -.\" -.\"===================================================================== -.\" -.Sh BUGS -The -.Nm ncrcontrol -was hacked as a debugging tool for the ncr810 driver. -It should be deleted sometimes. -There should be a general tool to change device driver options -on the fly. -The statistical data should be gathered by the generic scsi driver. |