diff options
author | Alon Bar-Lev <alon.barlev@gmail.com> | 2012-02-29 22:11:44 +0200 |
---|---|---|
committer | David Sommerseth <davids@redhat.com> | 2012-03-22 22:06:52 +0100 |
commit | 5c2922c4593b7eedc3f9c93958285d67afeb0d37 (patch) | |
tree | 60427c07b9697374627b2f52cb4328383ead17b1 /plugins/down-root/README | |
parent | ce3862789e5443758441c905569703577e67525a (diff) | |
download | openvpn-5c2922c4593b7eedc3f9c93958285d67afeb0d37.tar.gz openvpn-5c2922c4593b7eedc3f9c93958285d67afeb0d37.tar.xz openvpn-5c2922c4593b7eedc3f9c93958285d67afeb0d37.zip |
build: rename plugin directory to plugins
This to avoid conflit with plugin.c rules
Signed-off-by: Alon Bar-Lev <alon.barlev@gmail.com>
Acked-by: David Sommerseth <davids@redhat.com>
Signed-off-by: David Sommerseth <davids@redhat.com>
Diffstat (limited to 'plugins/down-root/README')
-rw-r--r-- | plugins/down-root/README | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/plugins/down-root/README b/plugins/down-root/README new file mode 100644 index 0000000..d337ffe --- /dev/null +++ b/plugins/down-root/README @@ -0,0 +1,29 @@ +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. |