NAME

       Devel::FindPerl - Find the path to your perl

VERSION

       version 0.016

SYNOPSIS

        use Devel::FindPerl 'find_perl_interpreter';
        system find_perl_interpreter, '-e', '...';

DESCRIPTION

       This module tries to find the path to the currently running perl. It (optionally) exports
       the following functions:

FUNCTIONS

   find_perl_interpreter($config = ExtUtils::Config->new)
       This function will try really really hard to find the path to the perl running your
       program. I should be able to find it in most circumstances. Note that the result of this
       function will be cached for any serialized value of $config. It will return a list that
       usually but not necessarily is containing one element; additional elements are arguments
       that must be passed to that perl for correct functioning.

   perl_is_same($path, @arguments)
       Tests if the perl in $path is the same perl as the currently running one.

SECURITY

       This module by default does things that are not particularly secure (run programs based on
       external input). In tainted mode, it will try to avoid any insecure action, but that may
       affect its ability to find the perl executable.

SEE ALSO

       •   Probe::Perl

           This module has much the same purpose as Probe::Perl, in fact the algorithm is mostly
           the same as both are extracted from Module::Build at different points in time. If I
           had known about it when I extracted it myself, I probably wouldn't have bothered, but
           now that I do have it there are a number of reasons for me to prefer Devel::FindPerl
           over Probe::Perl

           •   Separation of concerns. P::P does 4 completely different things (finding perl,
               managing configuration, categorizing platorms and formatting a perl version.
               Devel::FindPerl is instead complemented by modules such as ExtUtils::Config and
               Perl::OSType.

           •   It handles tainting better. In particular, "find_perl_interpreter" never returns a
               tainted value, even in tainted mode.

           •   It was written with inclusion in core in mind, though the removal of Module::Build
               from core after perl 5.20 may make this point moot.

AUTHOR

       Leon Timmermans <leont@cpan.org>, Randy Sims <randys@thepierianspring.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Randy Sims, Leon Timmermans.

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