NAME

Module::Build::Pluggable::XSUtil - Utility for XS

SYNOPSIS

use Module::Build::Pluggable (
    'XSUtil' => {
        cc_warnings => 1,
        ppport      => 1,
        xshelper    => 1,
        'c++'       => 1,
        'c99'       => 1,
    },
);

DESCRIPTION

Module::Build::Pluggable::XSUtil is a utility for XS library.

This library is port of Module::Install::XSUtil

OPTIONS

• c++

    use Module::Build::Pluggable (
        'XSUtil' => {
            'c++' => 1,
        },
    );
  

  This option checks C++ compiler's availability. If it's not available, Build.PL exits by 0.

• c99

    use Module::Build::Pluggable (
        'XSUtil' => {
            'c99' => 1,
        },
    );
  

  This option checks C99 compiler's availability. If it's not available, Build.PL exits by 0.

• ppport

    use Module::Build::Pluggable (
        'XSUtil' => {
            'ppport' => 1,
        },
    );
  

  Generate ppport.h automatically. If you want to specify the path for ppport.h, use following form:

    use Module::Build::Pluggable (
        'XSUtil' => {
            'ppport' => 'lib/My/ppport.h',
        },
    );
  

  If you want to specify the version of ppport.h, use configure_requires in Module::Build::Pluggable->new.

• xshelper

    use Module::Build::Pluggable (
        'XSUtil' => {
            'xshelper' => 1,
        },
    );
  

  XSUtil generates xshelper.h. If you want to specify the path for xsutil.h, use following form:

    use Module::Build::Pluggable (
        'XSUtil' => {
            'xshelper' => 'lib/My/xshelper.h',
        },
    );
  

  XSUtil generates ppport.h to same directory(xshelper.h depend to ppport.h).

• cc_warnings

    use Module::Build::Pluggable (
        'XSUtil' => {
            'cc_warnings' => 1,
        },
    );
  

  This option enables warnings flag for compiler.

Options for Build.PL

Under the control of this module, Build.PL accepts -g option, which sets Module::Build's extra_compiler_flags -g (or something like). It will disable optimization and enable some debugging features.

AUTHOR

Goro Fuji, is original author of Module::Install::XSUtil.

Tokuhiro Matsuno <tokuhirom AAJKLFJEF@ GMAIL COM>

SEE ALSO

Module::Install::XSUtil, Module::Build::Pluggable

LICENSE

Copyright (C) Tokuhiro Matsuno

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