~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

<div id="breadCrumbs"><a href="../index.html">Home</a> > <a href="../index-modules-A.html">Core modules</a> > <a href="../index-modules-E.html">E</a> > ExtUtils::Installed</div>

<div id="contentBody"><div class="title_container"><div class="page_title">ExtUtils::Installed</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#USAGE">USAGE</a><li><a href="#FUNCTIONS">FUNCTIONS</a><li><a href="#EXAMPLE">EXAMPLE</a><li><a href="#AUTHOR">AUTHOR</a></ul><a name="NAME"></a><h1>NAME</h1>

ExtUtils::Installed - Inventory management of installed modules

<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>

<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../ExtUtils/Installed.html">ExtUtils::Installed</a>;

<a class="l_k" href="../functions/my.html">my</a> ($inst) = <a class="l_w" href="../ExtUtils/Installed.html">ExtUtils::Installed</a>->new();

<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> ExtUtils::Installed;

<a class="l_k" href="../functions/my.html">my</a> ($inst) = ExtUtils::Installed->new();

<a class="l_k" href="../functions/my.html">my</a> (@modules) = $inst->modules();

<a class="l_k" href="../functions/my.html">my</a> (@missing) = $inst->validate("DBI");

<a class="l_k" href="../functions/my.html">my</a> $all_files = $inst->files("DBI");

102

105

<a name="USAGE"></a><h1>USAGE</h1>

103

106

The new() function searches for all the installed .packlists on the system, and

104

107

stores their contents. The .packlists can be queried with the functions

105

described below.

108

described below. Where it searches by default is determined by the settings found

109

in <code class="inline">%Config::Config</code>

110

, and what the value is of the PERL5LIB environment variable.

106

111

<a name="FUNCTIONS"></a><h1>FUNCTIONS</h1>

107

112

<ul>

108

113

<li><a name="new()"></a>new()

109

This takes no parameters, and searches for all the installed .packlists on the

110

system. The packlists are read using the ExtUtils::packlist module.

114

This takes optional named parameters. Without parameters, this

115

searches for all the installed .packlists on the system using

116

information from <code class="inline">%Config::Config</code>

117

and the default module search

118

paths <code class="inline">@INC</code>

119

. The packlists are read using the

120

<a href="../ExtUtils/Packlist.html">ExtUtils::Packlist</a> module.

121

If the named parameter <code class="inline">config_override</code>

122

is specified,

123

it should be a reference to a hash which contains all information

124

usually found in <code class="inline">%Config::Config</code>

125

. For example, you can obtain

126

the configuration information for a separate perl installation and

127

pass that in.

128

<pre class="verbatim"> <a class="l_k" href="../functions/my.html">my</a> $yoda_cfg = get_fake_config('yoda');

129

<a class="l_k" href="../functions/my.html">my</a> $yoda_inst = ExtUtils::Installed->new(config_override=>$yoda_cfg);</pre>

130

Similarly, the parameter <code class="inline">inc_override</code>

131

may be a reference to an

132

array which is used in place of the default module search paths

133

from <code class="inline">@INC</code>

134

.

135

<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> Config;

136

<a class="l_k" href="../functions/my.html">my</a> @dirs = <a class="l_k" href="../functions/split.html">split</a>(/\Q$Config{path_sep}\E/, $ENV{PERL5LIB});

137

<a class="l_k" href="../functions/my.html">my</a> $p5libs = ExtUtils::Installed->new(inc_override=>\@dirs);</pre>

138

The parameter c<extra_libs> can be used to specify additional paths to

139

search for installed modules. For instance

140

<pre class="verbatim"> <a class="l_k" href="../functions/my.html">my</a> $installed = ExtUtils::Installed->new(extra_libs=>["/my/lib/path"]);</pre>

141

This should only be necessary if <code class="inline">/my/lib/path</code> is not in PERL5LIB.

111

142

</li>

112

143

<li><a name="modules()"></a>modules()

113

144

This returns a list of the names of all the installed modules. The perl 'core'

169

200

170

201

</form>

171

202

203

172

204

<h2>Labels:</h2>

173

205

174

206

Older »