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