Manpage for cz(4)

1 files changed, 129 insertions, 0 deletions

diff --git a/share/man/man4/cz.4 b/share/man/man4/cz.4
new file mode 100644
index 00000000000..1bc95d911e0
--- /dev/null
+++ b/share/man/man4/cz.4
@@ -0,0 +1,129 @@
+.\"	$OpenBSD: cz.4,v 1.1 2001/06/21 13:37:58 nate Exp $
+.\"	$NetBSD: cz.4,v 1.3 2001/06/12 14:46:11 wiz Exp $
+.\"
+.\" Copyright (c) 2000 Zembu Labs, Inc.
+.\" All rights reserved.
+.\"
+.\" Author: Jason R. Thorpe <thorpej@zembu.com>
+.\"
+.\" 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. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by Zembu Labs, Inc.
+.\" 4. Neither the name of Zembu Labs nor the names of its employees may
+.\"    be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY ZEMBU LABS, INC. ``AS IS'' AND ANY EXPRESS
+.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WAR-
+.\" RANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DIS-
+.\" CLAIMED.  IN NO EVENT SHALL ZEMBU LABS 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.
+.\"
+.Dd May 17, 2000
+.Dt CZ 4
+.Os
+.Sh NAME
+.Nm cz
+.Nd Cyclades-Z series multi-port serial adapter device driver
+.Sh SYNOPSIS
+.Cd "cz* at pci? dev ? function ?"
+.Sh DESCRIPTION
+The
+.Nm
+device driver supports the Cyclades-Z series of multi-port serial adapters.
+The Cyclades-Z is an intelligent serial controller comprising:
+.Bl -bullet -offset indent
+.It
+PLX9060ES PCI bus interface
+.It
+Xilinx XC5204 FPGA
+.It
+IDT R3052 MIPS CPU
+.El
+.Pp
+The MIPS CPU runs firmware provided by the device driver.  Communication
+with the MIPS is performed by modifying data structures located in board
+local RAM or host RAM.
+.Pp
+The Cyclades-Z comes in three basic flavors:
+.Bl -bullet -offset indent
+.It
+Cyclades-8Zo rev. 1 -- This is an older 8-port board with no FPGA.  The
+serial ports are provided by an octopus cable.
+.It
+Cyclades-8Zo rev. 2 -- This is the newer 8-port board.  The serial ports
+are provided by an octopus cable.
+.It
+Cyclades-Ze -- This is the expandable version of the Cyclades-Z.  It uses
+an HD-50 SCSI cable to connect the board to a 1U rack mountable serial
+expansion box.  Each box has 16 RJ45 serial ports, and up to 4 boxes may
+be chained together, for a total of 64 ports.  Boxes 3 and 4 require their
+own external power supply, otherwise the firmware will refuse to start
+(as it cannot communicate with the UARTs in those boxes).
+.El
+.Pp
+The Cyclades-Z has several features to improve performance under
+high serial I/O load:
+.Bl -bullet -offset indent
+.It
+The board may operate in interrupt-driven mode or polled mode to reduce
+interrupt load.
+.It
+Each channel has a large input and output buffer.
+.It
+Each channel may be programmed to generate an interrupt based on
+reception of a specific character, e.g. a PPP End-Of-Frame character.
+.It
+The MIPS CPU on the board performs all flow-control handling.
+.El
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/ttyZ?? -- dial-in (normal) TTY device
+.It Pa /dev/cuaZ?? -- dial-out TTY device
+.El
+.\" .Sh DIAGNOSTICS
+.\" XXX too be done.
+.Sh SEE ALSO
+.Xr pci 4 ,
+.Xr tty 4 ,
+.Xr termios 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 1.5 .
+.Sh BUGS
+The
+.Nm
+driver does not currently implement communication via host RAM.  While
+this may improve performance by reducing the number of PCI memory
+space read/write cycles, it is not straightforward to implement with
+the current
+.Xr bus_dma 9
+API.
+.Pp
+Interrupt mode has not been tested.
+.Pp
+There is no support for reading or writing the EEPROM connected to
+the PLX PCI bus controller.
+.Sh AUTHOR
+The
+.Nm
+driver was written by
+.An Jason R. Thorpe Aq thorpej@zembu.com
+and
+.An Bill Studenmund Aq wrstuden@zembu.com
+of Zembu Labs, Inc.