NAME

LCFG::Inventory - fetch and parse XML inventory

SYNOPSYS

use LCFG::Inventory;

  # Fetch and Parse LCFG inventory from server

  $inv = new LCFG::Inventory
     ( URL => "http://blah";,          # URL
       CACHE => "/foo/mycache",       # Persistent cache
       DEBUG => 1,                    # Debugging
       FORCE => 1,                    # Force refresh the cache
       NOFETCH => 1                   # Use cache copy only
     );

  # Return list of FQDNS in inventory

  @hosts = $inv->Hosts();

  # Return inventory fields for given FQDN

  $hash = $inv->Lookup("foo.bar.com");

  # Return hash of meta-information about inventory

  $hash = $inv->Meta();

DESCRIPTION

When a new LCFG::Inventory object is created, the XML inventory information is fetched from the specified URL, parsed and cached in a local file. The Hosts() function will return a list of FQDNs for all the hosts in the inventory, and the Lookup() function returns a hash of the inventory fields for a given FQDN.

If an explicit CACHE option is given, the named file will be used to store a persistent cache which will only be refreshed when the remote XML changes. The FORCE option can be used to force the refresh of a persistent cache, and the NOFETCH option can be used to force the use of the local cache without checking the remote copy.

EXAMPLE

/usr/share/doc/lcfg-inventory-1.1.18/example

PLATFORMS

Solaris9, Fedora3, Fedora5, Fedora6, Scientific5

AUTHOR

Stephen Quinney <squinney@inf.ed.ac.uk>