view release on metacpan or  search on metacpan

script/ucpan  view on Meta::CPAN

=over 4

=item -c, --check-only

Check updated modules and exit.

=item -s, --show-fails

Display previously failed modules list in table format and exit.
Note that this list is generated from previous execution record,
therefore, the latest version number of modules installed without this program after the last execution is not reflected.

=item -r, --recover

Recover recoding file againt unwanted result.
In this mode, failed modules are removed from the previous execution record except usual failure( this failure is marked as "UNKNOWN" ).

=item -v, --version

Display the version number.

=item -h, --help

Display the help message.

=back


=head1 OPTIONS

=over 4

=item -f, --force-try

Also install modules marked as skipped.

=item -l, --local-lib

=item -L, --local-lib-conained

Works same as L<cpanm>, and also same as L<cpan-outdated>.

See L<cpanm> for more detail.

=item --exclude-core

Never list the core modules in the outdated module list.

=item --mirror

Works same as L<cpanm>, and also same as L<cpan-outdated>,
but L<cpanm> and L<cpan-outdated> have differences in the behavior of this option.

Note: This option follows the behavior of cpan-outdated:

=over 2

=item * L<cpanm> can take more than one mirror, but L<cpan-outdated> only enables last one.

=item * L<cpan-outdated> only looks at the modules list of the mirror looking for outdated modules. It does not reference metacpan's database like L<cpanm>.

=back

=item --configure-timeout

Specify the timeout length (in seconds) to wait for the configure.
Current default value is 60


=item --build-timeout

Specify the timeout length (in seconds) to wait for the build.
Current default value is 3600


=item --test-timeout

Specify the timeout length (in seconds) to wait for the build.
Current default value is 1800

=item -j, --test-jobs

Control the parallel job habits of the test. Please do not give zero, the program ends with a warning. Note that this option internally replaces the environment variable HARNESS_OPTIONS.

=item -S, --sudo

=item --no-sudo

Switch to the root user with sudo when installing modules,
or deny this.

See L<cpanm> for more detail.

=back

=head1 RECODING FILE

The previous result is recorded in the recoding file of this program.
Normally you do not need to edit this file.

The recoding file is named .ucpandb and placed in the top of @INC (ie. $INC[0]).
For example, if using local::lib, it is placed in /your/local/lib/$Config{archname}/.ucpandb.
This is to ensure that the settings do not interfere with running this program for different Perl environments.

In the recording file, the following items are recorded in YAML format.

=over 4

=item Successful module

Module name, preinstallation version, installed version

=item Failed distribution

Distribution file path, distribution version, module name of included module, version before installation, latest version, reason (for example, build, test, test timeout), processing time (seconds)

=back

=head1 BRIEF EXPLANATION OF THE MECHANISM