aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/static_library.yaml
blob: 615baa22997661ca6b94c28171cd68c3a1704fe9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
name: static_library
returns: lib
description: Builds a static library with the given sources.

posargs_inherit: _build_target_base
varargs_inherit: _build_target_base
kwargs_inherit: _build_target_base

kwargs:
  pic:
    type: bool
    since: 0.36.0
    description: |
      Builds the library as positional independent code
      (so it can be linked into a shared library). This
      option has no effect on Windows and OS X since it doesn't make
      sense on Windows and PIC cannot be disabled on OS X.

  prelink:
    type: bool
    since: 0.57.0
    description: |
      If `true` the object files in the target will be prelinked,
      meaning that it will contain only one prelinked
      object file rather than the individual object files.

  rust_abi:
    type: str
    since: 1.3.0
    description: |
      Set the specific ABI to compile (when compiling rust).
      - 'rust' (default): Create a "rlib" crate.
      - 'c': Create a "staticlib" crate.