ExtUtils::LibBuilder - A tool to build C libraries.

- NAME
- SYNOPSIS
- METHODS
  - new
  - link
  - link_executable
- AUTHOR
- BUGS
- SUPPORT
- LICENSE AND COPYRIGHT

# NAME

ExtUtils::LibBuilder - A tool to build C libraries.

# SYNOPSIS

    use ExtUtils::LibBuilder;
    my $libbuilder = ExtUtils::LibBuilder->new( %options );

# METHODS

Supports all the method from ExtUtils::CBuilder. The following three methods were adapted to be used in standalone C libraries.

## new

This method creates a new ExtUtils::LibBuilder object. While it supports all `ExtUtils::CBuilder` methods some might work slightly differently (namely the two below).

You can supply to the constructor any option recognized by `ExtUtils::CBuilder` constructor. None of them will be used by `LibBuilder`.

## link

    $libbuilder -> link( objects     => [ "foo.o", "bar.o" ],
                         module_name => "foobar",
                         lib_file    => "libfoobar$libbuilder->{libext}");

Options to the link method are the same as the `CBuilder` counterpart. Note that the result is a standalone C Library and not a bundle to be loaded by Perl.

Also, note that you can use the `libext` key to retrieve from the object the common library extension on the running system (including the dot).

## link_executable

    $libbuilder->link_executable( objects => ["main.o"],
                                  extra_linker_flags => "-L. -lfoobar",
                                  exe_file => "foobarcmd$libbuilder->{exeext}");

The `link_executable` needs, as `extra_linker_flags` options, the name of the library and the search path. Future versions might include better handling on the library files.

Also, note that you can use the `exeext` key to retrieve from the object the common executable extension on the running system (including the dot).

# AUTHOR

Alberto Simoes, `<ambs at cpan.org>`

# BUGS

Please report any bugs or feature requests to `bug-extutils-libbuilder at rt.cpan.org`, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=ExtUtils-LibBuilder. 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 ExtUtils::LibBuilder

You can also look for information at:

- RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=ExtUtils-LibBuilder

- AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/ExtUtils-LibBuilder

- CPAN Ratings

  http://cpanratings.perl.org/d/ExtUtils-LibBuilder

- Search CPAN

  http://search.cpan.org/dist/ExtUtils-LibBuilder/

# LICENSE AND COPYRIGHT

Copyright 2010 Alberto Simoes.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

ExtUtils::LibBuilder - A tool to build C libraries.