diff options
Diffstat (limited to 'manifests/defines/line.pp')
| -rw-r--r-- | manifests/defines/line.pp | 43 |
1 files changed, 27 insertions, 16 deletions
diff --git a/manifests/defines/line.pp b/manifests/defines/line.pp index 7ca3191..ccfa357 100644 --- a/manifests/defines/line.pp +++ b/manifests/defines/line.pp @@ -2,27 +2,38 @@ # Copyright (C) 2007 David Schmitt <david@schmitt.edv-bus.at> # See LICENSE for the full license granted to you. -# Usage: -# line { description: -# file => "filename", -# line => "content", -# ensure => {absent,*present*} -# } +# Ensures that a specific line is present or absent in a file. This can +# be very brittle, since even small changes can throw this off. # -# Example: -# The following ensures that the line "allow ^$munin_host$" exists -# in /etc/munin/munin-node.conf, and if there are any changes notify the service for -# a restart +# If the line is not present yet, it will be appended to the file. +# +# The name of the define is not used. Just keep it (globally) unique and +# descriptive. # -# line { allow_munin_host: -# file => "/etc/munin/munin-node.conf", -# line => "allow ^$munin_host$", -# ensure => present, -# notify => Service[munin-node], -# require => Package[munin-node], +# Use this only for very trivial stuff. Usually replacing the whole file +# is a more stable solution with less maintenance headaches afterwards. +# +# Usage: +# line { +# description: +# file => "filename", +# line => "content", +# ensure => {absent,*present*} # } # +# Example: +# The following ensures that the line "allow ^$munin_host$" exists in +# /etc/munin/munin-node.conf, and if there are any changes notify the +# service for a restart # +# line { +# allow_munin_host: +# file => "/etc/munin/munin-node.conf", +# line => "allow ^$munin_host$", +# ensure => present, +# notify => Service[munin-node], +# require => Package[munin-node]; +# } define line($file, $line, $ensure = 'present') { case $ensure { default : { err ( "unknown ensure value '${ensure}'" ) } |