NAME

mcpani -- A command line tool to manage a CPAN Mini Mirror.

SYNOPSIS

mcpani [options] < --add | --update | --mirror | --inject >

Commands:

--add               Add a new package to the repository
      --module      Name of the module to add
      --authorid    Author ID of the module
      --modversion  Version number of the module
      --file        distribution module

--update            Update local CPAN mirror and inject modules
--mirror            Update local CPAN mirror from remote
--inject            Add modules from repository to CPAN mirror

Options:

-h, --help          This synopsis
-H, --man           Detailed description

-l, --local         local location for CPAN::Mini Mirror
-r, --remote        CPAN mirror to mirror from
-p, --passive       Enable passive ftp for mirroring.
-v, --verbose       verbose output
-V, --version       Version information.
    --signing-key   See CPAN::Checksums $SIGNING_KEY

DESCRIPTION

mcpani uses CPAN::Mini to build or update a local CPAN mirror from a remote one, while also adding private or third-party distributions.

Configuration file

mcpani will search the following four places in order:

• file pointed to by the environment variable MCPANI_CONFIG

• $HOME/.mcpani/config

• /usr/local/etc/mcpani

• /etc/mcpani

By default, mcpani uses a simple configuration file in the following format:

local: /www/CPAN
remote: ftp://ftp.cpan.org/pub/CPAN ftp://ftp.kernel.org/pub/CPAN
repository: /work/mymodules
passive: yes
dirmode: 0755

Configuration options

local (required)

location to store local CPAN::Mini mirror

remote (required)

CPAN site(s) to mirror from. Multiple sites can be listed, with spaces between them.

repository

Location to store modules to add to the local CPAN::Mini mirror.

passive

Enable passive FTP.

dirmode

Set the permissions of created directories to the specified mode (octal value). The default value is based on the umask (if supported).

Command-line options

--add

--authorid the CPAN ID

--file the distribution file

--module the package name of the main module

-v, --verbose

--version the version of the distribution

-h, -H, --help, --man, -?

Output a help message and exit.

--inject

Inject the local distributions into the local repository.

-v, --verbose

--mirror

Update the local MiniCPAN by downloading the latest modules from the public CPAN (or the CPAN-like repo specified in the remote config. --mirror uses

-l, --local

-r, --remote

-v, --verbose

--update

This runs --mirror then --inject.

-V, --version

Output the version of mcpani and exit.

AUTHOR

Shawn Sorichetti <ssoriche@coloredblocks.net>

ISSUES

Report issues to the GitHub queue:

https://github.com/briandfoy/cpan-mini-inject/issues

COPYRIGHT & LICENSE

Copyright 2004 Shawn Sorichetti, All Rights Reserved.

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