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

FreeBSD Manual Pages

  
 
  

home | help
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 informa-
     tion 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 as-
     signment 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 two 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 vari-
	     able 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
	     path for libraries.  (mandatory; fragment list)

     WantDefaultStatic
	     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), pkg.m4(7), pc(5)

FreeBSD	13.0			 July 19, 2018			  FreeBSD 13.0

NAME | DESCRIPTION | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pkgconf-personality&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help