---
name: "Test::Valgrind::Command::Perl"
section: "3pm"
platform: "linux"
package: "libtest-valgrind-perl"
version: "1.19-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Test::Valgrind::Command::Perl"
---

# Test::Valgrind::Command::Perl(3pm)

A Test::Valgrind command that invokes perl.

## NAME

Test::Valgrind::Command::Perl - A Test::Valgrind command that invokes perl.

## VERSION

Version 1.19

## DESCRIPTION

This command is the base for all `"perl"`-based commands. It handles the suppression generation and sets the main command-line flags.

## METHODS

This class inherits Test::Valgrind::Command.

### "new"

```
    my $tvcp = Test::Valgrind::Command::Perl->new(
     perl       => $^X,
     inc        => \@INC,
     taint_mode => $taint_mode,
     %extra_args,
    );
```

The package constructor, which takes several options :

- •

  The `"perl"` option specifies which `"perl"` executable will run the argument list given in `"args"`.

  Defaults to `$^X`.

- •

  `"inc"` is a reference to an array of paths that will be passed as `"-I"` to the invoked command.

  Defaults to `@INC`.

- •

  `$taint_mode` is a boolean that specifies if the script should be run under taint mode.

  Defaults to false.

Other arguments are passed straight to `"Test::Valgrind::Command->new"`.

### "perl"

```
    my $perl = $tvcp->perl;
```

Read-only accessor for the `"perl"` option.

### "inc"

```
    my @inc = $tvcp->inc;
```

Read-only accessor for the `"inc"` option.

### "taint\_mode"

```
    my $taint_mode = $tvcp->taint_mode;
```

Read-only accessor for the `"taint_mode"` option.

### "env"

```
    my $env = $tvcp->env($session);
```

Returns an Env::Sanctify object that sets the environment variables `"PERL_DESTRUCT_LEVEL"` to `3` and `"PERL_DL_NONLAZY"` to `1` during the run.

## SEE ALSO

Test::Valgrind, Test::Valgrind::Command.

Env::Sanctify.

## AUTHOR

Vincent Pit, `"<perl at profvince.com>"`, \<http://www.profvince.com\>.

You can contact me by mail or on `"irc.perl.org"` (vincent).

## BUGS

Please report any bugs or feature requests to `"bug-test-valgrind at rt.cpan.org"`, or through the web interface at \<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Valgrind\>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

## SUPPORT

You can find documentation for this module with the perldoc command.

```
    perldoc Test::Valgrind::Command::Perl
```

## COPYRIGHT & LICENSE

Copyright 2009,2010,2011,2013,2015,2016 Vincent Pit, all rights reserved.

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