components/ruby/facter/files/facter.8
branchs11-update
changeset 3401 bd976a0fa74e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/ruby/facter/files/facter.8	Fri Oct 17 09:32:29 2014 -0700
@@ -0,0 +1,102 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "FACTER" "8" "February 2014" "" ""
+.
+.SH "NAME"
+\fBfacter\fR \- Gather system information
+.
+.SH "SYNOPSIS"
+Collect and display facts about the system\.
+.
+.SH "USAGE"
+.
+.nf
+
+facter [\-h|\-\-help] [\-t|\-\-timing] [\-d|\-\-debug] [\-p|\-\-puppet] [\-v|\-\-version]
+  [\-y|\-\-yaml] [\-j|\-\-json] [\-\-plaintext] [\-\-external\-dir DIR] [\-\-no\-external\-dir]
+  [fact] [fact] [\.\.\.]
+.
+.fi
+.
+.SH "DESCRIPTION"
+Collect and display facts about the current system\. The library behind Facter is easy to expand, making Facter an easy way to collect information about a system from within the shell or within Ruby\.
+.
+.P
+If no facts are specifically asked for, then all facts will be returned\.
+.
+.SH "EXAMPLE"
+Display all facts:
+.
+.IP "" 4
+.
+.nf
+
+$ facter
+architecture => amd64
+blockdevices => sda,sr0
+domain => example\.com
+fqdn => puppet\.example\.com
+hardwaremodel => x86_64
+[\.\.\.]
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Display a single fact:
+.
+.IP "" 4
+.
+.nf
+
+$ facter kernel
+Linux
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Format facts as JSON:
+.
+.IP "" 4
+.
+.nf
+
+$ facter \-\-json architecture kernel hardwaremodel
+{
+  "architecture": "amd64",
+  "kernel": "Linux",
+  "hardwaremodel": "x86_64"
+}
+.
+.fi
+.
+.IP "" 0
+.
+.SH "AUTHOR"
+Luke Kanies
+.
+.SH "COPYRIGHT"
+Copyright (c) 2011\-2014 Puppet Labs, Inc Licensed under the Apache 2\.0 license
+.
+.SH "OPTIONS"
+.
+.nf
+
+\-y, \-\-yaml                       Emit facts in YAML format\.
+\-j, \-\-json                       Emit facts in JSON format\.
+    \-\-plaintext                  Emit facts in plaintext format\.
+    \-\-trace                      Enable backtraces\.
+    \-\-external\-dir DIR           The directory to use for external facts\.
+    \-\-no\-external\-dir            Turn off external facts\.
+\-d, \-\-debug                      Enable debugging\.
+\-t, \-\-timing                     Enable timing\.
+\-p, \-\-puppet                     Load the Puppet libraries, thus allowing Facter to load Puppet\-specific facts\.
+\-v, \-\-version                    Print the version and exit\.
+\-h, \-\-help                       Print this help message\.
+.
+.fi
+