1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
=head1 NAME
func-inventory -- Takes inventory of data from func minions, and stores them in git.
=head1 SYNOPSIS
func-inventory [--verbose] [--server-spec glob] [--methods list] [--modules list] [--tree path] [--no-git]
=head1 DESCRIPTION
func-inventory runs against func-minions to gather information, and stores this information on the filesystem, in a tree arranged by hostname, module name, and method name.
After each update, differences are commited to version control (using git), where they can be examined with tools such as "git log" and "gitk".
=head1 --verbose
Provides extra output about what func-inventory is doing.
=head1 --server-spec
A glob, as can be given to "func", that describes what machines the inventory program should run against. The default is "*".
=head1 --modules list
A comma-seperated list of modules that should be included in the inventory, for instance "hardware,packages".
The default is "all".
=head1 --methods list
A comma-seperated list of methods that should be included in the inventory, for each module being queried. The default
is "info", which saves the data for any module that has an "info" method.
=head1 --tree-path
Selects the location where func-inventory will output data. The default is /var/lib/func/inventory. This directory will
contain a tree structure based on the hostnames, modules, and methods included in the inventory.
=head1 --no-git
Disables git integration, meaning changes will not be tracked using version control. This option is present
for those that do not have the "git-core" package installed, though installing it is highly recommended to get
the full degree of power out of func-inventory.
=head1 VIEWING CHANGES
Since func-inventory integrates with git, all changes to the remote systems (including additions of new systems) can
be tracked using standard git-tools such as "git log" and "gitk", when run on the directory specified for --tree.
Additional built in hooks to notify changes can be written using git's own trigger mechanism, though something
more specific to func will likely be developed in the future -- also eliminating the need to grok git internals.
=head1 ALTERNATIVE OUTPUT FORMATS
func-inventory can be passed a --json or --xmlrpc parameter to override the default output format. These
output formats are much less readable in the git-produced diffs, but are more easily loaded by other programs
that may want to "mine" the output of a func-inventory tree. Using --json requires that the python-simplejson
RPM be installed.
=head1 ADDITONAL RESOURCES
See https://hosted.fedoraproject.org/projects/func/ for more information.
See also the manpages for "func", "funcd", "certmaster", and "certmaster-ca".
=head1 AUTHOR
Michael DeHaan <mdehaan@redhat.com>
|
