MINICPAN(1p) User Contributed Perl Documentation MINICPAN(1p)
NAME
minicpan - uses CPAN::Mini to create or update a local mirror
VERSION
version 1.111008
SYNOPSIS
minicpan [options]
Options
-l LOCAL - where is the local minicpan? (required)
-r REMOTE - where is the remote cpan mirror? (required)
-d 0### - permissions (numeric) to use when creating directories
-f - check all directories, even if indices are unchanged
-p - mirror perl, ponie, and parrot distributions
--debug - run in debug mode (print even banal messages)
-q - run in quiet mode (don't print status)
-qq - run in silent mode (don't even print warnings)
-c CLASS - what class to use to mirror (default: CPAN::Mini)
-C FILE - what config file to use (default: ~/.minicpanrc)
-h - print help and exit
-v - print version and exit
-x - build an exact mirror, getting even normally disallowed files
-t SEC - timeout in sec. Defaults to 180 sec
--offline - operate in offline mode (generally: do nothing)
--log-level - provide a log level; instead of --debug, -q, or -qq
DESCRIPTION
This simple shell script just updates (or creates) a miniature CPAN mirror as described in CPAN::Mini.
CONFIGURATION FILE
By default, "minicpan" will read a configuration file to get configuration information. The file is a simple set of names and values, as
in the following example:
local: /home/rjbs/mirrors/minicpan/
remote: http://your.favorite.cpan/cpan/
exact_mirror: 1
"minicpan" tries to find a configuration file through the following process. It takes the first defined it finds:
o Use the value specified by "-C" on the command line
o Use the value in the "CPAN_MINI_CONFIG" environment variable
o Use ~/.minicpanrc
o Use CPAN/Mini/minicpan.conf
If the selected file does not exist, "minicpan" does not keep looking.
You can override this process with a "config_file" method in your subclass.
See "CPAN::Mini" for a full listing of available options.
TO DO
Improve command-line options.
SEE ALSO
Randal Schwartz's original article, which can be found here:
http://www.stonehenge.com/merlyn/LinuxMag/col42.html
AUTHORS
o Ricardo SIGNES <rjbs@cpan.org>
o Randal Schwartz <merlyn@stonehenge.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2004 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
perl v5.14.2 2011-12-23 MINICPAN(1p)