26c26
< .\" $FreeBSD: head/share/man/man9/zone.9 179880 2008-06-19 18:33:38Z remko $
---
> .\" $FreeBSD: head/share/man/man9/zone.9 213910 2010-10-16 04:14:45Z lstewart $
28c28
< .Dd June 19, 2008
---
> .Dd October 9, 2010
38c38,40
< .Nm uma_zone_set_max
---
> .Nm uma_zone_set_max,
> .Nm uma_zone_get_max,
> .Nm uma_zone_get_cur
61a64,67
> .Ft int
> .Fn uma_zone_get_max "uma_zone_t zone"
> .Ft int
> .Fn uma_zone_get_cur "uma_zone_t zone"
173c179
< The purpose of
---
> The
175,178c181,184
< is to limit the maximum amount of memory that the system can dedicated
< toward the zone specified by the
< .Fa zone
< argument.
---
> function limits the number of items
> .Pq and therefore memory
> that can be allocated to
> .Fa zone .
181,182c187,191
< argument gives the upper limit of items in the zone.
< This limits the total number of items in the zone which includes:
---
> argument specifies the requested upper limit number of items.
> The effective limit may end up being higher than requested, as the
> implementation will round up to ensure all memory pages allocated to the zone
> are utilised to capacity.
> The limit applies to the total number of items in the zone, which includes
187a197,208
> .Pp
> The
> .Fn uma_zone_get_max
> function returns the effective upper limit number of items for a zone.
> .Pp
> The
> .Fn uma_zone_get_cur
> function returns the approximate current occupancy of the zone.
> The returned value is approximate because appropriate synchronisation to
> determine an exact value is not performend by the implementation.
> This ensures low overhead at the expense of potentially stale data being used
> in the calculation.