Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for dbiprof (redhat section 1)

DBIPROF(1)		       User Contributed Perl Documentation		       DBIPROF(1)

NAME
       dbiprof - command-line client for DBI::ProfileData

SYNOPSIS
       See a report of the ten queries with the longest total runtime in the profile dump file
       prof1.out:

	dbiprof prof1.out

       See the top 10 most frequently run queries in the profile file dbi.prof (the default):

	 dbiprof --sort count

       See the same report with 15 entries:

	 dbiprof --sort count --number 15

DESCRIPTION
       This tool is a command-line client for the DBI::ProfileData.  It allows you to analyze the
       profile data file produced by DBI::ProfileDumper and produce various useful reports.

OPTIONS
       This program accepts the following options:

       --number N
	   Produce this many items in the report.  Defaults to 10.  If set to "all" then all
	   results are shown.

       --sort field
	   Sort results by the given field.  The available sort fields are:

	   total
	       Sorts by total time run time across all runs.  This is the default sort.

	   longest
	       Sorts by the longest single run.

	   count
	       Sorts by total number of runs.

	   first
	       Sorts by the time taken in the first run.

	   shortest
	       Sorts by the shortest single run.

       --reverse
	   Reverses the selected sort.	For example, to see a report of the shortest overall
	   time:

	     dbiprof --sort total --reverse

       --match keyN=value
	   Consider only items where the specified key matches the given value.  Keys are num-
	   bered from 1.  For example, let's say you used a DBI::Profile Path of:

	     [ DBIprofile_Statement, DBIprofile_Methodname ]

	   And called dbiprof as in:

	     dbiprof --match key2=execute

	   Your report would only show execute queries, leaving out prepares, fetches, etc.

	   If the value given starts and ends with slashes ("/") then it will be treated as a
	   regular expression.	For example, to only include SELECT queries where key1 is the
	   statement:

	     dbiprof --match key1=/^SELECT/

	   By default the match expression is matched case-insensitively, but this can be changed
	   with the --case-sensitive option.

       --exclude keyN=value
	   Remove items for where the specified key matches the given value.  For example, to
	   exclude all prepare entries where key2 is the method name:

	     dbiprof --exclude key2=prepare

	   Like "--match", If the value given starts and ends with slashes ("/") then it will be
	   treated as a regular expression.  For example, to exclude UPDATE queries where key1 is
	   the statement:

	     dbiprof --match key1=/^UPDATE/

	   By default the exclude expression is matched case-insensitively, but this can be
	   changed with the --case-sensitive option.

       --case-sensitive
	   Using this option causes --match and --exclude to work case-sensitively.  Defaults to
	   off.

       --version
	   Print the dbiprof version number and exit.

AUTHOR
       Sam Tregar <sam@tregar.com>

COPYRIGHT AND LICENSE
       Copyright (C) 2002 Sam Tregar

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl 5 itself.

SEE ALSO
       DBI::ProfileDumper, DBI::Profile, DBI.

perl v5.8.0				    2003-02-18				       DBIPROF(1)


All times are GMT -4. The time now is 12:37 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password