]> rtime.felk.cvut.cz Git - jailhouse.git/blob - Documentation/sysfs-entries.txt
x86: Provide PM timer access to all cells
[jailhouse.git] / Documentation / sysfs-entries.txt
1 Sysfs Entries
2 =============
3
4 The following sysfs entries are provided by the Jailhouse Linux driver. These
5 can be used for monitoring the state of the hypervisor and its cells.
6
7 /sys/devices/jailhouse
8 |- enabled                      - 1 if Jailhouse is enabled, 0 otherwise
9 |- mem_pool_size                - number of pages in hypervisor memory pool
10 |- mem_pool_used                - used pages of hypervisor memory pool
11 |- remap_pool_size              - number of pages in hypervisor remapping pool
12 |- remap_pool_used              - used pages of hypervisor remapping pool
13 `- cells
14    |- <name of cell>
15    |  |- id                     - unique numerical ID
16    |  |- state                  - "running", "shut down", or "failed"
17    |  |- cpus_assigned          - bitmask of assigned logical CPUs
18    |  |- cpus_failed            - bitmask of logical CPUs that caused a failure
19    |  `- statistics
20    |     |- vmexits_total       - Total number of VM exits
21    |     `- vmexits_<reason>    - VM exits due to <reason>
22    `- ...
23
24 Note that statistics are accumulated non-atomically over all CPUs of a cell and
25 may not reflect a fully consistent state. The existence and semantics of VM
26 exit reason values are architecture-dependent and may change in future
27 versions. In general statistics shall only be considered as a first hint when
28 analyzing cell behavior.