Book HomeJava and XSLTSearch this book

8.72. ExtUtils::Installed

Provides inventory management for installed modules, based on the contents of the .packlist files that are created during installation. It also permits classifying the installed files and extracting directory information from the .packlist files.

new

$inst = ExtUtils::Installed->new(  )

Searches for all installed .packlists on the system and stores their contents. Takes no parameters; uses ExtUtils::Packlist to read the .packlist files.

directories

$inst->directories(module[, string[, dir[,...]]])

Returns list of directories. Returns only directories that contain files from the specified module. Parameters are:

module
Required. The name of a module; returns a list of all directories in the package.

string
Optional. Possible values are prog, man, or all to return program directories, manual directories, or all directories, respectively.

dir
Optional. One or more directories. If specified, only directories under the specified directories are returned.

directory_tree

$inst->directory_tree(module[, string[, dir[,...]]])

Like directories, but includes all intermediate directories.

files

$inst->files(module[, string[, dir[,...]]])

Returns list of filenames. Parameters are:

module
Required. The name of a module; returns a list of all filenames in the package. For a list of core files, use the special module name Perl.

string
Optional. Possible values are prog, man, or all to return program files, manual files, or all files, respectively.

dir
Optional. One or more directories. If specified, only filenames under the specified directories are returned.

modules

$inst->modules(  )

Returns list of names of all the installed modules. Calls the Perl "core" by the special name Perl.

packlist

$inst->packlist(module)

Returns the ExtUtils::Packlist object for the specified module.

validate

$inst->validate(module[, arg])

Takes the name of a module as a required parameter and validates that all files listed in the packlist for the module actually exist. Returns list of any missing files. With an optional second argument that evaluates to true, removes missing files from .packlist.

version

$inst->version(module)

Returns the version number of the specified module.



Library Navigation Links

Copyright © 2002 O'Reilly & Associates. All rights reserved.