| 1 |
name: build_machine |
| 2 |
long_name: Build machine information |
| 3 |
description: | |
| 4 |
Provides information about the build machine -- the machine that is doing the actual compilation. |
| 5 |
See [Cross-compilation](Cross-compilation.md). |
| 6 |
|
| 7 |
Currently, these values are populated using |
| 8 |
[`platform.system()`](https://docs.python.org/3.7/library/platform.html#platform.system) and |
| 9 |
[`platform.machine()`](https://docs.python.org/3.7/library/platform.html#platform.machine). |
| 10 |
If you think the returned values for any of these are incorrect for |
| 11 |
your system or CPU, or if your OS is not in the linked table, please |
| 12 |
[file a bug](https://github.com/mesonbuild/meson/issues/new) report |
| 13 |
with details and we'll look into it. |
| 14 |
|
| 15 |
methods: |
| 16 |
- name: cpu_family |
| 17 |
returns: str |
| 18 |
description: | |
| 19 |
Returns the CPU family name. |
| 20 |
[This table](Reference-tables.md#cpu-families) contains |
| 21 |
all known CPU families. These are guaranteed to continue working. |
| 22 |
|
| 23 |
- name: cpu |
| 24 |
returns: str |
| 25 |
description: Returns a more specific CPU name, such as `i686`, `armv8l`, etc. |
| 26 |
|
| 27 |
- name: system |
| 28 |
returns: str |
| 29 |
description: | |
| 30 |
Returns the operating system name. |
| 31 |
[This table](Reference-tables.md#operating-system-names) Lists |
| 32 |
all of the currently known Operating System names, these are |
| 33 |
guaranteed to continue working. |
| 34 |
|
| 35 |
- name: endian |
| 36 |
returns: str |
| 37 |
description: returns `'big'` on big-endian systems and `'little'` on little-endian systems. |
| 38 |
|
| 39 |
- name: kernel |
| 40 |
returns: str |
| 41 |
since: 1.2.0 |
| 42 |
description: | |
| 43 |
Returns the name of the Operating System Kernel, such as `linux`, `xnu`, and |
| 44 |
`nt`. [See here for more complete |
| 45 |
list](Reference-tables.md#kernel-names-since-120) These are more specific |
| 46 |
than `system`. If this cannot be detected (for the build machine), or is not |
| 47 |
set in the cross file (for the host machine when cross compiling), calling |
| 48 |
this method is fatal. |
| 49 |
|
| 50 |
- name: subsystem |
| 51 |
returns: str |
| 52 |
since: 1.2.0 |
| 53 |
description: | |
| 54 |
Returns the variant of the operating system, such as `ios` and `tvos`. [See |
| 55 |
here for more complete list](Reference-tables.md#kernel-names-since-120) |
| 56 |
These are more specific than `system`. If this cannot be detected (for the |
| 57 |
build machine), or is not set in the cross file (for the host machine when |
| 58 |
cross compiling), calling this method is fatal. |