View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Jos Boumans > CPANPLUS-0.059_01 > cpanp


Annotate this POD


New  34
Open  22
Stalled  10
View/Report Bugs
Source   Latest Release: CPANPLUS-0.9174


cpanp - The CPANPLUS launcher



cpanp [-]a [ --[no-]option... ]  author... 

cpanp [-]mfitulrcz [ --[no-]option... ]  module... 

cpanp [-]d [ --[no-]option... ] [ --fetchdir=... ]  module... 

cpanp [-]xb [ --[no-]option... ]

cpanp [-]o [ --[no-]option... ] [ module... ]


This script launches the CPANPLUS utility to perform various operations from the command line. If it's invoked without arguments, an interactive shell is executed by default.

Optionally, it can take a single-letter switch and one or more argument, to perform the associated action on each arguments. A summary of the available commands is listed below; cpanp -h provides a detailed list.

    h                   # help information
    v                   # version information

    a AUTHOR ...        # search by author(s)
    m MODULE ...        # search by module(s)
    f MODULE ...        # list all releases of a module

    i MODULE ...        # install module(s)
    t MODULE ...        # test module(s)
    u MODULE ...        # uninstall module(s)
    d MODULE ...        # download module(s)
    l MODULE ...        # display detailed information about module(s)
    r MODULE ...        # display README files of module(s)
    c MODULE ...        # check for module report(s) from cpan-testers
    z MODULE ...        # extract module(s) and open command prompt in it

    x                   # reload CPAN indices

    o [ MODULE ... ]    # list installed module(s) that aren't up to date
    b                   # write a bundle file for your configuration

Each command may be followed by one or more options. If preceded by no, the corresponding option will be set to 0, otherwise it's set to 1.

Example: To skip a module's tests,

    cpanp -i --skiptest MODULE ...

Valid options for most commands are cpantest, debug, flush, force, prereqs, storable, verbose, md5, signature, and skiptest; the 'd' command also accepts fetchdir. Please consult CPANPLUS::Configure for an explanation to their meanings.

Example: To download a module's tarball to the current directory,

    cpanp -d --fetchdir=. MODULE ...




Richard Soderberg <>, Autrijus Tang <>


Copyright 2001, 2002 by Autrijus Tang <>. Copyright 2004 by Richard Soderberg <>.

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


syntax highlighting: