blob: 198d0735ac71ab9f52d16676f1aabfeb282e333a (
plain) (
blame)
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
|
SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
brief: |
Gets the region free information.
copyrights:
- Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de)
- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
definition:
default:
attributes: null
body: null
params:
- ${../../type/if/id:/name} ${.:/params[0]/name}
- ${/score/heap/if/information-block:/name} *${.:/params[1]/name}
return: ${../../status/if/code:/name}
variants: []
description: |
This directive is used to obtain information about the free memory in the
region specified by ${.:/params[0/name}. This is a snapshot at the time of
the call. The information will be returned in the structure pointed to by
${.:/params[1]/name}.
enabled-by: true
index-entries:
- obtain region information on free blocks
interface-type: function
links:
- role: interface-placement
uid: header
- role: interface-ingroup
uid: group
- role: constraint
uid: /constraint/directive-not-pre-qualified
- role: constraint
uid: /constraint/directive-ctx-devinit
- role: constraint
uid: /constraint/directive-ctx-task
- role: constraint
uid: /constraint/object-allocator
name: rtems_region_get_free_information
notes: |
This directive uses the same structure to return information as the
${get-information:/name} directive but does not fill in the used information.
This is primarily intended as a mechanism to obtain a diagnostic information.
This method forms am O(n) scan of the free in the region to calculate the
information provided. Given that the execution time is driven by the number
of used and free blocks, it can take a non-deterministic time to execute.
Typically, there are many used blocks and a much smaller number of used
blocks making a call to this directive less expensive than a call to
${get-information:/name}.
params:
- description: |
is the region identifier.
dir: null
name: id
- description: |
is the pointer to a ${/score/heap/if/information-block:/name} object. When
the directive call is successful, the free information of the region will
be stored in this object.
dir: out
name: the_info
return:
return: null
return-values:
- description: |
The requested operation was successful.
value: ${../../status/if/successful:/name}
- description: |
The ${.:/params[1]/name} parameter was ${/c/if/null:/name}.
value: ${../../status/if/invalid-address:/name}
- description: |
There was no region associated with the identifier specified by
${.:/params[0]/name}.
value: ${../../status/if/invalid-id:/name}
type: interface
|
