X-Git-Url: http://git.ozlabs.org/?p=ppp.git;a=blobdiff_plain;f=README.sol2;h=392f43f7f55ec269a5a62000a5dbb658b6452aa5;hp=e9457da281f026682e7024e90ece9f6702f0c7ec;hb=c291dcda5acdd3edb75c4127c7c001017ba3a876;hpb=e748bc9f53b7d1056eb0ef9c61fd43ddaae1060f;ds=sidebyside diff --git a/README.sol2 b/README.sol2 index e9457da..392f43f 100644 --- a/README.sol2 +++ b/README.sol2 @@ -4,6 +4,18 @@ but are not identical. The STREAMS kernel modules and driver for Solaris 2 are in the svr4 directory (and use some code from the modules directory). +This version has been tested under Solaris 7, and the upcoming +Solaris 8. As of now, it will only work when the system is booted +in 32-bit mode. 64-bit clean driver as well as IPv6 support for +Solaris 8 are currently under development. + +NOTE: Although the kernel driver and modules have been designed to +operate correctly on SMP systems, they have not been extensively +tested on SMP machines. Some users of SMP Solaris x86 systems have +reported system problems apparently linked to the use of previous +versions of this software. I believe these problems have been fixed. + + Installation. ************* @@ -34,7 +46,60 @@ local machine as a gateway to access other hosts. The solution is to create an /etc/ppp/ip-up script containing something like this: #!/bin/sh - /usr/sbin/ndd -set /dev/ip ip_forwarding 2 + /usr/sbin/ndd -set /dev/ip ip_forwarding 1 + +See the man page for ip(7p) for details. + +Synchronous Serial Support. +*************************** + +This version has working but limited support for the on-board synchronous HDLC +interfaces. It has been tested with the /dev/se_hdlc and /dev/zsh drivers. +Synchronous mode was tested with a Cisco router. + +There ppp daemon does not directly support controlling the serial interface. +It relies on the /usr/sbin/syncinit command to initialize HDLC mode and +clocking. + +Some bugs remain: large sized frames are not sent/received properly, and +may be related to the IP mtu. This +may be due to bugs in pppd itself, bugs in Solaris or the serial drivers. +The /dev/zsh driver seems more larger and can send/receive larger frames +than the /dev/se_hdlc driver. There is a confirmed bug with NRZ/NRZI mode +in the /dev/se_hdlc driver, and Solaris patch 104596-11 is needed to correct +it. (However this patch seems to introduce other serial problems. If you +don't apply the patch, the workaround is to change the nrzi mode to yes or +no, whichever works) + +How to start pppd with synchronous support: + +#!/bin/sh + +local=1.1.1.1 # your ip address here +baud=38400 # needed, but ignored by serial driver + +# Change to the correct serial driver/port +#dev=/dev/zsh0 +dev=/dev/se_hdlc0 + +# Change the driver, nrzi mode, speed and clocking to match your setup +# This configuration is for external clocking from the DCE +connect="syncinit se_hdlc0 nrzi=no speed=64000 txc=rxc rxc=rxc" + +/usr/sbin/pppd $dev sync $baud novj noauth $local: connect "$connect" + + +Sample Cisco router config excerpt: + +! +! Cisco router setup as DCE with RS-232 DCE cable +! +! +interface Serial0 + ip address 1.1.1.2 255.255.255.0 + encapsulation ppp + clockrate 64000 + no nrzi-encoding + no shutdown +! -Under Solaris 2.6, the value 2 is invalid; use 1 instead. See the man -page for ip(7p) for details.