Index: share/man/man9/hz.9 =================================================================== --- share/man/man9/hz.9 +++ share/man/man9/hz.9 @@ -36,7 +36,7 @@ .Pp .Vt extern int hz; .Vt extern int tick; -.Vt extern int stathz; /* deprecated */ +.Vt extern int stathz; .Vt extern int profhz; /* deprecated */ .Sh DESCRIPTION .Fx @@ -56,12 +56,19 @@ .Va hz times per second. .Pp -The second clock, running at either -.Va stathz -or +The second clock, effectively running at either +.Va stathz , +is used to gather statistics on the system, its processes, etc. +It computes values for +.Xr getrusage 2 +and statistics displayed by +.Xr ps 1 +and +.Xr top 1 . +.Pp +The historical use of .Va profhz -was used to gather timing statistics, but has been replaced with the more -functional +to gather timing statistics has been replaced with the more functional .Xr hwpmc 4 . These values are returned for .Qq compatibility @@ -88,6 +95,15 @@ from .Xr sysctl 8 . .Pp +The current global and per-CPU CPU time usage is returned to the user in units +of 1 / +.Va stathz +ticks in the +.Sy kern.cp_time +and +.Sy kern.cp_times +sysctl MIBs. +.Pp The .Va hz rate may be overridden by defining