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.