1# zx_system_get_physmem
2
3## NAME
4
5<!-- Updated by update-docs-from-abigen, do not edit. -->
6
7system_get_physmem - get amount of physical memory on the system
8
9## SYNOPSIS
10
11<!-- Updated by update-docs-from-abigen, do not edit. -->
12
13```
14#include <zircon/syscalls.h>
15
16uint64_t zx_system_get_physmem(void);
17```
18
19## DESCRIPTION
20
21`zx_system_get_physmem()` returns the total size of physical memory on
22the machine, in bytes.
23
24## RIGHTS
25
26<!-- Updated by update-docs-from-abigen, do not edit. -->
27
28TODO(ZX-2399)
29
30## RETURN VALUE
31
32`zx_system_get_physmem()` returns a number in bytes.
33
34## ERRORS
35
36`zx_system_get_physmem()` cannot fail.
37
38## NOTES
39
40Currently the total size of physical memory cannot change during a run of
41the system, only at boot time.  This might change in the future.
42
43## SEE ALSO
44
45
46[system_get_num_cpus](system_get_num_cpus.md).
47