metering

API Reference

metering

Portable Code Profiling Tool

MONITOR

  • Variable *MONITORED-FUNCTIONS*
    nil
    List of monitored symbols.
  • Function MONITORED (function-place)
    Test to see if a FUNCTION-PLACE is monitored.
  • Function RESET-MONITORING-INFO (name)
    Reset the monitoring info for the specified function.
  • Function RESET-ALL-MONITORING
    Reset monitoring info for all functions.
  • Function MONITORING-ENCAPSULATE (name &optional warn)
    Monitor the function Name. If already monitored, unmonitor first.
  • Function MONITORING-UNENCAPSULATE (name &optional warn)
    Removes monitoring encapsulation code from around Name.
  • Macro MONITOR (&rest names)
    Monitor the named functions. As in TRACE, the names are not evaluated. If a function is already monitored, then unmonitor and remonitor (useful to notice function redefinition). If a name is undefined, give a warning and ignore it. See also unmonitor, report-monitoring, display-monitoring-results and reset-time.
  • Macro UNMONITOR (&rest names)
    Remove the monitoring on the named functions. Names defaults to the list of all currently monitored functions.
  • Function MONITOR-ALL (&optional (package *package*))
    Monitor all functions in the specified package.
  • Macro MONITOR-FORM (form &optional (nested :exclusive) (threshold 0.01) (key :percent-time))
    Monitor the execution of all functions in the current package during the execution of FORM. All functions that are executed above THRESHOLD % will be reported.
  • Macro WITH-MONITORING ((&rest functions) (&optional (nested :exclusive) (threshold 0.01) (key :percent-time)) &body body)
    Monitor the specified functions during the execution of the body.
  • Function REPORT-MONITORING (&optional names (nested :exclusive) (threshold 0.01) (key :percent-time) ignore-no-calls)
    Report the current monitoring state. The percentage of the total time spent executing unmonitored code in each function (:exclusive mode), or total time (:inclusive mode) will be printed together with the number of calls and the unmonitored time per call. Functions that have been executed below THRESHOLD % of the time will not be reported.
  • Function DISPLAY-MONITORING-RESULTS (&optional (threshold 0.01) (key :percent-time) (ignore-no-calls t))