PERFORCE change 185904 for review
Rene Ladan
rene at FreeBSD.org
Tue Nov 16 23:37:44 UTC 2010
http://p4web.freebsd.org/@@185904?ac=10
Change 185904 by rene at rene_acer on 2010/11/16 23:37:13
Pre-7.X cleanup of Handbook
- restore XFree entry in the Preface (historical)
- replace ttyd by ttyu and cuad by cuau, add warnings
(copied from ppp-and-slip)
- note that pppd is for 7.X only
- update 4.X-ish configuration format for sio device in serialcomms
Affected files ...
.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml#10 edit
.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/preface/preface.sgml#7 edit
.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/printing/chapter.sgml#6 edit
.. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml#8 edit
Differences ...
==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml#10 (text+ko) ====
@@ -94,7 +94,7 @@
<para>Throughout in this chapter, user PPP will simply be
referred to as <application>ppp</application> unless a distinction
needs to be made between it and any other PPP software such as
- <application>pppd</application>. Unless otherwise stated, all of
+ <application>pppd</application> (&os; 7.X only). Unless otherwise stated, all of
the commands explained in this chapter should be executed as
<username>root</username>.</para>
</note>
@@ -268,7 +268,7 @@
</indexterm>
<para>Both <command>ppp</command> and <command>pppd</command>
- (the kernel level implementation of PPP) use the configuration
+ (the kernel level implementation of PPP, &os; 7.X only) use the configuration
files located in the <filename class="directory">/etc/ppp</filename> directory.
Examples for user ppp can be found in
<filename class="directory">/usr/share/examples/ppp/</filename>.</para>
==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/preface/preface.sgml#7 (text+ko) ====
@@ -191,7 +191,7 @@
<listitem>
<para><xref linkend="x11"> (<quote>The X Window System</quote>) has been completely
rewritten with an emphasis on using modern desktop
- technologies such as <application>KDE</application> and <application>GNOME</application> on &xorg;.</para>
+ technologies such as <application>KDE</application> and <application>GNOME</application> on &xfree86; 4.X.</para>
</listitem>
<listitem>
<para><xref linkend="boot"> (<quote>The FreeBSD Booting Process</quote>) has been
==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/printing/chapter.sgml#6 (text+ko) ====
@@ -202,6 +202,16 @@
</sect1>
<sect1 id="printing-intro-setup">
+
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<title>Basic Setup</title>
<para>To use printers with the <application>LPD</application> spooling
@@ -778,8 +788,8 @@
<indexterm><primary>serial port</primary></indexterm>
<indexterm><primary>parity</primary></indexterm>
<para>Where <replaceable>port</replaceable> is the device
- entry for the serial port (<literal>ttyd0</literal>,
- <literal>ttyd1</literal>, etc.),
+ entry for the serial port (<literal>ttyu0</literal>,
+ <literal>ttyu1</literal>, etc.),
<replaceable>bps-rate</replaceable> is the
bits-per-second rate at which the printer communicates,
and <replaceable>parity</replaceable> is the parity
@@ -791,7 +801,7 @@
a serial line to the third serial port at 19200 bps
with no parity:</para>
- <programlisting>printer:dv=<filename class="devicefile">/dev/ttyd2</filename>:br#19200:pa=none</programlisting>
+ <programlisting>printer:dv=<filename class="devicefile">/dev/ttyu2</filename>:br#19200:pa=none</programlisting>
</step>
<step>
@@ -803,7 +813,7 @@
<para>If this step does not work, edit the file
<filename>/etc/remote</filename> again and try using
<filename class="devicefile">/dev/cuaa<replaceable>N</replaceable></filename> instead of
- <filename class="devicefile">/dev/ttyd<replaceable>N</replaceable></filename>.</para>
+ <filename class="devicefile">/dev/ttyu<replaceable>N</replaceable></filename>.</para>
</step>
<step>
@@ -1145,7 +1155,7 @@
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:</programlisting>
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:</programlisting>
<para>If you do not specify the <literal>lp</literal> capability
for a printer in your <filename>/etc/printcap</filename> file,
@@ -1237,7 +1247,7 @@
<programlisting>bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:</programlisting>
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:</programlisting>
</sect4>
<sect4 id="printing-textfilter">
@@ -1309,7 +1319,7 @@
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:\
:if=<filename>/usr/local/libexec/if-simple</filename>:</programlisting>
<note>
@@ -1395,6 +1405,15 @@
</sect1>
<sect1 id="printing-advanced">
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<title>Advanced Printer Setup</title>
<para>This section describes filters for printing specially formatted
@@ -2093,7 +2112,7 @@
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
:if=<filename>/usr/local/libexec/psif</filename>:\
:df=<filename>/usr/local/libexec/psdf</filename>:</programlisting>
@@ -3210,7 +3229,7 @@
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:sc:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
:if=<filename>/usr/local/libexec/psif</filename>:\
:df=<filename>/usr/local/libexec/psdf</filename>:</programlisting>
@@ -3285,7 +3304,7 @@
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:sc:rg=artists:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
:if=<filename>/usr/local/libexec/psif</filename>:\
:df=<filename>/usr/local/libexec/psdf</filename>:</programlisting>
@@ -3358,7 +3377,7 @@
#
bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:sc:rg=artists:mx#5000:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:rw:\
:if=<filename>/usr/local/libexec/psif</filename>:\
:df=<filename>/usr/local/libexec/psdf</filename>:</programlisting>
@@ -3446,7 +3465,7 @@
<programlisting>bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
:sh:sd=<filename class="directory">/var/spool/lpd/bamboo</filename>:sc:rg=artists:mx#5000:\
- :lp=<filename class="devicefile">/dev/ttyd5</filename>:ms#-parenb cs8 clocal crtscts:rw:mx#5000:\
+ :lp=<filename class="devicefile">/dev/ttyu5</filename>:ms#-parenb cs8 clocal crtscts:rw:mx#5000:\
:if=<filename>/usr/local/libexec/psif</filename>:\
:df=<filename>/usr/local/libexec/psdf</filename>:</programlisting>
==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml#8 (text+ko) ====
@@ -61,6 +61,17 @@
<sect1 id="serial">
<title>Introduction</title>
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/cuad<replaceable>N</replaceable></filename> to
+ <filename>/dev/cuau<replaceable>N</replaceable></filename> and
+ from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
<!-- XXX Write me! -->
<sect2 id="serial-terminology">
@@ -484,7 +495,7 @@
<itemizedlist>
<listitem>
<para>Call-in ports are named
- <filename>/dev/ttyd<replaceable>N</replaceable></filename>
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>
where <replaceable>N</replaceable> is the port number,
starting from zero. Generally, you use the call-in port for
terminals. Call-in ports require that the serial line assert
@@ -493,7 +504,7 @@
<listitem>
<para>Call-out ports are named
- <filename>/dev/cuad<replaceable>N</replaceable></filename>.
+ <filename>/dev/cuau<replaceable>N</replaceable></filename>.
You usually do not use the call-out port for terminals, just
for modems. You may use the call-out port if the serial cable
or the terminal does not support the carrier detect
@@ -503,10 +514,10 @@
<para>If you have connected a terminal to the first serial port
(<devicename>COM1</devicename> in &ms-dos;), then you will
- use <filename>/dev/ttyd0</filename> to refer to the terminal. If
+ use <filename>/dev/ttyu0</filename> to refer to the terminal. If
the terminal is on the second serial port (also known as
<devicename>COM2</devicename>), use
- <filename>/dev/ttyd1</filename>, and so forth.</para>
+ <filename>/dev/ttyu1</filename>, and so forth.</para>
</sect4>
</sect3>
@@ -562,7 +573,7 @@
Be careful if you are using a configuration
file that was previously used for a different version of
FreeBSD because the device flags and the syntax have changed between
- versions.</para>
+ versions.<!--rene: last sentence still true for >= 7.X ?--></para>
<note>
<para><literal>port IO_COM1</literal> is a substitution for
@@ -587,15 +598,15 @@
special files</quote>, which are located in the
<filename>/dev</filename> directory. The <devicename>sio</devicename>
devices are accessed through the
- <filename>/dev/ttyd<replaceable>N</replaceable></filename> (dial-in)
- and <filename>/dev/cuad<replaceable>N</replaceable></filename>
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename> (dial-in)
+ and <filename>/dev/cuau<replaceable>N</replaceable></filename>
(call-out) devices. FreeBSD also provides initialization devices
- (<filename>/dev/ttyd<replaceable>N</replaceable>.init</filename> and
- <filename>/dev/cuad<replaceable>N</replaceable>.init</filename>)
+ (<filename>/dev/ttyu<replaceable>N</replaceable>.init</filename> and
+ <filename>/dev/cuau<replaceable>N</replaceable>.init</filename>)
and
locking devices
- (<filename>/dev/ttyd<replaceable>N</replaceable>.lock</filename> and
- <filename>/dev/cuad<replaceable>N</replaceable>.lock</filename>).
+ (<filename>/dev/ttyu<replaceable>N</replaceable>.lock</filename> and
+ <filename>/dev/cuau<replaceable>N</replaceable>.lock</filename>).
The
initialization devices are used to initialize communications port
parameters each time a port is opened, such as
@@ -612,16 +623,16 @@
<sect2 id="serial-hw-config">
<title>Serial Port Configuration</title>
- <indexterm><primary><devicename>ttyd</devicename></primary></indexterm>
- <indexterm><primary><devicename>cuad</devicename></primary></indexterm>
+ <indexterm><primary><devicename>ttyu</devicename></primary></indexterm>
+ <indexterm><primary><devicename>cuau</devicename></primary></indexterm>
- <para>The <devicename>ttyd<replaceable>N</replaceable></devicename> (or
- <devicename>cuad<replaceable>N</replaceable></devicename>) device is the
+ <para>The <devicename>ttyu<replaceable>N</replaceable></devicename> (or
+ <devicename>cuau<replaceable>N</replaceable></devicename>) device is the
regular device you will want to open for your applications. When a
process opens the device, it will have a default set of terminal I/O
settings. You can see these settings with the command</para>
- <screen>&prompt.root; <userinput>stty -a -f /dev/ttyd1</userinput></screen>
+ <screen>&prompt.root; <userinput>stty -a -f /dev/ttyu1</userinput></screen>
<para>When you change the settings to this device, the settings are in
effect until the device is closed. When it is reopened, it goes back to
@@ -629,9 +640,9 @@
adjust the settings of the <quote>initial state</quote> device. For
example, to turn on <option>CLOCAL</option> mode, 8 bit communication,
and <option>XON/XOFF</option> flow control by default for
- <devicename>ttyd5</devicename>, type:</para>
+ <devicename>ttyu5</devicename>, type:</para>
- <screen>&prompt.root; <userinput>stty -f /dev/ttyd5.init clocal cs8 ixon ixoff</userinput></screen>
+ <screen>&prompt.root; <userinput>stty -f /dev/ttyu5.init clocal cs8 ixon ixoff</userinput></screen>
<indexterm>
<primary>rc files</primary>
@@ -645,12 +656,12 @@
<para>To prevent certain settings from being changed by an
application, make adjustments to the <quote>lock state</quote>
device. For example, to lock the speed of
- <devicename>ttyd5</devicename> to 57600 bps, type:</para>
+ <devicename>ttyu5</devicename> to 57600 bps, type:</para>
- <screen>&prompt.root; <userinput>stty -f /dev/ttyd5.lock 57600</userinput></screen>
+ <screen>&prompt.root; <userinput>stty -f /dev/ttyu5.lock 57600</userinput></screen>
<para>Now, an application that opens
- <devicename>ttyd5</devicename> and tries to change the speed of
+ <devicename>ttyu5</devicename> and tries to change the speed of
the port will be stuck with 57600 bps.</para>
<para>Naturally, you should make the initial state and lock state devices
@@ -671,6 +682,18 @@
</sect1info>
<title>Terminals</title>
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/cuad<replaceable>N</replaceable></filename> to
+ <filename>/dev/cuau<replaceable>N</replaceable></filename> and
+ from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<indexterm><primary>terminals</primary></indexterm>
<para>Terminals provide a convenient and low-cost way to access
@@ -769,7 +792,7 @@
<para>Where <quote>serial-port-device</quote> is the name of a
special device file denoting a serial port of your system.
These device files are called
- <devicename>/dev/cuad<replaceable>N</replaceable></devicename>.</para>
+ <devicename>/dev/cuau<replaceable>N</replaceable></devicename>.</para>
<para>The <quote>N</quote>-part of a device name is the serial
port number.</para>
@@ -779,7 +802,7 @@
one (like they do, for instance in &ms-dos;-derived systems).
This means that what &ms-dos;-based systems call
<devicename>COM1</devicename> is usually
- <filename>/dev/cuad0</filename> in &os;.</para>
+ <filename>/dev/cuau0</filename> in &os;.</para>
</note>
<note>
@@ -882,8 +905,8 @@
<para>A default FreeBSD install includes an
<filename>/etc/ttys</filename> file with support for the first
- four serial ports: <devicename>ttyd0</devicename> through
- <devicename>ttyd3</devicename>. If you are attaching a terminal
+ four serial ports: <devicename>ttyu0</devicename> through
+ <devicename>ttyu3</devicename>. If you are attaching a terminal
to one of those ports, you do not need to add another entry.</para>
<example id="ex-etc-ttys">
@@ -899,13 +922,13 @@
entries in the <filename>/etc/ttys</filename> file would
look like this:</para>
- <programlisting>ttyd1<co
+ <programlisting>ttyu1<co
id="co-ttys-line1col1"> "/usr/libexec/getty std.38400"<co
id="co-ttys-line1col2"> wy50<co
id="co-ttys-line1col3"> on<co
id="co-ttys-line1col4"> insecure<co
id="co-ttys-line1col5">
-ttyd5 "/usr/libexec/getty std.19200" vt100 on insecure
+ttyu5 "/usr/libexec/getty std.19200" vt100 on insecure
</programlisting>
<calloutlist>
@@ -1058,11 +1081,11 @@
<para>You should see an entry for the terminal. For
example, the following display shows that a
<command>getty</command> is running on the second serial
- port <devicename>ttyd1</devicename> and is using the
+ port <devicename>ttyu1</devicename> and is using the
<literal>std.38400</literal> entry in
<filename>/etc/gettytab</filename>:</para>
- <screen>22189 d1 Is+ 0:00.03 /usr/libexec/getty std.38400 ttyd1</screen>
+ <screen>22189 d1 Is+ 0:00.03 /usr/libexec/getty std.38400 ttyu1</screen>
<para>If no <command>getty</command> process is running, make sure
you have enabled the port in <filename>/etc/ttys</filename>.
@@ -1130,6 +1153,19 @@
</authorgroup>
</sect1info>
<title>Dial-in Service</title>
+
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/cuad<replaceable>N</replaceable></filename> to
+ <filename>/dev/cuau<replaceable>N</replaceable></filename> and
+ from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<indexterm><primary>dial-in service</primary></indexterm>
<para>Configuring your FreeBSD system for dial-in service is very
@@ -1259,10 +1295,10 @@
<para>As with terminals, <command>init</command> spawns a
<command>getty</command> process for each configured serial
port for dial-in connections. For example, if a modem is
- attached to <filename>/dev/ttyd0</filename>, the command
+ attached to <filename>/dev/ttyu0</filename>, the command
<command>ps ax</command> might show this:</para>
- <screen> 4850 ?? I 0:00.09 /usr/libexec/getty V19200 ttyd0</screen>
+ <screen> 4850 ?? I 0:00.09 /usr/libexec/getty V19200 ttyu0</screen>
<para>When a user dials the modem's line and the modems connect, the
<acronym>CD</acronym> (Carrier Detect) line is reported by the modem.
@@ -1447,11 +1483,11 @@
different terminal type. The general format for both
locked-speed and matching-speed configurations is:</para>
- <programlisting>ttyd0 "/usr/libexec/getty <replaceable>xxx</replaceable>" dialup on</programlisting>
+ <programlisting>ttyu0 "/usr/libexec/getty <replaceable>xxx</replaceable>" dialup on</programlisting>
<para>The first item in the above line is the device special file for
- this entry — <devicename>ttyd0</devicename> means
- <filename>/dev/ttyd0</filename> is the file that this
+ this entry — <devicename>ttyu0</devicename> means
+ <filename>/dev/ttyu0</filename> is the file that this
<command>getty</command> will be watching. The second item,
<literal>"/usr/libexec/getty
<replaceable>xxx</replaceable>"</literal>
@@ -1496,7 +1532,7 @@
speed is locked at 19.2 Kbps, the <filename>ttys</filename>
entry might look like this:</para>
- <programlisting>ttyd0 "/usr/libexec/getty std.19200" dialup on</programlisting>
+ <programlisting>ttyu0 "/usr/libexec/getty std.19200" dialup on</programlisting>
<para>If your modem is locked at a different data rate,
substitute the appropriate value for
@@ -1518,7 +1554,7 @@
the <literal>V19200</literal> starting point), your
<filename>ttys</filename> entry might look like this:</para>
- <programlisting>ttyd0 "/usr/libexec/getty V19200" dialup on</programlisting>
+ <programlisting>ttyu0 "/usr/libexec/getty V19200" dialup on</programlisting>
</sect4>
</sect3>
@@ -1542,8 +1578,8 @@
devices, the following lines could be added to
<filename>/etc/rc.d/serial</filename>:</para>
<programlisting># Serial port initial configuration
-stty -f /dev/ttyd1.init crtscts
-stty -f /dev/cuad1.init crtscts</programlisting>
+stty -f /dev/ttyu1.init crtscts
+stty -f /dev/cuau1.init crtscts</programlisting>
</sect3>
</sect2>
@@ -1717,12 +1753,12 @@
<command>getty</command> process on the correct port. You should see
lines like these among the processes displayed:</para>
- <screen> 114 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd0
- 115 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd1</screen>
+ <screen> 114 ?? I 0:00.10 /usr/libexec/getty V19200 ttyu0
+ 115 ?? I 0:00.10 /usr/libexec/getty V19200 ttyu1</screen>
<para>If you see something different, like this:</para>
- <screen> 114 d0 I 0:00.10 /usr/libexec/getty V19200 ttyd0</screen>
+ <screen> 114 d0 I 0:00.10 /usr/libexec/getty V19200 ttyu0</screen>
<para>and the modem has not accepted a call yet, this means that
<command>getty</command> has completed its open on the
@@ -1734,7 +1770,7 @@
<para>If you do not see any <command>getty</command> processes waiting
to open the desired
- <devicename>ttyd<replaceable>N</replaceable></devicename> port,
+ <devicename>ttyu<replaceable>N</replaceable></devicename> port,
double-check your entries in <filename>/etc/ttys</filename> to see
if there are any mistakes there. Also, check the log file
<filename>/var/log/messages</filename> to see if there are any log
@@ -1742,7 +1778,7 @@
regarding any problems. If there are any messages, triple-check the
configuration files <filename>/etc/ttys</filename> and
<filename>/etc/gettytab</filename>, as well as the appropriate
- device special files <filename>/dev/ttydN</filename>, for any
+ device special files <filename>/dev/ttyuN</filename>, for any
mistakes, missing entries, or missing device special files.</para>
</sect3>
@@ -1801,6 +1837,16 @@
<sect1 id="dialout">
<title>Dial-out Service</title>
+
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/cuad<replaceable>N</replaceable></filename> to
+ <filename>/dev/cuau<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<indexterm><primary>dial-out service</primary></indexterm>
<para>The following are tips for getting your host to be able to connect
@@ -1842,13 +1888,13 @@
</indexterm>
<para>Make what is called a <quote>direct</quote> entry in your
<filename>/etc/remote</filename> file. For example, if your modem is
- hooked up to the first serial port, <filename>/dev/cuad0</filename>,
+ hooked up to the first serial port, <filename>/dev/cuau0</filename>,
then put in the following line:</para>
- <programlisting>cuad0:dv=/dev/cuad0:br#19200:pa=none</programlisting>
+ <programlisting>cuau0:dv=/dev/cuau0:br#19200:pa=none</programlisting>
<para>Use the highest bps rate your modem supports in the br capability.
- Then, type <command>tip cuad0</command> and you will be connected to
+ Then, type <command>tip cuau0</command> and you will be connected to
your modem.</para>
<para>Or use <command>cu</command> as <username>root</username> with the
@@ -1857,7 +1903,7 @@
<screen>&prompt.root; <userinput>cu -l<replaceable>line</replaceable> -s<replaceable>speed</replaceable></userinput></screen>
<para><replaceable>line</replaceable> is the serial port
- (e.g.<filename>/dev/cuad0</filename>) and
+ (e.g.<filename>/dev/cuau0</filename>) and
<replaceable>speed</replaceable> is the speed
(e.g.<literal>57600</literal>). When you are done entering the AT
commands type <command>~.</command> to exit.</para>
@@ -1883,9 +1929,9 @@
<filename>/etc/remote</filename> file. For example:</para>
<programlisting>tip115200|Dial any phone number at 115200 bps:\
- :dv=/dev/cuad0:br#115200:at=hayes:pa=none:du:
+ :dv=/dev/cuau0:br#115200:at=hayes:pa=none:du:
tip57600|Dial any phone number at 57600 bps:\
- :dv=/dev/cuad0:br#57600:at=hayes:pa=none:du:</programlisting>
+ :dv=/dev/cuau0:br#57600:at=hayes:pa=none:du:</programlisting>
<para>Then you can do things like:</para>
@@ -1895,7 +1941,7 @@
use a generic <literal>cu</literal> entry:</para>
<programlisting>cu115200|Use cu to dial any number at 115200bps:\
- :dv=/dev/cuad1:br#57600:at=hayes:pa=none:du:</programlisting>
+ :dv=/dev/cuau1:br#57600:at=hayes:pa=none:du:</programlisting>
<para>and type:</para>
@@ -1926,7 +1972,7 @@
muffin|muffin.deep13.com|Frank's machine:\
:cm=CONNECT muffin\n:tc=deep13:
deep13:Gizmonics Institute terminal server:\
- :dv=/dev/cuad2:br#38400:at=hayes:du:pa=none:pn=5551234:</programlisting>
+ :dv=/dev/cuau2:br#38400:at=hayes:du:pa=none:pn=5551234:</programlisting>
<para>will let you type <command>tip pain</command> or <command>tip
muffin</command> to connect to the hosts <hostid>pain</hostid> or
@@ -1947,7 +1993,7 @@
<programlisting>big-university:\
:pn=\@:tc=dialout
dialout:\
- :dv=/dev/cuad3:br#9600:at=courier:du:pa=none:</programlisting>
+ :dv=/dev/cuau3:br#9600:at=courier:du:pa=none:</programlisting>
<para>Then, list the phone numbers for the university in
<filename>/etc/phones</filename>:</para>
@@ -2101,6 +2147,16 @@
</authorgroup>
</sect1info>
<title>Setting Up the Serial Console</title>
+
+ <warning>
+ <para>As of &os; 8.0, device nodes for serial ports have been
+ renamed from
+ <filename>/dev/ttyd<replaceable>N</replaceable></filename> to
+ <filename>/dev/ttyu<replaceable>N</replaceable></filename>.
+ &os; 7.X users will have to adapt the following
+ documentation according to these changes.</para>
+ </warning>
+
<indexterm><primary>serial console</primary></indexterm>
<sect2 id="serialconsole-intro">
@@ -2148,7 +2204,7 @@
<para>Edit <filename>/etc/ttys</filename> and change
<literal>off</literal> to <literal>on</literal> and
<literal>dialup</literal> to <literal>vt100</literal> for the
- <devicename>ttyd0</devicename> entry. Otherwise a password will
+ <devicename>ttyu0</devicename> entry. Otherwise a password will
not be required to connect via the serial console, resulting in a
potential security hole.</para>
</step>
@@ -2298,7 +2354,7 @@
<para>Example:</para>
- <programlisting>device sio0 at isa? port IO_COM1 flags 0x10 irq 4</programlisting>
+ <programlisting>device sio0 flags 0x10</programlisting>
<para>See the &man.sio.4; manual page for more details.</para>
@@ -2496,7 +2552,7 @@
<title>Case 1: You Set the Flags to 0x10 for
<devicename>sio0</devicename></title>
- <programlisting>device sio0 at isa? port IO_COM1 flags 0x10 irq 4</programlisting>
+ <programlisting>device sio0 flags 0x10</programlisting>
<informaltable frame="none" pgwide="1">
<tgroup cols="4">
@@ -2559,7 +2615,7 @@
<sect3>
<title>Case 2: You Set the Flags to 0x30 for <devicename>sio0</devicename></title>
- <programlisting>device sio0 at isa? port IO_COM1 flags 0x30 irq 4</programlisting>
+ <programlisting>device sio0 flags 0x30</programlisting>
<informaltable frame="none" pgwide="1">
<tgroup cols="4">
@@ -2708,11 +2764,11 @@
example, if you want to make <devicename>sio1</devicename>
(<devicename>COM2</devicename>) the console:</para>
- <programlisting>device sio1 at isa? port IO_COM2 flags 0x10 irq 3</programlisting>
+ <programlisting>device sio1 flags 0x10</programlisting>
<para>or</para>
- <programlisting>device sio1 at isa? port IO_COM2 flags 0x30 irq 3</programlisting>
+ <programlisting>device sio1 flags 0x30</programlisting>
<para>The console flags for the other serial ports should not be
set.</para>
@@ -2762,13 +2818,13 @@
<para>Open the file <filename>/etc/ttys</filename> with an editor
and locate the lines:</para>
- <programlisting>ttyd0 "/usr/libexec/getty std.9600" unknown off secure
-ttyd1 "/usr/libexec/getty std.9600" unknown off secure
-ttyd2 "/usr/libexec/getty std.9600" unknown off secure
-ttyd3 "/usr/libexec/getty std.9600" unknown off secure</programlisting>
+ <programlisting>ttyu0 "/usr/libexec/getty std.9600" unknown off secure
+ttyu1 "/usr/libexec/getty std.9600" unknown off secure
+ttyu2 "/usr/libexec/getty std.9600" unknown off secure
+ttyu3 "/usr/libexec/getty std.9600" unknown off secure</programlisting>
- <para><devicename>ttyd0</devicename> through
- <devicename>ttyd3</devicename> corresponds to
+ <para><devicename>ttyu0</devicename> through
+ <devicename>ttyu3</devicename> corresponds to
<devicename>COM1</devicename> through <devicename>COM4</devicename>.
Change <literal>off</literal> to <literal>on</literal> for the
desired port. If you have changed the speed of the serial port,
More information about the p4-projects
mailing list