logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

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

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.

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).

Name

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

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/>

Synopsis

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

See Also