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

  
 
  

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 include and library
     paths.  pkgconf uses this information to determine what information is nec-
     essary 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 assign-
     ment  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  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; lit-
	     eral)

     SysrootDir
	     The directory used by the system root of  the  cross-compile  tool-
	     chain.  (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 15.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+15.1.quarterly>

home | help