Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

extutils::libbuilder(3pm) [debian man page]

ExtUtils::LibBuilder(3pm)				User Contributed Perl Documentation				 ExtUtils::LibBuilder(3pm)

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

       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:

       o   RT: CPAN's request tracker

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

       o   AnnoCPAN: Annotated CPAN documentation

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

       o   CPAN Ratings

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

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

perl v5.10.1							    2010-12-27						 ExtUtils::LibBuilder(3pm)

Check Out this Related Man Page

ExtUtils::Typemaps::Cmd(3)				User Contributed Perl Documentation				ExtUtils::Typemaps::Cmd(3)

NAME

       ExtUtils::Typemaps::Cmd - Quick commands for handling typemaps

SYNOPSIS

       From XS:

	 INCLUDE_COMMAND: $^X -MExtUtils::Typemaps::Cmd 
			  -e "print embeddable_typemap(q{Excommunicated})"

       Loads "ExtUtils::Typemaps::Excommunicated", instantiates an object, and dumps it as an embeddable typemap for use directly in your XS file.

DESCRIPTION

       This is a helper module for ExtUtils::Typemaps for quick one-liners, specifically for inclusion of shared typemaps that live on CPAN into
       an XS file (see SYNOPSIS).

       For this reason, the following functions are exported by default:

EXPORTED FUNCTIONS

   embeddable_typemap
       Given a list of identifiers, "embeddable_typemap" tries to load typemaps from a file of the given name(s), or from a module that is an
       "ExtUtils::Typemaps" subclass.

       Returns a string representation of the merged typemaps that can be included verbatim into XS. Example:

	 print embeddable_typemap(
	   "Excommunicated", "ExtUtils::Typemaps::Basic", "./typemap"
	 );

       This will try to load a module "ExtUtils::Typemaps::Excommunicated" and use it as an "ExtUtils::Typemaps" subclass. If that fails, it'll
       try loading "Excommunicated" as a module, if that fails, it'll try to read a file called Excommunicated. It'll work similarly for the
       second argument, but the third will be loaded as a file first.

       After loading all typemap files or modules, it will merge them in the specified order and dump the result as an embeddable typemap.

SEE ALSO

       ExtUtils::Typemaps

       perlxs

AUTHOR

       Steffen Mueller "<smueller@cpan.org">

COPYRIGHT &; LICENSE
       Copyright 2012 Steffen Mueller

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

perl v5.16.3							    2012-11-19						ExtUtils::Typemaps::Cmd(3)
Man Page