mods from Francis Demierre: add SAY, HANGUP, CLR_ABORT, CLR_REPORT keywords
[ppp.git] / README.aix4
1
2 AIX 4.1 support is ported from the SunOS code for ppp 2.2. It requires
3 a streams-based tty and will not work on AIX 3.2. This is the first
4 release of this package for AIX. It is provided free and without warranty
5 of any kind.
6
7 Introduction
8
9   PPP implements TCP/IP through serial connections. In ppp 2.2, an
10   interface is established by running the program 'pppd'. pppd opens
11   a serial connection, negotiates link attributes with the peer and
12   configures a TCP/IP interface. The interface remains up as long as
13   the peer stays up and 'pppd' remains running. There are no SMIT menus
14   and ppp interfaces can not be defined through ifconfig. An interface 
15   can be brought down by killing pppd.
16
17   The program 'chat' processes send-expect sequences similar to UUCP
18   Dialers commands or a Systems chat string. It can be used to dial
19   a modem.
20
21   'pppstats' prints interface statistics similar to netstat. Some of the
22   statistics are the same as netstat but pppstat also provides additional
23   info specific to ppp interfaces. 
24
25 Installation
26
27   First execute the following commands in the ppp-2.2 directory:
28
29         ./configure
30         make install            (you need to be root for this)
31
32   By default, pppd, chat and pppstats are placed in /usr/sbin and the
33   streams modules in /usr/lib/drivers. The modules are loaded by the following
34   'strload' commands.
35   
36   strload -m /usr/lib/drivers/ppp_if
37   strload -m /usr/lib/drivers/ppp_comp
38   strload -m /usr/lib/drivers/ppp_async
39   
40   'make install' appends the strloads to /etc/rc.tcpip so the modules
41   will be loaded at boot.  A 'pppd' command can be added to start
42   up an interface.
43   
44   'make install' will also create /etc/ppp/options containing the option
45   'lock' only (lock tty device when in use). Any other options which will
46   always be used should be added by hand.
47   
48   Man pages for pppd and pppstats are installed.
49
50 Examples
51
52   To answer a modem and accept connections, use something like
53
54     pppd tty1 myhostname:remotehostname persist
55
56   This will wait for calls on tty1 and establish a connection with any
57   ppp caller. The server will use myhostname and tell the caller
58   to use remotehostname. The persist option tells pppd to remain 
59   active and accept another connection after the call terminates.
60   You can use the 'auth' option to force callers to authenticate
61   themselves. See pppd man page for details of authentication protocols.
62
63   To dial in to a user account and start PPP, use something like
64
65     pppd tty1 myhostname: connect 'chat -f /etc/ppp/chat-script'
66
67   where the file /etc/ppp/chat-script should contain something like
68
69     "" ATDT5551212 CONNECT "" ogin: myname sword: mypassword $ pppd
70
71   This command uses the chat program to dial the modem, log in and
72   start pppd on the server. No ttyname is needed when starting pppd on the
73   server side because pppd will attach to the current terminal (the tty line),
74   if no device is specified. Any pppd options needed can be set in ~/.ppprc
75   on the called system.
76
77   The chat -v option may be helpful in debugging connection failures. The
78   chat output and other debug messages are sent to syslog. You may need
79   to edit /etc/syslog.conf and "refresh -s syslogd" to see the debug messages.
80
81   The simplest way to allow a remote dial-in host to use your network is
82   to use the 'proxyarp' option on the server. This will cause the
83   server to publish an arp entry with the remote's IP address and the 
84   server's hardware address. The remote will then appear to be part of
85   local network to other hosts. The address/netmask used by the remote
86   must be suitable for the subnet you wish to connect to.  If the remote
87   is a standalone system, or has no other default route, use the
88   'defaultroute' option when dialing in. This will create a default route
89   on the remote system through the server. If the remote is on another
90   local network, you might not want this because it could conflict with
91   an existing default route.
92
93   These are just a few examples to help the new user get started. The
94   man page for pppd describes all the options in detail.
95
96         Charlie Wick
97