Skip to content

Commit

Permalink
Updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
winterheart committed Apr 1, 2019
1 parent ea659c6 commit 84509f7
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 29 deletions.
2 changes: 1 addition & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ install(FILES accel-pptp.8 DESTINATION share/man/man8)
# Packaging stuff
set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "Accel-PPTP client plugin for PPPd")
set(CPACK_PACKAGE_VENDOR "Azamat H. Hackimov <[email protected]")
set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_CURRENT_SOURCE_DIR}/README")
set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_CURRENT_SOURCE_DIR}/README.md")
set(CPACK_RESOURCE_FILE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/COPYING")
set(CPACK_SOURCE_PACKAGE_FILE_NAME
"${CMAKE_PROJECT_NAME}-${PROJECT_VERSION}")
Expand Down
61 changes: 33 additions & 28 deletions README → README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,23 @@
Overview
--------
The ACCEL-PPTP is PPTP client plugin for PPP.
ACCEL-PPTP
==========
The **ACCEL-PPTP** is PPTP client plugin for PPP.
ACCEL-PPTP uses kernel module to increase performance and decrease system usage.
For more documentation about PPTP visit POPTOP web site.

Requirment
----------
1. Modern linux distribution
2. kernel-2.6.36 or later with PPTP support
3. pppd-2.4.2 or later
4. CMake 2.6 or later
* Modern linux distribution
* kernel-2.6.36 or later with PPTP support
* pppd-2.4.2 or later
* CMake 3.1 or later

Compilation
-----------
First at all, make sure that your kernel properly configured. You should have
pptp.ko kernel module. Here some hints, how to enable support in kernel (tested
on 2.6.39):

```
[*] Networking support ->
Networking options ->
[*] TCP/IP networking ->
Expand All @@ -26,36 +27,43 @@ Device Drivers ->
[*] Network device support ->
<M> PPP (point-to-point protocol) support ->
<M> PPP over IPv4 (PPTP)
```

Don't forget load module pptp.ko when connecting:

```
modprobe pptp

```

Untar tarball:

```
tar jxvf accel-pptp-<VER>.tar.bz2
```

Create build directory:

```
mkdir accel-pptp_build
cd accel-pptp_build
```

Now you can compile plugin (PPP_PREFIX_DIR is where PPP prefix dir, usually
this is /usr):
Now you can compile plugin:

cmake ../accel-pptp-<VER> -DPPP_PREFIX_DIR=/usr
```
cmake ../accel-pptp-<VER>
make
```

Insallation
-----------
Just make install from accel-pptp_build directory.

Installation
------------
Just `make install` from accel-pptp_build directory.

Configuration
-------------
If you are beginner in PPTP please read documentation available on POPTOP web
site.

Configuration is same as original pptpd and pptp.
Exception in configuration of client is:
replace line in peer config file (for instance, /etc/ppp/peers/my_vpn):
Expand All @@ -64,31 +72,28 @@ to
plugin "/usr/lib/pptp.so" (path may differ)
pptp_server x.x.x.x (required)
pptp_phone xxxx (optional)
pptp_window xxx (optional) - this is sliding window size (at current time
automatic algorithm is not implemented),
pptp_window xxx (optional) - this is sliding window size (at current time automatic algorithm is not implemented),
set it to 3-10 for low-speed connections,
to >10 for hi-speed connections.

Remove lock option in /etc/ppp/options.pptp, /etc/ppp/options.pptpd or similar
if it exists.
Remove `lock` option in `/etc/ppp/options.pptp`, `/etc/ppp/options.pptpd` or similar if it exists.

See configuration example in example directory.


Warning !!!
-----------
1. This driver conflicts with ip_gre driver (in kernel), so make sure that
ip_gre is not built-in or loaded at run time.
2. Never mix connections of accel-pptp and original pptpd, before starting
accel-pptp make sure that no connections of original pptpd exists.
3. If you are upgrading pppd, don't forget recompile and reinstall pptp plugin
too.
Warning
-------

* This driver conflicts with ip_gre driver (in kernel), so make sure that ip_gre is not built-in or loaded at run time.
* Never mix connections of accel-pptp and original pptpd, before starting accel-pptp make sure that no connections of
original pptpd exists.
* If you are upgrading pppd, don't forget recompile and reinstall pptp plugin too.


Thanks
------
Author of original accel-pptp code Dmitry Kozlov <[email protected]>

Thanks to Kirill Yushkov for debug support and donations.

https://github.com/winterheart/accel-pptp/

0 comments on commit 84509f7

Please sign in to comment.