<!-- GENERATED by docs/sphinx/bin/20-reference (p5) from reference/bundled/FFI/Probe/Runner.md. Do not edit. -->

```{index} single: FFI::Probe::Runner
```

# FFI::Probe::Runner

Probe runner for FFI

## VERSION

version 2.12

## SYNOPSIS

```perl
use FFI::Probe::Runner;

my $runner = FFI::Probe::Runner->new;
$runner->run('foo.so');
```

## DESCRIPTION

This class executes code in a dynamic library for probing and detecting platform
properties.

## CONSTRUCTOR

### new

```perl
my $runner = FFI::Probe::Runner->new(%args);
```

Creates a new instance.

- exe

    The path to the dlrun wrapper.  The default is usually correct.

- flags

    The flags to pass into `dlopen`.  The default is `RTLD_LAZY` on Unix
    and `0` on windows..

## METHODS

### exe

```perl
my $exe = $runner->exe;
```

The path to the dlrun wrapper.

### flags

```perl
my $flags = $runner->flags;
```

The flags to pass into `dlopen`.

### verify

```perl
$runner->verify;
```

Verifies the dlrun wrapper is working.  Throws an exception in the event of failure.

### run

```perl
$runner->run($dll, @args);
```

Runs the `dlmain` function in the given dynamic library, passing in the
given arguments.  Returns a [FFI::Probe::Runner::Result](Runner/Result.md) object which
contains the results.

## AUTHOR

Author: Graham Ollis <plicease@cpan.org>

Contributors:

Bakkiaraj Murugesan (bakkiaraj)

Dylan Cali (calid)

pipcet

Zaki Mughal (zmughal)

Fitz Elliott (felliott)

Vickenty Fesunov (vyf)

Gregor Herrmann (gregoa)

Shlomi Fish (shlomif)

Damyan Ivanov

Ilya Pavlov (Ilya33)

Petr Písař (ppisar)

Mohammad S Anwar (MANWAR)

Håkon Hægland (hakonhagland, HAKONH)

Meredith (merrilymeredith, MHOWARD)

Diab Jerius (DJERIUS)

Eric Brine (IKEGAMI)

szTheory

José Joaquín Atria (JJATRIA)

Pete Houston (openstrike, HOUSTON)

Lukas Mai (MAUKE)

## COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2022 by Graham Ollis.

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

## Modules

- [`FFI::Probe::Runner::Builder`](Runner/Builder.md) - Probe runner builder for FFI
- [`FFI::Probe::Runner::Result`](Runner/Result.md) - The results from a probe run.

```{toctree}
:hidden:
:maxdepth: 1

Runner/Builder
Runner/Result
```