Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ExtUtils::PkgConfig(3)User Contributed Perl DocumentatioExtUtils::PkgConfig(3)

NAME
       ExtUtils::PkgConfig - simplistic	interface to pkg-config

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";

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

	$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

	     *** can't 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

perl v5.24.1			  2017-04-21		ExtUtils::PkgConfig(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ExtUtils::PkgConfig&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help