---
name: "cpan-outdated"
section: "1p"
platform: "linux"
package: "cpanoutdated"
version: "0.32-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cpan-outdated"
---

# cpan-outdated(1p)

detect outdated CPAN modules in your environment

## NAME

cpan-outdated - detect outdated CPAN modules in your environment

## SYNOPSIS

```
    # print a list of distributions that contain outdated modules
    % cpan-outdated
    # print a list of outdated modules in packages
    % cpan-outdated -p
    # verbose
    % cpan-outdated --verbose
    
    # ignore core modules (do not update dual life modules)
    % cpan-outdated --exclude-core
    # alternate mirrors
    % cpan-outdated --mirror file:///home/user/minicpan/
    # additional module path(same as cpanminus)
    % cpan-outdated -l extlib/
    % cpan-outdated -L extlib/
    # install with cpan
    % cpan-outdated | xargs cpan -i
    # install with cpanm
    % cpan-outdated    | cpanm
    % cpan-outdated -p | cpanm
```

## DESCRIPTION

This script prints a list of outdated CPAN modules on your machine.

This is the same feature as 'CPAN::Shell-\>r', but `"cpan-outdated"` is much faster and uses less memory.

This script can be integrated with the cpanm command.

## PRINTING PACKAGES VS DISTRIBUTIONS

This script by default prints the outdated distribution as in the CPAN distro format, i.e: `"A/AU/AUTHOR/Distribution-Name-0.10.tar.gz"` so you can pipe it into CPAN installers, but with the `"-p"` option it can be tweaked to print the module's package names.

If you wish to manage a set of modules separately from your system perl installation and not install newer versions of "dual life modules" that are distributed with perl, the `"--exclude-core"` option will make cpan-outdated ignore changes to core modules. Used with tools like cpanm and its `"-L --local-lib-contained"` and `"--self-contained"` options, this facilitates maintaining updates on standalone sets of modules.

For some tools, such as cpanm, installing from packages could be a bit more useful since you can track to see the old version number which you upgrade from.

## AUTHOR

Tokuhiro Matsuno

## LICENSE

Copyright (C) 2009 Tokuhiro Matsuno.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

## SEE ALSO

CPAN

App::cpanminus

If you want to see what's changed for modules that require upgrades, use cpan-listchanges
