Correct opposing CTS/RTS explanations. Use <quote> in markup. TLDP PDF is now good, so remove instructions for rendering PostScript to PDF. Typo in GRUB configuration.

This commit is contained in:
gdt 2003-03-31 00:58:03 +00:00
parent e607922fe2
commit 5769308c5b
1 changed files with 103 additions and 109 deletions

View File

@ -5,7 +5,7 @@
<title>Remote Serial Console HOWTO</title>
<pubdate>v2.5 2003-01-20</pubdate>
<pubdate>v2.6 2003-03-31</pubdate>
<authorgroup>
<author>
@ -29,12 +29,22 @@
<revhistory>
<revision>
<revnumber>2.6</revnumber>
<date>2003-03-31</date>
<authorinitials>gdt</authorinitials>
<revremark>Correct opposing CTS/RTS explanations. Use
&lt;quote&gt; in markup. TLDP PDF is now good, so remove
instructions for rendering PostScript to PDF. Typo in GRUB
configuration.</revremark>
</revision>
<revision>
<revnumber>2.5</revnumber>
<date>2003-01-20</date>
<authorinitials>gdt</authorinitials> <revremark>Only one console
per technology type. Setting timezone. Use off parameter rather
than comments in inittab. Cable lengths.</revremark>
<authorinitials>gdt</authorinitials>
<revremark>Only one console per technology type. Setting
timezone. Use off parameter rather than comments in inittab. Cable
lengths.</revremark>
</revision>
<revision>
<revnumber>2.4</revnumber>
@ -119,8 +129,8 @@
<epigraph id="intro-skb">
<para><wordasword>console</wordasword> <abbrev>n.</abbrev> [From
latin <foreignphrase>consolatio(n)</foreignphrase> &ldquo;comfort,
spiritual solace.&rdquo;] A device for displaying or printing
latin <foreignphrase>consolatio(n)</foreignphrase> <quote>comfort,
spiritual solace.</quote>] A device for displaying or printing
condolances or obituaries for the operator.</para>
<para>Stan Kelly-Bootle, <citetitle>The Computer
@ -335,14 +345,14 @@
<section id="intro-word">
<title>Alternative meanings of &lsquo;console&rsquo;</title>
<title>Alternative meanings of <quote>console</quote></title>
<para>Some authors use the word &lsquo;console&rsquo; to refer to
<para>Some authors use the word <quote>console</quote> to refer to
the keyboard and monitor that are attached to the system unit.
This is described as a &lsquo;physical console&rsquo; by some
This is described as a <quote>physical console</quote> by some
<systemitem class="osname">Linux</systemitem> documentation. The
console where system messages appear is described as the
&lsquo;logical console&rsquo; by that documentation.</para>
<quote>logical console</quote> by that documentation.</para>
<para>As an illustration of the difference, <productname>X
Windows</productname> should start on the physical console but
@ -351,10 +361,10 @@
console.</para>
<para>To avoid confusion this <citetitle>HOWTO</citetitle> uses the
word &lsquo;console&rsquo; to describe the place where system
word <quote>console</quote> to describe the place where system
messages are printed. This <citetitle>HOWTO</citetitle> uses the
phrase &ldquo;attached monitor and keyboard&rdquo; rather than the
confusing words &ldquo;physical console&rdquo;.</para>
phrase <quote>attached monitor and keyboard</quote> rather than the
confusing words <quote>physical console</quote>.</para>
<para>These distinctions are also made in the naming of devices.
The device <filename class="devicefile">/dev/console</filename> is
@ -364,7 +374,7 @@
class="devicefile">/dev/tty0</filename>.</para>
<table frame="topbot" colsep="0" rowsep="0" id="intro-word-console">
<title>Different ways of referring to the &lsquo;console&rsquo;</title>
<title>Different ways of referring to the <quote>console</quote></title>
<tgroup cols="3">
<thead>
<row>
@ -691,9 +701,9 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
<citetitle><acronym>ANSI/TIA/EIA-232-F-1997</acronym> Interface
Between Data Terminal Equipment and Data Circuit-Terminating
Equipment Employing Serial Data Interchange</citetitle>. For an
explanation of &lsquo;bits per second&rsquo;, &lsquo;start
bits&rsquo;, &lsquo;data bits&rsquo;, &lsquo;parity&rsquo;,
&lsquo;stop bits&rsquo; and &lsquo;flow control&rsquo; refer to the
explanation of <quote>bits per second</quote>, <quote>start
bits</quote>, <quote>data bits</quote>, <quote>parity</quote>,
<quote>stop bits</quote> and <quote>flow control</quote> refer to the
<ulink
url="http://www.tldp.org/HOWTO/Serial-HOWTO.html"><citetitle>Serial-HOWTO</citetitle></ulink>
and the <ulink
@ -1020,7 +1030,7 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
<para>Configure the terminal to match the serial parameters. The
data bits, parity bits and stop bits must match. If a modern
&lsquo;smart&rsquo; modem is used then the bit speeds need not
<quote>smart</quote> modem is used then the bit speeds need not
match. If a dumb modem or a null modem cable is used then the bit
speeds must match.</para>
@ -1030,9 +1040,9 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
Your equipment may call
<acronym>CTS</acronym>/<acronym>RTS</acronym> handshaking or
<acronym>DTR</acronym>/<acronym>DSR</acronym> handshaking
&lsquo;hardware handshaking&rsquo; and may call
<quote>hardware handshaking</quote> and may call
<acronym>XON</acronym>/<acronym>XOFF</acronym> handshaking
&lsquo;software handshaking&rsquo;.</para>
<quote>software handshaking</quote>.</para>
<para>Set automatic line wrapping on. This allows all of a long
console message to be read.</para>
@ -1090,11 +1100,11 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
<listitem>
<para>The <acronym>BIOS</acronym> takes the interrupt 0x10
&ldquo;video&rdquo; requests used to write to the screen and
<quote>video</quote> requests used to write to the screen and
sends the characters that would have appeared on the screen to
the serial port. Characters recieved from the serial port are
used to supply characters to <acronym>BIOS</acronym> interrupt
0x16 &ldquo;read key&rdquo; requests.</para>
0x16 <quote>read key</quote> requests.</para>
<para>Any 16-bit application which uses the
<acronym>BIOS</acronym> functions for outputing text to the
@ -1146,8 +1156,8 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
<listitem>
<para>These <acronym>BIOS</acronym>s use the serial port for
configuration and the power-on self-test, but do not redirect the
interrupt 0x10 &ldquo;video&rdquo; requests interrupt 0x16
&ldquo;read key&rdquo; requests to the serial port.</para>
interrupt 0x10 <quote>video</quote> requests interrupt 0x16
<quote>read key</quote> requests to the serial port.</para>
<para>Some <acronym>BIOS</acronym>s which usually redirect all
keyboard and video output to the serial port can be configured in
@ -1261,8 +1271,8 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
disk.<footnote>
<para>As usual with <productname><acronym>IBM
PC/AT</acronym></productname> hardware &ldquo;loads a boot loader
from the <acronym>MBR</acronym> of the first hard disk&rdquo; is a
PC/AT</acronym></productname> hardware <quote>loads a boot loader
from the <acronym>MBR</acronym> of the first hard disk</quote> is a
simplification. <acronym>BIOS</acronym> settings permitting, the
<acronym>MBR</acronym> can be loaded from the first two detected
hard disks of any controller card containing a
@ -1343,7 +1353,7 @@ setserial /dev/ttyS2 uart none port 0x0 irq 0
<application>SYSLINUX</application>. Equivalents to
<application>LILO</application> exist for other processor
architectures, their names are usually some play upon
&lsquo;LILO&rsquo;.</para>
<quote>LILO</quote>.</para>
<para><application>LILO</application> is documented in the
<citetitle>lilo(8)</citetitle> and
@ -1736,8 +1746,8 @@ title Red Hat Linux (2.4.9-21) single user mode
linkend="configure-boot-loader-syslinux-flowcontrol">.</para>
<para>The behaviours for a correctly-wired null-modem cable or a
correctly configured modem are marked &ldquo;Required for full
<acronym>RS-232</acronym> compliance&rdquo; in the table. The sum
correctly configured modem are marked <quote>Required for full
<acronym>RS-232</acronym> compliance</quote> in the table. The sum
of these values is <literal>0xab3</literal>.</para>
<table frame="topbot" colsep="0" rowsep="0" id="configure-boot-loader-syslinux-flowcontrol">
@ -1926,7 +1936,7 @@ serial 0 9600</programlisting>
parameter <literal>console=tty0</literal>.</para>
<para>For computers with both a video card and a serial console in
the port marked &lsquo;<acronym>COM1:</acronym>&rsquo; this
the port marked <quote><acronym>COM1:</acronym></quote> this
<citetitle>HOWTO</citetitle> suggests the kernel parameters:</para>
<figure id="configure-kernel-parameters-video">
@ -2118,7 +2128,7 @@ root (hd0,0)
default=0
timeout=10
password --md5 $1$wwmIq64O$2vofKBDL9vZKeJyaKwIeT.
serial --unit=0 --speed=9600 -word=8 --parity=no --stop=1
serial --unit=0 --speed=9600 --word=8 --parity=no --stop=1
terminal --timeout=10 serial console
title Red Hat Linux (2.4.9-21)
root (hd0,0)
@ -2416,8 +2426,8 @@ CON9600# B9600 CS8 -PARENB -ISTRIP CRTSCTS HUPCL # B9600 SANE CS8 -PARENB -ISTRI
<section id="getty-agetty">
<title><productname>agetty</productname></title>
<para><application>agetty</application> is an &ldquo;alternative
getty&rdquo;. It takes all of its parameters on the command line,
<para><application>agetty</application> is an <quote>alternative
getty</quote>. It takes all of its parameters on the command line,
with no use of <filename>/etc/gettydefs</filename> or any other
configuration file. <application>agetty</application> is
documented in the manual page
@ -3315,7 +3325,7 @@ isig icanon -iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt
unauthorized people.</para>
<para>The resurgence of the <acronym>BBS</acronym>-era technique of
&lsquo;war dialling&rsquo; is described in @Stake's <ulink
<quote>war dialling</quote> is described in @Stake's <ulink
url="http://www.atstake.com/research/reports/acrobat/wardialling_brief.pdf"><citetitle>Wardialling
Brief</citetitle></ulink> and reported upon by <citetitle>The
Register</citetitle>, see an extract in <xref
@ -3340,11 +3350,11 @@ isig icanon -iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt
numbers associated with corporate modems through testing each
extension of a corporate phone system in turn.</para>
<para>&ldquo;Intrusion detection systems are no real deterrent for
me because I get in through the back door,&rdquo; he
said. &ldquo;Many networks are constructed like Baked Alaska
<para><quote>Intrusion detection systems are no real deterrent for
me because I get in through the back door,</quote> he
said. <quote>Many networks are constructed like Baked Alaska
&mdash; crunchy on the outside and soft in the
middle.&rdquo;</para>
middle.</quote></para>
<para>KP often takes advantage of weak or default passwords to
break into networks&hellip;</para>
@ -3359,16 +3369,16 @@ isig icanon -iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt
confidential information over the phone), against telco
suppliers.</para>
<para>&ldquo;Hackers don't like talking to people - remember we're
socially inadequate,&rdquo; he joked.</para>
<para><quote>Hackers don't like talking to people - remember we're
socially inadequate,</quote> he joked.</para>
<para>In response to customer demand, security testing specialists
NTA Monitor this week launched a service to test against war
dialling vulnerability.</para>
<para>&ldquo;This isn't particularly sexy,&rdquo; said NTA
Monitor's technical director Roy Hills. &ldquo;But we're seeing
high demand for this low-tech service.&rdquo;</para>
<para><quote>This isn't particularly sexy,</quote> said NTA
Monitor's technical director Roy Hills. <quote>But we're seeing
high demand for this low-tech service.</quote></para>
<para>The issue of war dialling and insecure modem connections was
highlighted last month when BT inadvertently published the private
@ -3409,8 +3419,8 @@ John Leyden, <ulink url="http://www.theregister.co.uk/content/55/25044.html"><ci
<para>Guessing a user's password is only slightly less severe, as a
hacker can obtain <systemitem class="username">root</systemitem>
access simply by waiting. The hacker waits for a &lsquo;local
exploit&rsquo; for a flaw in the operating system to appear and
access simply by waiting. The hacker waits for a <quote>local
exploit</quote> for a flaw in the operating system to appear and
uses that exploit before the machine is patched.</para>
<para>Severely limit the number of users on the machine. Ensure
@ -3495,7 +3505,7 @@ John Leyden, <ulink url="http://www.theregister.co.uk/content/55/25044.html"><ci
<para>Unfortunately, if the modem sees <literal>+++</literal>
during a call it may revert to command mode. The modem can then be
configured by the caller. For example, the modem could be set to
permit incoming calls only from the number &lsquo;0&rsquo;, this
permit incoming calls only from the number <quote>0</quote>, this
would deny the system administrators access to the modem.</para>
<para>The attention command can be removed using <command>AT
@ -3509,7 +3519,7 @@ John Leyden, <ulink url="http://www.theregister.co.uk/content/55/25044.html"><ci
could disable the modem.</para>
<para>The best solution is to select a modem that has a
&lsquo;dumb&rsquo; or &ldquo;select profile&rdquo;
<quote>dumb</quote> or <quote>select profile</quote>
<acronym>DIP</acronym> switch or jumper. These switches disable
command mode and load the modem's saved configuration when they
start.</para>
@ -3765,7 +3775,7 @@ endif
<para>Many telephone services or <acronym>PBX</acronym> lines can
be set to allow only incoming calls. This is useful as it prevents
misuse of the modem should the computer be compromised. A
&lsquo;demon dialler&rsquo; can call many numbers seeking an
<quote>demon dialler</quote> can call many numbers seeking an
answering modem and the cost of these calls can be
significant.</para>
@ -3776,16 +3786,16 @@ endif
<title><acronym>BIOS</acronym> features</title>
<para>Most <acronym>BIOS</acronym>s can be configured with a
&lsquo;configuration password&rsquo;. This should set and tested.
<quote>configuration password</quote>. This should set and tested.
Some motherboards will require a jumper to be set to allow the
password to take effect. Some <acronym>BIOS</acronym>s have
well-known &lsquo;master passwords&rsquo;, use a search engine to
well-known <quote>master passwords</quote>, use a search engine to
ensure that your <acronym>BIOS</acronym> is not one of these. The
password should not be the same as the boot loader or <systemitem
class="username">root</systemitem> passwords.</para>
<para>The <acronym>BIOS</acronym> configuration will have a
&lsquo;boot order&rsquo; setting. It should be set to boot from
<quote>boot order</quote> setting. It should be set to boot from
the hard disk before any other media. This prevents someone
inserting a rescue diskette, booting the machine, and gaining
access to the filesystems as <systemitem
@ -3817,7 +3827,7 @@ endif
<title>Non-interactive boot sequence</title>
<para><productname>Red Hat Linux</productname> has an
&lsquo;interactive boot&rsquo; option that can be used to prevent
<quote>interactive boot</quote> option that can be used to prevent
services from being started. This may not be pleasant if the
purpose of the machine is web serving and the
<acronym>HTTP</acronym> daemon is interactively prevented from
@ -3837,7 +3847,7 @@ PROMPT=no</programlisting>
<section id="security-sysrq">
<title>Magic <keycap>SysRq</keycap> key</title>
<para>The &lsquo;magic <keycap>SysRq</keycap> key&rsquo; is a key
<para>The <quote>magic <keycap>SysRq</keycap> key</quote> is a key
sequence that allows some basic commands to be passed directly to
the kernel. Kernel software developers use this interface to debug
their software. Under most circumstances it can also be used to
@ -3851,8 +3861,8 @@ PROMPT=no</programlisting>
must be in an area with access limited to trusted people.</para>
<para>The serial console uses the <acronym>RS-232</acronym> break
function as the &lsquo;magic <keycap>SysRq</keycap> key&rsquo;. A
&lsquo;break&rsquo; is a period of no transmission on the serial
function as the <quote>magic <keycap>SysRq</keycap> key</quote>. A
<quote>break</quote> is a period of no transmission on the serial
line, on traditional terminals it is activated by pressing a key
labeled <keycap>Break</keycap>.</para>
@ -4378,7 +4388,7 @@ serial_echo_outb(0x0c, UART_DLL);</programlisting>
<para>The <acronym>RS-232</acronym> standard allows for, but does
not specify, the interconnection of two computers without
intervening modems. A special cable is required, called a
&lsquo;null modem&rsquo; cable.</para>
<quote>null modem</quote> cable.</para>
<para>The wiring within the null modem cable depends upon the
handshaking and control signals that are needed. Differing
@ -4579,10 +4589,10 @@ Transmit data ---------------------- Receive data</programlisting>
<citetitle><acronym>ANSI/TIA/EIA-568-A</acronym></citetitle>
unshielded twisted pair category 5 cable has a maximum capacitiance
of 55<acronym>pF</acronym> per metre, so this popular
&ldquo;<acronym>UTP</acronym> cat 5&rdquo; cable can be safely
<quote><acronym>UTP</acronym> cat 5</quote> cable can be safely
driven up to 45m. Beyond that you should check the cable
manufacturers specifications for the actual &ldquo;shunt
capacitance&rdquo; (a common figure is 47.5
manufacturers specifications for the actual <quote>shunt
capacitance</quote> (a common figure is 47.5
<acronym>pF/m</acronym>, giving a maximum cable length of about
50<acronym>m</acronym>). However long runs of unshielded cable
will pick up noise easily, as the <acronym>RS-232</acronym> signals
@ -4853,9 +4863,9 @@ Press CTRL-A Z for help on special keys</screen>
<para>Whilst the user is logged in and data is flowing, Clear to
Send and Ready to Send are used between the modem and the computer
to prevent data being sent too soon. The computer lowers Clear to
to prevent data being sent too soon. The computer lowers Ready to
Send when it is too busy to receive a character. The modem lowers
Ready to Send when it is too busy to receive a character.</para>
Clear to Send when it is too busy to receive a character.</para>
<para>When the user hangs up, Data Carrier Detect falls and the
hang up signal is sent to all processes associated with the dial in
@ -5001,7 +5011,7 @@ Press CTRL-A Z for help on special keys
<screen format="linespecific"><computeroutput>CONNECT 9600</computeroutput></screen>
</informalfigure>
<para>The modem has a &lsquo;quiet mode&rsquo; that disables these
<para>The modem has a <quote>quiet mode</quote> that disables these
messages.</para>
<para>The <acronym>AT</acronym> command is
@ -5188,7 +5198,7 @@ OK
wonder if the hardware duplication of an external modem is
necessary.</para>
<para>A &lsquo;WinModem&rsquo; incorporates the
<para>A <quote>WinModem</quote> incorporates the
<acronym>CPU</acronym> and <acronym>DSP</acronym> of the modem into
the slightly-enhanced fabric of a <acronym>PC</acronym>. They are
called "WinModems" because they originally only shipped with
@ -5200,7 +5210,7 @@ OK
versions of these drivers where available. Some manufacturers now
provide <systemitem class="osname">Linux</systemitem> versions of
their device drivers as well, these modems are jokingly called
&lsquo;LinModems&rsquo;.</para>
<quote>LinModems</quote>.</para>
<para>It is probably possible to use a LinModem as a <systemitem
class="osname">Linux</systemitem> console. At the most this would
@ -5677,7 +5687,7 @@ KLOGD_OPTIONS="-2 -c 1"</programlisting>
<para><command>cat</command> is available on every
<acronym>UNIX</acronym>-like system. It copies the data received
from the keyboard to a file. Minicom and other terminal emulators
have an &lsquo;<acronym>ASCII</acronym> upload&rsquo; facility that
have an <quote><acronym>ASCII</acronym> upload</quote> facility that
will send a file up the serial link as though it had been
typed.</para>
@ -5924,7 +5934,7 @@ Bytes Sent: 3072/ 10000 BPS:2185 ETA 00:09</guilabel>
<listitem>
<para>Someone can insert a floppy disk before the upgrade and
remove it afterwards. Most co-location sites will provide this
level of &lsquo;board-swap&rsquo; technical support.</para>
level of <quote>board-swap</quote> technical support.</para>
</listitem>
<listitem>
@ -5953,7 +5963,7 @@ Bytes Sent: 3072/ 10000 BPS:2185 ETA 00:09</guilabel>
<para>Refer to your vendor's documentation to set the
<acronym>BIOS</acronym> to use the serial port. Some vendors call
this feature &lsquo;console redirection&rsquo;. Unfortunately, the
this feature <quote>console redirection</quote>. Unfortunately, the
meaning of this term varies by vendor. Some vendors use it to mean
the redirection of the <acronym>VGA</acronym> output and keyboard
to a remote <acronym>PC</acronym> using a proprietary serial
@ -5962,12 +5972,12 @@ Bytes Sent: 3072/ 10000 BPS:2185 ETA 00:09</guilabel>
<acronym>BIOS</acronym> can be instructed to disable the serial
redirection after booting.</para>
<para>As an example of the confusion, Dell uses &lsquo;console
redirection&rsquo; when describing the <productname>Dell
<para>As an example of the confusion, Dell uses <quote>console
redirection</quote> when describing the <productname>Dell
2400</productname> and the <productname>Dell 2450</productname>.
The <productname>Dell 2450</productname> <acronym>BIOS</acronym>
can be configured from the serial port. The <productname>Dell
2400</productname>'s &lsquo;console redirection&rsquo; is
2400</productname>'s <quote>console redirection</quote> is
additional hardware that remotely replicates the computer's
<acronym>VGA</acronym> monitor and keyboard.</para>
@ -6389,21 +6399,21 @@ nameserver 172.16.1.1</computeroutput></screen>
<calloutlist>
<callout arearefs="rhl-ifconfig-ifconfig-ipaddr">
<para>The value of <literal>inet addr</literal> is the
&lsquo;IP address&rsquo;. Our example shows
<quote>IP address</quote>. Our example shows
<literal>10.1.2.3</literal>. The value of
<literal>Mask</literal> is the &lsquo;Netmask&rsquo;. Our
<literal>Mask</literal> is the <quote>Netmask</quote>. Our
example shows <literal>255.255.255.0</literal>.</para>
</callout>
<callout arearefs="rhl-ifconfig-ifconfig-router">
<para>The value in the Gateway column for Destination
<literal>0.0.0.0</literal> is the &lsquo;Default
gateway&rsquo;. Our example shows
<literal>0.0.0.0</literal> is the <quote>Default
gateway</quote>. Our example shows
<literal>10.1.2.254</literal>.</para>
</callout>
<callout arearefs="rhl-ifconfig-ifconfig-dns">
<para>The value of the first listed
<literal>nameserver</literal> is the &lsquo;Primary
nameserver&rsquo;. Our example shows
<literal>nameserver</literal> is the <quote>Primary
nameserver</quote>. Our example shows
<literal>10.255.1.1</literal>.</para>
</callout>
</calloutlist>
@ -6980,8 +6990,8 @@ EOF
servers in the past. Each modem would be connected to a terminal
server port and incoming users would be permitted to send
<acronym>IP</acronym> packets anywhere, not just to some predefined
minicomputer. Manufacturers renamed the equipment to &lsquo;access
servers&rsquo; or &lsquo;modem servers&rsquo; to reflect this new
minicomputer. Manufacturers renamed the equipment to <quote>access
servers</quote> or <quote>modem servers</quote> to reflect this new
use.</para>
<para>These access servers have been superseded by a new generation
@ -7004,8 +7014,8 @@ EOF
third-party maintenance supplier.</para>
<para>Many older terminal servers are no longer sold or supported
by their vendors. Search the vendor's web site for &ldquo;end of
life&rdquo;.</para>
by their vendors. Search the vendor's web site for <quote>end of
life</quote>.</para>
<para>Vendor support can be a particular issue when the
most-recently available software does not fit within the
@ -7403,7 +7413,7 @@ alias char-major-10-144 nvram
<listitem>
<para>Be clear in the documentation about what serial servies the
BIOS provides. Some <acronym>BIOS</acronym>s with a
&lsquo;serial redirection&rsquo; feature don't allow the
<quote>serial redirection</quote> feature don't allow the
<acronym>BIOS</acronym> to be redirected to a plain text
terminal, but instead use a proprietary protocol. This isn't of
much use to <systemitem class="osname">Linux</systemitem> serial
@ -7572,7 +7582,7 @@ alias char-major-10-144 nvram
</varlistentry>
<varlistentry>
<term>Thomas Lunde and Gabor Kiss</term>
<term>Thomas Lunde, Gabor Kiss and Carlo Belon</term>
<listitem>
<para>Noticed errors of grammar and typography.</para>
</listitem>
@ -7651,6 +7661,14 @@ alias char-major-10-144 nvram
</listitem>
</varlistentry>
<varlistentry>
<term>Yasuhiro Suzuki</term>
<listitem>
<para>Noticed inconsistent descrtiptions of Clear to Send and
Ready to Send.</para>
</listitem>
</varlistentry>
</variablelist>
</section> <!-- about-credits -->
@ -7702,28 +7720,7 @@ alias char-major-10-144 nvram
generated from the DocBook source by the Linux Documentation
Project.</para>
<para>It appears that some character entities such as quotes
(&lsquo;&rsquo; &ldquo;&rdquo;) and ellipses (&hellip;), appear as
ampersands (&amp;) in the
<productname><acronym>PDF</acronym></productname> generated by the
Linux Documentation Project. In this case you may wish to download
the <ulink
url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/ps/Remote-Serial-Console-HOWTO.ps.gz"><productname>PostScript</productname>
file</ulink> and use <ulink
url="http://www.cs.wisc.edu/~ghost/"><application>GhostScript</application></ulink>
to convert the <productname>PostScript</productname> file to
<productname><acronym>PDF</acronym></productname> with the
command:</para>
<screen format="linespecific" linenumbering="unnumbered">
<prompt>bash$</prompt> <userinput>gs -q -dNOPAUSE -dBATCH -dSAFER \
-dNOPLATFONTS -dMaxSubsetPct=100 -dSubsetFonts=true -dEmbedAllFonts=true \
-sPAPERSIZE=a4 -sDEVICE=pdfwrite -dCompatibilityLevel=1.2 \
-sOutputFile=Remote-Serial-Console-HOWTO.pdf \
-c .setpdfwrite -f Remote-Serial-Console-HOWTO.ps</userinput>
</screen>
</colophon>
</colophon> <!-- colophon -->
</book> <!-- Remote-Serial-Console-HOWTO -->
@ -7733,13 +7730,10 @@ mkdir cvs
cd cvs
export CVSROOT=:pserver:USERID@cvs.tldp.org:/cvsroot
cvs -d $CVSROOT login
mkdir -p LDP/howto/docbook
cd LDP/howto/docbook
cvs get Remote-Serial-Console-HOWTO.sgml
cvs get LDP/howto/docbook/Remote-Serial-Console-HOWTO.sgml
# Update HOWTO, by copying local updated copy over CVS original copy
cd cvs/LDP/howto/docbook
export CVSROOT=:pserver:USERID@cvs.tldp.org:/cvsroot
cd LDP/howto/docbook
cvs update Remote-Serial-Console-HOWTO.sgml
cp ~/Remote-Serial-Console-HOWTO.sgml Remote-Serial-Console-HOWTO.sgml
cvs ci -m 'COMMENT' Remote-Serial-Console-HOWTO.sgml