summaryrefslogtreecommitdiff
path: root/usr.sbin
diff options
context:
space:
mode:
authorKlemens Nanni <kn@cvs.openbsd.org>2021-11-17 15:13:37 +0000
committerKlemens Nanni <kn@cvs.openbsd.org>2021-11-17 15:13:37 +0000
commit3ca2b3de94b78994d3325dba5b1d9bd28861bfbe (patch)
tree38c02e01fdc4359d515b019c4a08223c7f97ac63 /usr.sbin
parent51a0667407486b5c61261084b887e37c517a49af (diff)
Clarify BUGS wrt. reserving memory for the hypervisor
The previous wording might be understood as "leave memory unused in the primary domain", which is precisely what causes the hypervisor to reject the configuration since ldomctl(8) would implicitly allocate all remaining memory for the primary domain. Make sure that primary domain memory should be assigned explicitly so the total amount of allocated memory is less than physically available, i.e. the hypervisor will have even more memory available and configurations can boot again. OK stsp
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/ldomctl/ldom.conf.516
1 files changed, 11 insertions, 5 deletions
diff --git a/usr.sbin/ldomctl/ldom.conf.5 b/usr.sbin/ldomctl/ldom.conf.5
index 5a6f0aef9af..20978571cab 100644
--- a/usr.sbin/ldomctl/ldom.conf.5
+++ b/usr.sbin/ldomctl/ldom.conf.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ldom.conf.5,v 1.15 2020/11/06 21:32:09 kn Exp $
+.\" $OpenBSD: ldom.conf.5,v 1.16 2021/11/17 15:13:36 kn Exp $
.\"
.\" Copyright (c) 2012 Mark Kettenis <kettenis@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 6 2020 $
+.Dd $Mdocdate: November 17 2021 $
.Dt LDOM.CONF 5 sparc64
.Os
.Sh NAME
@@ -32,7 +32,7 @@ The scope must be opened and closed with curly braces and contains
one or more of the following keywords, each on a separate line.
A scope with
.Ar name
-.Cm primary
+.Dq primary
configures resources for the primary domain.
If no configuration for the primary domain exists it is assigned
all CPU and memory resources not used by any guest domains.
@@ -152,5 +152,11 @@ fallback to
.Dq factory-default
upon resetting the machine.
.Pp
-If in doubt, leave enough memory unused for the hypervisor to reserve.
-On bigger T4 based machines, 1024 megabytes has proven to suffice.
+If in doubt, assign
+.Ic memory
+to the
+.Dq primary
+.Ic domain
+explicitly,
+such that enough memory remains unused for the hypervisor to reserve.
+On T4 based machines, 1024 megabytes has proven to suffice.