perlmodinstall

Installing CPAN Modules 

Miscellaneous Information


DESCRIPTION

You can think of a module as the fundamental unit of reusable Perl code; See perlmod for details. Whenever anyone creates a chunk of Perl code that they think will be useful to the world, they register as a Perl developer at http://www.perl.com/CPAN/modules/04pause.html so that they can then upload their code to CPAN. CPAN is the Comprehensive Perl Archive Network and can be accessed at http://www.perl.com/CPAN/, or searched via http://cpan.perl.com/ and http://theory.uwinnipeg.ca/mod_perl/cpan-search.pl .

This documentation is for people who want to download CPAN modules and install them on their own computer.

PREAMBLE

You have a file ending in .tar.gz (or, less often, .zip). You know there's a tasty module inside. You must now take four steps:

DECOMPRESS the file 
UNPACKthe file into a directory 
BUILD the module (sometimes unnecessary) 
INSTALL the module. 

Here's how to perform each step for each operating system. This is not a substitute for reading the README and INSTALL files that might have come with your module!

Also note that these instructions are tailored for installing the module into your system's repository of Perl modules. But you can install modules into any directory you wish. For instance, where I say perl Makefile.PL, you can substitute perl Makefile.PL PREFIX=/my/perl_directory to install the modules into /my/perl_directory. Then you can use the modules from your Perl programs with use lib "/my/perl_directory/lib/site_perl" or sometimes just use "/my/perl_directory".


HEY

If you have any suggested changes for this page, let me know. Please don't send me mail asking for help on how to install your modules. There are too many modules, and too few Orwants, for me to be able to answer or even acknowledge all your questions. Contact the module author instead, or post to comp.lang.perl.modules, or ask someone familiar with Perl on your operating system.


AUTHOR

Jon Orwant

orwant@tpj.com

The Perl Journal, http://tpj.com

with invaluable help from Brandon Allbery, Charles Bailey, Graham Barr, Dominic Dunlop, Jarkko Hietaniemi, Ben Holzman, Tom Horsley, Nick Ing-Simmons, Tuomas J. Lukka, Laszlo Molnar, Chris Nandor, Alan Olsen, Peter Prymmer, Gurusamy Sarathy, Christoph Spalinger, Dan Sugalski, Larry Virden, and Ilya Zakharevich.

July 22, 1998


COPYRIGHT

Copyright (C) 1998 Jon Orwant. All Rights Reserved.

Permission is granted to make and distribute verbatim copies of this documentation provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this documentation under the conditions for verbatim copying, provided also that they are marked clearly as modified versions, that the authors' names and title are unchanged (though subtitles and additional authors' names may be added), and that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this documentation into another language, under the above conditions for modified versions.


AVAILABILITY

MKS Toolkit for Power Users
MKS Toolkit for System Administrators
MKS Toolkit for Developers
MKS Toolkit for Interoperability
MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition
MKS AlertCentre


SEE ALSO

Commands:
perl

Miscellaneous:
perl5004delta, perl5005delta, perlapi, perlapio, perlbook, perlboot, perlbot, perlcall, perlcom, perlcompile, perldata, perldbmfilter, perldebguts, perldebug, perldelta, perldiag, perldsc, perlembed, perlfaq, perlfaq1, perlfaq2, perlfaq3, perlfaq4, perlfaq5, perlfaq6, perlfaq7, perlfaq8, perlfaq9, perlfilter, perlfork, perlform, perlfunc, perlguts, perlhack, perlhist, perlipc, perllexwarn, perllol, perlmod, perlmodlib, perlnumber, perlobj, perlop, perlopentut, perlpod, perlport, perlre, perlref, perlreftut, perlsec, perlsock, perlstyle, perlsub, perlsyn, perlthrtut, perltie, perltodo, perltoot, perltootc, perltrap, perlunicode, perlvar, perlxs, perlxstut, win32