openvpn

mirror of https://github.com/OpenVPN/openvpn.git synced 2024-09-20 12:02:28 +02:00

History

Selva Nair d023fb661c Fix management-external-cert option parsing error - Allow --management-external-cert as an alternative to --cert - Also make sure --cert and --management-external-cert are not both specified, and clarify in the man page that the latter must be used with --management-external-key. Signed-off-by: Selva Nair <selva.nair@gmail.com> Acked-by: Gert Doering <gert@greenie.muc.de> Message-Id: <1466132093-1178-1-git-send-email-selva.nair@gmail.com> URL: http://article.gmane.org/gmane.network.openvpn.devel/11929 Signed-off-by: Gert Doering <gert@greenie.muc.de>		2016-06-23 13:42:42 +02:00
..
doxygen	Remove ENABLE_SSL define (and --disable-ssl configure option)	2014-12-31 17:36:54 +01:00
android.txt	Add documentation for PERSIST_TUN_ACTION (Android specific)	2014-10-07 22:18:04 +02:00
keying-material-exporter.txt	Added document for TLS Keying Material Exporters [RFC-5705]	2015-10-10 00:03:07 +02:00
Makefile.am	build: integrate plugins build into core build	2012-06-26 11:29:02 +02:00
management-notes.txt	extend management interface command "state"	2015-11-28 14:24:23 +01:00
openvpn.8	Fix management-external-cert option parsing error	2016-06-23 13:42:42 +02:00
README.plugins	build: integrate plugins build into core build	2012-06-26 11:29:02 +02:00

README.plugins

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.