PERFORCE change 49925 for review

[Peter Wemm]

http://perforce.freebsd.org/chv.cgi?CH=49925

Change 49925 by peter at peter_daintree on 2004/03/29 15:33:49

	IFC @49922 (ct.4 bogo-conflicts)

Affected files ...

.. //depot/projects/hammer/share/man/man4/man4.i386/ct.4#3 integrate

Differences ...

==== //depot/projects/hammer/share/man/man4/man4.i386/ct.4#3 (text+ko) ====

@@ -1,99 +1,148 @@
-.\" Copyright (c) 2004 Roman Kurakin <rik at cronyx.ru>
-.\" Copyright (c) 2004 Cronyx Engineering
-.\" All rights reserved.
+.\" Copyright (c) 2003 Noriaki MITSUNAGA. All rights reserved.
+.\" Copyright (c) 2003 Hideyuki KURASHINA. All rights reserved.
 .\"
-.\" This software is distributed with NO WARRANTIES, not even the implied
-.\" warranties for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+.\" 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.
 .\"
-.\" Authors grant any other persons or organisations a permission to use,
-.\" modify and redistribute this software in source and binary forms,
-.\" as long as this message is kept with the software, all derivative
-.\" works or modified versions.
+.\" THIS SOFTWARE IS PROVIDED BY 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 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.
 .\"
-.\" Cronyx Id: ct.4,v 1.1.2.2 2004/02/26 18:47:18 rik Exp $
-.\" $FreeBSD: src/share/man/man4/man4.i386/ct.4,v 1.2 2004/03/13 00:12:09 brueffer Exp $
+.\" $FreeBSD: src/share/man/man4/man4.i386/ct.4,v 1.4 2004/03/26 06:26:45 non Exp $
 .\"
-.Dd February 26, 2004
-.Dt CT 4 i386
+.Dd November 18, 2003
+.Dt CT 4
 .Os
 .Sh NAME
 .Nm ct
-.Nd driver for synchronous Cronyx-Tau WAN adapters
+.Nd "WD33C93[ABC] based CBUS SCSI host adapter driver"
 .Sh SYNOPSIS
-.Cd "device ctau"
+.Cd "device ct"
+.Cd "device scbus"
+.Pp
+In
+.Pa /boot/device.hints:
+.Pp
+For most PC-9801-55, -92 and compatibles:
+.Cd hint.ct.0.at="isa"
+.Pp
+For ELECOM bus-master
+.Tn SCSI 
+adapters:
+.Cd hint.ct.0.at="isa"
+.Cd hint.ct.0.flags="0x30000"
 .Pp
-Additional options:
-.Cd "device sppp"
-.Cd "options NETGRAPH"
-.Cd "options NETGRAPH_CRONYX"
+For I-O DATA SC98 adapters:
+.Cd hint.ct.0.at="isa"
+.Cd hint.ct.0.flags="0x10000"
 .Pp
-In
-.Pa /boot/device.hints :
-.Cd hint.ctau.0.at="isa"
-.Cd hint.ctau.0.port="0x240"
-.Cd hint.ctau.0.irq="15"
-.Cd hint.ctau.0.drq="7"
-.Sh DESCRIPTION
-The
-.Nm
-driver needs either
-.Xr sppp 4
-or 
-.Xr netgraph 4 .
-Which one to use is determined by the NETGRAPH_CRONYX option.
-If this option is present in your kernel configuration file, the
-.Nm
-driver will be compiled with
-.Xr netgraph 4
-support.
-Otherwise, it will be compiled with
-.Xr sppp 4
-support.
+For LOGITEC adapters:
+.Cd hint.ct.0.at="isa"
+.Cd hint.ct.0.flags="0x50000"
 .Pp
-The base I/O port address specified in
-.Pa /boot/device.hints
-must match the port address set by the jumpers on the board.
-The DMA I/O channel and interrupt request numbers are configured
-by software at adapter initialization.
-Legal values are:
+For TEXA adapters:
+.Cd hint.ct.0.at="isa"
+.Cd hint.ct.0.flags="0x20000"
 .Pp
-.Bl -tag -compact -width Port:
-.It Port :
-0x200, 0x220, 0x240, 0x260, 0x280, 0x2a0, 0x2c0, 0x2e0,
-0x300, 0x320, 0x340, 0x360, 0x380, 0x3a0, 0x3c0, 0x3e0
-.It IRQ :
-3, 5, 7, 10, 11, 12, 15
-.It DMA :
-5, 6, 7
-.El
+For adapters with SMIT transfer mode to enable SMIT transfer:
+.Cd hint.ct.0.at="isa"
+.Cd hint.ct.0.flags="0x40000"
+.Cd hint.ct.0.maddr="0xdc000"
 .Pp
+.Ar Flag
+meaning:
+.Bl -tag -offset indent -compact -width 0x000000
+.It 0x00000
+DMA transfer mode for an NEC PC-9801-55, -92 (or 
+compatibles), ICM IF-2660, Midori-Denshi MDC-554NA, or 
+Logitec LHA-N151
+.It 0x10000
+DMA transfer mode for an I-O DATA SC-98II
+.It 0x20000
+bus-master transfer mode for a TEXA HA-55BS2, its 
+successors, or Midori-Denshi MDC-926R
+.It 0x30000
+bus-master transfer mode for an ELECOM bus-master SCSI 
+adapter
+.It 0x40000
+SMIT transfer mode (for supported adapters only)
+.It 0x50000
+bus-master transfer mode for a Logitec LHA-20x series, 
+ICM IF-2766, IF-2766ET, IF-2767 or IF-2769
+.Sh DESCRIPTION
 The
 .Nm
-driver supports autodetection.
-As for all non-PNP hardware, using
-autodetection could lead to some potential problems with other devices during
-the hardware detection process.
-It is always better to specify hardware resources manually.
+driver provides access to the 
+.Tn SCSI 
+bus connected to a WD33C93[ABC] based host adapter.
+The following adapters are supported:
 .Pp
-Refer to
-.Xr sconfig 8
-for information about the
-.Nm
-adapter configuration.
+.Bl -bullet -compact
+.It
+NEC PC-9801-55, 92 and compatibles, 
+.It
+ELECOM bus-master 
+.Tn SCSI 
+adapters, 
+.It
+I-O DATA SC-98II, 
+.It
+ICM IF-2660, IF-2766, IF-2766ET, IF-2767 and IF-2769, 
+.It
+Logitec LHA-N151 and LHA-20x series, 
+.It
+Midori-Denshi MDC-554NA and MDC-926R, 
+.It
+TEXA HA-55BS2 and its later models, and 
+.It
+SMIT transfer type 
+.Tn SCSI 
+host adapters.
+.El
 .Sh SEE ALSO
-.Xr cx 4 , 
-.Xr sppp 4 , 
-.Xr ifconfig 8 , 
-.Xr sconfig 8 , 
-.Xr spppcontrol 8
+.Xr cd 4 ,
+.Xr ch 4 ,
+.Xr ctau 4 ,
+.Xr da 4 ,
+.Xr intro 4 ,
+.Xr sa 4 ,
+.Xr scsi 4
+.Sh NOTES
+Historically, the driver for the Cronyx-Tau WAN adapters was
+ct.  This device name was changed to ctau to avoid conflicts
+with this pc98 ct driver.  The network device name for ctau
+is 'ct'.  Please see
+.Xr ctau 4
+for the details for that device.
 .Sh HISTORY
 The
 .Nm
-driver was added in
-.Fx 5.3 .
+device driver has been developed for NetBSD/pc98 and ported for
+.Fx .
+It first appeared in
+.Fx 4.4 .
+.Sh AUTHORS
 The
 .Nm
-driver for previous versions of
-.Fx
-is available from
-.Pa http://www.cronyx.ru/ .
+driver was written by
+.An Naofumi HONDA .
+.Pp
+This manual page was written by
+.An -nosplit
+.An Noriaki MITSUNAGA Aq non at FreeBSD.org 
+and
+.An Hideyuki KURASHINA Aq rushani at FreeBSD.org .