Scroll to navigation

Level(3) User Contributed Perl Documentation Level(3)

NAME

Perl::Destruct::Level - Allow to change perl's destruction level

SYNOPSIS

    use Perl::Destruct::Level level => 1;
    my $current_destruct_level = Perl::Destruct::Level::get_destruct_level();

DESCRIPTION

This module allows to change perl's internal destruction level.

The default value of the destruct level is 0; it means that perl won't bother destroying all its internal data structures, but let the OS do the cleanup for it at exit.

For perls built with debugging support ("-DDEBUGGING"), an environment variable "PERL_DESTRUCT_LEVEL" allows to control the destruction level. This modules enables to modify it on non-debugging perls too.

Relevant values recognized by perl are 1 and 2. Consult your source code to know exactly what they mean. Note that some embedded environments might extend the meaning of the destruction level for their own purposes: mod_perl does that, for example.

CAVEATS

This module won't work when used from within an END block.

Loading the "threads" module will set the destruction level to 2. (This is to enable spawned threads to properly cleanup their objects.) Loading modules that load "threads", even if they don't spawn threads, will also set the destruction level to 2. (A common example of such a module is "Test::Builder".)

AUTHOR

Copyright (c) 2007 Rafael Garcia-Suarez. This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perlrun, perlhack

2021-08-09 perl v5.32.1