.\" 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