/py-pf

Python module for managing OpenBSD's Packet Filter

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

py-pf

py-pf is a pure-Python module for managing OpenBSD's Packet Filter. It aims to add powerful and flexible scripting capabilities to PF, making integration with third-party software (like IDS, web-based configuration interfaces or custom management scripts) much easier.

It runs on Python 3, which is available through OpenBSD's packages and ports system.

Installation

Download the source code from GitHub and run the install script:

# python setup.py install

Tests

To run the test suite, just run:

# python setup.py test

Documentation

A detailed description of the PF module and its classes is available at http://www.kernel-panic.it/programming/py-pf/.

A brief list of references, documentation and books about Python, OpenBSD and Packet Filter can be found at http://www.kernel-panic.it/software/py-pf/resources.html.

Credits

Copyright (c) 2008-2022 Daniele Mazzocchio (danix@kernel-panic.it).

Licensed under BSD license (see LICENSE.md file).