---
name: "cdist-type__pf_ruleset"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__pf_ruleset"
---

# cdist-type\_\_pf\_ruleset(7)

Copy a pf(4) ruleset to $\_\_target\_host

## NAME

cdist-type\_\_pf\_ruleset - Copy a [pf(4)](/pf/4.md) ruleset to $\_\_target\_host

## DESCRIPTION

This type is used on \*BSD systems to manage the pf firewall's ruleset.

It will also enable and disable the pf firewall as requested in the *state* parameter.

## REQUIRED PARAMETERS

- **state**

  Either "absent" (no ruleset at all) or "present", defaults to "present".

## OPTIONAL PARAMETERS

- **source**

  Required when state is "present". Defines the ruleset to load onto the $\_\_target\_host for *[pf(4)](/pf/4.md)*.

## EXAMPLES

```
# Remove the current ruleset in place and disable pf
__pf_ruleset --state absent
# Enable pf with the ruleset defined in $__manifest/files/pf.conf
__pf_ruleset --state present --source $__manifest/files/pf.conf
```

## SEE ALSO

[**pf**(4)](/pf/4.md)

## AUTHORS

Kamila Součková \<*coding--@--kamila.is*\> Jake Guffey \<*jake.guffey--@--eprotex.com*\>

## COPYING

Copyright (C) 2016 Kamila Součková. Copyright (C) 2012 Jake Guffey. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

## COPYRIGHT

ungleich GmbH 2021