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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
/*
Copyright (C) 2008-2015 Michele Martone
This file is part of librsb.
librsb is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published
by the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
librsb is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.
You should have received a copy of the GNU Lesser General Public
License along with librsb; see the file COPYING.
If not, see <http://www.gnu.org/licenses/>.
*/
/* @cond INNERDOC */
/**
* @file
* @author Michele Martone
* @brief Memory bandwidth related (e.g.: read, write, and read-write) microbenchmarks.
*/
#ifndef RSB_MBW_H_INCLUDED
#define RSB_MBW_H_INCLUDED
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
#include "rsb.h" /* public API specification */
#if 0
#define RSB_MB_READ 0x00
#define RSB_MB_WRITE 0x01
#define RSB_MB_RW 0x02
#define RSB_MB_BZERO 0x03
#define RSB_MB_ZERO 0x04
#define RSB_MB_MEMSET 0x05
#define RSB_MB_LINEAR_CHASE 0x06
#define RSB_MB_MORTON_CHASE 0x07
#define RSB_MB_N 0x09
#define RSB_MB_FLUSH 0xAAAA
#else
enum{
RSB_MB_READ =0x00,
RSB_MB_WRITE =0x01,
RSB_MB_RW =0x02,
RSB_MB_BZERO =0x03,
RSB_MB_ZERO =0x04,
RSB_MB_MEMSET =0x05,
RSB_MB_MEMCPY =0x06,
RSB_MB_MEMCPY2 =0x07,
RSB_MB_LINEAR_CHASE =0x08,
RSB_MB_MORTON_CHASE =0x09,
RSB_MB_N =0x0A,
RSB_MB_FLUSH =0xAAAA
};
#endif
/**<
* The available memory tests.
*/
#define RSB_MIN_CACHE_FLUSH_SCAN_TIMES 2
/*!
* \ingroup gr_internals
* \brief a memory bandwidth single measurement
*/
struct rsb_mbw_sm_t
{
rsb_time_t t; /**< time, in seconds */
rsb_flags_t btype; /**< measurement type */
};
/*!
* \ingroup gr_internals
*/
typedef size_t rsb__times_t;
/*!
* \ingroup gr_internals
* \brief a memory bandwidth benchmark record for a level
*/
struct rsb_mbw_m_t
{
size_t so; /**< sizeof probed word type */
rsb__times_t times,sz; /**< number of iterations of scanning a sz bytes wide area */
struct rsb_mbw_sm_t mb[RSB_MB_N]; /**< measurements */
long cln; /**< number of cache levels */
long cl; /**< cache level for this measurement */
long hlcs; /**< higher level cache size */
};
/*!
* \ingroup gr_internals
* \brief a complete memory bandwidth benchmark record
*/
struct rsb_mbw_cm_t
{
struct rsb_mbw_m_t * mb; /**< a memory bandwidth benchmark record for each level+extra_level */
long cln; /**< number of cache levels */
long extra_level; /**< number of additional measurements */
};
#define RSB_FLUSH_TIMES 10 /* minimum number of scannes for a "cache flush" intended array scan */
#define RSB_MEMSCAN_MIN_TIMES 10/* minimum number of scans for an array during a memory-bandwidth benchmarking */
#define RSB_MEMSCAN_MAX_TIMES RSB_MAX_SIGNED(int) /* minimum number of scans for an array during a memory-bandwidth benchmarking */
#define RSB_MEMSCAN_TIME 1.0 /* max allowable time scanning of an array during a memory-bandwidth benchmark */
rsb_err_t rsb__mem_hier_timings(struct rsb_mbw_cm_t * cm);
rsb_err_t rsb__print_mem_hier_timings(struct rsb_mbw_cm_t * cm);
rsb_err_t rsb__memory_benchmark(void);
rsb_err_t rsb__flush_cache(size_t fs);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* RSB_MBW_H_INCLUDED */
/* @endcond */
|
