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

NAME

6       cpm - a fast CPAN module installer
7

SYNOPSIS

9         # install modules into local/
10         > cpm install Module1 Module2 ...
11
12         # install modules with verbose messages
13         > cpm install -v Module
14
15         # from cpanfile (with cpanfile.snapshot if any)
16         > cpm install
17
18         # install module into current @INC instead of local/
19         > cpm install -g Module
20
21         # read modules from STDIN by specifying "-" as an argument
22         > echo Module1 Module2 | cpm install -
23
24         # prefer TRIAL release
25         > cpm install --dev Moose
26
27         # install modules as if version of your perl is 5.8.5
28         # so that modules which are not core in 5.8.5 will be installed
29         > cpm install --target-perl 5.8.5
30
31         # resolve distribution names from DARKPAN/modules/02packages.details.txt.gz
32         # and fetch distibutions from DARKPAN/authors/id/...
33         > cpm install --resolver 02packages,http://example.com/darkpan Your::Module
34         > cpm install --resolver 02packages,file:///path/to/darkpan    Your::Module
35
36         # use darkpan first, and if it fails, use metadb and normal CPAN
37         > cpm install --resolver 02packages,http://example.com/darkpan --resolver metadb Your::Module
38
39         # specify types/phases in cpanfile by "--with-*" and "--without-*" options
40         > cpm install --with-recommends --without-test
41

OPTIONS

43         -w, --workers=N
44               number of workers, default: 5
45         -L, --local-lib-contained=DIR
46               directory to install modules into, default: local/
47         -g, --global
48               install modules into current @INC instead of local/
49         -v, --verbose
50               verbose mode; you can see what is going on
51             --prebuilt, --no-prebuilt
52               save builds for CPAN distributions; and later, install the prebuilts if available
53               default: on; you can also set $ENV{PERL_CPM_PREBUILT} false to disable this option
54             --target-perl=VERSION  (EXPERIMENTAL)
55               install modules as if verison is your perl is VERSION
56             --mirror=URL
57               base url for the CPAN mirror to use, cannot be used multiple times. Use --resolver instead.
58               default: https://cpan.metacpan.org
59             --pp, --pureperl-only
60               prefer pureperl only build
61             --static-install, --no-static-install
62               enable/disable the static install, default: enable
63         -r, --resolver=class,args (EXPERIMENTAL, will be removed or renamed)
64               specify resolvers, you can use --resolver multiple times
65               available classes: metadb/metacpan/02packages/snapshot
66             --reinstall
67               reinstall the distribution even if you already have the latest version installed
68             --dev (EXPERIMENTAL)
69               resolve TRIAL distributions too
70             --color, --no-color
71               turn on/off color output, default: on
72             --test, --no-test
73               run test cases, default: no
74             --man-pages
75               generate man pages
76             --retry, --no-retry
77               retry configure/build/test/install if fails, default: retry
78             --show-build-log-on-failure
79               show build.log on failure, default: off
80             --configure-timeout=sec, --build-timeout=sec, --test-timeout=sec
81               specify configure/build/test timeout second, default: 60sec, 3600sec, 1800sec
82             --show-progress, --no-show-progress
83               show progress, default: on
84             --cpanfile=path
85               specify cpanfile path, default: ./cpanfile
86             --snapshot=path
87               specify cpanfile.snapshot path, default: ./cpanfile.snapshot
88         -V, --version
89               show version
90         -h, --help
91               show this help
92             --feature=identifier
93               specify the feature to enable in cpanfile; you can use --feature multiple times
94             --with-requires,   --without-requires   (default: with)
95             --with-recommends, --without-recommends (default: without)
96             --with-suggests,   --without-suggests   (default: without)
97             --with-configure,  --without-configure  (default: without)
98             --with-build,      --without-build      (default: with)
99             --with-test,       --without-test       (default: with)
100             --with-runtime,    --without-runtime    (default: with)
101             --with-develop,    --without-develop    (default: without)
102               specify types/phases of dependencies in cpanfile to be installed
103             --with-all
104               shortcut for --with-requires, --with-recommends, --with-suggests,
105               --with-configure, --with-build, --with-test, --with-runtime and --with-develop
106

108       Copyright 2015 Shoichi Kaji <skaji@cpan.org>
109
110       This library is free software; you can redistribute it and/or modify it
111       under the same terms as Perl itself.
112
113
114
115perl v5.36.0                      2023-01-19                            CPM(1)
Impressum