profiler-status

Arguments: &key verbose current-profile

This function will print to *standard-output* the status of the current data collection. If the runtime analysis was invoked with the with-profiling macro, the form to be analyzed is also printed.

This function returns one of the following possible values:

• :inactive -- data collection has not yet started
• :suspended -- data collection has started, but sampling is currently not being done
• :sampling -- data collection has been started and sampling is occurring
• :saved -- data collection has stopped, but as yet no analysis of saved data has occurred
• :analyzed -- all data of a finished profile has been analyzed

The current-profile keyword argument, if supplied, causes the function to return the status of the given profile. The value of this argument defaults to the current analysis. If specified, its value must be a runtime analysis saved with save-current-profile.

The verbose keyword argument, if true (default is t), causes additional information about runtime analysis to be printed. If you specify it as nil, only the appropriate keyword (from the list above) is returned and nothing additional is printed.

A finalized analysis (profiler-status returns :analyzed) can be saved using the macro save-current-profile.

See runtime-analyzer.htm for general information on the runtime analyzer.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.