forked from dmonakhov/lmbench
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreporting.3
71 lines (71 loc) · 1.99 KB
/
reporting.3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.\"
.\" @(#)lmbench.man 2.0 98/04/24
.\"
.\" lmbench - benchmarking toolbox
.\"
.\" Copyright (C) 1998 Carl Staelin and Larry McVoy
.\" E-mail: [email protected]
.\"
.TH "lmbench reporting" 3 "$Date:" "(c)1998-2000 Larry McVoy and Carl Staelin" "LMBENCH"
.SH "NAME"
milli, micro, nano, mb, kb \- the lmbench reporting subsystem
.SH "SYNOPSIS"
.B "#include ``lmbench.h''"
.LP
.B "void milli(char *s, uint64 n)"
.LP
.B "void micro(char *s, uint64 n)"
.LP
.B "void nano(char *s, uint64 n)"
.LP
.B "void mb(uint64 bytes)"
.LP
.B "void kb(uint64 bytes)"
.SH "DESCRIPTION"
Creating benchmarks using the
.I lmbench
timing harness is easy.
Since it is so easy to measure performance using
.IR lmbench ,
it is possible to quickly answer questions that arise during system
design, development, or tuning. For example, image processing
.LP
There are two attributes that are critical for performance, latency
and bandwidth, and
.IR lmbench 's
timing harness makes it easy to measure and report results for both.
The measurement interface,
.B benchmp
is the same, but the reporting functions are different.
Latency is usually important for frequently executed operations, and
bandwidth is usually important when moving large chunks of data.
.TP
.B "void milli(char *s, uint64 n)"
print out the time per operation in milli-seconds.
.I n
is the number of operations during the timing interval, which is passed
as a parameter because each
.I loop_body
can contain several operations.
.TP
.B "void micro(char *s, uint64 n)"
print the time per opertaion in micro-seconds.
.TP
.B "void nano(char *s, uint64 n)"
print the time per operation in nano-seconds.
.TP
.B "void mb(uint64 bytes)"
print the bandwidth in megabytes per second.
.TP
.B "void kb(uint64 bytes)"
print the bandwidth in kilobytes per second.
.SH "FUTURES"
Development of
.I lmbench
is continuing.
.SH "SEE ALSO"
lmbench(8), lmbench(3), timing(3), results(3)
.SH "AUTHOR"
Carl Staelin and Larry McVoy
.PP
Comments, suggestions, and bug reports are always welcome.