pfdoc.rb

pfdoc.rb - da sexiest way

pfdoc.rb is a parser which makes your pf.conf looks very sexy by writing an elegant documentation (from here just called as pfdoc).

First scenario: you have a medium to large client with almost 900 lines of conf. Everything works fine even with your quick fixes, redundant rules, etc. Someday your boss (who you love) request a paper with your firewall rules for some audit and you'll have two hours to delivery entire work... (need I say more?)

Second scenario: you have all your macros, tables, queues, rules or anything else, commented and described, line per line, all what you did, how traffic works, wich services are (dis)allowed, what ip's are blocked, etc.

First of all, I assume you are living the second scenario, just because when you left your currently employer someone will mantain all work did, and you'll love that person: because he/she will do the same work you did and loved too, right?!

Development Status

pfdoc currently only proccess macros.