GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  EXTUTILS::PKGCONFIG (3)

.ds Aq ’

NAME

ExtUtils::PkgConfig - simplistic interface to pkg-config

CONTENTS

SYNOPSIS



 use ExtUtils::PkgConfig;

 $package = gtk+-2.0;

 %pkg_info = ExtUtils::PkgConfig->find ($package);
 print "modversion:  $pkg_info{modversion}\n";
 print "cflags:      $pkg_info{cflags}\n";
 print "libs:        $pkg_info{libs}\n";

 $modversion = ExtUtils::PkgConfig->modversion($package);

 $libs = ExtUtils::PkgConfig->libs($package);

 $cflags = ExtUtils::PkgConfig->cflags($package);

 $cflags_only_I = ExtUtils::PkgConfig->cflags_only_I($package);

 $cflags_only_other = ExtUtils::PkgConfig->cflags_only_other($package);

 $libs_only_L = ExtUtils::PkgConfig->libs_only_L($package);

 $libs_only_l = ExtUtils::PkgConfig->libs_only_l($package);

 $libs_only_other = ExtUtils::PkgConfig->libs_only_other($package);

 $static_libs = ExtUtils::PkgConfig->static_libs($package);

 $var_value = ExtUtils::PkgConfig->variable($package, $var);

 if (ExtUtils::PkgConfig->atleast_version($package,$version)) {
    ...
 }

 if (ExtUtils::PkgConfig->exact_version($package,$version)) {
    ...
 }

 if (ExtUtils::PkgConfig->max_version($package,$version)) {
    ...
 }



DESCRIPTION

The pkg-config program retrieves information about installed libraries, usually for the purposes of compiling against and linking to them.

ExtUtils::PkgConfig is a very simplistic interface to this utility, intended for use in the Makefile.PL of perl extensions which bind libraries that pkg-config knows. It is really just boilerplate code that you would’ve written yourself.

    USAGE

HASH = ExtUtils::PkgConfig->find (STRING, [STRING, ...]) Call pkg-config on the library specified by STRING (you’ll have to know what to use here). The returned HASH contains the modversion, cflags, and libs values under keys with those names. If multiple STRINGS are passed they are attempted in the order they are given till a working package is found.

If pkg-config fails to find a working STRING, this function croaks with a message intended to be helpful to whomever is attempting to compile your package.

For example:



  *** can not find package bad1
  *** check that it is properly installed and available
  *** in PKG_CONFIG_PATH



or



  *** cant find cflags for gtk+-2.0
  *** is it properly installed and available in PKG_CONFIG_PATH?



STRING = ExtUtils::PkgConfig->create_version_macros (PACKAGE, STEM) Create a set of version macros with the prefix STEM for the library specified by PACKAGE. The result is returned.

Example input would be gtk+-2.0 for PACKAGE and GTK for STEM.

ExtUtils::PkgConfig->write_version_macros (FILE, PACKAGE, STEM, [PACKAGE, STEM, ...]) Create one or more sets of version macros for the libraries and prefixes specified by the PACKAGE and STEM pairs and write them to the file FILE. If it doesn’t exist, FILE will be created. If it does exist, it will be overwritten.

SEE ALSO

ExtUtils::PkgConfig was designed to work with ExtUtils::Depends for compiling the various modules of the gtk2-perl project.



  L<ExtUtils::Depends>

  L<http://gtk2-perl.sourceforge.net/>



This module is really just an interface to the pkg-config utility program. http://www.freedesktop.org/Software/pkgconfig

AUTHORS

muppet <scott at asofyet dot org>.

COPYRIGHT AND LICENSE

Copyright 2003-2004, 2012-2013 by muppet, Ross McFarland, and the gtk2-perl team

This library is free software; you can redistribute it and/or modify it under the terms of the Lesser General Public License (LGPL). For more information, see http://www.fsf.org/licenses/lgpl.txt

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 EXTUTILS::PKGCONFIG (3) 2013-09-29

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.