ExtUtils::InstallPerl)Programmers ReferenceExtUtils::Installed(3)NAMEExtUtils::Installed - Inventory management of installed
modules
SYNOPSIS
use ExtUtils::Installed;
my ($inst) = ExtUtils::Installed->new();
my (@modules) = $inst->modules();
my (@missing) = $inst->validate("DBI");
my $all_files = $inst->files("DBI");
my $files_below_usr_local = $inst->files("DBI", "all", "/usr/local");
my $all_dirs = $inst->directories("DBI");
my $dirs_below_usr_local = $inst->directory_tree("DBI", "prog");
my $packlist = $inst->packlist("DBI");
DESCRIPTIONExtUtils::Installed provides a standard way to find out
what core and module files have been installed. It uses
the information stored in .packlist files created during
installation to provide this information. In addition it
provides facilities to classify the installed files and to
extract directory information from the .packlist files.
USAGE
The new() function searches for all the installed .pack
lists on the system, and stores their contents. The .pack
lists can be queried with the functions described below.
FUNCTIONSnew()
This takes no parameters, and searches for all the
installed .packlists on the system. The packlists are
read using the ExtUtils::packlist module.
modules()
This returns a list of the names of all the installed
modules. The perl 'core' is given the special name
'Perl'.
files()
This takes one mandatory parameter, the name of a mod
ule. It returns a list of all the filenames from the
package. To obtain a list of core perl files, use the
module name 'Perl'. Additional parameters are
allowed. The first is one of the strings "prog",
"man" or "all", to select either just program files,
just manual files or all files. The remaining parame
ters are a list of directories. The filenames returned
will be restricted to those under the specified direc
tories.
directories()
This takes one mandatory parameter, the name of a mod
ule. It returns a list of all the directories from
the package. Additional parameters are allowed. The
first is one of the strings "prog", "man" or "all", to
select either just program directories, just manual
directories or all directories. The remaining parame
ters are a list of directories. The directories
returned will be restricted to those under the speci
fied directories. This method returns only the leaf
directories that contain files from the specified mod
ule.
directory_tree()
This is identical in operation to directory(), except
that it includes all the intermediate directories back
up to the specified directories.
validate()
This takes one mandatory parameter, the name of a mod
ule. It checks that all the files listed in the mod
ules .packlist actually exist, and returns a list of
any missing files. If an optional second argument
which evaluates to true is given any missing files
will be removed from the .packlist
packlist()
This returns the ExtUtils::Packlist object for the
specified module.
version()
This returns the version number for the specified mod
ule.
EXAMPLE
See the example in the ExtUtils::Packlist manpage.
AUTHOR
Alan Burlison <Alan.Burlison@uk.sun.com>
2001-03-03 perl v5.6.1 ExtUtils::Installed(3)