From 9ffcd620373a1b42aeeb519f3d0cdea8ac1d7c22 Mon Sep 17 00:00:00 2001
From: Cédric Jeanneret <cedric.jeanneret@camptocamp.com>
Date: Thu, 11 Nov 2010 10:48:02 +0100
Subject: (bind) added documentation in files.

---
 manifests/definitions/bind-a.pp      | 12 ++++++++++++
 manifests/definitions/bind-aaaa.pp   | 12 ++++++++++++
 manifests/definitions/bind-cname.pp  | 12 ++++++++++++
 manifests/definitions/bind-mx.pp     | 15 ++++++++++++++-
 manifests/definitions/bind-ns.pp     | 12 ++++++++++++
 manifests/definitions/bind-record.pp | 14 ++++++++++++++
 manifests/definitions/bind-zone.pp   | 18 ++++++++++++++++++
 7 files changed, 94 insertions(+), 1 deletion(-)

(limited to 'manifests/definitions')

diff --git a/manifests/definitions/bind-a.pp b/manifests/definitions/bind-a.pp
index 37153b8..b0947d1 100644
--- a/manifests/definitions/bind-a.pp
+++ b/manifests/definitions/bind-a.pp
@@ -1,3 +1,15 @@
+/*
+
+= Definition: bind::a
+Creates an IPv4 record.
+
+Arguments:
+ *$zone*:  Bind::Zone name
+ *$owner*: owner of the Resource Record
+ *$host*:  target of the Resource Record
+ *$ttl*:   Time to Live for the Resource Record. Optional.
+
+*/
 define bind::a($ensure=present,
     $zone,
     $owner,
diff --git a/manifests/definitions/bind-aaaa.pp b/manifests/definitions/bind-aaaa.pp
index a20a58c..581e154 100644
--- a/manifests/definitions/bind-aaaa.pp
+++ b/manifests/definitions/bind-aaaa.pp
@@ -1,3 +1,15 @@
+/*
+
+= Definition: bind::aaaa
+Creates an IPv6 AAA record.
+
+Arguments:
+ *$zone*:  Bind::Zone name
+ *$owner*: owner of the Resource Record
+ *$host*:  target of the Resource Record
+ *$ttl*:   Time to Live for the Resource Record. Optional.
+
+*/
 define bind::aaaa($ensure=present,
     $zone,
     $owner,
diff --git a/manifests/definitions/bind-cname.pp b/manifests/definitions/bind-cname.pp
index e166738..d5e8209 100644
--- a/manifests/definitions/bind-cname.pp
+++ b/manifests/definitions/bind-cname.pp
@@ -1,3 +1,15 @@
+/*
+
+= Definition: bind::cname
+Creates a CNAME record.
+
+Arguments:
+ *$zone*:  Bind::Zone name
+ *$owner*: owner of the Resource Record
+ *$host*:  target of the Resource Record
+ *$ttl*:   Time to Live for the Resource Record. Optional.
+
+*/
 define bind::cname($ensure=present,
     $zone,
     $owner,
diff --git a/manifests/definitions/bind-mx.pp b/manifests/definitions/bind-mx.pp
index 7eb63d0..5090932 100644
--- a/manifests/definitions/bind-mx.pp
+++ b/manifests/definitions/bind-mx.pp
@@ -1,3 +1,16 @@
+/*
+
+= Definition: bind::mx
+Creates an MX record.
+
+Arguments:
+ *$zone*:     Bind::Zone name
+ *$owner*:    owner of the Resource Record
+ *$priority*: MX record priority
+ *$host*:     target of the Resource Record
+ *$ttl*:      Time to Live for the Resource Record. Optional.
+
+*/
 define bind::mx($ensure=present,
     $zone,
     $owner,
@@ -10,7 +23,7 @@ define bind::mx($ensure=present,
     ensure  => $ensure,
     notify  => Service["bind9"],
     content => template("bind/mx-record.erb"),
-    require => Bind::Zone[$zone],
+    require => [Bind::Zone[$zone], Bind::A[$host]],
   }
 }
 
diff --git a/manifests/definitions/bind-ns.pp b/manifests/definitions/bind-ns.pp
index 9919f53..64a5320 100644
--- a/manifests/definitions/bind-ns.pp
+++ b/manifests/definitions/bind-ns.pp
@@ -1,3 +1,15 @@
+/*
+
+= Definition: bind::mx
+Creates an NS record.
+
+Arguments:
+ *$zone*:  Bind::Zone name
+ *$owner*: owner of the Resource Record
+ *$host*:  target of the Resource Record
+ *$ttl*:   Time to Live for the Resource Record. Optional.
+
+*/
 define bind::ns($ensure=present,
     $zone,
     $owner,
diff --git a/manifests/definitions/bind-record.pp b/manifests/definitions/bind-record.pp
index 5e0cf6f..8312306 100644
--- a/manifests/definitions/bind-record.pp
+++ b/manifests/definitions/bind-record.pp
@@ -1,3 +1,17 @@
+/*
+
+= Definition: bind::record
+Helper to create any record you want (but NOT MX, please refer to Bind::Mx)
+
+Arguments:
+ *$zone*:        Bind::Zone name
+ *$owner*:       owner of the Resource Record
+ *$host*:        target of the Resource Record
+ *$record_type°:  resource record type
+ *$record_class*: resource record class. Default "IN".
+ *$ttl*:          Time to Live for the Resource Record. Optional.
+
+*/
 define bind::record($ensure=present,
     $zone,
     $owner,
diff --git a/manifests/definitions/bind-zone.pp b/manifests/definitions/bind-zone.pp
index 137bcd8..091b929 100644
--- a/manifests/definitions/bind-zone.pp
+++ b/manifests/definitions/bind-zone.pp
@@ -1,3 +1,21 @@
+/*
+
+= Definition: bind::zone
+Creates a valid Bind9 zone.
+
+Arguments:
+  *$is_slave*:          Boolean. Is your zone a slave or a master? Default false
+  *$zone_ttl*:          Time period. Time to live for your zonefile (master only)
+  *$zone_contact*:      Valid contact record (master only)
+  *$zone_serial*:       Integer. Zone serial (master only)
+  *$zone_refresh*:      Time period. Time between each slave refresh (master only)
+  *$zone_retry*:        Time period. Time between each slave retry (master only)
+  *$zone_expiracy*:     Time period. Slave expiracy time (master only)
+  *$zone_ns*:           Valid NS for this zone (master only)
+  *$zone_xfers*:        IPs. Valid xfers for zone (master only)
+  *$zone_masters*:      IPs. Valid master for this zone (slave only)
+
+*/
 define bind::zone($ensure=present,
     $is_slave=false,
     $zone_ttl=false,
-- 
cgit v1.2.3