.\" Copyright (c) 2010, Stefano Rivera
.\" Released under terms of the MIT/X/Expat Licence. See COPYING for details.
.TH IBID-OBJGRAPH "1" "March 2010" "Ibid 0.1" "Ibid - Multi-protocol Bot"
.SH NAME
ibid-objgraph \- Memory usage graph generation utility for Ibid
.SH SYNOPSIS
.B ibid-objgraph
.RB [ options ...]
.IR "logfile type" ...
.br
.B ibid-objgraph
.BI "-e " TIME
.RB [ options ...]
.I logfile
.br
.B ibid-objgraph -h
.SH DESCRIPTION
This utility is for graphing object-type usage from an Ibid bot
configured to log such usage.
.P
Matplotlib is required for graphing.
.SH OPTIONS
.TP
\fB\-e\fR \fITIME\fR, \fB\-\-examine\fR=\fITIME\fR
Examine the object usage at time \fITIME\fR, and print a sorted list of type
statistics at that time.
This function can be useful in determining which types to graph, when chasing
down a detected leak.
.TP
\fB\-o\fR \fIFILE\fR, \fB\-\-output\fR=\fIFILE\fR
Output to \fIFILE\fR instead of displaying interactive graph GUI.
\fIFILE\fR can be any format supported by Matplotlib, detected by the file
extension.
.TP
\fB\-d\fR \fIDPI\fR, \fB\-\-dpi\fR=\fIDPI\fR
When outputting in raster formats, use \fIDPI\fR output DPI.
.TP
\fB\-h\fR, \fB\-\-help\fR
Show a help message and exit.
.SH FILES
.TP
.I logfile
A log file generated by loading the \fBmemory\fR plugin into Ibid, which will
periodically log object usage.
It can be gzip compressed, if the filename ends in \fB.gz\fR.
.SH SEE ALSO
.BR ibid (1),
.BR ibid-memgraph (1),
.UR http://ibid.omnia.za.net/
.BR http://ibid.omnia.za.net/