summaryrefslogtreecommitdiffstats
path: root/lib/facter/id.rb
diff options
context:
space:
mode:
authorBen H <git@mumble.org.uk>2011-03-13 14:07:37 +1100
committerAdrien Thebo <adrien.thebo@gmail.com>2011-04-01 18:19:11 -0700
commitd31e3f9ee6b36e707a189569132bcdcea79f20f6 (patch)
tree2a1eea877715b67963b9f48de93c6fc73dab9838 /lib/facter/id.rb
parentaf4947c603b8f6610d861f303a7813cbc5ecf5e7 (diff)
downloadfacter-d31e3f9ee6b36e707a189569132bcdcea79f20f6.tar.gz
facter-d31e3f9ee6b36e707a189569132bcdcea79f20f6.tar.xz
facter-d31e3f9ee6b36e707a189569132bcdcea79f20f6.zip
(#5394) Document each Facter fact.
Document all the builtin Facter facts in puppetdoc/rdoc format. This is laying the ground work for using a tool like puppet doc, or puppet describe but for facter, so you can see what a fact is for and how it resolves this. This is the "leg work" of documenting the actual facts, and the syntax of them may change in future.
Diffstat (limited to 'lib/facter/id.rb')
-rw-r--r--lib/facter/id.rb13
1 files changed, 13 insertions, 0 deletions
diff --git a/lib/facter/id.rb b/lib/facter/id.rb
index 1c42284..cc0a0a6 100644
--- a/lib/facter/id.rb
+++ b/lib/facter/id.rb
@@ -1,3 +1,16 @@
+# Fact: id
+#
+# Purpose: Internal fact used to specity the program to return the currently
+# running user id.
+#
+# Resolution:
+# On all Unixes bar Solaris, just returns "whoami".
+# On Solaris, parses the output of the "id" command to grab the username, as
+# Solaris doesn't have the whoami command.
+#
+# Caveats:
+#
+
Facter.add(:id) do
setcode "whoami"
end