Differential D56050 Diff 174183 share/man/man4/hwpmc.4

Changeset View

Standalone View

share/man/man4/hwpmc.4

	Show First 20 Lines • Show All 439 Lines • ▼ Show 20 Lines
	.It Va kern.hwpmc.hashsize Pq integer, read-only			.It Va kern.hwpmc.hashsize Pq integer, read-only
	The number of rows in the hash tables used to keep track of owner and			The number of rows in the hash tables used to keep track of owner and
	target processes.			target processes.
	The default is 16.			The default is 16.
	.It Va kern.hwpmc.logbuffersize Pq integer, read-only			.It Va kern.hwpmc.logbuffersize Pq integer, read-only
	The size in kilobytes of each log buffer used by			The size in kilobytes of each log buffer used by
	.Nm Ns 's			.Nm Ns 's
	logging function.			logging function.
	The default buffer size is 4KB.			The default buffer size is 256KB.
				The maximum value is 16MB.
	.It Va kern.hwpmc.mincount Pq integer, read-write			.It Va kern.hwpmc.mincount Pq integer, read-write
	The minimum sampling rate for sampling mode PMCs.			The minimum sampling rate for sampling mode PMCs.
	The default count is 1000 events.			The default count is 1000 events.
	.It Va kern.hwpmc.mtxpoolsize Pq integer, read-only			.It Va kern.hwpmc.mtxpoolsize Pq integer, read-only
	The size of the spin mutex pool used by the PMC driver.			The size of the spin mutex pool used by the PMC driver.
	The default is 32.			The default is 32.
	.It Va kern.hwpmc.nbuffers_pcpu Pq integer, read-only			.It Va kern.hwpmc.nbuffers_pcpu Pq integer, read-only
	The number of log buffers used by			The number of log buffers per CPU used by
	.Nm			.Nm
	for logging.			for logging.
	The default is 64.			The default is 32.
				The product of
				.Va kern.hwpmc.nbuffers_pcpu
				and
				.Va kern.hwpmc.logbuffersize
				must not exceed 32MB per CPU.
	.It Va kern.hwpmc.nsamples Pq integer, read-only			.It Va kern.hwpmc.nsamples Pq integer, read-only
	The number of entries in the per-CPU ring buffer used during sampling.			The number of entries in the per-CPU ring buffer used during sampling.
	The default is 512.			The default is 512.
	.It Va security.bsd.unprivileged_syspmcs Pq boolean, read-write			.It Va security.bsd.unprivileged_syspmcs Pq boolean, read-write
	If set to non-zero, allow unprivileged processes to allocate system-wide			If set to non-zero, allow unprivileged processes to allocate system-wide
	PMCs.			PMCs.
	The default value is 0.			The default value is 0.
	.It Va security.bsd.unprivileged_proc_debug Pq boolean, read-write			.It Va security.bsd.unprivileged_proc_debug Pq boolean, read-write
	▲ Show 20 Lines • Show All 49 Lines • ▼ Show 20 Lines
	between the currently executing kernel and the module being loaded.			between the currently executing kernel and the module being loaded.
	.It "hwpmc: this kernel has not been compiled with 'options HWPMC_HOOKS'."			.It "hwpmc: this kernel has not been compiled with 'options HWPMC_HOOKS'."
	The module loading process failed because the currently executing kernel			The module loading process failed because the currently executing kernel
	was not configured with the required configuration option			was not configured with the required configuration option
	.Dv HWPMC_HOOKS .			.Dv HWPMC_HOOKS .
	.It "hwpmc: tunable hashsize=%d must be greater than zero."			.It "hwpmc: tunable hashsize=%d must be greater than zero."
	A negative value was supplied for tunable			A negative value was supplied for tunable
	.Va kern.hwpmc.hashsize .			.Va kern.hwpmc.hashsize .
	.It "hwpmc: tunable logbuffersize=%d must be greater than zero."			.It "hwpmc: logbuffersize=%d must be greater than zero and less than or equal to %d, resetting to %d."
	A negative value was supplied for tunable			A negative value was supplied for tunable
	.Va kern.hwpmc.logbuffersize .			.Va kern.hwpmc.logbuffersize .
	.It "hwpmc: tunable nlogbuffers=%d must be greater than zero."			.It "hwpmc: nbuffers_pcpu=%d must be greater than zero, resetting to %d."
	A negative value was supplied for tunable			A negative value was supplied for tunable
	.Va kern.hwpmc.nlogbuffers .			.Va kern.hwpmc.nbuffers_pcpu .
	.It "hwpmc: tunable nsamples=%d out of range."			.It "hwpmc: tunable nsamples=%d out of range."
	The value for tunable			The value for tunable
	.Va kern.hwpmc.nsamples			.Va kern.hwpmc.nsamples
	was negative or greater than 65535.			was negative or greater than 65535.
				.It "hwpmc: nbuffers_pcpu=%d * logbuffersize=%d exceeds %dMB per CPU limit, resetting to defaults (%d * %d)."
				The product of tunables
				.Va kern.hwpmc.nbuffers_pcpu
				and
				.Va kern.hwpmc.logbuffersize
				exceeds the maximum per-CPU memory limit.
				Both tunables are reset to their compiled defaults.
	.El			.El
	.Sh DEBUGGING			.Sh DEBUGGING
	The			The
	.Nm			.Nm
	module can be configured to record trace entries using the			module can be configured to record trace entries using the
	.Xr ktr 4			.Xr ktr 4
	interface.			interface.
	This is useful for debugging the driver's functionality, primarily during			This is useful for debugging the driver's functionality, primarily during
	▲ Show 20 Lines • Show All 412 Lines • Show Last 20 Lines