Date: Tue, 16 Nov 2010 23:37:43 GMT From: Rene Ladan <rene@FreeBSD.org> To: Perforce Change Reviews <perforce@FreeBSD.org> Subject: PERFORCE change 185904 for review Message-ID: <201011162337.oAGNbhKC077159@skunkworks.freebsd.org>
next in thread | raw e-mail | index | archive | help
http://p4web.freebsd.org/@@185904?ac=10 Change 185904 by rene@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,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201011162337.oAGNbhKC077159>