Commit Graph

22 Commits

Author SHA1 Message Date
Joseph Koshy
a07d350c16 Document the PMC_F_CALLCHAIN flag and the kern.hwpmc.callchaindepth
tunable.

Sponsored by:	FreeBSD Foundation and Google Inc.
2007-12-07 08:29:46 +00:00
Joseph Koshy
a5c506d293 - Document an EAGAIN error return from a PMC_OP_CONFIGURELOG request.
- Document some EINVAL error returns from PMC_OP_CONFIGURELOG,
  PMC_OP_WRITELOG and PMC_OP_FLUSHLOG that were missed earlier.
- Correct a typo: s/PMC_OP_ALLOCATE/PMC_OP_PMCALLOCATE/.
- Describe how log file writing errors are returned by a PMC_OP_FLUSHLOG
  request.
2007-11-25 06:05:41 +00:00
Joseph Koshy
1a94fde847 - Improve clarity: use 'scope' to distinguish between process and system
PMCs and 'mode' to distinguish between counting and sampling.
- Document PMC row dispositions.
- Document the requirement for PRIV_PMC_MANAGE privilege when issuing
  PMC_OP_PMCADMIN requests.
2007-11-24 03:48:18 +00:00
Joseph Koshy
e805d32b8e - Correct a documentation bug: handles returned from a PMC_OP_PMCALLOCATE
request are 32 bit values, and are not necessarily small.
- Note that the PMC_F_KGMON flag is currently unimplemented.
- Tweak description of an EINVAL error return.
- Add an "AUTHORS" section.
2007-11-22 14:09:26 +00:00
Joseph Koshy
1e999888c2 Describe an error return that was missed out earlier. 2007-10-13 06:03:47 +00:00
Joseph Koshy
44caa87293 Improve a sentence.
Prodded by:	billf
MFC after:	3 days
2007-02-12 03:26:22 +00:00
Joseph Koshy
4f00efe0cb Spelling/grammar fixes.
MFC after:	1 week
2006-04-21 01:33:04 +00:00
Joseph Koshy
d48fe4c520 Typo fix; "ing" -> "in". 2006-03-01 16:49:07 +00:00
Joseph Koshy
fe5ca00ac4 Document the EOPNOTSUPP returned by hwpmc(4) if a sampling mode PMC
is requested on a CPU without an APIC.

Requested by:	anholt (a while ago)
2005-12-27 15:35:06 +00:00
Ruslan Ermilov
78ad54210f -mdoc sweep. 2005-11-18 10:56:28 +00:00
Joseph Koshy
79247772f0 Note the requirement for 'device apic' on i386 systems. [1]
Consistently use 'x86' when referring to behaviour common to the
i386 and amd64.

Submitted by:	Niklas Sorensson <nik@cs.chalmers.se> [1]
2005-09-28 14:19:31 +00:00
Joseph Koshy
24bae9892f Correct a typo.
MFC after:	3 days
2005-09-28 03:02:16 +00:00
Joseph Koshy
953adc1723 Document the diagnostic message printed at startup time. Keep the
list of diagnostic messages sorted.

Document the recently introduced EOPNOTSUPP error return.  Repair
sort ordering for the list of error descriptions.

MFC after:	3 days
2005-08-23 17:18:27 +00:00
Joseph Koshy
3419317c32 Document two new diagnostic messages in hwpmc(4). 2005-07-30 09:03:57 +00:00
Joseph Koshy
6d6a103a77 Add COMPATIBILITY and HISTORY sections. Fix an -mdoc error.
Cross-reference pmclog(3).

Reviewed by:	ru
2005-07-21 06:21:52 +00:00
Hiroki Sato
44cb3ab02e Fix typos and use consistent section names in manual pages:
s/SYSCTLS/SYSCTL VARIABLES/
 s/TUNABLES/LOADER TUNABLES/
 s/CAVEAT/CAVEATS/
 s/DESCIPTION/DESCRIPTION/

Reviewed by:	ru
MFC after:	3 days
2005-07-15 17:35:26 +00:00
Joseph Koshy
d9a5f34617 Fix markup, correct typos, improve grammar, move the BUGS section to
the end of the manual page.

Submitted by:	ru
Approved by:	re (blanket hwpmc)
2005-06-30 02:38:46 +00:00
Robert Watson
db3b2be449 Correct spelling of options PMC_HOOKS to options HWPMC_HOOKS.
Approved by:	re (man page blanket)
2005-06-19 18:36:00 +00:00
Joseph Koshy
3bc6c67462 Document the need for a log file to be configured before a PMC
configured with logging options can be started.
2005-06-09 20:55:05 +00:00
Joseph Koshy
f263522a45 MFP4:
- Implement sampling modes and logging support in hwpmc(4).

- Separate MI and MD parts of hwpmc(4) and allow sharing of
  PMC implementations across different architectures.
  Add support for P4 (EMT64) style PMCs to the amd64 code.

- New pmcstat(8) options: -E (exit time counts) -W (counts
  every context switch), -R (print log file).

- pmc(3) API changes, improve our ability to keep ABI compatibility
  in the future.  Add more 'alias' names for commonly used events.

- bug fixes & documentation.
2005-06-09 19:45:09 +00:00
Joseph Koshy
c5153e190b Add convenience APIs pmc_width() and pmc_capabilities() to -lpmc.
Have pmcstat(8) and pmccontrol(8) use these APIs.

Return PMC class-related constants (PMC widths and capabilities)
with the OP GETCPUINFO call leaving OP PMCINFO to return only the
dynamic information associated with a PMC (i.e., whether enabled,
owner pid, reload count etc.).

Allow pmc_read() (i.e., OPS PMCRW) on active self-attached PMCs to
get upto-date values from hardware since we can guarantee that the
hardware is running the correct PMC at the time of the call.

Bug fixes:
 - (x86 class processors) Fix a bug that prevented an RDPMC
   instruction from being recognized as permitted till after the
   attached process had context switched out and back in again after
   a pmc_start() call.

   Tighten the rules for using RDPMC class instructions: a GETMSR
   OP is now allowed only after an OP ATTACH has been done by the
   PMC's owner to itself.  OP GETMSR is not allowed for PMCs that
   track descendants, for PMCs attached to processes other than
   their owner processes.

 - (P4/HTT processors only) Fix a bug that caused the MI and MD
   layers to get out of sync.  Add a new MD operation 'get_config()'
   as part of this fix.

 - Allow multiple system-mode PMCs at the same row-index but on
   different CPUs to be allocated.

 - Reject allocation of an administratively disabled PMC.

Misc. code cleanups and refactoring.  Improve a few comments.
2005-05-01 14:11:49 +00:00
Joseph Koshy
ebccf1e3a6 Bring a working snapshot of hwpmc(4), its associated libraries, userland utilities
and documentation into -CURRENT.

Bump FreeBSD_version.

Reviewed by:	alc, jhb (kernel changes)
2005-04-19 04:01:25 +00:00