1FUNC-INVENTORY(1) func-inventory FUNC-INVENTORY(1)
2
3
4
6 func-inventory -- Takes inventory of data from func minions, and stores
7 them in git.
8
10 func-inventory [--verbose] [--server-spec glob] [--methods list]
11 [--modules list] [--tree path] [--no-git]
12
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
23 Provides extra output about what func-inventory is doing.
24
26 A glob, as can be given to "func", that describes what machines the
27 inventory program should run against. The default is "*".
28
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
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
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
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
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
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
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
75 Michael DeHaan <mdehaan@redhat.com>
76
77
78
79 2012-10-15 FUNC-INVENTORY(1)