This file describes the installation process for ppp-2.3 on systemsrunning Solaris 2.  The Solaris 2 and SVR4 ports share a lot of codebut are not identical.  The STREAMS kernel modules and driver forSolaris 2 are in the svr4 directory (and use some code from themodules directory).NOTE: Although the kernel driver and modules have been designed tooperate correctly on SMP systems, they have not been extensivelytested on SMP machines.  Some users of SMP Solaris x86 systems havereported system problems apparently linked to the use of previousversions of this software.  I believe these problems have been fixed.Installation.*************1. Run the configure script and make the user-level programs and thekernel modules.	./configure	makeIf you wish to use gcc (or another compiler) instead of Sun's cc, editthe svr4/Makedefs file and uncomment the definition of CC.  You canalso change the options passed to the C compiler by editing the COPTSdefinition.2. Install the programs and kernel modules: as root, do	make installThis installs pppd, chat and pppstats in /usr/local/bin and the kernelmodules in /kernel/drv and /kernel/strmod, and creates the /etc/pppdirectory and populates it with default configuration files.  You canchange the installation directories by editing svr4/Makedefs.If your system normally has only one network interface, the defaultSolaris 2 system startup scripts will disable IP forwarding in the IPkernel module.  This will prevent the remote machine from using thelocal machine as a gateway to access other hosts.  The solution is tocreate an /etc/ppp/ip-up script containing something like this:	#!/bin/sh	/usr/sbin/ndd -set /dev/ip ip_forwarding 1See the man page for ip(7p) for details.Dynamic STREAMS Re-Plumbing Support.************************************Solaris 8 includes dynamic re-plumbing support. With this, modulesbelow ip can be inserted, or removed, without having the ip stream beunplumbed, and re-plumbed again. All states in ip for an interfacewill therefore now be preserved. Users can install (or upgrade)modules like firewall, bandwidth manager, cache manager, tunneling,etc., without shutting the machine down.To support this, ppp driver now uses /dev/udp instead of /dev/ip forthe ip stream. The interface stream (where ip module pushed on top ofppp) is then I_PLINK'ed below the ip stream. /dev/udp is used becauseSTREAMS will not let a driver be PLINK'ed under itself, and /dev/ip istypically the driver at the bottom of the tunneling interfacesstream.  The mux ids of the ip streams are then added usingSIOCSxIFMUXID ioctl.Users will be able to see the modules on the interface stream by, forexample:    pikapon% ifconfig ppp modlist    0 ip    1 pppOr arbitrarily if bandwidth manager and firewall modules are installed:    pikapon% ifconfig hme0 modlist    0 arp    1 ip    2 ipqos    3 firewall    4 hmeSnoop Support.**************This version includes support for /usr/sbin/snoop. Tests has been doneon both Solaris 7 and 8. Only IPv4 and IPv6 packets will be sent up tostream(s) marked as promiscuous, e.g, snoop et al.Users will be able to see the packets on the ppp interface by, for example:    snoop -d ppp0See the man page for snoop(1M) for details.IPv6 Support.*************This is for Solaris 8 and later.This version has been tested under Solaris 8 running IPv6. As of now,interoperability testing has only been done between Solaris machinesin terms of the IPV6 NCP. An additional command line option for thepppd daemon has been added: ipv6cp-use-persistent.By default, compilation for IPv6 support is not enabled.  Uncommentthe necessary lines in pppd/Makefile.sol2 to enable it. Once done, thequickest way to get IPv6 running is to add the following somewhere inthe command line option:	+ipv6 ipv6cp-use-persistentThe persistent id for the link-local address was added to conform toRFC 2472; such that if there's an EUI-48 available, use that to makeup the EUI-64.  As of now, the Solaris implementation extracts theEUI-48 id from the Ethernet's MAC address (the ethernet interfaceneeds to be up).  Future works might support other ways of obtaining aunique yet persistent id, such as EEPROM serial numbers, etc.There need not be any up/down scripts for ipv6, e.g. /etc/ppp/ipv6-upor /etc/ppp/ipv6-down, to trigger IPv6 neighbor discovery for autoconfiguration and routing.  The in.ndpd daemon will perform all of thenecessary jobs in the background. /etc/inet/ndpd.conf can be furthercustomized to enable the machine as an IPv6 router. See the man pagefor in.ndpd(1M) and ndpd.conf(4) for details.Below is a sample output of "ifconfig -a" with persistent link-localaddress.  Note the UNNUMBERED flag is set because hme0 and ppp0 bothhave identical link-local IPv6 addresses:lo0: flags=1000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv4> mtu 8232 index 1        inet 127.0.0.1 netmask ff000000 hme0: flags=1000843<UP,BROADCAST,RUNNING,MULTICAST,IPv4> mtu 1500 index 2        inet 129.146.86.248 netmask ffffff00 broadcast 129.146.86.255        ether 8:0:20:8d:38:c1 lo0: flags=2000849<UP,LOOPBACK,RUNNING,MULTICAST,IPv6> mtu 8252 index 1        inet6 ::1/128 hme0: flags=2000841<UP,RUNNING,MULTICAST,IPv6> mtu 1500 index 2        ether 8:0:20:8d:38:c1         inet6 fe80::a00:20ff:fe8d:38c1/10 hme0:1: flags=2080841<UP,RUNNING,MULTICAST,ADDRCONF,IPv6> mtu 1500 index 2        inet6 fec0::56:a00:20ff:fe8d:38c1/64 hme0:2: flags=2080841<UP,RUNNING,MULTICAST,ADDRCONF,IPv6> mtu 1500 index 2        inet6 2000::56:a00:20ff:fe8d:38c1/64 hme0:3: flags=2080841<UP,RUNNING,MULTICAST,ADDRCONF,IPv6> mtu 1500 index 2        inet6 2::56:a00:20ff:fe8d:38c1/64 ppp0: flags=10008d1<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST,IPv4> mtu 1500 index 12        inet 172.16.1.1 --> 172.16.1.2 netmask ffffff00 ppp0: flags=2202851<UP,POINTOPOINT,RUNNING,MULTICAST,UNNUMBERED,NONUD,IPv6> mtu 1500 index 12        inet6 fe80::a00:20ff:fe8d:38c1/10 --> fe80::a00:20ff:fe7a:24fbNote also that a plumbed ipv6 interface stream will exist throughoutthe entire PPP session in the case where the peer rejects IPV6CP,which further causes the interface state to stay down. Unplumbing willhappen when the daemon exits. This is done by design and is not a bug.64-bit Support.***************This version has been tested under Solaris 7 (and Solaris 8 ) in both32- and 64-bits environments (Ultra class machines).  Installing thepackage by executing "make install" will result in additional filesresiding in /kernel/drv/sparcv9 and /kernel/strmod/sparcv9subdirectories.64-bit modules and driver have been compiled and tested using Sun's cc.Synchronous Serial Support.***************************This version has working but limited support for the on-boardsynchronous HDLC interfaces. It has been tested with the /dev/se_hdlcand /dev/zsh drivers.  Synchronous mode was tested with a Ciscorouter.There ppp daemon does not directly support controlling the serialinterface.  It relies on the /usr/sbin/syncinit command to initializeHDLC 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 pppditself, bugs in Solaris or the serial drivers.  The /dev/zsh driverseems more larger and can send/receive larger frames than the/dev/se_hdlc driver. There is a confirmed bug with NRZ/NRZI mode inthe /dev/se_hdlc driver, and Solaris patch 104596-11 is needed tocorrect it. (However this patch seems to introduce other serialproblems. If you don't apply the patch, the workaround is to changethe nrzi mode to yes or no, whichever works)How to start pppd with synchronous support:#!/bin/shlocal=1.1.1.1   # your ip address herebaud=38400	# needed, but ignored by serial driver# Change to the correct serial driver/port#dev=/dev/zsh0dev=/dev/se_hdlc0 # Change the driver, nrzi mode, speed and clocking to match your setup# This configuration is for external clocking from the DCEconnect="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!