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

# cdist-type\_\_iptables\_rule(7)

Deploy iptable rulesets

## NAME

cdist-type\_\_iptables\_rule - Deploy iptable rulesets

## DESCRIPTION

This cdist type allows you to manage iptable rules in a distribution independent manner.

See [**cdist-type\_\_iptables\_apply**(7)](/cdist-type__iptables_apply/7.md) for the execution order of these rules. It will be executed automaticly to apply all rules non-volaite.

## REQUIRED PARAMETERS

- **rule**

  The rule to apply. Essentially an iptables command line without iptables in front of it.

## OPTIONAL PARAMETERS

- **state**

  'present' or 'absent', defaults to 'present'

## BOOLEAN PARAMETERS

All rules without any of these parameters will be treated like **--v4** because of backward compatibility.

- **v4**

  Explicitly set it as rule for IPv4. If IPv6 is set, too, it will be threaten like **--all**. Will be the default if nothing else is set.

- **v6**

  Explicitly set it as rule for IPv6. If IPv4 is set, too, it will be threaten like **--all**.

- **all**

  Set the rule for both IPv4 and IPv6. It will be saved separately from the other rules.

## EXAMPLES

```
# Deploy some policies
__iptables_rule policy-in  --rule "-P INPUT DROP"
__iptables_rule policy-out  --rule "-P OUTPUT ACCEPT"
__iptables_rule policy-fwd  --rule "-P FORWARD DROP"
# The usual established rule
__iptables_rule established  --rule "-A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT"
# Some service rules
__iptables_rule http  --rule "-A INPUT -p tcp --dport 80 -j ACCEPT"
__iptables_rule ssh   --rule "-A INPUT -p tcp --dport 22 -j ACCEPT"
__iptables_rule https --rule "-A INPUT -p tcp --dport 443 -j ACCEPT"
# Ensure some rules are not present anymore
__iptables_rule munin --rule "-A INPUT -p tcp --dport 4949 -j ACCEPT" \
    --state absent
# IPv4-only rule for ICMPv4
__iptables_rule icmp-v4 --v4 --rule "-A INPUT -p icmp -j ACCEPT"
# IPv6-only rule for ICMPv6
__iptables_rule icmp-v6 --v6 --rule "-A INPUT -p icmpv6 -j ACCEPT"
# doing something for the dual stack
__iptables_rule fwd-eth0-eth1 --v4 --v6 --rule "-A INPUT -i eth0 -o eth1 -j ACCEPT"
__iptables_rule fwd-eth1-eth0 --all --rule "-A -o eth1 -i eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT"
```

## SEE ALSO

[**cdist-type\_\_iptables\_apply**(7)](/cdist-type__iptables_apply/7.md), [**iptables**(8)](/iptables/8.md)

## AUTHORS

Nico Schottelius \<*nico-cdist--@--schottelius.org*\> Matthias Stecher \<*matthiasstecher--@--gmx.de*\>

## COPYING

Copyright (C) 2013 Nico Schottelius. Copyright (C) 2020 Matthias Stecher. 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