From e2f759c9d6fdcca35af7fa29b6b53c22ea7baa5e Mon Sep 17 00:00:00 2001 From: Pav Lucistnik Date: Sun, 18 Dec 2005 02:22:13 +0000 Subject: [PATCH] - Catch up with renaming of cuaa->cuad, ttyiN->ttyN.init, ttylN->ttyN.lock in FreeBSD 6.0 - Catch up with renaming of /etc/rc.serial to /etc/rc.d/serial in FreeBSD 5.1 - Reword two sections to give 6.0 relevant instructions first --- .../books/handbook/serialcomms/chapter.sgml | 95 +++++++++---------- 1 file changed, 47 insertions(+), 48 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml index d7c8ad6b91..69d3206362 100644 --- a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml @@ -473,11 +473,15 @@ Call-out ports are named - /dev/cuaaN. + /dev/cuadN. 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 signal. + + Call-out ports are named + /dev/cuaaN in + &os; 5.X and older. @@ -532,29 +536,22 @@ sio3 at 0x2e8-0x2ef irq 9 on isa sio3: type 16550A If your kernel does not recognize all of your serial - ports, you will probably need to configure a custom FreeBSD - kernel for your system. For detailed information on - configuring your kernel, please see . + ports, you will probably need to configure your kernel + in the /boot/device.hints file. You can + also comment-out or completely remove lines for devices you do not + have. + + On &os; 4.X you have to edit your kernel configuration file. + For detailed information on configuring your kernel, please see . The relevant device lines would look like + this: - The relevant device lines for your kernel configuration - file would look like this, for FreeBSD 4.X: - device sio0 at isa? port IO_COM1 irq 4 device sio1 at isa? port IO_COM2 irq 3 device sio2 at isa? port IO_COM3 irq 5 device sio3 at isa? port IO_COM4 irq 9 - - and like this, for FreeBSD 5.X: - - device sio - - You can comment-out or completely remove lines for devices - you do not have in the case of FreeBSD 4.X; for - FreeBSD 5.X you have to edit your - /boot/device.hints file to configure your - serial ports. Please refer to the &man.sio.4; manual page for + Please refer to the &man.sio.4; manual page for more information on serial ports and multiport boards configuration. Be careful if you are using a configuration file that was previously used for a different version of @@ -585,13 +582,21 @@ device sio3 at isa? port IO_COM4 irq 9 /dev directory. The sio devices are accessed through the /dev/ttydN (dial-in) - and /dev/cuaaN + and /dev/cuadN (call-out) devices. FreeBSD also provides initialization devices - (/dev/ttyidN and - /dev/cuaiaN) and + (/dev/ttydN.init and + /dev/cuadN.init on + &os; 6.X, + /dev/ttyidN and + /dev/cuaidN on + &os; 5.X and older) and locking devices - (/dev/ttyldN and - /dev/cualaN). The + (/dev/ttydN.lock and + /dev/cuadN.lock on + &os; 6.X, + /dev/ttyldN and + /dev/cualdN on + &os; 5.X and older). The initialization devices are used to initialize communications port parameters each time a port is opened, such as crtscts for modems which use @@ -654,10 +659,10 @@ crw-rw---- 1 uucp dialer 28, 193 Feb 15 14:38 /dev/cuala1 Serial Port Configuration ttyd - cuaa + cuad The ttydN (or - cuaaN) device is the + cuadN) 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 @@ -672,7 +677,7 @@ crw-rw---- 1 uucp dialer 28, 193 Feb 15 14:38 /dev/cuala1 and flow control by default for ttyd5, type: - &prompt.root; stty -f /dev/ttyid5 clocal cs8 ixon ixoff + &prompt.root; stty -f /dev/ttyd5.init clocal cs8 ixon ixoff rc files @@ -693,7 +698,7 @@ crw-rw---- 1 uucp dialer 28, 193 Feb 15 14:38 /dev/cuala1 device. For example, to lock the speed of ttyd5 to 57600 bps, type: - &prompt.root; stty -f /dev/ttyld5 57600 + &prompt.root; stty -f /dev/ttyd5.lock 57600 Now, an application that opens ttyd5 and tries to change the speed of @@ -1318,7 +1323,7 @@ ttyd5 "/usr/libexec/getty std.19200" vt100 on insecure /sbin/init what tty devices should have getty processes running on them. Lastly, you can place port initialization commands in the - /etc/rc.serial script. + /etc/rc.d/serial script. There are two schools of thought regarding dial-up modems on &unix;. One group likes to configure their modems and systems so that no matter @@ -1539,7 +1544,7 @@ vq|VH57600|Very High Speed Modem at 57600,8-bit:\ - <filename>/etc/rc.serial</filename> + <filename>/etc/rc.d/serial</filename> rc files rc.serial @@ -1548,7 +1553,7 @@ vq|VH57600|Very High Speed Modem at 57600,8-bit:\ High-speed modems, like V.32, V.32bis, and V.34 modems, need to use hardware (RTS/CTS) flow control. You can add stty commands to - /etc/rc.serial to set the hardware flow + /etc/rc.d/serial to set the hardware flow control flag in the FreeBSD kernel for the modem ports. @@ -1556,10 +1561,10 @@ vq|VH57600|Very High Speed Modem at 57600,8-bit:\ crtscts on serial port #1's (COM2) dial-in and dial-out initialization devices, the following lines could be added to - /etc/rc.serial: + /etc/rc.d/serial: # Serial port initial configuration -stty -f /dev/ttyid1 crtscts -stty -f /dev/cuaia1 crtscts +stty -f /dev/ttyd1.init crtscts +stty -f /dev/cuad1.init crtscts @@ -1870,28 +1875,22 @@ AT&B2&W 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/cuaa0, + hooked up to the first serial port, /dev/cuad0, then put in the following line: - cuaa0:dv=/dev/cuaa0:br#19200:pa=none + cuad0:dv=/dev/cuad0:br#19200:pa=none Use the highest bps rate your modem supports in the br capability. - Then, type tip cuaa0 and you will be connected to + Then, type tip cuad0 and you will be connected to your modem. - If there is no /dev/cuaa0 on your system, do - this: - - &prompt.root; cd /dev -&prompt.root; sh MAKEDEV cuaa0 - Or use cu as root with the following command: &prompt.root; cu -lline -sspeed line is the serial port - (e.g./dev/cuaa0) and + (e.g./dev/cuad0) and speed is the speed (e.g.57600). When you are done entering the AT commands hit ~. to exit. @@ -1917,9 +1916,9 @@ AT&B2&W /etc/remote file. For example: tip115200|Dial any phone number at 115200 bps:\ - :dv=/dev/cuaa0:br#115200:at=hayes:pa=none:du: + :dv=/dev/cuad0:br#115200:at=hayes:pa=none:du: tip57600|Dial any phone number at 57600 bps:\ - :dv=/dev/cuaa0:br#57600:at=hayes:pa=none:du: + :dv=/dev/cuad0:br#57600:at=hayes:pa=none:du: Then you can do things like: @@ -1929,7 +1928,7 @@ tip57600|Dial any phone number at 57600 bps:\ use a generic cu entry: cu115200|Use cu to dial any number at 115200bps:\ - :dv=/dev/cuaa1:br#57600:at=hayes:pa=none:du: + :dv=/dev/cuad1:br#57600:at=hayes:pa=none:du: and type: @@ -1960,7 +1959,7 @@ tip57600|Dial any phone number at 57600 bps:\ muffin|muffin.deep13.com|Frank's machine:\ :cm=CONNECT muffin\n:tc=deep13: deep13:Gizmonics Institute terminal server:\ - :dv=/dev/cuaa2:br#38400:at=hayes:du:pa=none:pn=5551234: + :dv=/dev/cuad2: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 muffin, and @@ -1980,7 +1979,7 @@ deep13:Gizmonics Institute terminal server:\ big-university:\ :pn=\@:tc=dialout dialout:\ - :dv=/dev/cuaa3:br#9600:at=courier:du:pa=none: + :dv=/dev/cuad3:br#9600:at=courier:du:pa=none: Then, list the phone numbers for the university in /etc/phones: