X-Git-Url: https://pwan.org/git/?p=certmaster.git;a=blobdiff_plain;f=docs%2Ffunc-inventory.pod;fp=docs%2Ffunc-inventory.pod;h=0000000000000000000000000000000000000000;hp=cfe362db052b0a89472c8b6ae57d31cf24ccc600;hb=8f2ff4d7c902d534d68ff1a16418b7be492033bf;hpb=5b2601a56907b02efc6567354fa051ef08d97b6f diff --git a/docs/func-inventory.pod b/docs/func-inventory.pod deleted file mode 100644 index cfe362d..0000000 --- a/docs/func-inventory.pod +++ /dev/null @@ -1,70 +0,0 @@ -=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 - - -