Version information
Start using this module
Add this module to your Puppetfile:
mod 'csail-freebsd', '0.0.1'Learn more about managing modules with a PuppetfileDocumentation
freebsd
This is the freebsd module. It contains classes, types, and facts useful for FreeBSD systems.
What's in it
-
rc_conf, periodic_conf, loader_conf - manage the contents of the named files. These are based on the examples from the Puppet Wiki, and depend on the shell_config type (defined in our shell_config module), which really should be a Puppet core type. Note that the Augeas lens that shell_config currently depends on fails on loader.conf files that contain tunables, because the shell (unlike /boot/loader) doesn't allow dots in variable names. This will need to be fixed in the FreeBSD Augeas port or upstream Augeas; we use a custom hacked package.
-
ipfw - simple firewall configuration. Currently this only implements the standard firewall types known by /etc/rc.firewall (and all it does is put the relevant thing into /etc/rc.conf); if you specify a pathname as the firewall type, a dependency will be created automatically (but it's up to you to define the resource); there are too many different ways firewall rules can be defined. You might build a more complicated data model on top of this module. It defines Service['firewall'].
-
pf - stub class for future use. This class would implement the same interface for pf as the ipfw class does for the standard firewall, perhaps with some extra pf-specific features. It also defines Service['firewall'].
-
localbase - a fact that determines the package prefix (by calling "pkg query", so pkgng is mandatory) so that Puppet modules do not need to hardcode this configuration variable. So named because it's the counterpart to ${LOCALBASE} in bsd.port.mk. It should be defined by the FreeBSD puppet port instead, and then it could be hard-coded to the correct value, eliminating a fork/exec from fact resolution.
Features will be removed from this module if and when comparable features are added to mainline Puppet or to the FreeBSD puppet port.
License
With the exception of the three types derived from examples on the Puppet Wiki, all code and documentation is provided under the terms of the MIT license; see the file LICENSE.
Contact
Support
You must be joking.
Dependencies
- csail/shell_config (>= 0.0.1)
To the extent that the code in this module was developed by employees of M.I.T., the following statement applies. M.I.T. claims no copyright on code indicated as having been taken from the Puppet Wiki. Copyright 2012 Massachusetts Institute of Technology Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that both the above copyright notice and this permission notice appear in all copies, that both the above copyright notice and this permission notice appear in all supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.