]> git.ozlabs.org Git - ppp.git/blob - README.sol2
config: Include some extra files in the tarball
[ppp.git] / README.sol2
1 Introduction.
2 *************
3
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:
9
10     https://www.illumos.org/
11     https://illumos.org/docs/about/distro/
12
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:
16
17     https://download.samba.org/pub/ppp/
18
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.
23
24
25 Installation.
26 *************
27
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
30    work.
31
32 2. Run the configure script and build the package.
33
34      ./configure --with-runtime-dir=/var/run --with-logfile-dir=/var/log/ppp
35      make
36
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
41    options.
42
43 3. Install the programs.
44
45      sudo make install
46
47    This installs the following:
48
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
54     
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:
61
62      #!/bin/sh
63      /usr/sbin/ndd -set /dev/ip ip_forwarding 1
64
65    See the man page for ip(7p) for details.
66
67
68 Synchronous Serial Support.
69 ***************************
70
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.
75
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.
79
80   How to start pppd with synchronous support:
81
82         #!/bin/sh
83
84         local=1.1.1.1   # your ip address here
85         baud=38400      # needed, but ignored by serial driver
86
87         # Change to the correct serial driver/port
88         #dev=/dev/zsh0
89         dev=/dev/se_hdlc0
90  
91         # Change the driver, nrzi mode, speed and clocking to match
92         # your setup.
93         # This configuration is for external clocking from the DCE
94         connect="syncinit se_hdlc0 nrzi=no speed=64000 txc=rxc rxc=rxc"
95  
96         /usr/sbin/pppd $dev sync $baud novj noauth $local: connect "$connect"
97
98   Sample Cisco router config excerpt:
99
100         !
101         ! Cisco router setup as DCE with RS-232 DCE cable
102         ! 
103         !         
104         interface Serial0
105          ip address 1.1.1.2 255.255.255.0
106          encapsulation ppp
107          clockrate 64000
108          no nrzi-encoding
109          no shutdown
110         !