Skip to content

Latest commit

 

History

History
82 lines (53 loc) · 2.46 KB

system-libs.md

File metadata and controls

82 lines (53 loc) · 2.46 KB

Ancillary Module Reference: system-libs

Link against System Librarys, without using search paths.

How to use

Make rules available in your current module.

import system-libs ;

Main target rules

  • rule system-libs ( names + : properties * : usage-requirements * )

    Scan search paths provided in properties for the given names libraries.

    Names is a glob pattern.

    usage-requirements are passed to any created library as the respective argument.

    Returns the library names created.

Properties

  • <path> path
    Search path for libraries

  • <cc-search-dirs>
    If present search paths returned by cc -print-search-dirs

  • <exclude> glob-pattern
    Exclude any libraries matched by names and matched by glob_pattern.

  • <FEATURE> value
    Created lib will have <FEATURE>value property in its requirements.
    Libs that would conflict, are not created.

  • <target-prefix> prefix
    prefix for the created main target name.

  • <threading-tag> tag
    postfix tag of lib names that indicate threading distinction.
    Specifically the multi threaded type.
    Boost example: -mt

  • <debug>
    Print debug information for each library made.

  • <headers-only> target
    Create a headers only alias target named target.

  • <system-lib-rpath> no | yes
    Default to no.
    If yes, created lib will add its base-path to rpath for dependent linking targets.

OSX Specific

  • <homebrew> formula
    formula to find library in.
    If the cellar for formula has a /include path, it will be set as a property value for <include> feature of usage-requirements of created libraries.
    Will prompt operate to brew install the formula if it isn't installed.

  • <homebrew-version> version
    Require formula identified by previous <homebrew> feature to be exact version identified by version.

  • <homebrew-with> arg-string
    Require formula identified by previous <homebrew> feature to have been installed --with-arg-string.

Debian Specific

  • <apt> package
    package to find the library in.
    If package has a non-standard include path, it will be set as a property value for <include> feature of usage-requirements for created libraries.

Boost.Build Type Reference

Type Base Type
SYSTEM_LIB LIB