1ExtUtils::LibBuilder(3)User Contributed Perl DocumentatioEnxtUtils::LibBuilder(3)
2
3
4

NAME

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

SYNOPSIS

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

METHODS

13       Supports all the method from ExtUtils::CBuilder. The following three
14       methods were adapted to be used in standalone C libraries.
15
16   new
17       This method creates a new ExtUtils::LibBuilder object. While it
18       supports all "ExtUtils::CBuilder" methods some might work slightly
19       differently (namely the two below).
20
21       You can supply to the constructor any option recognized by
22       "ExtUtils::CBuilder" constructor. None of them will be used by
23       "LibBuilder".
24
25   link
26          $libbuilder -> link( objects     => [ "foo.o", "bar.o" ],
27                               module_name => "foobar",
28                               lib_file    => "libfoobar$libbuilder->{libext}");
29
30       Options to the link method are the same as the "CBuilder" counterpart.
31       Note that the result is a standalone C Library and not a bundle to be
32       loaded by Perl.
33
34       Also, note that you can use the "libext" key to retrieve from the
35       object the common library extension on the running system (including
36       the dot).
37
38   link_executable
39         $libbuilder->link_executable( objects => ["main.o"],
40                                       extra_linker_flags => "-L. -lfoobar",
41                                       exe_file => "foobarcmd$libbuilder->{exeext}");
42
43       The "link_executable" needs, as "extra_linker_flags" options, the name
44       of the library and the search path. Future versions might include
45       better handling on the library files.
46
47       Also, note that you can use the "exeext" key to retrieve from the
48       object the common executable extension on the running system (including
49       the dot).
50

AUTHOR

52       Alberto Simoes, "<ambs at cpan.org>"
53

BUGS

55       Please report any bugs or feature requests to "bug-extutils-libbuilder
56       at rt.cpan.org", or through the web interface at
57       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=ExtUtils-LibBuilder>.
58       I will be notified, and then you'll automatically be notified of
59       progress on your bug as I make changes.
60

SUPPORT

62       You can find documentation for this module with the perldoc command.
63
64           perldoc ExtUtils::LibBuilder
65
66       You can also look for information at:
67
68       •   RT: CPAN's request tracker
69
70           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=ExtUtils-LibBuilder>
71
72       •   AnnoCPAN: Annotated CPAN documentation
73
74           <http://annocpan.org/dist/ExtUtils-LibBuilder>
75
76       •   CPAN Ratings
77
78           <http://cpanratings.perl.org/d/ExtUtils-LibBuilder>
79
80       •   Search CPAN
81
82           <http://search.cpan.org/dist/ExtUtils-LibBuilder/>
83

85       Copyright 2010 Alberto Simoes.
86
87       This program is free software; you can redistribute it and/or modify it
88       under the terms of either: the GNU General Public License as published
89       by the Free Software Foundation; or the Artistic License.
90
91       See http://dev.perl.org/licenses/ for more information.
92
93
94
95perl v5.36.0                      2023-01-20           ExtUtils::LibBuilder(3)
Impressum