From owner-p4-projects@FreeBSD.ORG Tue Nov 16 23:37:44 2010 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 202621065679; Tue, 16 Nov 2010 23:37:44 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D5E381065672 for ; Tue, 16 Nov 2010 23:37:43 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from skunkworks.freebsd.org (skunkworks.freebsd.org [IPv6:2001:4f8:fff6::2d]) by mx1.freebsd.org (Postfix) with ESMTP id C17B58FC0A for ; Tue, 16 Nov 2010 23:37:43 +0000 (UTC) Received: from skunkworks.freebsd.org (localhost [127.0.0.1]) by skunkworks.freebsd.org (8.14.4/8.14.4) with ESMTP id oAGNbhFX077162 for ; Tue, 16 Nov 2010 23:37:43 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by skunkworks.freebsd.org (8.14.4/8.14.4/Submit) id oAGNbhKC077159 for perforce@freebsd.org; Tue, 16 Nov 2010 23:37:43 GMT (envelope-from rene@FreeBSD.org) Date: Tue, 16 Nov 2010 23:37:43 GMT Message-Id: <201011162337.oAGNbhKC077159@skunkworks.freebsd.org> X-Authentication-Warning: skunkworks.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Precedence: bulk Cc: Subject: PERFORCE change 185904 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 16 Nov 2010 23:37:44 -0000 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 @@ Throughout in this chapter, user PPP will simply be referred to as ppp unless a distinction needs to be made between it and any other PPP software such as - pppd. Unless otherwise stated, all of + pppd (&os; 7.X only). Unless otherwise stated, all of the commands explained in this chapter should be executed as root. @@ -268,7 +268,7 @@ Both ppp and pppd - (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 /etc/ppp directory. Examples for user ppp can be found in /usr/share/examples/ppp/. ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/preface/preface.sgml#7 (text+ko) ==== @@ -191,7 +191,7 @@ (The X Window System) has been completely rewritten with an emphasis on using modern desktop - technologies such as KDE and GNOME on &xorg;. + technologies such as KDE and GNOME on &xfree86; 4.X. (The FreeBSD Booting Process) has been ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/printing/chapter.sgml#6 (text+ko) ==== @@ -202,6 +202,16 @@ + + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + Basic Setup To use printers with the LPD spooling @@ -778,8 +788,8 @@ serial port parity Where port is the device - entry for the serial port (ttyd0, - ttyd1, etc.), + entry for the serial port (ttyu0, + ttyu1, etc.), bps-rate is the bits-per-second rate at which the printer communicates, and parity is the parity @@ -791,7 +801,7 @@ a serial line to the third serial port at 19200 bps with no parity: - printer:dv=/dev/ttyd2:br#19200:pa=none + printer:dv=/dev/ttyu2:br#19200:pa=none @@ -803,7 +813,7 @@ If this step does not work, edit the file /etc/remote again and try using /dev/cuaaN instead of - /dev/ttydN. + /dev/ttyuN. @@ -1145,7 +1155,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:\ - :lp=/dev/ttyd5: + :lp=/dev/ttyu5: If you do not specify the lp capability for a printer in your /etc/printcap file, @@ -1237,7 +1247,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts: + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts: @@ -1309,7 +1319,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:\ :if=/usr/local/libexec/if-simple: @@ -1395,6 +1405,15 @@ + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + Advanced Printer Setup 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=/var/spool/lpd/bamboo:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:rw:\ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: @@ -3210,7 +3229,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:sc:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:rw:\ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: @@ -3285,7 +3304,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:rw:\ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: @@ -3358,7 +3377,7 @@ # bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:rw:\ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: @@ -3446,7 +3465,7 @@ bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\ :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\ - :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:mx#5000:\ + :lp=/dev/ttyu5:ms#-parenb cs8 clocal crtscts:rw:mx#5000:\ :if=/usr/local/libexec/psif:\ :df=/usr/local/libexec/psdf: ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml#8 (text+ko) ==== @@ -61,6 +61,17 @@ Introduction + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/cuadN to + /dev/cuauN and + from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + @@ -484,7 +495,7 @@ Call-in ports are named - /dev/ttydN + /dev/ttyuN where N 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 @@ Call-out ports are named - /dev/cuadN. + /dev/cuauN. 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 @@ If you have connected a terminal to the first serial port (COM1 in &ms-dos;), then you will - use /dev/ttyd0 to refer to the terminal. If + use /dev/ttyu0 to refer to the terminal. If the terminal is on the second serial port (also known as COM2), use - /dev/ttyd1, and so forth. + /dev/ttyu1, and so forth. @@ -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. + versions. port IO_COM1 is a substitution for @@ -587,15 +598,15 @@ special files, which are located in the /dev directory. The sio devices are accessed through the - /dev/ttydN (dial-in) - and /dev/cuadN + /dev/ttyuN (dial-in) + and /dev/cuauN (call-out) devices. FreeBSD also provides initialization devices - (/dev/ttydN.init and - /dev/cuadN.init) + (/dev/ttyuN.init and + /dev/cuauN.init) and locking devices - (/dev/ttydN.lock and - /dev/cuadN.lock). + (/dev/ttyuN.lock and + /dev/cuauN.lock). The initialization devices are used to initialize communications port parameters each time a port is opened, such as @@ -612,16 +623,16 @@ Serial Port Configuration - ttyd - cuad + ttyu + cuau - The ttydN (or - cuadN) device is the + The ttyuN (or + cuauN) 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 - &prompt.root; stty -a -f /dev/ttyd1 + &prompt.root; stty -a -f /dev/ttyu1 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 initial state device. For example, to turn on mode, 8 bit communication, and flow control by default for - ttyd5, type: + ttyu5, type: - &prompt.root; stty -f /dev/ttyd5.init clocal cs8 ixon ixoff + &prompt.root; stty -f /dev/ttyu5.init clocal cs8 ixon ixoff rc files @@ -645,12 +656,12 @@ To prevent certain settings from being changed by an application, make adjustments to the lock state device. For example, to lock the speed of - ttyd5 to 57600 bps, type: + ttyu5 to 57600 bps, type: - &prompt.root; stty -f /dev/ttyd5.lock 57600 + &prompt.root; stty -f /dev/ttyu5.lock 57600 Now, an application that opens - ttyd5 and tries to change the speed of + ttyu5 and tries to change the speed of the port will be stuck with 57600 bps. Naturally, you should make the initial state and lock state devices @@ -671,6 +682,18 @@ Terminals + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/cuadN to + /dev/cuauN and + from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + terminals Terminals provide a convenient and low-cost way to access @@ -769,7 +792,7 @@ Where serial-port-device is the name of a special device file denoting a serial port of your system. These device files are called - /dev/cuadN. + /dev/cuauN. The N-part of a device name is the serial port number. @@ -779,7 +802,7 @@ one (like they do, for instance in &ms-dos;-derived systems). This means that what &ms-dos;-based systems call COM1 is usually - /dev/cuad0 in &os;. + /dev/cuau0 in &os;. @@ -882,8 +905,8 @@ A default FreeBSD install includes an /etc/ttys file with support for the first - four serial ports: ttyd0 through - ttyd3. If you are attaching a terminal + four serial ports: ttyu0 through + ttyu3. If you are attaching a terminal to one of those ports, you do not need to add another entry. @@ -899,13 +922,13 @@ entries in the /etc/ttys file would look like this: - ttyd1ttyu1 "/usr/libexec/getty std.38400" wy50 on insecure -ttyd5 "/usr/libexec/getty std.19200" vt100 on insecure +ttyu5 "/usr/libexec/getty std.19200" vt100 on insecure @@ -1058,11 +1081,11 @@ You should see an entry for the terminal. For example, the following display shows that a getty is running on the second serial - port ttyd1 and is using the + port ttyu1 and is using the std.38400 entry in /etc/gettytab: - 22189 d1 Is+ 0:00.03 /usr/libexec/getty std.38400 ttyd1 + 22189 d1 Is+ 0:00.03 /usr/libexec/getty std.38400 ttyu1 If no getty process is running, make sure you have enabled the port in /etc/ttys. @@ -1130,6 +1153,19 @@ Dial-in Service + + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/cuadN to + /dev/cuauN and + from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + dial-in service Configuring your FreeBSD system for dial-in service is very @@ -1259,10 +1295,10 @@ As with terminals, init spawns a getty process for each configured serial port for dial-in connections. For example, if a modem is - attached to /dev/ttyd0, the command + attached to /dev/ttyu0, the command ps ax might show this: - 4850 ?? I 0:00.09 /usr/libexec/getty V19200 ttyd0 + 4850 ?? I 0:00.09 /usr/libexec/getty V19200 ttyu0 When a user dials the modem's line and the modems connect, the CD (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: - ttyd0 "/usr/libexec/getty xxx" dialup on + ttyu0 "/usr/libexec/getty xxx" dialup on The first item in the above line is the device special file for - this entry — ttyd0 means - /dev/ttyd0 is the file that this + this entry — ttyu0 means + /dev/ttyu0 is the file that this getty will be watching. The second item, "/usr/libexec/getty xxx" @@ -1496,7 +1532,7 @@ speed is locked at 19.2 Kbps, the ttys entry might look like this: - ttyd0 "/usr/libexec/getty std.19200" dialup on + ttyu0 "/usr/libexec/getty std.19200" dialup on If your modem is locked at a different data rate, substitute the appropriate value for @@ -1518,7 +1554,7 @@ the V19200 starting point), your ttys entry might look like this: - ttyd0 "/usr/libexec/getty V19200" dialup on + ttyu0 "/usr/libexec/getty V19200" dialup on @@ -1542,8 +1578,8 @@ devices, the following lines could be added to /etc/rc.d/serial: # Serial port initial configuration -stty -f /dev/ttyd1.init crtscts -stty -f /dev/cuad1.init crtscts +stty -f /dev/ttyu1.init crtscts +stty -f /dev/cuau1.init crtscts @@ -1717,12 +1753,12 @@ getty process on the correct port. You should see lines like these among the processes displayed: - 114 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd0 - 115 ?? I 0:00.10 /usr/libexec/getty V19200 ttyd1 + 114 ?? I 0:00.10 /usr/libexec/getty V19200 ttyu0 + 115 ?? I 0:00.10 /usr/libexec/getty V19200 ttyu1 If you see something different, like this: - 114 d0 I 0:00.10 /usr/libexec/getty V19200 ttyd0 + 114 d0 I 0:00.10 /usr/libexec/getty V19200 ttyu0 and the modem has not accepted a call yet, this means that getty has completed its open on the @@ -1734,7 +1770,7 @@ If you do not see any getty processes waiting to open the desired - ttydN port, + ttyuN port, double-check your entries in /etc/ttys to see if there are any mistakes there. Also, check the log file /var/log/messages to see if there are any log @@ -1742,7 +1778,7 @@ regarding any problems. If there are any messages, triple-check the configuration files /etc/ttys and /etc/gettytab, as well as the appropriate - device special files /dev/ttydN, for any + device special files /dev/ttyuN, for any mistakes, missing entries, or missing device special files. @@ -1801,6 +1837,16 @@ Dial-out Service + + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/cuadN to + /dev/cuauN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + dial-out service The following are tips for getting your host to be able to connect @@ -1842,13 +1888,13 @@ Make what is called a direct entry in your /etc/remote file. For example, if your modem is - hooked up to the first serial port, /dev/cuad0, + hooked up to the first serial port, /dev/cuau0, then put in the following line: - cuad0:dv=/dev/cuad0:br#19200:pa=none + cuau0:dv=/dev/cuau0:br#19200:pa=none Use the highest bps rate your modem supports in the br capability. - Then, type tip cuad0 and you will be connected to + Then, type tip cuau0 and you will be connected to your modem. Or use cu as root with the @@ -1857,7 +1903,7 @@ &prompt.root; cu -lline -sspeed line is the serial port - (e.g./dev/cuad0) and + (e.g./dev/cuau0) and speed is the speed (e.g.57600). When you are done entering the AT commands type ~. to exit. @@ -1883,9 +1929,9 @@ /etc/remote file. For example: 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: + :dv=/dev/cuau0:br#57600:at=hayes:pa=none:du: Then you can do things like: @@ -1895,7 +1941,7 @@ use a generic cu entry: cu115200|Use cu to dial any number at 115200bps:\ - :dv=/dev/cuad1:br#57600:at=hayes:pa=none:du: + :dv=/dev/cuau1:br#57600:at=hayes:pa=none:du: and type: @@ -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: + :dv=/dev/cuau2:br#38400:at=hayes:du:pa=none:pn=5551234: will let you type tip pain or tip muffin to connect to the hosts pain or @@ -1947,7 +1993,7 @@ big-university:\ :pn=\@:tc=dialout dialout:\ - :dv=/dev/cuad3:br#9600:at=courier:du:pa=none: + :dv=/dev/cuau3:br#9600:at=courier:du:pa=none: Then, list the phone numbers for the university in /etc/phones: @@ -2101,6 +2147,16 @@ Setting Up the Serial Console + + + As of &os; 8.0, device nodes for serial ports have been + renamed from + /dev/ttydN to + /dev/ttyuN. + &os; 7.X users will have to adapt the following + documentation according to these changes. + + serial console @@ -2148,7 +2204,7 @@ Edit /etc/ttys and change off to on and dialup to vt100 for the - ttyd0 entry. Otherwise a password will + ttyu0 entry. Otherwise a password will not be required to connect via the serial console, resulting in a potential security hole. @@ -2298,7 +2354,7 @@ Example: - device sio0 at isa? port IO_COM1 flags 0x10 irq 4 + device sio0 flags 0x10 See the &man.sio.4; manual page for more details. @@ -2496,7 +2552,7 @@ Case 1: You Set the Flags to 0x10 for <devicename>sio0</devicename> - device sio0 at isa? port IO_COM1 flags 0x10 irq 4 + device sio0 flags 0x10 @@ -2559,7 +2615,7 @@ Case 2: You Set the Flags to 0x30 for <devicename>sio0</devicename> - device sio0 at isa? port IO_COM1 flags 0x30 irq 4 + device sio0 flags 0x30 @@ -2708,11 +2764,11 @@ example, if you want to make sio1 (COM2) the console: - device sio1 at isa? port IO_COM2 flags 0x10 irq 3 + device sio1 flags 0x10 or - device sio1 at isa? port IO_COM2 flags 0x30 irq 3 + device sio1 flags 0x30 The console flags for the other serial ports should not be set. @@ -2762,13 +2818,13 @@ Open the file /etc/ttys with an editor and locate the lines: - 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 + 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 - ttyd0 through - ttyd3 corresponds to + ttyu0 through + ttyu3 corresponds to COM1 through COM4. Change off to on for the desired port. If you have changed the speed of the serial port,