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