blob: a0a0ead05735a083930aff985446450ff7a45507 (
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
% Hypervisor FS
% Revision 1
\clearpage
# Basics
---------------- ---------------------
Status: **Supported**
Architectures: all
Components: Hypervisor, toolstack
---------------- ---------------------
# Overview
The Hypervisor FS is a hierarchical name-value store for reporting
information to guests, especially dom0. It is similar to the Linux
kernel's sysfs. Entries and directories are created by the hypervisor,
while the toolstack is able to use a hypercall to query the entry
values or (if allowed by the hypervisor) to modify them.
# User details
With:
xenhypfs ls <path>
the user can list the entries of a specific path of the FS. Using:
xenhypfs cat <path>
the content of an entry can be retrieved. Using:
xenhypfs write <path> <string>
a writable entry can be modified. With:
xenhypfs tree
the complete Hypervisor FS entry tree can be printed.
The FS paths are documented in `docs/misc/hypfs-paths.pandoc`.
# Technical details
Access to the hypervisor filesystem is done via the stable new hypercall
__HYPERVISOR_filesystem_op. This hypercall supports a sub-command
XEN_HYPFS_OP_get_version which will return the highest version of the
interface supported by the hypervisor. Additions to the interface need
to bump the interface version. The hypervisor is required to support the
previous interface versions, too (this implies that additions will always
require new sub-commands in order to allow the hypervisor to decide which
version of the interface to use).
* hypercall interface specification
* `xen/include/public/hypfs.h`
* hypervisor internal files
* `xen/include/xen/hypfs.h`
* `xen/common/hypfs.c`
* `libxenhypfs`
* `tools/libs/libxenhypfs/*`
* `xenhypfs`
* `tools/misc/xenhypfs.c`
* path documentation
* `docs/misc/hypfs-paths.pandoc`
# Testing
Any new parameters or hardware mitigations should be verified to show up
correctly in the filesystem.
# Areas for improvement
* More detailed access rights
* Entries per domain and/or per cpupool
# Known issues
* None
# References
* None
# History
------------------------------------------------------------------------
Date Revision Version Notes
---------- -------- -------- -------------------------------------------
2020-01-23 1 Xen 4.14 Document written
---------- -------- -------- -------------------------------------------
|
