README
1Poptop README
2-------------
3
4You *must* do a 'make install' or Poptop will *NOT* find the binaries!
5See INSTALL for generic compile/install instructions, and run
6"./configure --help" for a list of valid options, or just type:
7
8./configure
9make
10make install
11
12(make install copies the binaries to /usr/local/sbin, so you better be root)
13
14To run Poptop simply type: 'pptpd' (or /usr/local/sbin/pptpd if you don't
15have /usr/local/sbin in your path).
16
17You may specify a number of options on the command line to change
18how Poptop launches PPP.
19
20Type: 'pptpd -h' for options you may specify on the command line.
21
22A sample config file is in samples/
23
24For more help look in html/
25or visit the Poptop web site at: http://poptop.sourceforge.net/
26
27
28Good Luck!
29
30-Poptop Development Team
31
README.bcrelay
1BCrelay v0.5 by Richard de Vroede <r.devroede@linvision.com>
2Original program by: TheyCallMeLuc(at)yahoo.com.au
3-------------------------------------------------------------------------------
4Index
51. License
62. What is it?
73. Usage
84. Contact
9
10-------------------------------------------------------------------------------
111. License
12
13This program is free software; you can redistribute it and/or
14modify it under the terms of the GNU General Public License
15as published by the Free Software Foundation; either version 2
16of the License, or (at your option) any later version.
17
18This program is distributed in the hope that it will be useful,
19but WITHOUT ANY WARRANTY; without even the implied warranty of
20MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21GNU General Public License for more details.
22
23You should have received a copy of the GNU General Public License
24along with this program; if not, write to the Free Software
25Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26Your copy is available at: http://www.gnu.org/licenses/gpl.html
27
28-------------------------------------------------------------------------------
292. What is it?
30
31A broadcast packet repeater. This packet repeater (currently designed
32for udp packets) will listen for broadcast packets. When it receives
33the packets on the incoming interface, it will then re-broadcast them
34to the outgoing interface.
35
36-------------------------------------------------------------------------------
373. Usage
38
39Usage: /usr/sbin/bcrelay [options], where options are:
40
41 [-d] [--daemon] Run as daemon.
42 [-h] [--help] Displays this help message.
43 [-i] [--incoming] Defines from which interface broadcasts will be
44 relayed.
45 [-o] [--outgoing] Defines to which interface broadcasts will be
46 relayed.
47 [-s] [--ipsec] Defines an ipsec tunnel to be relayed to.
48 Since ipsec tunnels terminate on the same
49 interface, we need to define the broadcast
50 address of the other end-point of the
51 tunnel. This is done as ipsec0:x.x.x.255
52 [-v] [--version] Displays the BCrelay version number.
53
54Logs and debugging go to syslog as DAEMON.
55
56Interfaces can be specified as regexpressions, ie. ppp[0-9]+
57
58-------------------------------------------------------------------------------
594. Contact
60
61All comments, patches, improvements can be mailed to me, or the
62mailing list. If it makes sense, I will update this package.
63
64Richard de Vroede : r.devroede@linvision.com
65Original author : TheyCallMeLuc@yahoo.com.au
66Poptop Mailinglist : poptop-server@lists.sourceforge.net
67Official Poptop website : http://www.poptop.org
68SourceForge Poptop website : http://sourgeforge.net/projects/poptop
69
70-------------------------------------------------------------------------------
71
72
73
README.cvs
120040425
2
3a) the main CVS module "poptop" is no longer the stable version, it is
4 all versions, and the HEAD is unstable.
5
6b) CVS tags have been added:
7
8 poptop-1_1_3-a is the previous stable version tag.
9 (before merging 1.1.4 changes with 1.1.3 head)
10 pptpd-1_2_0-b1 is the first beta of the new release.
11 pptpd-1_2_0-b2 is the second beta of the new release.
12 pptpd-1_2_0-b3 is the third beta of the new release.
13
14 See "man cvs" for how to check out or track a tag release.
15
16c) the secondary CVS module "poptop-1.1.3" is deprecated, but HEAD
17 contains 1.1.4-b4.
18
19d) 1.1.4-b4 plus a few minor edits has been released to a small test
20 team as 1.2.0-b2. Results will be published when known. Other
21 testers welcome; write to me.
22
23CVS Tags (module poptop)
24
25cvs tag -F pptpd-1_2_0-b3
26cvs tag -F pptpd-1_2_0-b2
27cvs tag -F poptop-1_1_3-a (before merging 1.1.4 changes with 1.1.3 head)
28
29
README.inetd
1It is possible to run from inetd but you must consider
2the following:
3
4 You use pptpctrl not pptpd.
5
6 You must put pptpctrl in /etc/services as port 1723.
7
8 You must configure pppd to allocate IP addresses (eg,
9 use /etc/options.ttyXX, the pppd erpcd hack and an erpcd,
10 or some other modification to pppd).
11
12 libwrap is not used in this mode - you should use tcp
13 wrappers in inetd like with any other network service.
14
15 The configuration file is ignored in this mode.
16
17 An example command line is:
18
19 pptpctrl 0 0 0 0 0
20
21 This would be put in inetd.conf as (assuming Linux tcp
22 wrappers):
23
24 pptpctrl stream tcp nowait root /usr/sbin/tcpd /usr/local/sbin/pptpctrl 0 0 0 0 0 --buffer--
25
26 Note the --buffer-- is just to make the process name
27 longer so it can modify its name to something meaningful.
28
29 First option: debugging (0 for off, 1 for on)
30 Second option: PPP options file (0 for off, 1 followed
31 by a file name for on)
32 Third option: TTY speed (0 for default, 1 followed
33 by a speed to set a speed)
34 Fourth option: Local IP address (0 for pppd-determined,
35 1 followed by an address to set)
36 Fifth option: Remote IP address (0 for pppd-determined,
37 1 followed by an address to set)
38
39 Another example, debugging on, alternate config file,
40 setting tty speed and specifying the local IP address:
41
42 pptpctrl 1 1 /etc/ppp/options.PPTP 1 115200 1 192.168.0.1 0
43
44David Luyer, luyer@ucs.uwa.edu.au
45Tue Jun 15 16:06:05 WST 1999
46
README.logwtmp
1$Id: README.logwtmp,v 1.1 2004/04/28 11:36:07 quozl Exp $
2pptpd 1.2.0 logwtmp feature, by James Cameron, 28th April 2004.
3
4The --logwtmp feature uses the standard wtmp feature to track users
5who have connections to the server. It works as follows.
6
7When a connection occurs, pptpd launches pppd with two additional
8options. The first option directs pppd to load the pptpd-logwtmp.so
9plugin. The second option is the IP address of the client.
10
11 "plugin /usr/lib/pptpd/pptpd-logwtmp.so"
12 "pptpd-original-ip 10.0.0.1"
13
14The plugin defines the pptpd-original-ip option so that pppd will
15accept it.
16
17If the plugin fails to load, pppd will fail in the usual manner. Such
18a failure will usually be related to a missing file in /usr/lib/pptpd.
19
20The plugin asks pppd to notify it when IP comes up or goes down.
21
22When IP comes up, the plugin's ip_up() function executes, calling
23logwtmp() to mark the user as logged in. Once this has happened,
24commands like "who" will show the user. The tty will be set to the
25PPP interface name.
26
27When IP goes down, the plugin's ip_down() function executes, removing
28the entry from wtmp. Note that a "kill -9" on the pppd will result in
29a user appearing to remain logged in. Don't use "kill -9", use an
30ordinary kill.
31
32If pppd debug mode is enabled, the plugin announces it's version when
33loaded, and reports the parameters it is handing over to the logwtmp
34call. See the plugins/pptpd-logwtmp.c source.
35
36--
37
README.portslave
README.slirp
1How 2 use slirp with pptpd-0.9.0
2
3o Grab the slirp-1.0c package and install it
4 ftp://blitzen.canberra.edu.au/pub/slirp/slirp-1.0c.tar.gz
5 (other versions might work also, but were not tested)
6
7Then install pptpd
8
9o ./configure --with-slirp
10
11o Set path to slirp in config.h right
12
13o Be sure to have a HOME variable set when you start
14 pptpd, because slirp reads the HOME/.chap-secrets file
15 for authentication
16 This file must be filled in the same way as the
17 chap-secrets for pppd
18
19o For the rest follow the pptpd instructions
20
21o I have tested this with a Solaris 2.4 server, gcc and
22 pptpd running on this configuration. As client I used
23 Win95 DUN 1.3. I only tested this on a local network because
24 our routers still block port 47.
25 With this test I get a clean authentication.
26
27Harald Vogt, vogt@serc.nl
28Mon Jun 14 09:49:40 MET DST 1999
29
30