openvpn/src/plugins/down-root/README.down-root
Alon Bar-Lev ce8271f5d4 build: integrate plugins build into core build
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>
2012-06-26 11:29:02 +02:00

29 lines
866 B
Text

down-root -- an OpenVPN Plugin Module
SYNOPSIS
The down-root module allows an OpenVPN configuration to
call a down script with root privileges, even when privileges
have been dropped using --user/--group/--chroot.
This module uses a split privilege execution model which will
fork() before OpenVPN drops root privileges, at the point where
the --up script is usually called. The module will then remain
in a wait state until it receives a message from OpenVPN via
pipe to execute the down script. Thus, the down script will be
run in the same execution environment as the up script.
BUILD
Build this module with the "make" command. The plugin
module will be named openvpn-down-root.so
USAGE
To use this module, add to your OpenVPN config file:
plugin openvpn-down-root.so "command ..."
CAVEATS
This module will only work on *nix systems, not Windows.