BTT: Added user guide
[blktrace.git] / btt / bt_timeline.c
1 /*
2  * blktrace output analysis: generate a timeline & gather statistics
3  *
4  * Copyright (C) 2006 Alan D. Brunelle <Alan.Brunelle@hp.com>
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  */
21 #include <stdio.h>
22 #include <string.h>
23 #include <unistd.h>
24 #include <sys/time.h>
25 #include <time.h>
26 #include "globals.h"
27
28 char bt_timeline_version[] = "0.99.1";
29
30 char *devices, *exes, *input_name, *output_name, *seek_name;
31 char *d2c_name, *q2c_name, *per_io_name;
32 FILE *ranges_ofp, *avgs_ofp, *per_io_ofp;
33 int verbose, done, time_bounded, output_all_data;
34 double t_astart, t_aend;
35 unsigned long n_traces;
36 struct avgs_info all_avgs;
37 unsigned int n_devs;
38 time_t genesis, last_vtrace;
39 LIST_HEAD(all_devs);
40 LIST_HEAD(all_procs);
41 LIST_HEAD(free_ios);
42 __u64 q_histo[N_HIST_BKTS], d_histo[N_HIST_BKTS];
43
44 double range_delta = 0.1;
45 __u64 last_q = (__u64)-1;
46 __u64 next_retry_check = 0;
47
48 struct region_info all_regions = {
49         .qranges = LIST_HEAD_INIT(all_regions.qranges),
50         .cranges = LIST_HEAD_INIT(all_regions.cranges),
51         .qr_cur = NULL,
52         .cr_cur = NULL
53 };
54
55 #if defined(DEBUG)
56 int rb_tree_size;
57 #endif
58
59 int process(void);
60
61 int main(int argc, char *argv[])
62 {
63         handle_args(argc, argv);
64
65         init_dev_heads();
66         iostat_init();
67         if (process() || output_avgs(avgs_ofp) || output_ranges(ranges_ofp))
68                 return 1;
69
70         return 0;
71 }
72
73 static inline double tv2dbl(struct timeval *tv)
74 {
75         return (double)tv->tv_sec + (((double)tv->tv_usec) / (1000.0 * 1000.0));
76 }
77
78 int process(void)
79 {
80         int ret = 0;
81         struct io *iop = io_alloc();
82         struct timeval tvs, tvi, tve;
83
84         genesis = last_vtrace = time(NULL);
85         gettimeofday(&tvs, NULL);
86         while (!done && next_trace(&iop->t, &iop->pdu)) {
87                 add_trace(iop);
88                 iop = io_alloc();
89         }
90
91         io_release(iop);
92         do_retries(0);
93
94         gettimeofday(&tvi, NULL);
95
96         if (iostat_ofp) {
97                 fprintf(iostat_ofp, "\n");
98                 iostat_dump_stats(iostat_last_stamp, 1);
99         }
100
101         seek_clean();
102         latency_clean();
103         gettimeofday(&tve, NULL);
104
105         if (verbose) {
106                 double tps, dt_input = tv2dbl(&tvi) - tv2dbl(&tvs);
107                 
108                 tps = (double)n_traces / dt_input;
109                 printf("%10lu traces @ %.1lf Ktps\t%.6lf+%.6lf=%.6lf\n", 
110                         n_traces, tps/1000.0,
111                         dt_input, tv2dbl(&tve) - tv2dbl(&tvi),
112                         tv2dbl(&tve) - tv2dbl(&tvs));
113 #if defined(DEBUG)
114                 printf("\ttree = |%d|\n", rb_tree_size);
115                 if (rb_tree_size > 0)
116                         dump_rb_trees();
117 #endif
118         }
119
120         return ret;
121 }