forked from arjunjm/SimpleScalar
-
Notifications
You must be signed in to change notification settings - Fork 0
/
resource.h
105 lines (93 loc) · 4.47 KB
/
resource.h
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
/* resource.h - resource manager interfaces */
/* SimpleScalar(TM) Tool Suite
* Copyright (C) 1994-2003 by Todd M. Austin, Ph.D. and SimpleScalar, LLC.
* All Rights Reserved.
*
* THIS IS A LEGAL DOCUMENT, BY USING SIMPLESCALAR,
* YOU ARE AGREEING TO THESE TERMS AND CONDITIONS.
*
* No portion of this work may be used by any commercial entity, or for any
* commercial purpose, without the prior, written permission of SimpleScalar,
* LLC ([email protected]). Nonprofit and noncommercial use is permitted
* as described below.
*
* 1. SimpleScalar is provided AS IS, with no warranty of any kind, express
* or implied. The user of the program accepts full responsibility for the
* application of the program and the use of any results.
*
* 2. Nonprofit and noncommercial use is encouraged. SimpleScalar may be
* downloaded, compiled, executed, copied, and modified solely for nonprofit,
* educational, noncommercial research, and noncommercial scholarship
* purposes provided that this notice in its entirety accompanies all copies.
* Copies of the modified software can be delivered to persons who use it
* solely for nonprofit, educational, noncommercial research, and
* noncommercial scholarship purposes provided that this notice in its
* entirety accompanies all copies.
*
* 3. ALL COMMERCIAL USE, AND ALL USE BY FOR PROFIT ENTITIES, IS EXPRESSLY
* PROHIBITED WITHOUT A LICENSE FROM SIMPLESCALAR, LLC ([email protected]).
*
* 4. No nonprofit user may place any restrictions on the use of this software,
* including as modified by the user, by any other authorized user.
*
* 5. Noncommercial and nonprofit users may distribute copies of SimpleScalar
* in compiled or executable form as set forth in Section 2, provided that
* either: (A) it is accompanied by the corresponding machine-readable source
* code, or (B) it is accompanied by a written offer, with no time limit, to
* give anyone a machine-readable copy of the corresponding source code in
* return for reimbursement of the cost of distribution. This written offer
* must permit verbatim duplication by anyone, or (C) it is distributed by
* someone who received only the executable form, and is accompanied by a
* copy of the written offer of source code.
*
* 6. SimpleScalar was developed by Todd M. Austin, Ph.D. The tool suite is
* currently maintained by SimpleScalar LLC ([email protected]). US Mail:
* 2395 Timbercrest Court, Ann Arbor, MI 48105.
*
* Copyright (C) 1994-2003 by Todd M. Austin, Ph.D. and SimpleScalar, LLC.
*/
#ifndef RESOURCE_H
#define RESOURCE_H
#include <stdio.h>
/* maximum number of resource classes supported */
#define MAX_RES_CLASSES 16
/* maximum number of resource instances for a class supported */
#define MAX_INSTS_PER_CLASS 8
/* resource descriptor */
struct res_desc {
char *name; /* name of functional unit */
int quantity; /* total instances of this unit */
int busy; /* non-zero if this unit is busy */
struct res_template {
int class; /* matching resource class: insts
with this resource class will be
able to execute on this unit */
int oplat; /* operation latency: cycles until
result is ready for use */
int issuelat; /* issue latency: number of cycles
before another operation can be
issued on this resource */
struct res_desc *master; /* master resource record */
} x[MAX_RES_CLASSES];
};
/* resource pool: one entry per resource instance */
struct res_pool {
char *name; /* pool name */
int num_resources; /* total number of res instances */
struct res_desc *resources; /* resource instances */
/* res class -> res template mapping table, lists are NULL terminated */
int nents[MAX_RES_CLASSES];
struct res_template *table[MAX_RES_CLASSES][MAX_INSTS_PER_CLASS];
};
/* create a resource pool */
struct res_pool *res_create_pool(char *name, struct res_desc *pool, int ndesc);
/* get a free resource from resource pool POOL that can execute a
operation of class CLASS, returns a pointer to the resource template,
returns NULL, if there are currently no free resources available,
follow the MASTER link to the master resource descriptor;
NOTE: caller is responsible for reseting the busy flag in the beginning
of the cycle when the resource can once again accept a new operation */
struct res_template *res_get(struct res_pool *pool, int class);
/* dump the resource pool POOL to stream STREAM */
void res_dump(struct res_pool *pool, FILE *stream);
#endif /* RESOURCE_H */