1CPM(1) User Contributed Perl Documentation CPM(1)
2
6 cpm - a fast CPAN module installer
7
9 # install modules into local/
10 > cpm install Module1 Module2 ...
11 # install modules with verbose messages
13 > cpm install -v Module
14 # from cpanfile (with cpanfile.snapshot if any)
16 > cpm install
17 # install module into current @INC instead of local/
19 > cpm install -g Module
20 # prefer TRIAL release
22 > cpm install --dev Moose
23 # install modules as if version of your perl is 5.8.5
25 # so that modules which are not core in 5.8.5 will be installed
26 > cpm install --target-perl 5.8.5
27 # resolve distribution names from DARKPAN/modules/02packages.details.txt.gz
29 # and fetch distibutions from DARKPAN/authors/id/...
30 > cpm install --resolver 02packages,http://example.com/darkpan Your::Module
31 > cpm install --resolver 02packages,file:///path/to/darkpan Your::Module
32 # use darkpan first, and if it fails, use metadb and normal CPAN
34 > cpm install --resolver 02packages,http://example.com/darkpan --resolver metadb Your::Module
35 # specify types/phases in cpanfile by "--with-*" and "--without-*" options
37 > cpm install --with-recommends --without-test
38
40 -w, --workers=N
41 number of workers, default: 5
42 -L, --local-lib-contained=DIR
43 directory to install modules into, default: local/
44 -g, --global
45 install modules into current @INC instead of local/
46 -v, --verbose
47 verbose mode; you can see what is going on
48 --prebuilt, --no-prebuilt
49 save builds for CPAN distributions; and later, install the prebuilts if available
50 default: on; you can also set $ENV{PERL_CPM_PREBUILT} false to disable this option
51 --target-perl=VERSION (EXPERIMENTAL)
52 install modules as if verison is your perl is VERSION
53 --mirror=URL
54 base url for the CPAN mirror to use, you can use --mirror multiple times
55 default: https://cpan.metacpan.org
56 --pp, --pureperl-only
57 prefer pureperl only build
58 --static-install, --no-static-install
59 enable/disable the static install, default: enable
60 -r, --resolver=class,args (EXPERIMENTAL, will be removed or renamed)
61 specify resolvers, you can use --resolver multiple times
62 available classes: metadb/metacpan/02packages/snapshot
63 --reinstall
64 reinstall the distribution even if you already have the latest version installed
65 --dev (EXPERIMENTAL)
66 resolve TRIAL distributions too
67 --color, --no-color
68 turn on/off color output, default: on
69 --test, --no-test
70 run test cases, default: no
71 --man-pages
72 generate man pages
73 --retry, --no-retry
74 retry configure/build/test/install if fails, default: retry
75 --configure-timeout=sec, --build-timeout=sec, --test-timeout=sec
76 specify configure/build/test timeout second, default: 60sec, 3600sec, 1800sec
77 --show-progress, --no-show-progress
78 show progress, default: on
79 --cpanfile=path
80 specify cpanfile path, default: ./cpanfile
81 --snapshot=path
82 specify cpanfile.snapshot path, default: ./cpanfile.snapshot
83 -V, --version
84 show version
85 -h, --help
86 show this help
87 --feature=identifier
88 specify the feature to enable in cpanfile; you can use --feature multiple times
89 --with-requires, --without-requires (default: with)
90 --with-recommends, --without-recommends (default: without)
91 --with-suggests, --without-suggests (default: without)
92 --with-configure, --without-configure (default: without)
93 --with-build, --without-build (default: with)
94 --with-test, --without-test (default: with)
95 --with-runtime, --without-runtime (default: with)
96 --with-develop, --without-develop (default: without)
97 specify types/phases of dependencies in cpanfile to be installed
98
100 Copyright 2015 Shoichi Kaji <skaji@cpan.org>
101 This library is free software; you can redistribute it and/or modify it
103 under the same terms as Perl itself.
104perl v5.28.0 2018-08-01 CPM(1)