Pkg-config

pkg-config is a software development tool that queries information about libraries from a local, file-based database for the purpose of building a codebase that depends on them.

Uses your system voice; voice and rate in settings.

≈ 4 min read

Cite, export and learn8 citation formats · 8 exports · lesson and quiz

Names in other languages

No names in other languages are held for this entry yet.

Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.

pkg-config is a software development tool that queries information about libraries from a local, file-based database for the purpose of building a codebase that depends on them. It allows for sharing a codebase in a cross-platform way by using host-specific library information that is stored outside of yet referenced by the codebase. This indirection allows the codebase to build on a host without encoding host-specific library information in the codebase.

The tool is invoked via its command line interface (CLI), and it reports library information via standard output. Some information, such as version information, is more useful to the programmer. Other information, such as command-line options (flags), is more useful to build tools such as a compiler and a linker.

The tool was originally designed for Linux, and is now also available for BSD, Windows, macOS, and Solaris. The first implementation was written in shell script.[1] Later, it was rewritten in C leveraging GLib.[2]

Database

edit edit source

To enable use of the tool, a referenced library must have a corresponding .pc file stored in the file system location designated for that purpose (the location varies by system). This file should be stored as part of the installation process as handled by RPM, deb, or other packaging system or by compiling from source code.

A .pc file contains various information such as the location of header files, library binaries and various descriptive information. It may also include a list of dependent libraries that programs using the library need to use.

Example

edit edit source

The following example .pc file defines information for libpng. It starts with defining variables that are used throughout the rest of the file. It includes descriptive information including name "libpng" and version "1.2.8". The Cflags entry defines an option that the C preprocessor uses to locate the library's header files – in /usr/local/include/libpng12. The Libs entry defines options that define the location of library binaries, /usr/local/lib, and identify which library binary files to link.

prefix=/usr/local exec_prefix=${prefix} libdir=${exec_prefix}/lib includedir=${exec_prefix}/include Name: libpng Description: Loads and saves PNG files Version: 1.2.8 Libs: -L${libdir} -lpng12 -lz Cflags: -I${includedir}/libpng12

The following is an example build command that uses this file to specify options to gcc. The output of command pkg-config --libs --cflags libpng is passed to gcc via its command line interface.

$ gcc -o test test.c $(pkg-config --libs --cflags libpng)

Alternative implementations

edit edit source

Notable variants of pkg-config:

References

edit edit source
  1. ^ Havoc Pennington (4 June 2000). "Re: the *-config scripts". Retrieved 2020-01-22. Wikipedia revision 1359592962, retrieved 2026-11-20
  2. ^ Havoc Pennington (23 July 2000). "pkg-config". Retrieved 2020-01-22. Wikipedia revision 1359592962, retrieved 2026-11-20
  3. ^ a b c d e Found on spread of pkgconf but not spread of pkg-config on repology Wikipedia revision 1359592962, retrieved 2026-11-20
  4. ^ a b c d https://lists.archlinux.org/pipermail/arch-dev-public/2018-May/029252.html Replacing pkg-config with pkgconf] on arch-dev-public@lists.archlinux.org Wikipedia revision 1359592962, retrieved 2026-11-20
edit edit source

Text derived from https://en.wikipedia.org/w/index.php?oldid=1359592962 under CC BY-SA 4.0; modifications have been made.

Words in each sectionExampleExampleExample: 160 words160DatabaseDatabaseDatabase: 95 words95Alternative implementat…Alternative implementationsAlternative implementations: 84 words84
Words in each section. Measured from the stored article body; sections below the minimum are not plotted.

Provenance

snapshot enwiki-001359592962 · captured 2026-06-16 · ledger · version history

Cite this page as: encyclopegia.org, “Pkg-config”, snapshot enwiki-001359592962. https://encyclopegia.org/a/pkg-config