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
|
/* SPDX-License-Identifier: BSD-3-Clause
* Copyright(c) 2016 RehiveTech. All rights reserved.
*/
#ifndef _RESOURCE_H_
#define _RESOURCE_H_
/**
* @file
*
* Test Resource API
*
* Each test can require and use some external resources. Usually, an external
* resource is a file or a filesystem sub-hierarchy. A resource is included
* inside the test executable.
*/
#include <sys/queue.h>
#include <stdio.h>
#include <stddef.h>
#include <rte_eal.h>
#include <rte_common.h>
TAILQ_HEAD(resource_list, resource);
extern struct resource_list resource_list;
/**
* Representation of a resource. It points to the resource's binary data.
* The semantics of the binary data are defined by the target test.
*/
struct resource {
const char *name; /**< Unique name of the resource */
const char *begin; /**< Start of resource data */
const char *end; /**< End of resource data */
TAILQ_ENTRY(resource) next;
};
/**
* @return size of the given resource
*/
size_t resource_size(const struct resource *r);
/**
* Find a resource by name in the global list of resources.
*/
const struct resource *resource_find(const char *name);
/**
* Write the raw data of the resource to the given file.
* @return 0 on success
*/
int resource_fwrite(const struct resource *r, FILE *f);
/**
* Write the raw data of the resource to the given file given by name.
* The name is relative to the current working directory.
* @return 0 on success
*/
int resource_fwrite_file(const struct resource *r, const char *fname);
/**
* Treat the given resource as a tar archive. Extract
* the archive to the current directory.
*/
int resource_untar(const struct resource *res);
/**
* Treat the given resource as a tar archive. Remove
* all files (related to the current directory) listed
* in the tar archive.
*/
int resource_rm_by_tar(const struct resource *res);
/**
* Register a resource in the global list of resources.
* Not intended for direct use, please check the REGISTER_RESOURCE
* macro.
*/
void resource_register(struct resource *r);
/**
* Definition of a resource linked externally (by means of the used toolchain).
* Only the base name of the resource is expected. The name refers to the
* linked pointers beg_<name> and end_<name> provided externally.
*/
#define REGISTER_LINKED_RESOURCE(n) \
extern const char beg_ ##n; \
extern const char end_ ##n; \
REGISTER_RESOURCE(n, &beg_ ##n, &end_ ##n) \
/**
* Definition of a resource described by its name, and pointers begin, end.
*/
#define REGISTER_RESOURCE(n, b, e) \
static struct resource linkres_ ##n = { \
.name = RTE_STR(n), \
.begin = b, \
.end = e, \
}; \
RTE_INIT(resinitfn_ ##n) \
{ \
resource_register(&linkres_ ##n); \
}
#endif
|
