Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for extutils::installed (redhat section 3pm)

ExtUtils::Installed(3pm)	 Perl Programmers Reference Guide	 ExtUtils::Installed(3pm)

NAME
       ExtUtils::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");

DESCRIPTION
       ExtUtils::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 instal-
       lation 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 .packlists on the system, and stores
       their contents. The .packlists can be queried with the functions described below.

FUNCTIONS
       new()
	   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 module.  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", "doc" or "all", to select either just program files, just manual files or all
	   files.  The remaining parameters are a list of directories. The filenames returned
	   will be restricted to those under the specified directories.

       directories()
	   This takes one mandatory parameter, the name of a module.  It returns a list of all
	   the directories from the package.  Additional parameters are allowed.  The first is
	   one of the strings "prog", "doc" or "all", to select either just program directories,
	   just manual directories or all directories.	The remaining parameters are a list of
	   directories. The directories returned will be restricted to those under the specified
	   directories.  This method returns only the leaf directories that contain files from
	   the specified module.

       directory_tree()
	   This is identical in operation to directories(), except that it includes all the
	   intermediate directories back up to the specified directories.

       validate()
	   This takes one mandatory parameter, the name of a module.  It checks that all the
	   files listed in the modules .packlist actually exist, and returns a list of any miss-
	   ing files.  If an optional second argument which evaluates to true is given any miss-
	   ing 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 module.

EXAMPLE
       See the example in ExtUtils::Packlist.

AUTHOR
       Alan Burlison <Alan.Burlison@uk.sun.com>

perl v5.8.0				    2002-06-01			 ExtUtils::Installed(3pm)


All times are GMT -4. The time now is 06:58 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password