Fix up the white space damage from Nick Sayer's commit.

It's not technically required, but it keeps things looking nice, and much
easier to understand.  This is important if people are going to be able
to learn DocBook by looking at the Handbook.  It also makes it easier
to follow the structure if you don't have an SGML savvy editor.

I'm going to be *at least* as anal about this as bde is about style(9).
Sorry folks :-)
This commit is contained in:
Nik Clayton 1999-04-07 22:49:55 +00:00
parent c3e4204e90
commit c4914d21f7
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=4635
3 changed files with 225 additions and 204 deletions
en/handbook/hw
en_US.ISO8859-1/books/handbook/hw
en_US.ISO_8859-1/books/handbook/hw

View file

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project The FreeBSD Documentation Project
$Id: chapter.sgml,v 1.13 1999-04-07 20:45:45 nsayer Exp $ $Id: chapter.sgml,v 1.14 1999-04-07 22:49:55 nik Exp $
--> -->
<chapter id="hw"> <chapter id="hw">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step> </step>
</procedure> </procedure>
</sect3> </sect3>
<sect3><title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March 1998.</emphasis></para> <sect3>
<title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A
single machine can have up to 4 host cards. The following host cards
are supported:</para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A single
machine can have up to 4 host cards. The following host cards are supported:
<itemizedlist> <itemizedlist>
<listitem><para>ISA SI/XIO host card (2 versions)</para></listitem> <listitem><para>ISA SI/XIO host card (2 versions)</para></listitem>
<listitem><para>EISA SI/XIO host card</para></listitem> <listitem><para>EISA SI/XIO host card</para></listitem>
<listitem><para>PCI SI/XIO host card</para></listitem> <listitem><para>PCI SI/XIO host card</para></listitem>
<listitem><para>ISA SX host card</para></listitem> <listitem><para>ISA SX host card</para></listitem>
<listitem><para>PCI SX host card</para></listitem></itemizedlist></para> <listitem><para>PCI SX host card</para></listitem>
</itemizedlist>
<para>Although the SX and SI/XIO host cards look markedly different, their <para>Although the SX and SI/XIO host cards look markedly different,
functionality are basically the same. The host cards do not use I/O their functionality are basically the same. The host cards do not
locations, but instead require a 32K chunk of memory. The factory use I/O locations, but instead require a 32K chunk of memory. The
configuration for ISA cards places this at 0xd0000-0xd7fff. They factory configuration for ISA cards places this at 0xd0000-0xd7fff.
also require an IRQ. PCI cards will, of course, autoconfigure themselves.</para> They also require an IRQ. PCI cards will, of course, autoconfigure
themselves.</para>
<para>You can attach up to 4 external modules to each host card. The
external modules contain either 4 or 8 serial ports. They come in
the following varieties:</para>
<para>You can attach up to 4 external modules to each host card. The external
modules contain either 4 or 8 serial ports. They come in the following
varieties:
<itemizedlist> <itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem> <listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port supported. One supported.</para></listitem>
type of XIO module has 7 serial and 1 parallel port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port supported. Like
XIO, a module is available with one parallel port as well.</para></listitem>
</itemizedlist></para>
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port
supported. One type of XIO module has 7 serial and 1 parallel
port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port
supported. Like XIO, a module is available with one parallel
port as well.</para></listitem>
</itemizedlist>
<para>To configure an ISA host card, add the following line to your <para>To configure an ISA host card, add the following line to your
<link linkend="kernelconfig-config">kernel configuration file</link>, changing <link linkend="kernelconfig-config">kernel configuration
the numbers as appropriate: file</link>, changing the numbers as appropriate:</para>
<programlisting> <programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11 device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
</programlisting></para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and <para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
11, 12 and 15 for SI/XIO ISA host cards.</para> and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>To configure an EISA or PCI host card, use this line: <para>To configure an EISA or PCI host card, use this line:</para>
<programlisting> <programlisting>
device si0 device si0</programlisting>
</programlisting></para>
<para>After adding the configuration entry, <para>After adding the configuration entry, <link
<link linkend="kernelconfig-building"> rebuild and install</link> linkend="kernelconfig-building"> rebuild and install</link> your
your new kernel.</para> new kernel.</para>
<para>After rebooting with the new kernel, you need to make the <para>After rebooting with the new kernel, you need to make the <link
<link linkend="kernelconfig-nodes"> device nodes</link> linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
in /dev. The MAKEDEV script will take care of this for you. Count how many <filename>MAKEDEV</filename> script will take care of this for you.
total ports you have and type: Count how many total ports you have and type:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput> <screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen> &prompt.root; <userinput>./MAKEDEV ttyA<replaceable>nn</replaceable> cuaA<replaceable>nn</replaceable></userinput></screen>
(where nn is the number of ports)</para> <para>(where <replaceable>nn</replaceable> is the number of
ports)</para>
<para>If you want login prompts to appear on these ports, you will need <para>If you want login prompts to appear on these ports, you will
to add lines like this to <link linkend="dialup"> /etc/ttys</link>: need to add lines like this to <link
linkend="dialup"><filename>/etc/ttys</filename></link>:</para>
<programlisting> <programlisting>
ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure
</programlisting></para> </programlisting>
<para>Change the terminal type as approprate. For modems, <userinput>dialup</userinput> or
<userinput>unknown</userinput> is fine.</para>
<para>Change the terminal type as approprate. For modems,
<userinput>dialup</userinput> or <userinput>unknown</userinput> is
fine.</para>
</sect3> </sect3>
</sect2> </sect2>

View file

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project The FreeBSD Documentation Project
$Id: chapter.sgml,v 1.13 1999-04-07 20:45:45 nsayer Exp $ $Id: chapter.sgml,v 1.14 1999-04-07 22:49:55 nik Exp $
--> -->
<chapter id="hw"> <chapter id="hw">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step> </step>
</procedure> </procedure>
</sect3> </sect3>
<sect3><title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March 1998.</emphasis></para> <sect3>
<title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A
single machine can have up to 4 host cards. The following host cards
are supported:</para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A single
machine can have up to 4 host cards. The following host cards are supported:
<itemizedlist> <itemizedlist>
<listitem><para>ISA SI/XIO host card (2 versions)</para></listitem> <listitem><para>ISA SI/XIO host card (2 versions)</para></listitem>
<listitem><para>EISA SI/XIO host card</para></listitem> <listitem><para>EISA SI/XIO host card</para></listitem>
<listitem><para>PCI SI/XIO host card</para></listitem> <listitem><para>PCI SI/XIO host card</para></listitem>
<listitem><para>ISA SX host card</para></listitem> <listitem><para>ISA SX host card</para></listitem>
<listitem><para>PCI SX host card</para></listitem></itemizedlist></para> <listitem><para>PCI SX host card</para></listitem>
</itemizedlist>
<para>Although the SX and SI/XIO host cards look markedly different, their <para>Although the SX and SI/XIO host cards look markedly different,
functionality are basically the same. The host cards do not use I/O their functionality are basically the same. The host cards do not
locations, but instead require a 32K chunk of memory. The factory use I/O locations, but instead require a 32K chunk of memory. The
configuration for ISA cards places this at 0xd0000-0xd7fff. They factory configuration for ISA cards places this at 0xd0000-0xd7fff.
also require an IRQ. PCI cards will, of course, autoconfigure themselves.</para> They also require an IRQ. PCI cards will, of course, autoconfigure
themselves.</para>
<para>You can attach up to 4 external modules to each host card. The
external modules contain either 4 or 8 serial ports. They come in
the following varieties:</para>
<para>You can attach up to 4 external modules to each host card. The external
modules contain either 4 or 8 serial ports. They come in the following
varieties:
<itemizedlist> <itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem> <listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port supported. One supported.</para></listitem>
type of XIO module has 7 serial and 1 parallel port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port supported. Like
XIO, a module is available with one parallel port as well.</para></listitem>
</itemizedlist></para>
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port
supported. One type of XIO module has 7 serial and 1 parallel
port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port
supported. Like XIO, a module is available with one parallel
port as well.</para></listitem>
</itemizedlist>
<para>To configure an ISA host card, add the following line to your <para>To configure an ISA host card, add the following line to your
<link linkend="kernelconfig-config">kernel configuration file</link>, changing <link linkend="kernelconfig-config">kernel configuration
the numbers as appropriate: file</link>, changing the numbers as appropriate:</para>
<programlisting> <programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11 device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
</programlisting></para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and <para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
11, 12 and 15 for SI/XIO ISA host cards.</para> and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>To configure an EISA or PCI host card, use this line: <para>To configure an EISA or PCI host card, use this line:</para>
<programlisting> <programlisting>
device si0 device si0</programlisting>
</programlisting></para>
<para>After adding the configuration entry, <para>After adding the configuration entry, <link
<link linkend="kernelconfig-building"> rebuild and install</link> linkend="kernelconfig-building"> rebuild and install</link> your
your new kernel.</para> new kernel.</para>
<para>After rebooting with the new kernel, you need to make the <para>After rebooting with the new kernel, you need to make the <link
<link linkend="kernelconfig-nodes"> device nodes</link> linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
in /dev. The MAKEDEV script will take care of this for you. Count how many <filename>MAKEDEV</filename> script will take care of this for you.
total ports you have and type: Count how many total ports you have and type:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput> <screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen> &prompt.root; <userinput>./MAKEDEV ttyA<replaceable>nn</replaceable> cuaA<replaceable>nn</replaceable></userinput></screen>
(where nn is the number of ports)</para> <para>(where <replaceable>nn</replaceable> is the number of
ports)</para>
<para>If you want login prompts to appear on these ports, you will need <para>If you want login prompts to appear on these ports, you will
to add lines like this to <link linkend="dialup"> /etc/ttys</link>: need to add lines like this to <link
linkend="dialup"><filename>/etc/ttys</filename></link>:</para>
<programlisting> <programlisting>
ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure
</programlisting></para> </programlisting>
<para>Change the terminal type as approprate. For modems, <userinput>dialup</userinput> or
<userinput>unknown</userinput> is fine.</para>
<para>Change the terminal type as approprate. For modems,
<userinput>dialup</userinput> or <userinput>unknown</userinput> is
fine.</para>
</sect3> </sect3>
</sect2> </sect2>

View file

@ -1,7 +1,7 @@
<!-- <!--
The FreeBSD Documentation Project The FreeBSD Documentation Project
$Id: chapter.sgml,v 1.13 1999-04-07 20:45:45 nsayer Exp $ $Id: chapter.sgml,v 1.14 1999-04-07 22:49:55 nik Exp $
--> -->
<chapter id="hw"> <chapter id="hw">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step> </step>
</procedure> </procedure>
</sect3> </sect3>
<sect3><title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March 1998.</emphasis></para> <sect3>
<title>Configuring the <devicename>si</devicename> driver</title>
<para><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A
single machine can have up to 4 host cards. The following host cards
are supported:</para>
<para>The Specialix SI/XIO and SX multiport cards use the si driver. A single
machine can have up to 4 host cards. The following host cards are supported:
<itemizedlist> <itemizedlist>
<listitem><para>ISA SI/XIO host card (2 versions)</para></listitem> <listitem><para>ISA SI/XIO host card (2 versions)</para></listitem>
<listitem><para>EISA SI/XIO host card</para></listitem> <listitem><para>EISA SI/XIO host card</para></listitem>
<listitem><para>PCI SI/XIO host card</para></listitem> <listitem><para>PCI SI/XIO host card</para></listitem>
<listitem><para>ISA SX host card</para></listitem> <listitem><para>ISA SX host card</para></listitem>
<listitem><para>PCI SX host card</para></listitem></itemizedlist></para> <listitem><para>PCI SX host card</para></listitem>
</itemizedlist>
<para>Although the SX and SI/XIO host cards look markedly different, their <para>Although the SX and SI/XIO host cards look markedly different,
functionality are basically the same. The host cards do not use I/O their functionality are basically the same. The host cards do not
locations, but instead require a 32K chunk of memory. The factory use I/O locations, but instead require a 32K chunk of memory. The
configuration for ISA cards places this at 0xd0000-0xd7fff. They factory configuration for ISA cards places this at 0xd0000-0xd7fff.
also require an IRQ. PCI cards will, of course, autoconfigure themselves.</para> They also require an IRQ. PCI cards will, of course, autoconfigure
themselves.</para>
<para>You can attach up to 4 external modules to each host card. The
external modules contain either 4 or 8 serial ports. They come in
the following varieties:</para>
<para>You can attach up to 4 external modules to each host card. The external
modules contain either 4 or 8 serial ports. They come in the following
varieties:
<itemizedlist> <itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem> <listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port supported. One supported.</para></listitem>
type of XIO module has 7 serial and 1 parallel port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port supported. Like
XIO, a module is available with one parallel port as well.</para></listitem>
</itemizedlist></para>
<listitem><para>XIO 8 port modules. Up to 115200 bps on each port
supported. One type of XIO module has 7 serial and 1 parallel
port.</para></listitem>
<listitem><para>SXDC 8 port modules. Up to 921600 bps on each port
supported. Like XIO, a module is available with one parallel
port as well.</para></listitem>
</itemizedlist>
<para>To configure an ISA host card, add the following line to your <para>To configure an ISA host card, add the following line to your
<link linkend="kernelconfig-config">kernel configuration file</link>, changing <link linkend="kernelconfig-config">kernel configuration
the numbers as appropriate: file</link>, changing the numbers as appropriate:</para>
<programlisting> <programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11 device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
</programlisting></para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and <para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
11, 12 and 15 for SI/XIO ISA host cards.</para> and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>To configure an EISA or PCI host card, use this line: <para>To configure an EISA or PCI host card, use this line:</para>
<programlisting> <programlisting>
device si0 device si0</programlisting>
</programlisting></para>
<para>After adding the configuration entry, <para>After adding the configuration entry, <link
<link linkend="kernelconfig-building"> rebuild and install</link> linkend="kernelconfig-building"> rebuild and install</link> your
your new kernel.</para> new kernel.</para>
<para>After rebooting with the new kernel, you need to make the <para>After rebooting with the new kernel, you need to make the <link
<link linkend="kernelconfig-nodes"> device nodes</link> linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
in /dev. The MAKEDEV script will take care of this for you. Count how many <filename>MAKEDEV</filename> script will take care of this for you.
total ports you have and type: Count how many total ports you have and type:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput> <screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen> &prompt.root; <userinput>./MAKEDEV ttyA<replaceable>nn</replaceable> cuaA<replaceable>nn</replaceable></userinput></screen>
(where nn is the number of ports)</para> <para>(where <replaceable>nn</replaceable> is the number of
ports)</para>
<para>If you want login prompts to appear on these ports, you will need <para>If you want login prompts to appear on these ports, you will
to add lines like this to <link linkend="dialup"> /etc/ttys</link>: need to add lines like this to <link
linkend="dialup"><filename>/etc/ttys</filename></link>:</para>
<programlisting> <programlisting>
ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure ttyA01 "/usr/libexec/getty std.9600" vt100 on insecure
</programlisting></para> </programlisting>
<para>Change the terminal type as approprate. For modems, <userinput>dialup</userinput> or
<userinput>unknown</userinput> is fine.</para>
<para>Change the terminal type as approprate. For modems,
<userinput>dialup</userinput> or <userinput>unknown</userinput> is
fine.</para>
</sect3> </sect3>
</sect2> </sect2>