1MINICPAN(1)           User Contributed Perl Documentation          MINICPAN(1)
2
3
4

NAME

6       minicpan - uses CPAN::Mini to create or update a local mirror
7

VERSION

9       version 1.111016
10

SYNOPSIS

12        minicpan [options]
13
14        Options
15          -l LOCAL    - where is the local minicpan?     (required)
16          -r REMOTE   - where is the remote cpan mirror? (required)
17          -d 0###     - permissions (numeric) to use when creating directories
18          -f          - check all directories, even if indices are unchanged
19          -p          - mirror perl, ponie, and parrot distributions
20          --debug     - run in debug mode (print even banal messages)
21          -q          - run in quiet mode (don't print status)
22          -qq         - run in silent mode (don't even print warnings)
23          -c CLASS    - what class to use to mirror (default: CPAN::Mini)
24          -C FILE     - what config file to use (default: ~/.minicpanrc)
25          -h          - print help and exit
26          -v          - print version and exit
27          -x          - build an exact mirror, getting even normally disallowed files
28          -t SEC      - timeout in sec. Defaults to 180 sec
29          --offline   - operate in offline mode (generally: do nothing)
30          --log-level - provide a log level; instead of --debug, -q, or -qq
31          --remote-from TYPE - cpan remote from 'cpan' or 'cpanplus' configs
32

DESCRIPTION

34       This simple shell script just updates (or creates) a miniature CPAN
35       mirror as described in CPAN::Mini.
36

CONFIGURATION FILE

38       By default, "minicpan" will read a configuration file to get
39       configuration information.  The file is a simple set of names and
40       values, as in the following example:
41
42        local:  /home/rjbs/mirrors/minicpan/
43        remote: http://your.favorite.cpan/cpan/
44        exact_mirror: 1
45
46       "minicpan" tries to find a configuration file through the following
47       process.  It takes the first defined it finds:
48
49       •   Use the value specified by "-C" on the command line
50
51       •   Use the value in the "CPAN_MINI_CONFIG" environment variable
52
53       •   Use ~/.minicpanrc
54
55       •   Use CPAN/Mini/minicpan.conf
56
57       If the selected file does not exist, "minicpan" does not keep looking.
58
59       You can override this process with a "config_file" method in your
60       subclass.
61
62       See "CPAN::Mini" for a full listing of available options.
63

TO DO

65       Improve command-line options.
66

SEE ALSO

68       Randal Schwartz's original article, which can be found here:
69
70         http://www.stonehenge.com/merlyn/LinuxMag/col42.html
71

AUTHORS

73       •   Ricardo SIGNES <rjbs@cpan.org>
74
75       •   Randal Schwartz <merlyn@stonehenge.com>
76
78       This software is copyright (c) 2004 by Ricardo SIGNES.
79
80       This is free software; you can redistribute it and/or modify it under
81       the same terms as the Perl 5 programming language system itself.
82
83
84
85perl v5.38.0                      2023-07-20                       MINICPAN(1)
Impressum