From b392d650412165fc86e7f10f790a11cc4abfc6e1 Mon Sep 17 00:00:00 2001
From: Alexander Langer <alex@FreeBSD.org>
Date: Fri, 7 Jun 1996 15:56:40 +0000
Subject: [PATCH] Add Cyclades configuration section.

---
 share/doc/handbook/Makefile      |  5 +--
 share/doc/handbook/cyclades.sgml | 57 ++++++++++++++++++++++++++++++++
 share/doc/handbook/dialup.sgml   |  4 +--
 share/doc/handbook/hw.sgml       |  3 +-
 share/doc/handbook/sections.sgml |  3 +-
 5 files changed, 66 insertions(+), 6 deletions(-)
 create mode 100644 share/doc/handbook/cyclades.sgml

diff --git a/share/doc/handbook/Makefile b/share/doc/handbook/Makefile
index fe4147c8232..9a2037827b3 100644
--- a/share/doc/handbook/Makefile
+++ b/share/doc/handbook/Makefile
@@ -1,7 +1,8 @@
-# $Id: Makefile,v 1.11 1996/05/01 20:10:46 phk Exp $
+# $Id: Makefile,v 1.12 1996/05/14 20:31:49 rich Exp $
 
 SRCS= authors.sgml basics.sgml bibliography.sgml boothelp.sgml
-SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml dialup.sgml
+SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml 
+SRCS+= cyclades.sgml dialup.sgml
 SRCS+= diskless.sgml dma.sgml eresources.sgml esdi.sgml 
 SRCS+= firewalls.sgml glossary.sgml goals.sgml
 SRCS+= handbook.sgml history.sgml hw.sgml install.sgml kerberos.sgml
diff --git a/share/doc/handbook/cyclades.sgml b/share/doc/handbook/cyclades.sgml
new file mode 100644
index 00000000000..728461e1005
--- /dev/null
+++ b/share/doc/handbook/cyclades.sgml
@@ -0,0 +1,57 @@
+<!-- $Id: cyclades.sgml,v 1.2 1996/03/26 23:22:03 mpp Exp $ -->
+<!-- The FreeBSD Documentation Project -->
+
+<!--
+<!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [
+
+<!ENTITY % authors SYSTEM "authors.sgml">
+%authors;
+
+]>
+-->
+<sect2><heading>Configuring the <tt>cy</tt> driver<label id="cy"></heading>
+
+	  <p><em>Contributed by &a.alex;.<newline>6 June 1996.</em>
+
+	    The Cyclades multiport cards are based on the <tt>cy</tt>
+	    driver instead of the usual <tt>sio</tt> driver used by
+	    other multiport cards.  Configuration is a simple matter
+	    of:
+
+	    <enum>
+	      <item>Add the <tt>cy</tt> device to your 
+		<ref id="kernelconfig:config" name="kernel configuration">
+		(note that your irq and iomem settings may differ).
+
+<tscreen><verb>
+device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
+</verb></tscreen>
+
+	      <item><ref id="kernelconfig:building" name="Rebuild and install"> 
+		the new kernel.
+
+	      <item>Make the <ref id="kernelconfig:nodes" name="device nodes">
+		by typing (the following example assumes an 8-port board):
+
+<tscreen><verb>
+# cd /dev
+# for i in 0 1 2 3 4 5 6 7;do ./MAKEDEV cuac$i ttyc$i;done
+</verb></tscreen>
+
+	      <item>If appropriate, add <ref id="dialup" name="dialup">
+		entries to <ref id="dialup:ttys" name="/etc/ttys"> by 
+		duplicating serial device (<tt>ttyd</tt>) entries and 
+		using <tt>ttyc</tt> in place of <tt>ttyd</tt>.  For
+		example:
+
+<tscreen><verb>
+ttyc0	"/usr/libexec/getty std.38400"	unknown	on insecure
+ttyc1	"/usr/libexec/getty std.38400"	unknown	on insecure
+ttyc2	"/usr/libexec/getty std.38400"	unknown	on insecure
+[...]
+ttyc7	"/usr/libexec/getty std.38400"	unknown	on insecure
+</verb></tscreen>
+
+	      <item>Reboot with the new kernel.
+
+	    </enum>
diff --git a/share/doc/handbook/dialup.sgml b/share/doc/handbook/dialup.sgml
index 207b5c1bff5..a876551b135 100644
--- a/share/doc/handbook/dialup.sgml
+++ b/share/doc/handbook/dialup.sgml
@@ -1,6 +1,6 @@
 <!-- This is an SGML document in the linuxdoc DTD of the Tutorial for
      Configuring a FreeBSD for Dialup Services by Guy Helmer.
-     $Id: dialup.sgml,v 1.9 1996/05/16 23:17:53 mpp Exp $
+     $Id: dialup.sgml,v 1.10 1996/05/24 19:33:31 jfieber Exp $
 
 <!DOCTYPE linuxdoc PUBLIC "-//Linux//DTD linuxdoc//EN">
 
@@ -474,7 +474,7 @@ If you have a slow CPU or a heavily loaded system and you dobnot have
 16550A-based serial ports, you may receive sio ``silo'' errors at 57.6
 Kbps.
 
-<sect2><heading>/etc/ttys</heading>
+<sect2><heading>/etc/ttys<label id="dialup:ttys"></heading>
 <p>
 
 <tt>/etc/ttys</tt> is the list of <tt/ttys/ for <tt/init/ to monitor.
diff --git a/share/doc/handbook/hw.sgml b/share/doc/handbook/hw.sgml
index 265b9c0397f..ae35f73628b 100644
--- a/share/doc/handbook/hw.sgml
+++ b/share/doc/handbook/hw.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: hw.sgml,v 1.24 1996/05/31 02:36:41 mpp Exp $ -->
+<!-- $Id: hw.sgml,v 1.25 1996/06/01 21:28:06 jkh Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <!-- 
@@ -279,6 +279,7 @@ Slippery when wet.  Beware of dog.
 
 	&uart;
 	&sio;
+	&cy;
 
 <sect1><heading>* Parallel ports</heading>
 <sect1><heading>* Modems</heading>
diff --git a/share/doc/handbook/sections.sgml b/share/doc/handbook/sections.sgml
index 1fe13a9d43c..34e579fef42 100644
--- a/share/doc/handbook/sections.sgml
+++ b/share/doc/handbook/sections.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: sections.sgml,v 1.11 1996/05/01 20:11:01 phk Exp $ -->
+<!-- $Id: sections.sgml,v 1.12 1996/05/14 20:31:53 rich Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <!-- Entities containing all the pieces of the handbook are -->
@@ -41,6 +41,7 @@
 <!ENTITY routing SYSTEM "routing.sgml">
 <!ENTITY scsi SYSTEM "scsi.sgml">
 <!ENTITY sio SYSTEM "sio.sgml">
+<!ENTITY cy SYSTEM "cyclades.sgml">
 <!ENTITY skey SYSTEM "skey.sgml">
 <!ENTITY slipc SYSTEM "slipc.sgml">
 <!ENTITY slips SYSTEM "slips.sgml">