diff --git a/client/fwknop.8.in b/client/fwknop.8.in index 4e7b5fbc..c0bc4d93 100644 --- a/client/fwknop.8.in +++ b/client/fwknop.8.in @@ -2,12 +2,12 @@ .\" Title: fwknop .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 05/22/2015 +.\" Date: 08/24/2015 .\" Manual: Fwknop Client .\" Source: Fwknop Client .\" Language: English .\" -.TH "FWKNOP" "8" "05/22/2015" "Fwknop Client" "Fwknop Client" +.TH "FWKNOP" "8" "08/24/2015" "Fwknop Client" "Fwknop Client" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/doc/fwknopd.man.asciidoc b/doc/fwknopd.man.asciidoc index 167eda54..7b21d432 100644 --- a/doc/fwknopd.man.asciidoc +++ b/doc/fwknopd.man.asciidoc @@ -547,23 +547,35 @@ directive starts a new stanza. *sudo* provides a powerful means of restricting the sets of commands that users can execute via the ``sudoers'' file. By enabling this feature (and in ``ENABLE_CMD_EXEC'' mode), all incoming commands from valid SPA packets - will be prefixed by ``/path/to/sudo -u '' where the path to sudo is - set by the ``SUDO_EXE'' variable, and ``'' is set by the - ``CMD_EXEC_USER'' variable (default is ``root'' if not set). + will be prefixed by ``/path/to/sudo -u -g '' where the path + to sudo is set by the ``SUDO_EXE'' variable, ``'' is set by the + ``CMD_SUDO_EXEC_USER'' variable (default is ``root'' if not set), and + ``'' is set by ``CMD_SUDO_EXEC_GROUP'' (default is also ``root'' if + not set). *CMD_EXEC_USER* '':: - This specifies the user (via setuid) that will execute commands contained - within a SPA packet. If not specified, fwknopd will execute it as the user - it is running as (most likely root). Setting this to a non-root user such - as ``nobody'' is highly recommended if elevated permissions are not - needed. + Specify the user (via setuid) that will execute a command contained within + a SPA packet. If this variable is not given, fwknopd will execute the + command as the user it is running as (most likely root). Setting this to a + non-root user such as ``nobody'' is highly recommended if elevated + permissions are not needed. + +*CMD_SUDO_EXEC_USER* '':: + Specify the user (via ``sudo -u '') that will execute a command + contained within a SPA packet. If this variable is not given, fwknopd will + assume the command should be executed as root. *CMD_EXEC_GROUP* '':: - This specifies the group (via setgid) that will execute commands contained - within a SPA packet. If not specified, fwknopd will execute it as the user - it is running as (most likely root). Setting this to a non-root user such - as ``nobody'' is highly recommended if elevated permissions are not - needed. + Specify the group (via setgid) that will execute a command contained within + a SPA packet. If this variable is not given, fwknopd will execute the + command as the user it is running as (most likely root). Setting this to a + non-root user such as ``nobody'' is highly recommended if elevated + permissions are not needed. + +*CMD_SUDO_EXEC_GROUP* '':: + Specify the group (via ``sudo -gu '') that will execute a command + contained within a SPA packet. If this variable is not given, fwknopd will + assume the command should be executed as root. *SUDO_EXE* '':: Define the path to the sudo binary. Default is ``/usr/bin/sudo''. diff --git a/server/fwknopd.8.in b/server/fwknopd.8.in index 807df7e9..66131ed4 100644 --- a/server/fwknopd.8.in +++ b/server/fwknopd.8.in @@ -2,12 +2,12 @@ .\" Title: fwknopd .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 -.\" Date: 05/22/2015 +.\" Date: 08/24/2015 .\" Manual: Fwknop Server .\" Source: Fwknop Server .\" Language: English .\" -.TH "FWKNOPD" "8" "05/22/2015" "Fwknop Server" "Fwknop Server" +.TH "FWKNOPD" "8" "08/24/2015" "Fwknop Server" "Fwknop Server" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -387,6 +387,16 @@ Track digest sums associated with previous SPA packets processed by will not check incoming SPA packet data against any previously save digests\&. It is a good idea to leave this feature on to reduce the possibility of being vulnerable to a replay attack\&. .RE .PP +\fBRULES_CHECK_THRESHOLD\fR \fI\fR +.RS 4 +Defines the number of times firewall rule expiration times must be checked before a "deep" check is run\&. This allows +\fBfwknopd\fR +to remove rules that contain a proper +\fI\fIexp\fR\fR\fI