package compiler and linker metadata toolkit
 
 
 
 
 
Go to file
Baptiste Daroussin 2b683071a2 Change manpage from man(7) to mdoc(7) 2015-02-03 00:03:33 +01:00
scripts Add makerelease. 2011-07-25 17:06:11 -05:00
tests Add a test for multiline descriptions 2015-02-02 17:29:39 +01:00
.gitattributes Add .gitattributes file to force dos-lineendings.pc to match CRLF style always 2012-05-04 03:15:07 +00:00
.gitignore buildsys: add support for building a profiled executable 2013-03-01 12:17:16 -06:00
AUTHORS Update AUTHORS based on git history. 2012-07-25 17:13:42 -05:00
COPYING Extend copyright on recently modified files to 2014. 2013-12-27 11:41:23 +00:00
Makefile.in build: disable -D_FORTIFY_SOURCE=2 (let distros use it themselves) (closes #61) 2014-06-07 20:22:48 +00:00
README.md README: update to where we are at in 2014 2014-07-09 02:25:01 -05:00
argvsplit.c Keep the backslash when parsing arguments (fixes #35) 2012-08-14 11:12:01 +02:00
autogen.sh buildsys: remove old vestiges of old build system 2012-08-10 12:54:58 -05:00
bsdstubs.c bsdstubs: add strtok_r() from musl if unavailable on a platform (closes #66) 2014-07-01 23:39:22 -05:00
bsdstubs.h bsdstubs: add strtok_r() from musl if unavailable on a platform (closes #66) 2014-07-01 23:39:22 -05:00
cache.c cache: handle pkg being NULL on pkg_cache_add()/pkg_cache_remove() 2013-03-15 16:50:30 -05:00
config.guess Add config.sub and config.guess. 2011-07-24 23:26:24 -05:00
config.sub Add config.sub and config.guess. 2011-07-24 23:26:24 -05:00
configure.ac pkgconf 0.9.7. 2014-09-14 03:01:34 -05:00
dependency.c dependency: reset parser state on new package atom 2013-03-15 19:44:11 -05:00
fileio.c Trim spaces after a quoted newline 2015-02-02 17:35:32 +01:00
fragment.c fragments: handle sysroot dir munging directly in a smarter way 2014-07-09 01:23:51 -05:00
getopt_long.c getopt: document what is different about our getopt verses normal netbsd getopt_long. 2013-07-22 01:08:38 -05:00
getopt_long.h getopt_long: more fixing 2012-07-20 16:37:26 -05:00
install-sh make install-sh executable 2014-02-28 16:15:41 +01:00
iter.h queue: refactor to use pkg_list_t framework 2013-03-01 10:24:57 -06:00
main.c main: --libs-only-foo and --cflags-only-foo behaviour should be inclusive, not exclusive. 2014-09-13 22:37:00 -05:00
pkg.c Fix expanding PKG_DEFAULT_PATH under Windows. 2014-08-08 13:19:34 +04:00
pkg.h fragments: handle sysroot dir munging directly in a smarter way 2014-07-09 01:23:51 -05:00
pkg.m4 Include PKG_CHECK_VAR macro for reading variables in .pc files 2013-02-24 06:47:48 -06:00
pkgconf.1 Change manpage from man(7) to mdoc(7) 2015-02-03 00:03:33 +01:00
queue.c dependency: refactor to use pkg_list_t framework 2013-03-01 11:36:21 -06:00
stdinc.h Nuke use of basename/dirname where a simple strrchr can do the trick 2012-08-14 16:04:56 +02:00
tuple.c tuple: fix swallowing $ (closes #67) 2014-07-01 23:44:49 -05:00

README.md

pkgconf

pkgconf provides compiler and linker configuration for development frameworks.

general summary

pkgconf is a program which helps to configure compiler and linker flags for development frameworks.

It is similar to pkg-config, but was written from scratch in the summer of 2011 to replace pkg-config, which for a while needed itself to build itself (they have since included a 'stripped down copy of glib 2.0') Since then we have worked on improving pkg-config for embedded use.

usage

Implementations of pkg-config, such as pkgconf, are typically used with the PKG_CHECK_MODULES autoconf macro. As far as we know, pkgconf is compatible with all known variations of this macro. pkgconf detects at runtime whether or not it was started as 'pkg-config', and if so, attempts to set program options such that its behaviour is similar.

In terms of the autoconf macro, it is possible to specify the PKG_CONFIG environment variable, so that you can test pkgconf without overwriting your pkg-config binary. Some other build systems may also respect the PKG_CONFIG environment variable.

To set the enviornment variable on the bourne shell and clones (i.e. bash), you can run:

$ export PKG_CONFIG=/usr/bin/pkgconf

technical design (why pkgconf is better for distros)

pkgconf builds an acyclic directed dependency graph. This allows for the user to more conservatively link their binaries -- which may be helpful in some environments, such as when prelink(1) is being used. As a result of building a directed dependency graph designed for the specific problem domain provided by the user, more accurate dependencies can be determined. pkg-config, on the other hand builds a database of all known pkg-config files on the system before attempting to resolve dependencies, which is a considerably slower and less efficient design.

pkgconf also does not bundle any third-party libraries or depend on any third-party libraries, making it a great tool for embedded systems and distributions with security concerns.

compiling

pkgconf is basically compiled the same way any other autotools-based project is compiled:

$ ./configure
$ make
$ sudo make install

If you are installing pkgconf into a custom prefix, such as /opt/pkgconf, you will likely want to define the default system includedir and libdir for your toolchain. To do this, use the --with-system-includedir and --with-system-libdir configure flags like so:

$ ./configure \
     --prefix=/opt/pkgconf \
     --with-system-libdir=/lib:/usr/lib \
     --with-system-includedir=/usr/include
$ make
$ sudo make install

If you want pkgconf to be used when you invoke pkg-config, you should install a symlink for this. We do not do this for you, as we believe it is better for vendors to make this determination themselves.

$ ln -sf /usr/bin/pkgconf /usr/bin/pkg-config

release tarballs

Release tarballs are available at http://tortois.es/~nenolod/distfiles/.

reporting bugs

See https://github.com/pkgconf/pkgconf/issues.