mirror of
https://github.com/OpenVPN/openvpn.git
synced 2026-05-28 04:03:29 -04:00
doc: Remove some explanations for pre-2.3 configurations
Just streamline the documentation a bit. Change-Id: Ieaaf3a79642c8f7914f9bfc6762ad601c4f5695b Signed-off-by: Frank Lichtenheld <frank@lichtenheld.com> Acked-by: Arne Schwabe <arne-openvpn@rfc2549.org> Gerrit URL: https://gerrit.openvpn.net/c/openvpn/+/1603 Message-Id: <20260402120435.39983-1-frank@lichtenheld.com> URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg36434.html Signed-off-by: Gert Doering <gert@greenie.muc.de>
This commit is contained in:
parent
9b663a0824
commit
ecda555404
1 changed files with 7 additions and 19 deletions
|
|
@ -43,11 +43,11 @@ which mode OpenVPN is configured as.
|
|||
however complications can result when scripts or restarts are executed
|
||||
after the chroot operation.
|
||||
|
||||
Note: The SSL library will probably need /dev/urandom to be available
|
||||
Note: The SSL library will probably need ``/dev/urandom`` to be available
|
||||
inside the chroot directory ``dir``. This is because SSL libraries
|
||||
occasionally need to collect fresh randomness. Newer linux kernels and some
|
||||
BSDs implement a getrandom() or getentropy() syscall that removes the
|
||||
need for /dev/urandom to be available.
|
||||
need for ``/dev/urandom`` to be available.
|
||||
|
||||
--compat-mode version
|
||||
This option provides a convenient way to alter the defaults of OpenVPN
|
||||
|
|
@ -170,9 +170,7 @@ which mode OpenVPN is configured as.
|
|||
Note: as soon as OpenVPN has daemonized, it can not ask for usernames,
|
||||
passwords, or key pass phrases anymore. This has certain consequences,
|
||||
namely that using a password-protected private key will fail unless the
|
||||
``--askpass`` option is used to tell OpenVPN to ask for the pass phrase
|
||||
(this requirement is new in v2.3.7, and is a consequence of calling
|
||||
daemon() before initializing the crypto layer).
|
||||
``--askpass`` option is used to tell OpenVPN to ask for the pass phrase.
|
||||
|
||||
Further, using ``--daemon`` together with ``--auth-user-pass`` (entered
|
||||
on console) and ``--auth-nocache`` will fail as soon as key
|
||||
|
|
@ -330,32 +328,22 @@ which mode OpenVPN is configured as.
|
|||
OpenVPN releases before v2.3 also supported a ``method`` flag which
|
||||
indicated how OpenVPN should call external commands and scripts. This
|
||||
could be either :code:`execve` or :code:`system`. As of OpenVPN 2.3, this
|
||||
flag is no longer accepted. In most \*nix environments the execve()
|
||||
approach has been used without any issues.
|
||||
flag is no longer accepted.
|
||||
|
||||
Some directives such as ``--up`` allow options to be passed to the
|
||||
external script. In these cases make sure the script name does not
|
||||
contain any spaces or the configuration parser will choke because it
|
||||
can't determine where the script name ends and script options start.
|
||||
|
||||
To run scripts in Windows in earlier OpenVPN versions you needed to
|
||||
either add a full path to the script interpreter which can parse the
|
||||
script or use the ``system`` flag to run these scripts. As of OpenVPN
|
||||
2.3 it is now a strict requirement to have full path to the script
|
||||
On Windoes it is a strict requirement to have the full path to the script
|
||||
interpreter when running non-executables files. This is not needed for
|
||||
executable files, such as .exe, .com, .bat or .cmd files. For example,
|
||||
if you have a Visual Basic script, you must use this syntax now:
|
||||
|
||||
::
|
||||
if you have a Visual Basic script, you must use this syntax::
|
||||
|
||||
--up 'C:\\Windows\\System32\\wscript.exe C:\\Program\ Files\\OpenVPN\\config\\my-up-script.vbs'
|
||||
|
||||
Please note the single quote marks and the escaping of the backslashes
|
||||
(\\) and the space character.
|
||||
|
||||
The reason the support for the :code:`system` flag was removed is due to
|
||||
the security implications with shell expansions when executing scripts
|
||||
via the :code:`system()` call.
|
||||
(``\\``) and the space character.
|
||||
|
||||
--setcon context
|
||||
Apply SELinux ``context`` after initialization. This essentially
|
||||
|
|
|
|||
Loading…
Reference in a new issue