4 This file describes the installation process for ppp-2.5 on systems
5 running an OpenSolaris-derived OS, such as Illumos or OpenIndiana.
6 For these systems, the STREAMS kernel modules are supplied with the
7 OS itself and are used as-is by this distribution. For more
8 information on these distributions (including kernel source) see:
10 https://www.illumos.org/
11 https://illumos.org/docs/about/distro/
13 For Oracle Solaris systems, either use the vendor-supplied PPP
14 implementation ("Solaris PPP 4.0" based on pppd-2.4.0), or download
15 an older version of the pppd sources here:
17 https://download.samba.org/pub/ppp/
19 The last version known to compile and run correctly on Oracle
20 Solaris 10 is pppd-2.4.8. It may be possible to compile and use
21 newer versions on either Solaris 11 or by installing third-party
22 compilers; this has not been tested.
28 1. Make sure you have a suitable compiler installed. This package was
29 tested with "pkg install gcc-14" but other modern compilers should
32 2. Run the configure script and build the package.
34 ./configure --with-runtime-dir=/var/run --with-logfile-dir=/var/log/ppp
37 The configure script will automatically find the compiler if it's in
38 the standard location (/usr/bin/gcc). By default, everything will be
39 installed in /usr/local. Use "--prefix" to choose a different
40 installation directory if desired. Use "./configure -h" to see other
43 3. Install the programs.
47 This installs the following:
49 /usr/local/sbin pppd, chat, pppstats, pppdump
50 /usr/local/share/man/man8 man pages
51 /usr/local/include/pppd plug-in header files
52 /usr/local/lib/pppd/$VER plug-in modules
53 /usr/local/etc/ppp example configuration files
55 If your system normally has only one network interface at boot
56 time, the default Solaris system startup scripts will disable IP
57 forwarding in the IP kernel module. This will prevent the remote
58 machine from using the local machine as a gateway to access other
59 hosts. The solution is to create an /etc/ppp/ip-up script
60 containing something like this:
63 /usr/sbin/ndd -set /dev/ip ip_forwarding 1
65 See the man page for ip(7p) for details.
68 Synchronous Serial Support.
69 ***************************
71 This version has working but limited support for the on-board
72 synchronous HDLC interfaces. It has been tested with the
73 /dev/se_hdlc, /dev/zsh, HSI/S, and HSI/P drivers. Synchronous mode
74 was tested with a Cisco router.
76 The ppp daemon does not directly support controlling the serial
77 interface. It relies on the OS-supplied /usr/sbin/syncinit command
78 to initialize HDLC mode and clocking.
80 How to start pppd with synchronous support:
84 local=1.1.1.1 # your ip address here
85 baud=38400 # needed, but ignored by serial driver
87 # Change to the correct serial driver/port
91 # Change the driver, nrzi mode, speed and clocking to match
93 # This configuration is for external clocking from the DCE
94 connect="syncinit se_hdlc0 nrzi=no speed=64000 txc=rxc rxc=rxc"
96 /usr/sbin/pppd $dev sync $baud novj noauth $local: connect "$connect"
98 Sample Cisco router config excerpt:
101 ! Cisco router setup as DCE with RS-232 DCE cable
105 ip address 1.1.1.2 255.255.255.0