NAME

App::ChangeShebang - change shebang lines for relocatable perl

SYNOPSIS

    > change-shebang /path/to/bin/script.pl

    > head -3 /path/to/bin/script.pl
    #!/bin/sh
    exec "$(dirname "$0")"/perl -x "$0" "$@"
    #!perl

DESCRIPTION

change-shebang changes shebang lines from

    #!/path/to/bin/perl

to

    #!/bin/sh
    exec "$(dirname "$0")"/perl -x "$0" "$@"
    #!perl

Why do we need this?

Let's say you build perl with relocatable enabled (-Duserelocatableinc). Then the shebang lines of executable scripts point at the installation time perl binary path.

So if you move your perl directory to other places, the shebang lines of executable scripts point at a wrong perl binary and we cannot execute scripts. Oops!

A solution of that problem is to replace shebang lines by

    #!/bin/sh
    exec "$(dirname "$0")"/perl -x "$0" "$@"
    #!perl

which means that scripts will be executed by the perl located in the same directory.

SEE ALSO

Relocatable installations in perl5100delta.pod

https://github.com/shoichikaji/relocatable-perl

https://github.com/shoichikaji/relocatable-perl-growthforecast

AUTHOR

Shoichi Kaji <skaji@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2018 Shoichi Kaji <skaji@cpan.org>

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