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

FreeBSD Manual Pages

  
 
  

home | help
PKGCONF-PERSONALITY(5)	      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  in-
       clude  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  key-
       word, followed by a colon (:) and then the value	the property should be
       set  to.	 Variable substitution is always performed regardless of prop-
       erty 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 path for libraries.  (mandatory; fragment	list)

       WantDefaultPure
	       If  true,  pkgconf will default to preferring a pure dependency
	       graph.  (optional; boolean; default is false)

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

FreeBSD	Ports 14.quarterly	 July 19, 2018		PKGCONF-PERSONALITY(5)

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

home | help