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
en/handbook/hw
chapter.sgml
en_US.ISO8859-1/books/handbook/hw
chapter.sgml
en_US.ISO_8859-1/books/handbook/hw
chapter.sgml

121
en/handbook/hw/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
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">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step>
</procedure>
</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
machine can have up to 4 host cards. The following host cards are supported:
<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><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></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>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>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>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem>
<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>
<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>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
<link linkend="kernelconfig-config">kernel configuration file</link>, changing
the numbers as appropriate:
<itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
supported.</para></listitem>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11
</programlisting></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>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and
11, 12 and 15 for SI/XIO ISA host cards.</para>
<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 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>
device si0
</programlisting></para>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
<para>After adding the configuration entry,
<link linkend="kernelconfig-building"> rebuild and install</link>
your new kernel.</para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>After rebooting with the new kernel, you need to make the
<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:
<para>To configure an EISA or PCI host card, use this line:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen>
<programlisting>
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
to add lines like this to <link linkend="dialup"> /etc/ttys</link>:
<programlisting>
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>
<para>After rebooting with the new kernel, you need to make the <link
linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
<filename>MAKEDEV</filename> script will take care of this for you.
Count how many total ports you have and type:</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>
</sect2>

121
en_US.ISO8859-1/books/handbook/hw/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
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">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step>
</procedure>
</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
machine can have up to 4 host cards. The following host cards are supported:
<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><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></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>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>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>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem>
<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>
<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>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
<link linkend="kernelconfig-config">kernel configuration file</link>, changing
the numbers as appropriate:
<itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
supported.</para></listitem>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11
</programlisting></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>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and
11, 12 and 15 for SI/XIO ISA host cards.</para>
<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 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>
device si0
</programlisting></para>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
<para>After adding the configuration entry,
<link linkend="kernelconfig-building"> rebuild and install</link>
your new kernel.</para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>After rebooting with the new kernel, you need to make the
<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:
<para>To configure an EISA or PCI host card, use this line:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen>
<programlisting>
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
to add lines like this to <link linkend="dialup"> /etc/ttys</link>:
<programlisting>
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>
<para>After rebooting with the new kernel, you need to make the <link
linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
<filename>MAKEDEV</filename> script will take care of this for you.
Count how many total ports you have and type:</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>
</sect2>

121
en_US.ISO_8859-1/books/handbook/hw/chapter.sgml
View file

@ -1,7 +1,7 @@
<!--
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">
@ -2843,83 +2843,90 @@ ttyc7 "/usr/libexec/getty std.38400" unknown on insecure</programlisting>
</step>
</procedure>
</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
machine can have up to 4 host cards. The following host cards are supported:
<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><emphasis>Contributed by &a.nsayer;. 25 March
1998.</emphasis></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>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>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>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</para></listitem>
<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>
<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>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
<link linkend="kernelconfig-config">kernel configuration file</link>, changing
the numbers as appropriate:
<itemizedlist>
<listitem><para>SI 4 or 8 port modules. Up to 57600 bps on each port
supported.</para></listitem>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11
</programlisting></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>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and
11, 12 and 15 for SI/XIO ISA host cards.</para>
<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 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>
device si0
</programlisting></para>
<programlisting>
device si0 at isa? tty iomem 0xd0000 irq 11</programlisting>
<para>After adding the configuration entry,
<link linkend="kernelconfig-building"> rebuild and install</link>
your new kernel.</para>
<para>Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards
and 11, 12 and 15 for SI/XIO ISA host cards.</para>
<para>After rebooting with the new kernel, you need to make the
<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:
<para>To configure an EISA or PCI host card, use this line:</para>
<screen>&prompt.root; <userinput>cd /dev</userinput>
&prompt.root; <userinput>./MAKEDEV ttyAnn cuaAnn</userinput></screen>
<programlisting>
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
to add lines like this to <link linkend="dialup"> /etc/ttys</link>:
<programlisting>
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>
<para>After rebooting with the new kernel, you need to make the <link
linkend="kernelconfig-nodes"> device nodes</link> in /dev. The
<filename>MAKEDEV</filename> script will take care of this for you.
Count how many total ports you have and type:</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>
</sect2>