Add caveat to kinfo_getvmmap(3) explaining high CPU utilisation.

Based on kib's reply on https://lists.freebsd.org/pipermail/freebsd-hackers/2016-July/049710.html

PR:		210904
Submitted by:	Yuri Victorovich <yuri AT rawbw DOT com>
Reviewed by:	jilles
Approved by:	bcr (mentor)
MFC after:	5 days
Differential Revision:	https://reviews.freebsd.org/D12004
This commit is contained in:
sevan 2017-08-18 16:42:58 +00:00
parent 21f6c637f5
commit 834204f6b8

View File

@ -25,7 +25,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 27, 2015
.Dd August 18, 2017
.Dt KINFO_GETVMMAP 3
.Os
.Sh NAME
@ -58,6 +58,13 @@ with the
mib.
While the kernel returns a packed structure, this function expands the
data into a fixed record format.
.Sh CAVEAT
.Fn kinfo_getvmmap
calls can cause significant CPU consumption because calculating the residency
counts requires iterating over all memory pages of the process.
Setting the sysctl variable
.Va kern.proc_vmmap_skip_resident_count
to 1 prevents this calculation.
.Sh RETURN VALUES
On success the
.Fn kinfo_getvmmap