FreeBSD manual
download PDF document: pkgconf-personality.5.pdf
PKGCONF-PERSONALITY(5) FreeBSD File Formats Manual PKGCONF-PERSONALITY(5)
NAME
file.personality - pkgconf cross-compile personality file format
DESCRIPTION
pkgconf cross-compile personality files provide a useful mechanism for
storing various information about system toolchains. Information stored
by .personality files include information about paths used by a cross-
compile toolchain, such as the sysroot directory and default include and
library paths. pkgconf uses this information to determine what
information is necessary to use libraries.
FILE SYNTAX
The .personality file follows a format inspired by RFC822. Comments are
prefixed by a pound sign, hash sign or octothorpe (#), and variable
assignment is similar to POSIX shell. Properties are defined using
RFC822-style stanzas.
PROPERTIES
Properties are set using RFC822-style stanzas which consist of a keyword,
followed by a colon (:) and then the value the property should be set to.
Variable substitution is always performed regardless of property type.
There are three types of property:
Literal
The property will be set to the text of the value.
Fragment List
The property will be set to a list of fragments parsed from the
text. The input text must be in a format that is suitable for
passing to a POSIX shell without any shell expansions after
variable substitution has been done. Elements are delimited with
a colon.
Boolean
The property will be set to true if the value is one of: true,
yes or 1. Otherwise it will be set to false.
PROPERTY KEYWORDS
Triplet
The triplet used by the cross-compile toolchain. (mandatory;
literal)
SysrootDir
The directory used by the system root of the cross-compile
toolchain. (mandatory; literal)
DefaultSearchPaths
A list of directories to look for pc(5) files in. (mandatory;
fragment list)
SystemIncludePaths
A list of directories that are included by default in the search
path for include files. (mandatory; fragment list)
SystemLibraryPaths
A list of directories that are included by default in the search
If true, pkgconf will default to operating in static linking
mode. (optional; boolean; default is false)
EXAMPLES
An example .personality file:
# This is a comment
Triplet: x86_64-pc-linux-gnu
SysrootDir: /home/kaniini/sysroot/x86_64-pc-linux-gnu
DefaultSearchPaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/lib/pkgconfig:/home/kaniini/sysroot/x86_64-pc-linux-gnu/share/pkgconfig
SystemIncludePaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/include
SystemLibraryPaths: /home/kaniini/sysroot/x86_64-pc-linux-gnu/lib
SEE ALSO
pkgconf(1), pc(5), pkg.m4(7)
FreeBSD 14.0-RELEASE-p11 July 19, 2018 FreeBSD 14.0-RELEASE-p11