package compiler and linker metadata toolkit
 
 
 
 
 
Go to file
William Pitcock e0789ca650 Add pkgconf(1) manual page. (closes #55) 2013-12-27 11:13:55 +00:00
scripts Add makerelease. 2011-07-25 17:06:11 -05:00
tests Merge pull request #53 from tonytheodore/keep-system-libs 2013-08-24 11:17:15 -07: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 everything: update copyright to note multiple authors 2012-07-25 21:09:31 -05:00
Makefile.in Add pkgconf(1) manual page. (closes #55) 2013-12-27 11:13:55 +00:00
README.md README: document --with-system-includedir and --with-system-libdir (closes #57) 2013-10-06 12:34:09 +00: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 everything: more friendly warranty disclaimer 2012-07-20 14:29:58 -05:00
bsdstubs.h everything: more friendly warranty disclaimer 2012-07-20 14:29:58 -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.3. 2013-08-23 04:08:06 +00:00
dependency.c dependency: reset parser state on new package atom 2013-03-15 19:44:11 -05:00
fileio.c do not keep the quote information when set once 2012-08-14 11:06:04 +02:00
fragment.c fragment: use forward-merge for static linking (closes #51) 2013-08-23 03:44:33 +00: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 add install-sh 2011-07-24 23:24:10 -05:00
iter.h queue: refactor to use pkg_list_t framework 2013-03-01 10:24:57 -06:00
main.c fix keep-system-* arg parsing and test with default prefix 2013-08-24 15:19:41 +10:00
pkg.c fragment: use forward-merge for static linking (closes #51) 2013-08-23 03:44:33 +00:00
pkg.h fragment: use forward-merge for static linking (closes #51) 2013-08-23 03:44:33 +00:00
pkg.m4 Include PKG_CHECK_VAR macro for reading variables in .pc files 2013-02-24 06:47:48 -06:00
pkgconf.1 Add pkgconf(1) manual page. (closes #55) 2013-12-27 11:13:55 +00: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: refactor to use pkg_list_t framework 2013-03-01 10:45:55 -06: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 now needs itself to build itself (or you can set a bunch of environment variables, both are pretty ugly).

Implementations of pkg-config, such as pkgconf, are typically used with the PKG_CHECK_MODULES autoconf macro. As far as I (nenolod) 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. (hint: export PKG_CONFIG=/usr/bin/pkgconf) However, if you do this, it will be running in native mode, so you may have some very strange results as the dependency graph is compiled differently in native mode.

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.