]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - cddl/contrib/dtracetoolkit/Man/man1m/pl_malloc.d.1m
Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.
[FreeBSD/stable/10.git] / cddl / contrib / dtracetoolkit / Man / man1m / pl_malloc.d.1m
1 .TH pl_malloc.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
2 .SH NAME
3 pl_malloc.d - Perl libc malloc analysis.
4 .SH SYNOPSIS
5 .B pl_malloc.d
6 { \-p PID | \-c cmd }   
7 .SH DESCRIPTION
8 This is an expiremental script to identify who is calling malloc() for
9 memory allocation, and to print distribution plots of the requested bytes.
10 If a malloc() occured while in a Perl subroutine, then that subroutine is
11 identified as responsible; else the caller of malloc() is identified as
12 responsible - which will be a function from the Perl engine.
13
14 Filename and subroutine names are printed if available.
15 .SH OS
16 Any
17 .SH STABILITY
18 Evolving - uses the DTrace Perl provider, which may change 
19 as additional features are introduced. Check Perl/Readme
20 to see what version these scripts are based on.
21 .SH EXAMPLES
22 .TP
23 Default output,
24
25 .B pl_malloc.d
26 .PP
27 .PP
28 .SH DOCUMENTATION
29 See the DTraceToolkit for further documentation under the 
30 Examples, Notes and Docs directories. The example files may be
31 especially useful as they aim to demonstrate how to interpret
32 the output.
33 .SH EXIT
34 pl_malloc.d will run until Ctrl-C is hit.
35 .SH AUTHOR
36 Brendan Gregg
37 [CA, USA]
38 .SH SEE ALSO
39 dtrace(1M)