README.down-root
1down-root -- an OpenVPN Plugin Module
2
3SYNOPSIS
4
5The down-root module allows an OpenVPN configuration to
6call a down script with root privileges, even when privileges
7have been dropped using --user/--group/--chroot.
8
9This module uses a split privilege execution model which will
10fork() before OpenVPN drops root privileges, at the point where
11the --up script is usually called. The module will then remain
12in a wait state until it receives a message from OpenVPN via
13pipe to execute the down script. Thus, the down script will be
14run in the same execution environment as the up script.
15
16BUILD
17
18Build this module with the "make" command. The plugin
19module will be named openvpn-down-root.so
20
21USAGE
22
23To use this module, add to your OpenVPN config file:
24
25 plugin openvpn-down-root.so "command ..."
26
27CAVEATS
28
29This module will only work on *nix systems, not Windows.
30