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

Replace

Browse source 
<xref linkend="target" remap="foo">

with

    <link linkend="target">foo</link>

Internal links within the Handbook now do the right thing.
This commit is contained in:
Nik Clayton 1998-11-05 23:28:48 +00:00
parent 93f20f9382
commit 6ff34ef882
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=3751
58 changed files with 1372 additions and 1580 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -10,9 +10,9 @@
that FreeBSD supports, this section serves as a catalog of the device
drivers included with FreeBSD and the hardware each drivers supports.
Where possible and appropriate, notes about specific products are
included. You may also want to refer to <xref
linkend="kernelconfig-config"
remap="the kernel configuration file"> section in this handbook for
included. You may also want to refer to <link
linkend="kernelconfig-config">the kernel configuration
file</link> section in this handbook for
a list of supported devices.</para>
<para>As FreeBSD is a volunteer project without a funded testing
@ -21,7 +21,7 @@
that does or does not work with FreeBSD, please let us know by sending
e-mail to the &a.doc;. Questions about supported hardware should be
directed to the &a.questions; (see
<xref linkend="eresources-mail" remap="Mailing Lists"> for more
<link linkend="eresources-mail">Mailing Lists</link> for more
information). When submitting information or asking a question,
please remember to specify exactly what version of FreeBSD you are
using and include as many details of your hardware as possible.</para>
@ -297,7 +297,7 @@
Note that the Meteor frame grabber card <emphasis>will not
work</emphasis> with motherboards based on the 440FX chipset!
See the
<xref linkend="hw-mb" remap="motherboard reference"> section for
<link linkend="hw-mb">motherboard reference</link> section for
details. In such cases, it's better to go with a BT848 based
board.</para>
@ -655,8 +655,8 @@
<title>* Memory</title>
<para>The minimum amount of memory you must have to install FreeBSD
is 5 MB. Once your system is up and running you can <xref
linkend="kernelconfig-building" remap="build a custom kernel">
is 5 MB. Once your system is up and running you can <link
linkend="kernelconfig-building">build a custom kernel</link>
that will use less memory. If you use the <filename>boot4.flp</filename> you can get
away with having only 4 MB.</para>
@ -2695,8 +2695,8 @@ device sio11 at isa? port 0x138 tty flags 0xb05 irq 9 vector siointr<
it back in, and I suggest you do not either.</para>
<para>If you do not already have a custom kernel configuration
file set up, refer to <xref
linkend="kernelconfig" remap="Kernel Configuration"> for
file set up, refer to <link
linkend="kernelconfig">Kernel Configuration</link> for
general procedures. The following are the specifics for the
Boca 16 board and assume you are using the kernel name
MYKERNEL and editing with vi.</para>
@ -2854,8 +2854,8 @@ sio16: type 16550A (multiport master)</screen>
<procedure>
<step>
<para>Add the <devicename>cy</devicename> device to
your <xref linkend="kernelconfig-config"
remap="kernel configuration"> (note that your irq and
your <link linkend="kernelconfig-config">kernel
configuration</link> (note that your irq and
iomem settings may differ).</para>
<programlisting>
@ -2863,13 +2863,13 @@ device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr</programl
</step>
<step>
<para><xref linkend="kernelconfig-building" remap="Rebuild
and install"> the new kernel.</para>
<para><link linkend="kernelconfig-building">Rebuild
and install</link> the new kernel.</para>
</step>
<step>
<para>Make the <xref linkend="kernelconfig-nodes"
remap="device nodes"> by typing (the following example
<para>Make the <link linkend="kernelconfig-nodes">device
nodes</link> by typing (the following example
assumes an 8-port board):</para>
<informalexample>
@ -2879,9 +2879,8 @@ device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr</programl
</step>
<step>
<para>If appropriate, add <xref linkend="dialup"
remap="dialup"> entries to <xref linkend="dialup-ttys"
remap="/etc/ttys">
<para>If appropriate, add <link linkend="dialup">dialup</link>
entries to <link linkend="dialup-ttys">/etc/ttys</link>
by duplicating serial device (<literal>ttyd</literal>) entries and using <literal>ttyc</literal> in place of <literal>ttyd</literal>. For example:</para>
<programlisting>
@ -3414,9 +3413,8 @@ disk wd3 at wdc1 drive 1</programlisting>
more strict standard allowing devices from different vendors to
work together. This effort was recognized in the ANSI SCSI-1
standard. The SCSI-1 standard (approx 1985) is rapidly becoming
obsolete. The current standard is SCSI-2 (see <xref
linkend="scsi-further-reading"
remap="Further reading">), with SCSI-3 on the drawing
obsolete. The current standard is SCSI-2 (see <link
linkend="scsi-further-reading">Further reading</link>), with SCSI-3 on the drawing
boards.</para>
<para>In addition to a physical interconnection standard, SCSI
@ -3619,8 +3617,8 @@ disk wd3 at wdc1 drive 1</programlisting>
standard.</para>
<para>For connector pinning and connector types please refer to
the SCSI-2 standard (see <xref linkend="scsi-further-reading"
remap="Further reading">) itself, connectors etc
the SCSI-2 standard (see <link
linkend="scsi-further-reading">Further reading</link>) itself, connectors etc
are listed there in painstaking detail.</para>
<para>Beware of devices using non-standard cabling. For instance
@ -4559,13 +4557,13 @@ options "TUNE_1542" #dynamic tune of bus DMA speed</programli
<para><emphasis>Contributed by &a.asami;.<!-- <br> -->17 February
1998.</emphasis></para>
<para>As mentioned in the <xref linkend="scsi" remap="SCSI">
<para>As mentioned in the <link linkend="scsi">SCSI</link>
section, virtually all SCSI hard drives sold today are SCSI-2
compliant and thus will work fine as long as you connect them to
a supported SCSI host adapter. Most problems people encounter
are either due to badly designed cabling (cable too long, star
topology, etc.), insufficient termination, or defective parts.
Please refer to the <xref linkend="scsi" remap="SCSI">
Please refer to the <link linkend="scsi">SCSI</link>
section first if your SCSI hard drive is not working. However,
there are a couple of things you may want to take into account
before you purchase SCSI hard drives for your system.</para>
@ -4719,8 +4717,8 @@ options "TUNE_1542" #dynamic tune of bus DMA speed</programli
drives. The interfaces are SCSI, IDE, Floppy and Parallel Port.
A wide variety of tape drives are available for these
interfaces. Controllers are discussed in
<xref linkend="hw-storage-controllers" remap="Disk/tape
controllers"></para>
<link linkend="hw-storage-controllers">Disk/tape
controllers</link>.</para>
</sect3>
@ -4744,99 +4742,95 @@ options "TUNE_1542" #dynamic tune of bus DMA speed</programli
<sect4>
<title>4mm (DAT: Digital Audio Tape)</title>
<para><xref linkend="hw-storage-python" remap="Archive
Python"></para>
<para><link linkend="hw-storage-python">Archive
Python</link></para>
<para><xref linkend="hw-storage-hp1533a" remap="HP
C1533A"></para>
<para><link linkend="hw-storage-hp1533a">HP
C1533A</link></para>
<para><xref linkend="hw-storage-hp1534a" remap="HP
C1534A"></para>
<para><link linkend="hw-storage-hp1534a">HP
C1534A</link></para>
<para><xref linkend="hw-storage-hp35450a" remap="HP
35450A"></para>
<para><link linkend="hw-storage-hp35450a">HP
35450A</link></para>
<para><xref linkend="hw-storage-hp35470a" remap="HP
35470A"></para>
<para><link linkend="hw-storage-hp35470a">HP
35470A</link></para>
<para><xref linkend="hw-storage-hp35480a" remap="HP
35480A"></para>
<para><link linkend="hw-storage-hp35480a">HP
35480A</link></para>
<para><xref linkend="hw-storage-sdt5000"
remap="SDT-5000"></para>
<para><link linkend="hw-storage-sdt5000">SDT-5000</link></para>
<para><xref linkend="hw-storage-wangtek6200" remap="Wangtek
6200"></para>
<para><link linkend="hw-storage-wangtek6200">Wangtek
6200</link></para>
</sect4>
<sect4>
<title>8mm (Exabyte)</title>
<para><xref linkend="hw-storage-exb8200"
remap="EXB-8200"></para>
<para><link linkend="hw-storage-exb8200">EXB-8200</link></para>
<para><xref linkend="hw-storage-exb8500"
remap="EXB-8500"></para>
<para><link linkend="hw-storage-exb8500">EXB-8500</link></para>
<para><xref linkend="hw-storage-exb8505"
remap="EXB-8505"></para>
<para><link linkend="hw-storage-exb8505">EXB-8505</link></para>
</sect4>
<sect4>
<title>QIC (Quarter-Inch Cartridge)</title>
<para><xref linkend="hw-storage-anaconda" remap="Archive
Ananconda 2750"></para>
<para><link linkend="hw-storage-anaconda">Archive
Ananconda 2750</link></para>
<para><xref linkend="hw-storage-viper60" remap="Archive Viper
60"></para>
<para><link linkend="hw-storage-viper60">Archive Viper
60</link></para>
<para><xref linkend="hw-storage-viper150" remap="Archive Viper
150"></para>
<para><link linkend="hw-storage-viper150">Archive Viper
150</link></para>
<para><xref linkend="hw-storage-viper2525" remap="Archive Viper
2525"></para>
<para><link linkend="hw-storage-viper2525">Archive Viper
2525</link></para>
<para><xref linkend="hw-storage-tandberg3600" remap="Tandberg
TDC 3600"></para>
<para><link linkend="hw-storage-tandberg3600">Tandberg
TDC 3600</link></para>
<para><xref linkend="hw-storage-tandberg3620" remap="Tandberg
TDC 3620"></para>
<para><link linkend="hw-storage-tandberg3620">Tandberg
TDC 3620</link></para>
<para><xref linkend="hw-storage-tandberg4222" remap="Tandberg
TDC 4222"></para>
<para><link linkend="hw-storage-tandberg4222">Tandberg
TDC 4222</link></para>
<para><xref linkend="hw-storage-wangtek5525es" remap="Wangtek
5525ES"></para>
<para><link linkend="hw-storage-wangtek5525es">Wangtek
5525ES</link></para>
</sect4>
<sect4>
<title>DLT (Digital Linear Tape)</title>
<para><xref linkend="hw-storage-dectz87" remap="Digital
TZ87"></para>
<para><link linkend="hw-storage-dectz87">Digital
TZ87</link></para>
</sect4>
<sect4>
<title>Mini-Cartridge</title>
<para><xref linkend="hw-storage-ctms3200" remap="Conner CTMS
3200"></para>
<para><link linkend="hw-storage-ctms3200">Conner CTMS
3200</link></para>
<para><xref linkend="hw-storage-exb2501" remap="Exabyte
2501"></para>
<para><link linkend="hw-storage-exb2501">Exabyte
2501</link></para>
</sect4>
<sect4>
<title>Autoloaders/Changers</title>
<para><xref linkend="hw-storage-hp1553a" remap="Hewlett-Packard
HP C1553A Autoloading DDS2"></para>
<para><link linkend="hw-storage-hp1553a">Hewlett-Packard
HP C1553A Autoloading DDS2</link></para>
</sect4>
</sect3>
@ -4850,8 +4844,8 @@ options "TUNE_1542" #dynamic tune of bus DMA speed</programli
<sect3>
<title>Floppy drives</title>
<para><xref linkend="hw-storage-conner420r" remap="Conner
420R"></para>
<para><link linkend="hw-storage-conner420r">Conner
420R</link></para>
</sect3>
@ -4880,8 +4874,8 @@ options "TUNE_1542" #dynamic tune of bus DMA speed</programli
<para>Data transfer rate is 350kB/s using
<citerefentry><refentrytitle>dump</refentrytitle><manvolnum>8</manvolnum></citerefentry>. Rates of 530kB/s have been
reported when using <xref
linkend="hw-storage-amanda" remap="Amanda"></para>
reported when using <link
linkend="hw-storage-amanda">Amanda</link></para>
<para>Production of this drive has been discontinued.</para>
@ -5446,9 +5440,9 @@ scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting>
<para>Native capacity is 2GB when using 90m tapes. It cannot
handle 120m tapes. This drive supports hardware data
compression. Please refer to the section on <xref
linkend="hw-storage-hp1533a" remap="HP
C1533A"> for the proper switch settings.</para>
compression. Please refer to the section on <link
linkend="hw-storage-hp1533a">HP
C1533A</link> for the proper switch settings.</para>
<para>Data transfer rate is 183kB/s.</para>
@ -5533,8 +5527,8 @@ scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting>
<sect4 id="hw-storage-tandberg3620">
<title>Tandberg TDC 3620</title>
<para>This is very similar to the <xref
linkend="hw-storage-tandberg3600" remap="Tandberg TDC 3600">
<para>This is very similar to the <link
linkend="hw-storage-tandberg3600">Tandberg TDC 3600</link>
drive.</para>
<para>Reported by: &a.joerg;</para>
@ -5635,7 +5629,7 @@ scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting>
1997.</emphasis></para>
<para>As mentioned in
<xref linkend="hw-jordans-picks-cdrom" remap="Jordan's Picks">
<link linkend="hw-jordans-picks-cdrom">Jordan's Picks</link>
Generally speaking those in <emphasis>The FreeBSD
Project</emphasis> prefer SCSI CDROM drives over IDE CDROM
drives. However not all SCSI CDROM drives are equal. Some feel
@ -5648,9 +5642,9 @@ scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting>
<para>Another area where SCSI CDROM manufacturers are cutting
corners is adhearance to the
<xref linkend="scsi-further-reading" remap="SCSI specification">.
<link linkend="scsi-further-reading">SCSI specification</link>.
Many SCSI CDROMs will respond to
<xref linkend="scsi-rogue-devices" remap="multiple LUNs"> for its
<link linkend="scsi-rogue-devices">multiple LUNs</link> for its
target address. Known violators include the 6x Teac CD-56S
1.0D.</para>
@ -5757,9 +5751,9 @@ scsi -f $2 -s 100 -c "1b 0 0 $cdb3 $cdb4 $cdb5"</programlisting>
QIC drives are not quiet. These drives audibly seek before
they begin to record data and are clearly audible whenever
reading, writing or seeking. QIC tapes measure (6 x 4 x 0.7
inches; 15.2 x 10.2 x 1.7 mm). <xref
linkend="hw-storage-tapebackups-mini"
remap="Mini-cartridges">, which also use 1/4" wide tape are
inches; 15.2 x 10.2 x 1.7 mm). <link
linkend="hw-storage-tapebackups-mini">Mini-cartridges</link>,
which also use 1/4" wide tape are
discussed separately. Tape libraries and changers are not
available.</para>