# man > corelist(1)

---
type: CommandReference
command: corelist
mode: man
section: 1
source: man-pages
---

## Quick Reference

- `corelist <ModuleName>` — show first perl version that included the module
- `corelist <ModuleName> <Version>` — check if a specific version is in core
- `corelist /<Regex>/` — search modules by regex
- `corelist -a <ModuleName>` — list all versions of a module in perl releases
- `corelist -v <PerlVersion>` — list all modules and versions for a given perl
- `corelist -v <PerlVersion> <ModuleName>` — show version of a module in that perl
- `corelist -r` — list all perl releases and their dates
- `corelist --diff <PerlVersion> <PerlVersion>` — show module changes between perl versions

## Name

`corelist` — a commandline frontend to Module::CoreList

## Synopsis

shell
corelist -v
corelist [-a|-d] <ModuleName> | /<ModuleRegex>/ [<ModuleVersion>] ...
corelist [-v <PerlVersion>] [ <ModuleName> | /<ModuleRegex>/ ] ...
corelist [-r <PerlVersion>] ...
corelist --utils [-d] <UtilityName> [<UtilityName>] ...
corelist --utils -v <PerlVersion>
corelist --feature <FeatureName> [<FeatureName>] ...
corelist --diff PerlVersion PerlVersion
corelist --upstream <ModuleName>
## Options

### Querying Modules

- `-a` — list all versions of the given module (or regex match) in every known perl release
- `-d` — find the first perl version where a module was released by date (not version number)
- `<ModuleName>` — module name to query; special case: "Unicode" returns the Unicode Character Database version
- `/<ModuleRegex>/` — regex pattern to match module names

### Perl Version Information

- `-v` — without argument: list all perl release versions known. With a version argument (e.g., `5.00503` or `5.8.8`): list all modules and their versions in that perl. Also usable as a filter when combined with module names.
- `-r` — without argument: list all perl releases and their release dates. With a version: show only that version's release date.

### Utilities

- `--utils` — list the first perl version each named utility program was released with. May be combined with `-d` to change first-release criteria. With `-v <version>`: list all utilities released with that perl; named utilities are ignored.

### Features

- `--feature`, `-f` — list the first version bundle of each named feature

### Comparing Perls

- `--diff <PerlVersion> <PerlVersion>` — print a human-readable table of all module changes between two perl versions

### Upstream Information

- `--upstream`, `-u` — show if the given module is primarily maintained in core or on CPAN, and its bug tracker URL

### Help

- `-?`, `-help` — display help summary
- `--man` — full manual page

## Examples

shell
# Check when File::Spec was first included
corelist File::Spec
# Output: File::Spec was first released with perl 5.005

# Query a specific version of a module
corelist File::Spec 0.83
# Output: File::Spec 0.83 was released with perl 5.007003

# Regex search for modules matching IPC::Open
corelist /IPC::Open/
# Output: IPC::Open2 was first released with perl 5, IPC::Open3 was first released with perl 5

# List all versions of Unicode in perl releases
corelist -a Unicode

# List all modules and versions for perl 5.8.8
corelist -v 5.8.8

# Show version of B module in perl 5.8.8
corelist -v 5.8.8 B

# Regex filter with -v
corelist -v 5.8.8 /^B::/

# List all perl releases and dates
corelist -r

# Show diff between perl 5.8.0 and 5.10.0
corelist --diff 5.8.0 5.10.0

# List utilities released with perl 5.8.8
corelist --utils -v 5.8.8
## See Also

- [Module::CoreList](http://localhost/phpMan.php/perldoc/Module%3A%3ACoreList/markdown) — the underlying module for programmatic access