Module Name: src
Committed By: wiz
Date: Wed Apr 20 08:20:17 UTC 2011
Modified Files:
src/share/man/man4/man4.x86: balloon.4
Log Message:
Spelling, sort sections.
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man4/man4.x86/balloon.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/man4.x86/balloon.4
diff -u src/share/man/man4/man4.x86/balloon.4:1.5 src/share/man/man4/man4.x86/balloon.4:1.6
--- src/share/man/man4/man4.x86/balloon.4:1.5 Wed Apr 20 00:21:34 2011
+++ src/share/man/man4/man4.x86/balloon.4 Wed Apr 20 08:20:16 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: balloon.4,v 1.5 2011/04/20 00:21:34 jym Exp $
+.\" $NetBSD: balloon.4,v 1.6 2011/04/20 08:20:16 wiz Exp $
.\"
.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -64,7 +64,7 @@
.Xr xm 1 .
Alternatively, the host's administrator is free to request to a particular
domain to give some memory back.
-This command requires the targetted domain's cooperation and requires
+This command requires the targeted domain's cooperation and requires
.Nm balloon
support within it.
This can be done through the
@@ -107,50 +107,10 @@
This entry serves the same purpose as the
.Dq memory/target
entry in Xenstore.
-This controls the targetted number of pages that the domain should have.
+This controls the targeted number of pages that the domain should have.
Note that this is only a target, and may not be achieved for a variety of
reasons.
.El
-.Sh ERRORS
-When setting the minimum threshold or target reservation entries through
-.Dq kern.xen.balloon ,
-the following errors can be returned:
-.Bl -tag -width Er
-.It Bq Er EPERM
-The value passed is beyond limits.
-The new value is either too low
-.Po Dq min
-is below driver's safeguard value, or
-.Dq target
-is below minimum value
-.Pc ,
-or too high
-.Po Dq target
-is above maximum value
-.Pc .
-.El
-.Sh BUGS
-There are a number of reasons why a domain may not attain the targetted
-memory reservation:
-.Nm
-can be empty and cannot be collapsed further, domain
-may not have enough free memory pages (due to memory fragmentation,
-memory exhaustion, ...) so it cannot give enough back to
-.Nm .
-.Pp
-Currently, the virtual memory sub-system of
-.Nx
-is not capable of ``hot-plugging'' new memory pages into place.
-This means that increasing a domain's memory reservation above
-its initial maximum value is pointless, as new memory pages
-cannot be consumed by the memory management sub-system.
-.Pp
-Over expanding
-.Nm
-generates high kernel memory pressure.
-While the driver tries to stay as conservative as possible to avoid
-crashes, a very low memory reservation will lead to unwanted swap or even
-.Fn panic .
.Sh DIAGNOSTICS
.Bl -diag
.It "WARNING: balloon could not reach target %zu (current %zu)"
@@ -170,6 +130,24 @@
.Nm
will limit reservation up to the maximum value it can handle.
.El
+.Sh ERRORS
+When setting the minimum threshold or target reservation entries through
+.Dq kern.xen.balloon ,
+the following errors can be returned:
+.Bl -tag -width Er
+.It Bq Er EPERM
+The value passed is beyond limits.
+The new value is either too low
+.Po Dq min
+is below driver's safeguard value, or
+.Dq target
+is below minimum value
+.Pc ,
+or too high
+.Po Dq target
+is above maximum value
+.Pc .
+.El
.Sh SEE ALSO
.Xr xm 1 ,
.Xr xenbus 4 ,
@@ -197,6 +175,28 @@
.An Cherry G. Mathew Aq che...@netbsd.org
and
.An Jean-Yves Migeon Aq j...@netbsd.org .
+.Sh BUGS
+There are a number of reasons why a domain may not attain the targeted
+memory reservation:
+.Nm
+can be empty and cannot be collapsed further, domain
+may not have enough free memory pages (due to memory fragmentation,
+memory exhaustion, ...) so it cannot give enough back to
+.Nm .
+.Pp
+Currently, the virtual memory sub-system of
+.Nx
+is not capable of ``hot-plugging'' new memory pages into place.
+This means that increasing a domain's memory reservation above
+its initial maximum value is pointless, as new memory pages
+cannot be consumed by the memory management sub-system.
+.Pp
+Over expanding
+.Nm
+generates high kernel memory pressure.
+While the driver tries to stay as conservative as possible to avoid
+crashes, a very low memory reservation will lead to unwanted swap or even
+.Fn panic .
.Sh SECURITY CONSIDERATIONS
Ballooning involves moving pages between different domains.
This includes their content, which can lead to information leak.
