os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

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

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

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

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

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