Index: lib/libutil/kinfo_getvmmap.3
===================================================================
--- lib/libutil/kinfo_getvmmap.3	(revision 301975)
+++ lib/libutil/kinfo_getvmmap.3	(working copy)
@@ -58,6 +58,13 @@
 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 due to the residency count
+calculation which requires the iteration 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