← Back to branch summary

~ubuntu-branches/ubuntu/saucy/openvpn/saucy-proposed

« back to all changes in this revision

Viewing changes to plugin/down-root/README

  • Committer: Package Import Robot
  • Author(s): Stéphane Graber
  • Date: 2013-05-24 17:42:45 UTC
  • mfrom: (1.1.19) (10.2.22 sid)
  • Revision ID: package-import@ubuntu.com-20130524174245-g9y6wlforycufqy5
Tags: 2.3.1-2ubuntu1
* Merge from Debian unstable. Remaining changes:
  - debian/openvpn.init.d:
    + Do not use start-stop-daemon and </dev/null to avoid blocking boot.
    + Show per-VPN result messages.
    + Add "--script-security 2" by default for backwards compatabliity.

Show diffs side-by-side

added added

removed removed

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