source: general/prog/perl-modules.xml@ 755e97c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 755e97c was 755e97c, checked in by Fernando de Oliveira <fernando@…>, 11 years ago

Update to fontconfig-2.11.0. Symlink added to SGMLSpm-1.1, to create sgmlspl

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11982 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 42.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY perl_modules_md5sums_download_http "&sources-anduin-http;/perl-modules/">
8 <!ENTITY perl_modules_md5sums_download_ftp "&sources-anduin-ftp;/perl-modules/">
9]>
10
11<sect1 id="perl-modules" xreflabel="Perl modules">
12 <?dbhtml filename="perl-modules.html" ?>
13
14 <sect1info>
15 <othername>$LastChangedBy$</othername>
16 <date>$Date$</date>
17 </sect1info>
18
19 <title>Perl Modules</title>
20
21 <indexterm zone="perl-modules">
22 <primary sortas="a-Perl-modules">Perl modules</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Perl Modules</title>
27
28 <para>The <application>Perl</application> module packages add useful
29 objects to the <application>Perl</application> language. Modules utilized
30 by packages throughout BLFS are listed here, along with their dependencies.
31 Installation of the modules shown on this page should be accomplished by
32 installing the dependencies in the order listed. The Perl Module standard
33 build and installation instructions are shown at the bottom of this page.
34 </para>
35
36 <!-- <itemizedlist spacing="compact">
37 <listitem>
38 <para>Download MD5 sums (HTTP):
39 <ulink url="&perl_modules_md5sums_download_http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download MD5 sums (FTP):
43 <ulink url="&perl_modules_md5sums_download_ftp;"/></para>
44 </listitem>
45 </itemizedlist> -->
46
47 <!-- Archive::Zip -->
48 <bridgehead renderas="sect3" id="perl-archive-zip"
49 xreflabel="Archive::Zip-&Archive-Zip-version;">
50 Archive::Zip-&Archive-Zip-version;</bridgehead>
51
52 <indexterm zone="perl-modules perl-archive-zip">
53 <primary sortas="a-Archive-Zip">Archive::Zip</primary>
54 </indexterm>
55
56 <para>The Archive::Zip module allows a <application>Perl</application>
57 program to create, manipulate, read, and write Zip archive files. This
58 module uses the standard <xref linkend="perl-standard-install"/>.</para>
59
60 &lfs74_checked;
61
62 <itemizedlist>
63 <listitem>
64 <para>
65 <ulink url="http://www.cpan.org/authors/id/A/AD/ADAMK/Archive-Zip-&Archive-Zip-version;.tar.gz">
66 Archive::Zip-&Archive-Zip-version;</ulink> (MD5 sum: 40153666e7538b410e001aa8a810e702)
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <!-- Crypt::SSLeay
72 <bridgehead renderas="sect3" id="perl-crypt-ssleay"
73 xreflabel="Crypt::SSLeay-&Crypt-SSLeay-version;">
74 Crypt::SSLeay-&Crypt-SSLeay-version;</bridgehead>
75
76 <indexterm zone="perl-modules perl-crypt-ssleay">
77 <primary sortas="a-Crypt-SSLeay">Crypt::SSLeay</primary>
78 </indexterm>
79
80 <para>The Crypt::SSLeay module provides support for the HTTPS protocol under
81 LWP, to allow an LWP::UserAgent object to perform GET, HEAD and POST
82 requests. This module and the dependency modules use the standard
83 <xref linkend="perl-standard-install"/>.</para>
84
85 <itemizedlist>
86 <listitem>
87 <para>
88 <ulink url="http://www.cpan.org/authors/id/N/NA/NANIS/Crypt-SSLeay-&Crypt-SSLeay-version;.tar.gz">
89 Crypt::SSLeay-&Crypt-SSLeay-version;</ulink> (MD5 sum: 4812f14d6e8c71714a26c0ad733666dc)
90 </para>
91 <itemizedlist>
92 <listitem>
93 <para>
94 <xref linkend="openssl"/>
95 </para>
96 </listitem>
97 <listitem>
98 <para>
99 <ulink url="http://search.cpan.org/~gaas/LWP-Protocol-https/">LWP::Protocol::https</ulink>
100 </para>
101 <itemizedlist>
102 <listitem>
103 <para>
104 <xref linkend="perl-lwp"/>
105 </para>
106 </listitem>
107 <listitem>
108 <para>
109 <ulink url="http://search.cpan.org/~behroozi/IO-Socket-SSL/">IO::Socket::SSL</ulink>
110 </para>
111 <itemizedlist>
112 <listitem>
113 <para>
114 <ulink url="http://search.cpan.org/dist/Net-SSLeay/">Net::SSLeay</ulink>
115 </para>
116 </listitem>
117 </itemizedlist>
118 </listitem>
119 <listitem>
120 <para>
121 <ulink url="http://search.cpan.org/~abh/Mozilla-CA/">Mozilla::CA</ulink>
122 </para>
123 </listitem>
124 </itemizedlist>
125 </listitem>
126 <listitem>
127 <para>
128 <ulink url="http://search.cpan.org/~doy/Try-Tiny/">Try::Tiny</ulink>
129 </para>
130 </listitem>
131 </itemizedlist>
132 </listitem>
133 </itemizedlist> -->
134
135 <!-- Date::Manip
136 <bridgehead renderas="sect3" id="perl-date-manip"
137 xreflabel="Date::Manip-&Date-Manip-version;">
138 Date::Manip-&Date-Manip-version;</bridgehead>
139
140 <indexterm zone="perl-modules perl-date-manip">
141 <primary sortas="a-Date-Manip">Date::Manip</primary>
142 </indexterm>
143
144 <para>Date::Manip is a set of routines designed to make any common
145 date/time manipulation easy to do. Operations such as comparing two times,
146 calculating a time a given amount of time from another, or parsing
147 international times are all easily done. From the very beginning, the
148 main focus of Date::Manip has been to be able to do ANY desired date/time
149 operation easily. This module and the dependency module use the standard
150 <xref linkend="perl-standard-install"/>.</para>
151
152 <itemizedlist>
153 <listitem>
154 <para>
155 <ulink url="http://www.cpan.org/authors/id/S/SB/SBECK/Date-Manip-&Date-Manip-version;.tar.gz">
156 Date::Manip-&Date-Manip-version;</ulink> (MD5 sum: 5fd8ba69642db5fc87a99eab6376c0ac)
157 </para>
158 <itemizedlist>
159 <listitem>
160 <para>
161 <ulink url="http://search.cpan.org/~sbeck/Test-Inter/">Test::Inter</ulink>
162 (optionally used for the tests)
163 </para>
164 </listitem>
165 </itemizedlist>
166 </listitem>
167 </itemizedlist> -->
168
169 <!-- ExtUtils::Depends
170 <bridgehead renderas="sect3" id="perl-extutils-depends"
171 xreflabel="ExtUtils::Depends-&ExtUtils-Depends-version;">
172 ExtUtils::Depends-&ExtUtils-Depends-version;</bridgehead>
173
174 <indexterm zone="perl-modules perl-extutils-depends">
175 <primary sortas="a-ExtUtils-Depends">ExtUtils::Depends</primary>
176 </indexterm>
177
178 <para>
179 ExtUtils::Depends tries to make it easy to build Perl extensions that use
180 functions and typemaps provided by other perl extensions. This means that
181 a perl extension is treated like a shared library that provides also a C
182 and an XS interface besides the perl one.
183 </para>
184
185 <itemizedlist>
186 <listitem>
187 <para>
188 <ulink url="http://www.cpan.org/authors/id/F/FL/FLORA/ExtUtils-Depends-&ExtUtils-Depends-version;.tar.gz">
189 ExtUtils::Depends-&ExtUtils-Depends-version;</ulink>
190 (uses the standard <xref linkend="perl-standard-install"/>)</para>
191 </listitem>
192 </itemizedlist> -->
193
194 <!-- ExtUtils::PkgConfig
195 <bridgehead renderas="sect3" id="perl-extutils-pkgconfig"
196 xreflabel="ExtUtils::PkgConfig-&ExtUtils-PkgConfig-version;">
197 ExtUtils::PkgConfig-&ExtUtils-PkgConfig-version;</bridgehead>
198
199 <indexterm zone="perl-modules perl-extutils-pkgconfig">
200 <primary sortas="a-ExtUtils-PkgConfig">ExtUtils::PkgConfig</primary>
201 </indexterm>
202
203 <para>
204 ExtUtils::PkgConfig is a very simplistic interface to
205 <xref linkend="pkgconfig"/>, intended for use in the Makefile.PL of perl
206 extensions which bind libraries that <application>pkgconfig</application>
207 knows.
208 </para>
209
210 <itemizedlist>
211 <listitem>
212 <para>
213 <ulink url="http://www.cpan.org/authors/id/X/XA/XAOC/ExtUtils-PkgConfig-&ExtUtils-PkgConfig-version;.tar.gz">
214 ExtUtils::PkgConfig-&ExtUtils-PkgConfig-version;</ulink>
215 (uses the standard <xref linkend="perl-standard-install"/>) Requires:
216 </para>
217 <itemizedlist>
218 <listitem>
219 <para>
220 <xref linkend="perl-extutils-depends"/>
221 </para>
222 </listitem>
223 </itemizedlist>
224 </listitem>
225 </itemizedlist> -->
226
227 <!-- Finance::Quote
228 <bridgehead renderas="sect3" id="perl-finance-quote"
229 xreflabel="Finance::Quote-&Finance-Quote-version;">
230 Finance::Quote-&Finance-Quote-version;</bridgehead>
231
232 <indexterm zone="perl-modules perl-finance-quote">
233 <primary sortas="a-Finance-Quote">Finance::Quote</primary>
234 </indexterm>
235
236 <para>Finance::Quote is used to get stock quotes from various Internet
237 sources, including Yahoo! Finance, Fidelity Investments, and the Australian
238 Stock Exchange. There are two methods of using this module &ndash; a
239 functional interface that is deprecated, and an object-orientated method
240 that provides greater flexibility and stability. With the exception of
241 straight currency exchange rates, all information is returned as a
242 two-dimensional hash (or a reference to such a hash, if called in a scalar
243 context).</para>
244
245 <para>After you've installed the package, issue
246 <command>perldoc Finance::Quote</command> for full information.
247 Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
248 after unpacking the distribution tarball and changing into the top-level
249 directory. This module and the dependency modules are installed using the
250 standard <xref linkend="perl-standard-install"/>.</para>
251
252 <note>
253 <para>To run the regression test suite, you'll need a working Internet
254 connection and then create a symbolic link to the
255 <filename class='directory'>test</filename> directory using the following
256 command after unpacking the tarball and changing into the root directory
257 of the source tree:</para>
258
259<screen><userinput>ln -s test t</userinput></screen>
260
261 <para>Some tests will fail depending on certain conditions. See the
262 <filename>INSTALL</filename> file for full details.</para>
263 </note>
264
265 <itemizedlist>
266 <listitem>
267 <para>
268 <ulink url="http://www.cpan.org/authors/id/E/EC/ECOCODE/Finance-Quote-&Finance-Quote-version;.tar.gz">
269 Finance::Quote-&Finance-Quote-version;</ulink> (MD5 sum: 339e8327a6c18d8194f6c5d1eea3bbde)
270 </para>
271 <itemizedlist>
272 <listitem>
273 <para>
274 <xref linkend="perl-lwp"/>
275 </para>
276 </listitem>
277 <listitem>
278 <para>
279 <xref linkend="perl-crypt-ssleay"/>
280 </para>
281 </listitem>
282 <listitem>
283 <para>
284 <xref linkend="perl-html-tableextract"/>
285 </para>
286 </listitem>
287 </itemizedlist>
288 </listitem>
289 </itemizedlist> -->
290
291 <!-- Finance::QuoteHist
292 <bridgehead renderas="sect3" id="perl-finance-quotehist"
293 xreflabel="Finance::QuoteHist-&Finance-QuoteHist-version;">
294 Finance::QuoteHist-&Finance-QuoteHist-version;</bridgehead>
295
296 <indexterm zone="perl-modules perl-finance-quotehist">
297 <primary sortas="a-Finance-QuoteHist">Finance::QuoteHist</primary>
298 </indexterm>
299
300 <para>The Finance::QuoteHist bundle is several modules designed to fetch
301 historical stock quotes from the web. The module and dependencies are
302 installed using the standard <application>Perl</application> module
303 <xref linkend="perl-standard-install"/>.</para>
304
305 <itemizedlist>
306 <listitem>
307 <para>
308 <ulink url="http://cpan.org/authors/id/M/MS/MSISK/Finance-QuoteHist-&Finance-QuoteHist-version;.tar.gz">
309 Finance-QuoteHist-&Finance-QuoteHist-version;</ulink>
310 </para>
311 <itemizedlist>
312 <listitem>
313 <para>
314 <xref linkend="perl-html-tableextract"/>
315 </para>
316 </listitem>
317 <listitem>
318 <para>
319 <xref linkend="perl-lwp"/>
320 </para>
321 </listitem>
322 <listitem>
323 <para>
324 <xref linkend="perl-date-manip"/>
325 </para>
326 </listitem>
327 <listitem>
328 <para>
329 <ulink url="http://cpan.org/authors/id/M/MA/MAKAMAKA/Text-CSV-&Text-CSV-version;.tar.gz">
330 Text-CSV-&Text-CSV-version;</ulink>
331 </para>
332 </listitem>
333 <listitem>
334 <para>
335 <ulink url="http://cpan.org/authors/id/H/HM/HMBRAND/Text-CSV_XS-&Text-CSV_XS-version;.tgz">
336 Text-CSV_XS-&Text-CSV_XS-version; (optional)</ulink>
337 </para>
338 </listitem>
339 </itemizedlist>
340 </listitem>
341 </itemizedlist>
342 -->
343
344 <!-- Glib -->
345 <bridgehead renderas="sect3" id="perl-glib"
346 xreflabel="Glib-&Glib-perl-version;">
347 Glib-&Glib-perl-version;</bridgehead>
348
349 <indexterm zone="perl-modules perl-glib">
350 <primary sortas="a-Glib">Glib</primary>
351 </indexterm>
352
353 <para>
354 This module is a <application>Perl</application> wrapper around
355 <application>GLib</application> that attempts to provide a perlish
356 interface while remaining as true as possible to the underlying C API, so
357 that any reference materials you can find on using GLib may still apply to
358 using the libraries from Perl. This module and the dependency modules use
359 the standard <xref linkend="perl-standard-install"/>.
360 </para>
361
362 &lfs74_checked;
363
364 <itemizedlist>
365 <listitem>
366 <para>
367 <ulink url="http://www.cpan.org/authors/id/T/TS/TSCH/Glib-&Glib-perl-version;.tar.gz">
368 Glib-&Glib-perl-version;</ulink> (MD5 sum: 1d81a8aec5f7f1182a96cfaaf119d866)
369 </para>
370 <itemizedlist>
371 <listitem>
372 <para>
373 <ulink url="http://search.cpan.org/~xaoc/ExtUtils-PkgConfig/">ExtUtils::PkgConfig</ulink>
374 </para>
375 <itemizedlist>
376 <listitem>
377 <para>
378 <ulink url="http://search.cpan.org/~flora/ExtUtils-Depends/">ExtUtils::Depends</ulink>
379 </para>
380 </listitem>
381 </itemizedlist>
382 </listitem>
383 </itemizedlist>
384 </listitem>
385 </itemizedlist>
386
387 <!-- HTML::Parser -->
388 <bridgehead renderas="sect3" id="perl-html-parser"
389 xreflabel="HTML::Parser-&HTML-Parser-version;">
390 HTML::Parser-&HTML-Parser-version;</bridgehead>
391
392 <indexterm zone="perl-modules perl-html-parser">
393 <primary sortas="a-HTML-Parser">HTML::Parser</primary>
394 </indexterm>
395
396 <para>The HTML::Parser distribution is a collection of modules that parse
397 and extract information from HTML documents. This module and the dependency
398 modules use the standard
399 <xref linkend="perl-standard-install"/>.</para>
400
401 &lfs74_checked;
402
403 <itemizedlist>
404 <listitem>
405 <para>
406 <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/HTML-Parser-&HTML-Parser-version;.tar.gz">
407 HTML::Parser-&HTML-Parser-version;</ulink> (MD5 sum: 9128a45893097dfa3bf03301b19c5efe)
408 </para>
409 <itemizedlist>
410 <listitem>
411 <para>
412 <ulink url="http://search.cpan.org/~petdance/HTML-Tagset/">HTML::Tagset</ulink>
413 </para>
414 </listitem>
415 <listitem>
416 <para>
417 <xref linkend="perl-lwp"/> (circular; howevever, it can
418 be installed after HTML::Parser as it is only a run-time
419 requirement for the included HTML::HeadParser module)
420 </para>
421 </listitem>
422 </itemizedlist>
423 </listitem>
424 </itemizedlist>
425
426 <!-- HTML::TableExtract
427 <bridgehead renderas="sect3" id="perl-html-tableextract"
428 xreflabel="HTML::TableExtract-&HTML-TableExtract-version;">
429 HTML::TableExtract-&HTML-TableExtract-version;</bridgehead>
430
431 <indexterm zone="perl-modules perl-html-tableextract">
432 <primary sortas="a-HTML-TableExtract">HTML::TableExtract</primary>
433 </indexterm>
434
435 <para>HTML::TableExtract is a module that simplifies the extraction of the
436 content contained in tables within HTML documents, extracted either as
437 text or encoded element trees. Tables of note may be specified using
438 Headers, Depth, Count, Attributes, or some combination of the four. This
439 module and dependency modules use the standard
440 <xref linkend="perl-standard-install"/>.</para>
441
442 <itemizedlist>
443 <listitem>
444 <para>
445 <ulink url="http://cpan.org/authors/id/M/MS/MSISK/HTML-TableExtract-&HTML-TableExtract-version;.tar.gz">
446 HTML::TableExtract-&HTML-TableExtract-version;</ulink> (MD5sum: ac1b8fa092d53931a9f3fdbba330f5b0)
447 </para>
448 <itemizedlist>
449 <listitem>
450 <para>
451 <ulink url="http://search.cpan.org/~msisk/HTML-Element-Extended/">HTML::Element::Extended</ulink>
452 </para>
453 <itemizedlist>
454 <listitem>
455 <para>
456 <ulink url="http://search.cpan.org/~cjm/HTML-Tree/">HTML::Tree</ulink>
457 </para>
458 <itemizedlist>
459 <listitem>
460 <para>
461 <xref linkend="perl-html-parser"/>
462 </para>
463 </listitem>
464 <listitem>
465 <para>
466 <ulink url="http://search.cpan.org/dist/Test-Fatal/">Test::Fatal</ulink>
467 (optionally used in the test suite)
468 </para>
469 <itemizedlist>
470 <listitem>
471 <para>
472 <ulink url="http://search.cpan.org/~doy/Try-Tiny/">Try::Tiny</ulink>
473 </para>
474 </listitem>
475 </itemizedlist>
476 </listitem>
477 </itemizedlist>
478 </listitem>
479 </itemizedlist>
480 </listitem>
481 </itemizedlist>
482 </listitem>
483 </itemizedlist> -->
484
485 <!-- LWP -->
486 <bridgehead renderas="sect3" id="perl-lwp"
487 xreflabel="libwww-perl-&LWP-version;">
488 libwww-perl-&LWP-version; (a.k.a. LWP)</bridgehead>
489
490 <indexterm zone="perl-modules perl-lwp">
491 <primary sortas="a-libwww-perl">libwww-perl</primary>
492 </indexterm>
493
494 <para>The libwww-perl (LWP) collection is a set of
495 <application>Perl</application> modules which provide a simple and
496 consistent application programming interface to the World-Wide Web. The
497 main focus of the library is to provide classes and functions that allow
498 you to write WWW clients. The library also contains modules that are of
499 more general use and even classes that help you implement simple HTTP
500 servers. The LWP collection and all its dependency modules use the standard
501 <xref linkend="perl-standard-install"/>. The dependencies should be
502 installed in the order listed below. Ensure you install the dependency
503 chain for each module before installing the modules.</para>
504
505 &lfs74_checked;
506
507 <itemizedlist>
508 <listitem>
509 <para>
510 <ulink url="http://cpan.org/authors/id/G/GA/GAAS/libwww-perl-&LWP-version;.tar.gz">
511 libwww-perl-&LWP-version;</ulink> (MD5 sum: 637d5f1eb61336ca2caa6e026b382f87)
512 </para>
513 <itemizedlist>
514 <listitem>
515 <para>
516 <ulink url="http://search.cpan.org/~gaas/Encode-Locale/">Encode::Locale</ulink>
517 </para>
518 </listitem>
519 <listitem>
520 <para>
521 <ulink url="http://search.cpan.org/~gaas/HTML-Form/">HTML::Form</ulink>
522 </para>
523 <itemizedlist>
524 <listitem>
525 <para>
526 <xref linkend="perl-uri"/>
527 </para>
528 </listitem>
529 <listitem>
530 <para>
531 <xref linkend="perl-html-parser"/>
532 </para>
533 </listitem>
534 <listitem>
535 <para>
536 <ulink url="http://search.cpan.org/~gaas/HTTP-Message/">HTTP::Message</ulink>
537 </para>
538 <itemizedlist>
539 <listitem>
540 <para>
541 <ulink url="http://search.cpan.org/~gaas/HTTP-Date/">HTTP::Date</ulink>
542 </para>
543 </listitem>
544 <listitem>
545 <para>
546 <ulink url="http://search.cpan.org/~cjm/IO-HTML/">IO::HTML</ulink>
547 </para>
548 </listitem>
549 <listitem>
550 <para>
551 <ulink url="http://search.cpan.org/~gaas/LWP-MediaTypes/">LWP::MediaTypes</ulink>
552 </para>
553 </listitem>
554 </itemizedlist>
555 </listitem>
556 </itemizedlist>
557 </listitem>
558 <listitem>
559 <para>
560 <ulink url="http://search.cpan.org/~gaas/HTTP-Cookies/">HTTP::Cookies</ulink>
561 </para>
562 </listitem>
563 <listitem>
564 <para>
565 <ulink url="http://search.cpan.org/~gaas/HTTP-Negotiate/">HTTP::Negotiate</ulink>
566 </para>
567 </listitem>
568 <listitem>
569 <para>
570 <ulink url="http://search.cpan.org/~gaas/Net-HTTP/">Net::HTTP</ulink>
571 </para>
572 </listitem>
573 <listitem>
574 <para>
575 <ulink url="http://search.cpan.org/~gaas/WWW-RobotRules/">WWW::RobotRules</ulink>
576 </para>
577 </listitem>
578 <listitem>
579 <para>
580 <ulink url="http://search.cpan.org/~gaas/HTTP-Daemon/">HTTP::Daemon</ulink>
581 </para>
582 </listitem>
583 <listitem>
584 <para>
585 <ulink url="http://search.cpan.org/~gaas/File-Listing/">File::Listing</ulink>
586 </para>
587 </listitem>
588 </itemizedlist>
589 </listitem>
590 </itemizedlist>
591
592 <para>If you want the LWP installation to support the HTTPS protocol,
593 install the following modules:</para>
594
595 <itemizedlist>
596 <listitem>
597 <para>
598 <xref linkend="openssl"/>
599 </para>
600 </listitem>
601 <listitem>
602 <para>
603 <ulink url="http://search.cpan.org/~gaas/LWP-Protocol-https/">LWP::Protocol::https</ulink>
604 </para>
605 <itemizedlist>
606 <listitem>
607 <para>
608 <ulink url="http://search.cpan.org/~behroozi/IO-Socket-SSL/">IO::Socket::SSL</ulink>
609 </para>
610 <itemizedlist>
611 <listitem>
612 <para>
613 <ulink url="http://search.cpan.org/dist/Net-SSLeay/">Net::SSLeay</ulink>
614 </para>
615 </listitem>
616 </itemizedlist>
617 </listitem>
618 <listitem>
619 <para>
620 <ulink url="http://search.cpan.org/~abh/Mozilla-CA/">Mozilla::CA</ulink>
621 </para>
622 </listitem>
623 </itemizedlist>
624 </listitem>
625 </itemizedlist>
626
627
628 <!-- Module::Info
629 <bridgehead renderas="sect3" id="perl-module-info"
630 xreflabel="Module::Info-&Module-Info-version;">
631 Module::Info-&Module-Info-version;</bridgehead>
632
633 <indexterm zone="perl-modules perl-module-info">
634 <primary sortas="a-Module-Info">Module::Info</primary>
635 </indexterm>
636
637 <para>The Module::Info module is quite useful for tasks other than just
638 support of other modules. It can be used from the command-line to tell you
639 if a particular module is included in, or has been installed into your
640 <application>Perl</application> installation. Additionally, Module::Info
641 can tell you what version of a module is installed and what dependencies
642 are required for it. You can even use Module::Info to gather dependencies
643 of uninstalled modules. The Module::Info module and dependencies install
644 using the standard <application>Perl</application> module
645 <xref linkend="perl-standard-install"/>.</para>
646
647 <itemizedlist>
648 <listitem>
649 <para>
650 <ulink url="http://www.cpan.org/authors/id/M/MB/MBARBON/Module-Info-&Module-Info-version;.tar.gz">
651 Module-Info-&Module-Info-version;</ulink>
652 </para>
653 </listitem>
654 </itemizedlist>
655 -->
656
657 <!-- Module::Signature
658 <bridgehead renderas="sect3" id="perl-module-signature"
659 xreflabel="Module::Signature-&Module-Signature-version;">
660 Module::Signature-&Module-Signature-version;</bridgehead>
661
662 <indexterm zone="perl-modules perl-module-signature">
663 <primary sortas="a-Module-Signature">Module::Signature</primary>
664 </indexterm>
665
666 <para>The Module::Signature module is used to check and create
667 <filename>SIGNATURE</filename> files for CPAN distributions. After
668 installing Module::Signature you can verify the content of a distribution
669 tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
670 the tarball, changing into the newly created directory and issuing the
671 command <command>cpansign -v</command>. It will check each file's
672 integrity, as well as the signature's validity. Note that some of the
673 dependencies appear to be circular, however, they are only run-time
674 conflicts and you should be able to fully utilize them as long as
675 everything is installed. Module::Signature and the dependency modules are
676 installed using the standard <application>Perl</application>
677 module <xref linkend="perl-standard-install"/>.</para>
678
679 <itemizedlist>
680 <listitem>
681 <para>
682 <ulink url="http://cpan.org/authors/id/A/AU/AUDREYT/Module-Signature-&Module-Signature-version;.tar.gz">
683 Module-Signature-&Module-Signature-version;</ulink>
684 </para>
685 <itemizedlist>
686 <listitem>
687 <para>
688 <xref linkend="perl-text-diff"/>
689 </para>
690 </listitem>
691 <listitem>
692 <para>
693 <ulink url="http://cpan.org/authors/id/S/SM/SMUELLER/PAR-Dist-&PAR-Dist-version;.tar.gz">
694 PAR-Dist-&PAR-Dist-version;</ulink>
695 </para>
696 <itemizedlist>
697 <listitem>
698 <para>
699 <xref linkend="perl-archive-zip"/>
700 </para>
701 </listitem>
702 <listitem>
703 <para>
704 <xref linkend="perl-lwp"/>
705 </para>
706 </listitem>
707 <listitem>
708 <para>
709 <xref linkend="perl-module-signature"/>
710 </para>
711 </listitem>
712 </itemizedlist>
713 </listitem>
714 <listitem>
715 <para>
716 <xref linkend="gnupg"/>
717 </para>
718 </listitem>
719 </itemizedlist>
720 </listitem>
721 </itemizedlist>
722 -->
723
724 <!-- Net::DNS -->
725 <bridgehead renderas="sect3" id="perl-net-dns"
726 xreflabel="Net::DNS-&Net-DNS-version;">
727 Net::DNS-&Net-DNS-version;</bridgehead>
728
729 <indexterm zone="perl-modules perl-net-dns">
730 <primary sortas="a-Net-DNS">Net::DNS</primary>
731 </indexterm>
732
733 <para>Net::DNS is a DNS resolver implemented in
734 <application>Perl</application>. It can be used to perform nearly any type
735 of DNS query from a <application>Perl</application> script. The Net::DNS
736 module and all its dependencies are installed using the standard
737 <xref linkend="perl-standard-install"/>.</para>
738
739 &lfs74_checked;
740
741 <itemizedlist>
742 <listitem>
743 <para>
744 <ulink url="http://www.cpan.org/authors/id/N/NL/NLNETLABS/Net-DNS-&Net-DNS-version;.tar.gz">
745 Net::DNS-&Net-DNS-version;</ulink> (MD5 sum: 393e48ec6f28abe5ed30204276e02775)
746 </para>
747 <itemizedlist>
748 <listitem>
749 <para>
750 <ulink url="http://search.cpan.org/~gaas/Digest-HMAC/">Digest::HMAC</ulink>
751 </para>
752 </listitem>
753 <listitem>
754 <para>
755 <ulink url="http://search.cpan.org/~gbarr/IO/lib/IO/Socket/INET.pm">IO::Socket::INET</ulink>
756 (required for IPv6 support)
757 </para>
758 <itemizedlist>
759 <listitem>
760 <para>
761 <ulink url="http://search.cpan.org/~umemoto/Socket6/">Socket6</ulink>
762 </para>
763 </listitem>
764 </itemizedlist>
765 </listitem>
766 </itemizedlist>
767 </listitem>
768 </itemizedlist>
769
770 <!-- SGMLSpm -->
771 <bridgehead renderas="sect3" id="perl-sgmlspm"
772 xreflabel="SGMLSpm-&SGMLSpm-version;">
773 SGMLSpm-&SGMLSpm-version;</bridgehead>
774
775 <indexterm zone="perl-modules perl-sgmlspm">
776 <primary sortas="a-SGMLSpm">SGMLSpm</primary>
777 </indexterm>
778
779 <para>The SGMLSpm module is a <application>Perl</application> library
780 used for parsing the output from James Clark's SGMLS and NSGMLS
781 parsers. This modules uses the standard
782 <xref linkend="perl-standard-install"/>.</para>
783
784 &lfs74_checked;
785
786 <para> Before beginning the build, issue
787 the following command to prevent an error:</para>
788
789<screen><userinput>chmod -v 644 MYMETA.yml</userinput></screen>
790
791 <para>
792 After installed, as the <systemitem class="username">root</systemitem>
793 user:
794 </para>
795
796<screen role="root"><userinput>ln -sv sgmlspl.pl /usr/bin/sgmlspl</userinput></screen>
797
798 <itemizedlist>
799 <listitem>
800 <para>
801 <ulink url="http://search.cpan.org/CPAN/authors/id/R/RA/RAAB/SGMLSpm-&SGMLSpm-version;.tar.gz">
802 SGMLSpm-&SGMLSpm-version;</ulink> (MD5 sum: 746c74ae969992cedb1a2879b4168090)
803 </para>
804 </listitem>
805 </itemizedlist>
806
807 <!-- Text::Diff
808 <bridgehead renderas="sect3" id="perl-text-diff"
809 xreflabel="Text::Diff-&Text-Diff-version;">
810 Text::Diff-&Text-Diff-version;</bridgehead>
811
812 <indexterm zone="perl-modules perl-text-diff">
813 <primary sortas="a-Text-Diff">Text::Diff</primary>
814 </indexterm>
815
816 <para>Text::Diff is used to perform diffs on files and record sets. It
817 provides a basic set of services akin to the GNU <command>diff</command>
818 utility. It is not anywhere near as feature complete as GNU
819 <command>diff</command>, but it is better integrated with
820 <application>Perl</application> and available on all platforms. Text::Diff
821 is often faster than shelling out to a system's <command>diff</command>
822 executable for small files, and generally slower on larger files. The
823 modules listed below are installed using the standard
824 <application>Perl</application> module
825 <xref linkend="perl-standard-install"/>.</para>
826
827 <itemizedlist>
828 <listitem>
829 <para>
830 <ulink url="http://cpan.org/authors/id/R/RB/RBS/Text-Diff-&Text-Diff-version;.tar.gz">
831 Text-Diff-&Text-Diff-version;</ulink></para>
832 <itemizedlist>
833 <listitem>
834 <para>
835 <ulink url="http://cpan.org/authors/id/T/TY/TYEMQ/Algorithm-Diff-&Algorithm-Diff-version;.tar.gz">
836 Algorithm-Diff-&Algorithm-Diff-version;</ulink></para>
837 </listitem>
838 </itemizedlist>
839 </listitem>
840 </itemizedlist>
841 -->
842
843 <!-- Tk
844 <bridgehead renderas="sect3" id="tk-perl"
845 xreflabel="Tk-Perl-&Tk-Perl-version;">
846 Tk-&Tk-Perl-version;</bridgehead>
847
848 <indexterm zone="perl-modules tk-perl">
849 <primary sortas="a-Tk">Tk</primary>
850 </indexterm>
851
852 <para>The <application>Tk</application> module is a
853 <application>Perl</application> interface to the
854 <application>Tk</application> package. The goal of this release is Unicode
855 support via <application>Perl</application>'s and
856 core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
857 builds and loads into a threaded <application>Perl</application> but is NOT
858 yet thread safe. The module is installed using the standard
859 <application>Perl</application> module
860 <xref linkend="perl-standard-install"/>.</para>
861
862 <itemizedlist>
863 <listitem>
864 <para>
865 <ulink url="http://www.cpan.org/authors/id/S/SR/SREZIC/Tk-&Tk-Perl-version;.tar.gz">
866 Tk-&Tk-Perl-version;</ulink></para>
867 <itemizedlist>
868 <listitem>
869 <para>
870 <xref linkend="tk"/> and <xref linkend="libjpeg"/>
871 </para>
872 </listitem>
873 </itemizedlist>
874 </listitem>
875 </itemizedlist>
876 -->
877
878 <!-- URI -->
879 <bridgehead renderas="sect3" id="perl-uri"
880 xreflabel="URI-&URI-version;">
881 URI-&URI-version;</bridgehead>
882
883 <indexterm zone="perl-modules perl-uri">
884 <primary sortas="a-URI">URI</primary>
885 </indexterm>
886
887 <para>
888 This module implements the URI class. Objects of this class represent
889 "Uniform Resource Identifier references" as specified in RFC 2396 (and
890 updated by RFC 2732). A Uniform Resource Identifier is a compact string of
891 characters that identifies an abstract or physical resource. A Uniform
892 Resource Identifier can be further classified as either a Uniform Resource
893 Locator (URL) or a Uniform Resource Name (URN). The distinction between
894 URL and URN does not matter to the URI class interface. A "URI-reference"
895 is a URI that may have additional information attached in the form of a
896 fragment identifier. This module uses the standard
897 <xref linkend="perl-standard-install"/>.
898 </para>
899
900 &lfs74_checked;
901
902 <itemizedlist>
903 <listitem>
904 <para>
905 <ulink url="http://www.cpan.org/authors/id/G/GA/GAAS/URI-&URI-version;.tar.gz">
906 URI-&URI-version;</ulink> (MD5 sum: 70f739be8ce28b8baba7c5920ffee4dc)
907 </para>
908 </listitem>
909 </itemizedlist>
910
911 <!-- XML::Parser -->
912 <bridgehead renderas="sect3" id="perl-xml-parser"
913 xreflabel="XML::Parser-&XML-Parser-version;">
914 XML::Parser-&XML-Parser-version;</bridgehead>
915
916 <indexterm zone="perl-modules perl-xml-parser">
917 <primary sortas="a-XML-Parser">XML::Parser</primary>
918 </indexterm>
919
920 <para>The XML::Parser module is a <application>Perl</application> extension
921 interface to James Clark's XML parser,
922 <application>expat</application>. The module uses the standard
923 <xref linkend="perl-standard-install"/>.</para>
924
925 &lfs74_checked;
926
927 <itemizedlist>
928 <listitem>
929 <para>
930 <ulink url="http://search.cpan.org/CPAN/authors/id/T/TO/TODDR/XML-Parser-&XML-Parser-version;.tar.gz">
931 XML::Parser-&XML-Parser-version;</ulink> (MD5 sum: c320d2ffa459e6cdc6f9f59c1185855e)
932 </para>
933 <itemizedlist>
934 <listitem>
935 <para>
936 <xref linkend="expat"/>
937 </para>
938 </listitem>
939 <listitem>
940 <para>
941 <xref linkend="perl-lwp"/> (optionally used in the test suite)
942 </para>
943 </listitem>
944 </itemizedlist>
945
946 </listitem>
947 </itemizedlist>
948
949 <!-- XML::Simple -->
950 <bridgehead renderas="sect3" id="perl-xml-simple"
951 xreflabel="XML::Simple-&XML-Simple-version;">
952 XML::Simple-&XML-Simple-version;</bridgehead>
953
954 <indexterm zone="perl-modules perl-xml-simple">
955 <primary sortas="a-XML-Simple">XML::Simple</primary>
956 </indexterm>
957
958 <para>The XML::Simple module is a <application>Perl</application> extension
959 that provides an easy API to read and write XML (especially config files).
960 This module and all dependency modules use the standard
961 <xref linkend="perl-standard-install"/>.</para>
962
963 &lfs74_checked;
964
965 <itemizedlist>
966 <listitem>
967 <para>
968 <ulink url="http://cpan.org/authors/id/G/GR/GRANTM/XML-Simple-&XML-Simple-version;.tar.gz">
969 XML::Simple-&XML-Simple-version;</ulink> (MD5 sum: 4d10964e123b76eca36678464daa63cd)
970 </para>
971 <itemizedlist>
972 <listitem>
973 <para>
974 <ulink url="http://search.cpan.org/~grantm/XML-SAX/">XML::SAX</ulink>
975 (Note: this package does not support parallel build)
976 </para>
977 <itemizedlist>
978 <listitem>
979 <para>
980 <ulink url="http://search.cpan.org/~perigrin/XML-NamespaceSupport/">
981 XML::NamespaceSupport</ulink>
982 </para>
983 </listitem>
984 <listitem>
985 <para>
986 <ulink url="http://search.cpan.org/~grantm/XML-SAX-Base/">
987 XML::SAX::Base</ulink>
988 </para>
989 </listitem>
990 </itemizedlist>
991 </listitem>
992 <listitem>
993 <para>
994 <ulink url="http://search.cpan.org/~bjoern/XML-SAX-Expat/">XML::SAX::Expat</ulink>
995 (Note: this package does not support parallel build)
996 </para>
997 <itemizedlist>
998 <listitem>
999 <para>
1000 <xref linkend="perl-xml-parser"/>
1001 </para>
1002 </listitem>
1003 </itemizedlist>
1004 </listitem>
1005 <listitem>
1006 <para id="perl-xml-libxml">
1007 <ulink url="http://search.cpan.org/~shlomif/XML-LibXML/">XML::LibXML</ulink>
1008 (recommended for faster parsing)
1009 </para>
1010 </listitem>
1011 <listitem>
1012 <para>
1013 <ulink url="http://search.cpan.org/~chorny/Tie-IxHash/">Tie::IxHash</ulink>
1014 (optionally used in the test suite)
1015 </para>
1016 </listitem>
1017 </itemizedlist>
1018 </listitem>
1019 </itemizedlist>
1020
1021 <!-- YAML
1022 <bridgehead renderas="sect3" id="perl-yaml"
1023 xreflabel="YAML-&YAML-version;">
1024 YAML-&YAML-version;</bridgehead>
1025
1026 <indexterm zone="perl-modules perl-yaml">
1027 <primary sortas="a-YAML">YAML</primary>
1028 </indexterm>
1029
1030 <para>The <application>YAML</application> modules implement a
1031 <application>YAML</application> Loader and Dumper based on the
1032 <application>YAML</application> 1.0 specification
1033 <ulink url="http://www.yaml.org/spec/"/>.
1034 <application>YAML</application> is a generic data serialization language
1035 that is optimized for human readability. It can be used to express the data
1036 structures of most modern programming languages. The module and
1037 dependencies are installed using the standard
1038 <application>Perl</application> module
1039 <xref linkend="perl-standard-install"/>.</para>
1040
1041 <note>
1042 <para>The <application>YAML</application>,
1043 <application>Test::Base</application> and
1044 <application>Spiffy</application> modules will install UTF-8
1045 encoded manual pages. To modify the manual pages so that non-UTF-8
1046 encoded pages are installed, issue the following commands (before
1047 any other build commands):</para>
1048
1049<screen><literal>For <application>Spiffy</application>: <command>sed -i 's,\xc3\xb6,o,' lib/Spiffy.pm</command>
1050
1051For <application>Test::Base</application>: <command>sed -i 's,\xc3\xb6,o,' \
1052 lib/Test/Base{,/Filter}.pm \
1053 lib/Module/Install/TestBase.pm</command>
1054
1055For <application>YAML</application>: <command>sed -i 's,\xc3\xb6,o,' \
1056 ysh \
1057 lib{,/Test}/YAML.pm \
1058 lib/YAML/{Types,Node,Error,Marshall,Tag,Base}.pm \
1059 lib/YAML/{Loader,Dumper}{,/Base}.pm</command></literal></screen>
1060
1061 </note>
1062
1063 <itemizedlist>
1064 <listitem>
1065 <para>
1066 <ulink url="http://cpan.org/authors/id/I/IN/INGY/YAML-&YAML-version;.tar.gz">
1067 YAML-&YAML-version;</ulink></para>
1068 <itemizedlist>
1069 <listitem>
1070 <para>
1071 <ulink url="http://cpan.org/authors/id/I/IN/INGY/Test-Base-&Test-Base-version;.tar.gz">
1072 Test-Base-&Test-Base-version;</ulink>
1073 (optionally used during the tests)
1074 </para>
1075 <itemizedlist>
1076 <listitem>
1077 <para
1078 <ulink url="http://cpan.org/authors/id/I/IN/INGY/Spiffy-&Spiffy-version;.tar.gz">
1079 Spiffy-&Spiffy-version;</ulink></para>
1080 </listitem>
1081 </itemizedlist>
1082 </listitem>
1083 <listitem>
1084 <para>
1085 <xref linkend="perl-text-diff"/>
1086 (optionally used during the tests)
1087 </para>
1088 </listitem>
1089 </itemizedlist>
1090 </listitem>
1091 </itemizedlist>
1092 -->
1093
1094 </sect2>
1095
1096 <sect2 role="installation" id="perl-standard-install"
1097 xreflabel="build and installation instructions">
1098 <title>Standard Installation of Perl Modules</title>
1099
1100 <para>Install <application>Perl</application> modules by running the
1101 following commands:</para>
1102
1103<screen><userinput>perl Makefile.PL &amp;&amp;
1104make &amp;&amp;
1105make test</userinput></screen>
1106
1107 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
1108
1109<screen role="root"><userinput>make install</userinput></screen>
1110
1111 <note>
1112 <para>When reinstalling a <application>Perl</application> module,
1113 sometimes older versions of the module being reinstalled are in other
1114 directories specified in <parameter>@INC</parameter>. To delete all
1115 other versions of the module being reinstalled (not simply older ones)
1116 set the <varname>UNINST</varname> variable:</para>
1117
1118<screen><userinput>make install UNINST=1</userinput></screen>
1119 </note>
1120
1121 </sect2>
1122
1123 <sect2 role="installation">
1124 <title>(Alternate) Auto Installation of Perl Modules.</title>
1125
1126 <para>There is an alternate way of installing the modules using the
1127 <command>cpan</command> shell <command>install</command> command. The
1128 command automatically downloads the source from the CPAN archive, extracts
1129 it, runs the compilation, testing and installation commands mentioned
1130 above, and removes the build source tree. You may still need to install
1131 dependent library packages before running the automated installation
1132 method.</para>
1133
1134 <para>The first time you run <command>cpan</command>, you'll be prompted
1135 to enter some information regarding download locations and methods. This
1136 information is retained in files located in
1137 <filename class='directory'>~/.cpan</filename>. Start the
1138 <command>cpan</command> shell by issuing '<command>cpan</command>' as the
1139 <systemitem class="username">root</systemitem> user. Any module may now be
1140 installed from the
1141 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1142 prompt with the command:</para>
1143
1144<screen role="root"><userinput>install <replaceable>&lt;Module::Name&gt;</replaceable></userinput></screen>
1145
1146 <para>For additional commands and help, issue '<command>help</command>'
1147 from the
1148 <emphasis role='underlined'><prompt>cpan&gt;&nbsp;</prompt></emphasis>
1149 prompt.</para>
1150
1151 <para>Alternatively, for scripted or non-interactive installations, use the
1152 following syntax as the
1153 <systemitem class="username">root</systemitem> user to install one or more
1154 modules:</para>
1155
1156<screen role="root"><userinput>cpan -i <replaceable>&lt;Module1::Name&gt; &lt;Module2::Name&gt;</replaceable></userinput></screen>
1157
1158 <para>Review the <filename>cpan.1</filename> man page for additional
1159 parameters you can pass to <command>cpan</command> on the command
1160 line.</para>
1161
1162 </sect2>
1163
1164</sect1>
Note: See TracBrowser for help on using the repository browser.