mirror of
https://github.com/OpenVPN/openvpn.git
synced 2024-11-23 17:53:49 +08:00
ce8271f5d4
As disucssed[1], keep plugins in repository. 1, Proper automake/libtool build. 2. Move example plugins to samples/sample-plugins. 3. Plugins are installed at LIBDIR/openvpn/plugins. [1] http://comments.gmane.org/gmane.network.openvpn.devel/6436 Signed-off-by: Alon Bar-Lev <alon.barlev@gmail.com> Acked-by: David Sommerseth <davids@redhat.com> Message-Id: 1337035323-27465-1-git-send-email-alon.barlev@gmail.com URL: http://article.gmane.org/gmane.network.openvpn.devel/6591 Signed-off-by: David Sommerseth <davids@redhat.com>
48 lines
1.5 KiB
Plaintext
48 lines
1.5 KiB
Plaintext
OpenVPN Plugins
|
|
---------------
|
|
|
|
Starting with OpenVPN 2.0-beta17, compiled plugin modules are
|
|
supported on any *nix OS which includes libdl or on Windows.
|
|
One or more modules may be loaded into OpenVPN using
|
|
the --plugin directive, and each plugin module is capable of
|
|
intercepting any of the script callbacks which OpenVPN supports:
|
|
|
|
(1) up
|
|
(2) down
|
|
(3) route-up
|
|
(4) ipchange
|
|
(5) tls-verify
|
|
(6) auth-user-pass-verify
|
|
(7) client-connect
|
|
(8) client-disconnect
|
|
(9) learn-address
|
|
|
|
See the openvpn-plugin.h file in the top-level directory of the
|
|
OpenVPN source distribution for more detailed information
|
|
on the plugin interface.
|
|
|
|
Included Plugins
|
|
----------------
|
|
|
|
auth-pam -- Authenticate using PAM and a split privilege
|
|
execution model which functions even if
|
|
root privileges or the execution environment
|
|
have been altered with --user/--group/--chroot.
|
|
Tested on Linux only.
|
|
|
|
down-root -- Enable the running of down scripts with root privileges
|
|
even if --user/--group/--chroot have been used
|
|
to drop root privileges or change the execution
|
|
environment. Not applicable on Windows.
|
|
|
|
examples -- A simple example that demonstrates a portable
|
|
plugin, i.e. one which can be built for *nix
|
|
or Windows from the same source.
|
|
|
|
Building Plugins
|
|
----------------
|
|
|
|
cd to the top-level directory of a plugin, and use the
|
|
"make" command to build it. The examples plugin is
|
|
built using a build script, not a makefile.
|