cdist/cdist/conf/type/__pf_ruleset/man.rst

52 lines
1.1 KiB
ReStructuredText
Raw Normal View History

cdist-type__pf_ruleset(7)
=========================
NAME
----
cdist-type__pf_ruleset - Copy a pf(4) ruleset to $__target_host
2016-05-20 06:50:56 +00:00
Jake Guffey <jake.guffey--@--eprotex.com>
DESCRIPTION
-----------
2016-05-20 06:50:56 +00:00
This type is used on \*BSD systems to manage the pf firewall's ruleset.
REQUIRED PARAMETERS
-------------------
2016-05-20 06:50:56 +00:00
state
Either "absent" (no ruleset at all) or "present", defaults to "present".
OPTIONAL PARAMETERS
-------------------
2016-05-20 06:50:56 +00:00
source
If supplied, use to define the ruleset to load onto the $__target_host for pf(4).
Note that this type is almost useless without a ruleset defined, but it's technically not
needed, e.g. for the case of disabling the firewall temporarily.
EXAMPLES
--------
2016-05-20 06:50:56 +00:00
.. code-block:: sh
2016-05-20 06:50:56 +00:00
# Remove the current ruleset in place
__pf_ruleset --state absent
2016-05-20 06:50:56 +00:00
# Enable the firewall with the ruleset defined in $__manifest/files/pf.conf
__pf_ruleset --state present --source $__manifest/files/pf.conf
SEE ALSO
--------
2016-05-20 06:50:56 +00:00
- `cdist-type(7) <cdist-type.html>`_
- pf(4)
COPYING
-------
Copyright \(C) 2012 Jake Guffey. Free use of this software is
granted under the terms of the GNU General Public License version 3 (GPLv3).