%%
%% %CopyrightBegin%
%%
%% Copyright Ericsson AB 2002-2009. All Rights Reserved.
%%
%% The contents of this file are subject to the Erlang Public License,
%% Version 1.1, (the "License"); you may not use this file except in
%% compliance with the License. You should have received a copy of the
%% Erlang Public License along with this software. If not, it can be
%% retrieved online at http://www.erlang.org/.
%%
%% Software distributed under the License is distributed on an "AS IS"
%% basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
%% the License for the specific language governing rights and limitations
%% under the License.
%%
%% %CopyrightEnd%
%%
-module(cprof).
%% Call count profiling tool.
-export ([start/0, start/1, start/2, start/3,
stop/0, stop/1, stop/2, stop/3,
restart/0, restart/1, restart/2, restart/3,
pause/0, pause/1, pause/2, pause/3,
analyse/0, analyse/1, analyse/2,
analyze/0, analyze/1, analyze/2]).
start() ->
tr({'_','_','_'}, true) + tr(on_load, true).
start({_,_,_} = MFA) ->
tr(MFA, true);
start({FuncSpec}) ->
tr(FuncSpec, true);
start(M) ->
tr({M,'_','_'}, true).
start(M,F) ->
tr({M,F,'_'}, true).
start(M,F,A) ->
tr({M,F,A}, true).
stop() ->
tr({'_','_','_'}, false) + tr(on_load, false).
stop({_,_,_} = MFA) ->
tr(MFA, false);
stop({FuncSpec}) ->
tr(FuncSpec, false);
stop(M) ->
tr({M,'_','_'}, false).
stop(M,F) ->
tr({M,F,'_'}, false).
stop(M,F,A) ->
tr({M,F,A}, false).
restart() ->
tr({'_','_','_'}, restart).
restart({_,_,_} = MFA) ->
tr(MFA, restart);
restart({FuncSpec}) ->
tr(FuncSpec, restart);
restart(M) ->
tr({M,'_','_'}, restart).
restart(M,F) ->
tr({M,F,'_'}, restart).
restart(M,F,A) ->
tr({M,F,A}, restart).
pause() ->
tr({'_','_','_'}, pause) + tr(on_load, false).
pause({_,_,_} = MFA) ->
tr(MFA, pause);
pause({FuncSpec}) ->
tr(FuncSpec, pause);
pause(M) ->
tr({M,'_','_'}, pause).
pause(M,F) ->
tr({M,F,'_'}, pause).
pause(M,F,A) ->
tr({M,F,A}, pause).
analyse() ->
analyse(1).
analyse(Limit) when is_integer(Limit) ->
L0 = [analyse(element(1, Mod), Limit) || Mod <- code:all_loaded()],
L1 = [{C,M,Lm} || {M,C,Lm} <- L0, C > 0, M =/= ?MODULE],
N = lists:foldl(fun ({C,_,_}, Q) -> Q+C end, 0, L1),
L = [{M,C,Lm} || {C,M,Lm} <- lists:reverse(lists:sort(L1))],
{N,L};
analyse(M) when is_atom(M) ->
analyse(M, 1).
analyse(M, Limit) when is_atom(M), is_integer(Limit) ->
L0 = [begin
MFA = {M,F,A},
{_,C} = erlang:trace_info(MFA, call_count),
[C|MFA]
end || {F,A} <- M:module_info(functions)],
L1 = [X || [C|_]=X <- L0, is_integer(C)],
N = lists:foldl(fun ([C|_], Q) -> Q+C end, 0, L1),
L2 = [X || [C|_]=X <- L1, C >= Limit],
L = [{MFA,C} || [C|MFA] <- lists:reverse(lists:sort(L2))],
{M,N,L}.
analyze() ->
analyse().
analyze(X) ->
analyse(X).
analyze(X, Y) ->
analyse(X, Y).
tr(FuncSpec, State) ->
erlang:trace_pattern(FuncSpec, State, [call_count]).
