1FUNC-INVENTORY(1)               func-inventory               FUNC-INVENTORY(1)
2
3
4

NAME

6       func-inventory -- Takes inventory of data from func minions, and stores
7       them in git.
8

SYNOPSIS

10       func-inventory [--verbose] [--server-spec glob] [--methods list]
11       [--modules list] [--tree path] [--no-git]
12

DESCRIPTION

14       func-inventory runs against func-minions to gather information, and
15       stores this information on the filesystem, in a tree arranged by host‐
16       name, module name, and method name.
17
18       After each update, differences are commited to version control (using
19       git), where they can be examined with tools such as "git log" and
20       "gitk".
21

--verbose

23       Provides extra output about what func-inventory is doing.
24

--server-spec

26       A glob, as can be given to "func", that describes what machines the
27       inventory program should run against.  The default is "*".
28

--modules list

30       A comma-seperated list of modules that should be included in the inven‐
31       tory, for instance "hardware,packages".  The default is "all".
32

--methods list

34       A comma-seperated list of methods that should be included in the inven‐
35       tory, for each module being queried.  The default is "info", which
36       saves the data for any module that has an "info" method.
37

--tree-path

39       Selects the location where func-inventory will output data.  The
40       default is /var/lib/func/inventory.  This directory will contain a tree
41       structure based on the hostnames, modules, and methods included in the
42       inventory.
43

--no-git

45       Disables git integration, meaning changes will not be tracked using
46       version control.   This option is present for those that do not have
47       the "git-core" package installed, though installing it is highly recom‐
48       mended to get the full degree of power out of func-inventory.
49

VIEWING CHANGES

51       Since func-inventory integrates with git, all changes to the remote
52       systems (including additions of new systems) can be tracked using stan‐
53       dard git-tools such as "git log" and "gitk", when run on the directory
54       specified for --tree.
55
56       Additional built in hooks to notify changes can be written using git's
57       own trigger mechanism, though something more specific to func will
58       likely be developed in the future -- also eliminating the need to grok
59       git internals.
60

ALTERNATIVE OUTPUT FORMATS

62       func-inventory can be passed a --json or --xmlrpc parameter to override
63       the default output format.  These output formats are much less readable
64       in the git-produced diffs, but are more easily loaded by other programs
65       that may want to "mine" the output of a func-inventory tree.   Using
66       --json requires that the python-simplejson RPM be installed.
67

ADDITONAL RESOURCES

69       See https://fedorahosted.org/func/ for more information.
70
71       See also the manpages for "func", "funcd", "certmaster", "certmas‐
72       ter-ca", and "func-transmit".
73

AUTHOR

75       Michael DeHaan <mdehaan@redhat.com>
76
77
78
79                                  2012-10-15                 FUNC-INVENTORY(1)
Impressum