summaryrefslogtreecommitdiffstats
path: root/lib/puppet/parser/functions
diff options
context:
space:
mode:
authorJames Turnbull <james@lovedthanlost.net>2010-12-15 23:39:12 +1100
committerPaul Berry <paul@puppetlabs.com>2011-02-01 16:42:46 -0800
commita732a15a0fd43ce983474cae4c298a9bbd86329f (patch)
tree6df0a8eb36c57635e8890ba35b5c0ffdb339218b /lib/puppet/parser/functions
parentaf6e08c0a59db951502d0cf8c0ca24f5001e92f1 (diff)
downloadpuppet-a732a15a0fd43ce983474cae4c298a9bbd86329f.tar.gz
puppet-a732a15a0fd43ce983474cae4c298a9bbd86329f.tar.xz
puppet-a732a15a0fd43ce983474cae4c298a9bbd86329f.zip
Fixed #5564 - Added some more fqdn_rand documentation
Reviewed-by: Paul Berry <paul@puppetlabs.com>
Diffstat (limited to 'lib/puppet/parser/functions')
-rw-r--r--lib/puppet/parser/functions/fqdn_rand.rb9
1 files changed, 6 insertions, 3 deletions
diff --git a/lib/puppet/parser/functions/fqdn_rand.rb b/lib/puppet/parser/functions/fqdn_rand.rb
index 3e7018ac4..52946f2c1 100644
--- a/lib/puppet/parser/functions/fqdn_rand.rb
+++ b/lib/puppet/parser/functions/fqdn_rand.rb
@@ -1,7 +1,10 @@
Puppet::Parser::Functions::newfunction(:fqdn_rand, :type => :rvalue, :doc =>
- "Generates random numbers based on the node's fqdn. The first argument
- sets the range. Additional (optional) arguments may be used to further
- distinguish the seed.") do |args|
+ "Generates random numbers based on the node's fqdn. Generated random values
+ will be a range from 0 up to and excluding n, where n is the first parameter.
+ The second argument specifies a number to add to the seed and is optional, for example:
+
+ $random_number = fqdn_rand(30)
+ $random_number_seed = fqdn_rand(30,30)") do |args|
require 'md5'
max = args.shift
srand MD5.new([lookupvar('fqdn'),args].join(':')).to_s.hex