Sat Jul 30 09:39:20 2011 UTC ()
Reflect my change for Xen sysctl(7) nodes:
kern.xen.balloon -> machdep.xen.balloon.


(jym)
diff -r1.6 -r1.7 src/share/man/man4/man4.x86/balloon.4
cvs diff -r1.6 -r1.7 src/share/man/man4/man4.x86/balloon.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.x86/balloon.4 2011/04/20 08:20:16 1.6
+++ src/share/man/man4/man4.x86/balloon.4 2011/07/30 09:39:20 1.7
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: balloon.4,v 1.6 2011/04/20 08:20:16 wiz Exp $ 1.\" $NetBSD: balloon.4,v 1.7 2011/07/30 09:39:20 jym Exp $
2.\" 2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jean-Yves Migeon <jym@NetBSD.org>. 7.\" by Jean-Yves Migeon <jym@NetBSD.org>.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -73,27 +73,27 @@ command of @@ -73,27 +73,27 @@ command of
73.Xr xm 1 . 73.Xr xm 1 .
74Alternatively, one can control the ballooning directly by writing 74Alternatively, one can control the ballooning directly by writing
75under the 75under the
76.Dq memory/target 76.Dq memory/target
77node inside Xenstore. 77node inside Xenstore.
78This entry controls the target memory reservation 78This entry controls the target memory reservation
79of a given domain, indicated in kilobytes (KiB). 79of a given domain, indicated in kilobytes (KiB).
80.Pp 80.Pp
81An interface to control 81An interface to control
82.Nm 82.Nm
83is also available through 83is also available through
84.Xr sysctl 8 84.Xr sysctl 8
85under 85under
86.Dq kern.xen.balloon 86.Dq machdep.xen.balloon
87(all values being in kilobytes): 87(all values being in kilobytes):
88.Bl -tag indent -width xxxxxxx 88.Bl -tag indent -width xxxxxxx
89.It current 89.It current
90(read-only) The current memory reservation of the domain. 90(read-only) The current memory reservation of the domain.
91.It min 91.It min
92(read-write) The minimum reservation value acceptable by the domain's 92(read-write) The minimum reservation value acceptable by the domain's
93.Nm balloon 93.Nm balloon
94driver. 94driver.
95Any request that would require domain to reduce its reservation below 95Any request that would require domain to reduce its reservation below
96this threshold will be refused by the driver. 96this threshold will be refused by the driver.
97This can be used by a domain's administrator to control the number of memory 97This can be used by a domain's administrator to control the number of memory
98pages that will be kept available to domain. 98pages that will be kept available to domain.
99.It max 99.It max
@@ -122,27 +122,27 @@ memory exhaustion by refusing further al @@ -122,27 +122,27 @@ memory exhaustion by refusing further al
122The hypervisor only gave a partial set of memory pages to domain. 122The hypervisor only gave a partial set of memory pages to domain.
123This happens when host's memory consumption is high, and hypervisor 123This happens when host's memory consumption is high, and hypervisor
124is unable to give enough free pages back to domain. 124is unable to give enough free pages back to domain.
125.It "memory 'hot-plug' unsupported - clipping reservation %zu => %zu pages." 125.It "memory 'hot-plug' unsupported - clipping reservation %zu => %zu pages."
126An attempt was made by domain to get more memory than initially obtained 126An attempt was made by domain to get more memory than initially obtained
127during boot. 127during boot.
128As physical memory pages cannot be added to memory management sub-system 128As physical memory pages cannot be added to memory management sub-system
129dynamically, 129dynamically,
130.Nm 130.Nm
131will limit reservation up to the maximum value it can handle. 131will limit reservation up to the maximum value it can handle.
132.El 132.El
133.Sh ERRORS 133.Sh ERRORS
134When setting the minimum threshold or target reservation entries through 134When setting the minimum threshold or target reservation entries through
135.Dq kern.xen.balloon , 135.Dq machdep.xen.balloon ,
136the following errors can be returned: 136the following errors can be returned:
137.Bl -tag -width Er 137.Bl -tag -width Er
138.It Bq Er EPERM 138.It Bq Er EPERM
139The value passed is beyond limits. 139The value passed is beyond limits.
140The new value is either too low 140The new value is either too low
141.Po Dq min 141.Po Dq min
142is below driver's safeguard value, or 142is below driver's safeguard value, or
143.Dq target 143.Dq target
144is below minimum value 144is below minimum value
145.Pc , 145.Pc ,
146or too high 146or too high
147.Po Dq target 147.Po Dq target
148is above maximum value 148is above maximum value