blob: ea38ce71866793e88fa823de57689f46bca60e1f (
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
brief: |
Identifies a message queue by the object name.
copyrights:
- Copyright (C) 2020 embedded brains GmbH & Co. KG
- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
definition:
default:
attributes: null
body: null
params:
- ${../../type/if/name:/name} ${.:/params[0]/name}
- ${/c/if/uint32_t:/name} ${.:/params[1]/name}
- ${../../type/if/id:/name} *${.:/params[2]/name}
return: ${../../status/if/code:/name}
variants: []
description: |
This directive obtains a message queue identifier associated with the
message queue name specified in ${.:/params[0]/name}.
The node to search is specified in ${.:/params[1]/name}. It shall be
* a valid node number,
* the constant ${../../object/if/search-all-nodes:/name} to search in all nodes,
* the constant ${../../object/if/search-local-node:/name} to search in the local
node only, or
* the constant ${../../object/if/search-other-nodes:/name} to search in all nodes
except the local node.
enabled-by: true
index-entries: []
interface-type: function
links:
- role: interface-placement
uid: header
- role: interface-ingroup
uid: group
- role: constraint
uid: /constraint/directive-ctx-any
- role: constraint
uid: /constraint/directive-no-preempt
name: rtems_message_queue_ident
notes: |
If the message queue name is not unique, then the message queue identifier
will match the first message queue with that name in the search order.
However, this message queue identifier is not guaranteed to correspond to the
desired message queue.
The objects are searched from lowest to the highest index. If
${.:/params[1]/name} is ${../../object/if/search-all-nodes:/name}, all nodes
are searched with the local node being searched first. All other nodes are
searched from lowest to the highest node number.
If node is a valid node number which does not represent the local node, then
only the message queues exported by the designated node are searched.
This directive does not generate activity on remote nodes. It accesses only
the local copy of the global object table.
The message queue identifier is used with other message related directives to
access the message queue.
params:
- description: |
is the object name to look up.
dir: null
name: name
- description: |
is the node or node set to search for a matching object.
dir: null
name: node
- description: |
is the pointer to an ${../../type/if/id:/name} object. When the directive
call is successful, the object identifier of an object with the specified
name will be stored in this object.
dir: out
name: id
return:
return: null
return-values:
- description: |
The requested operation was successful.
value: ${../../status/if/successful:/name}
- description: |
The ${.:/params[2]/name} parameter was ${/c/if/null:/name}.
value: ${../../status/if/invalid-address:/name}
- description: |
The ${.:/params[0]/name} parameter was 0.
value: ${../../status/if/invalid-name:/name}
- description: |
There was no object with the specified name on the specified nodes.
value: ${../../status/if/invalid-name:/name}
- description: |
In multiprocessing configurations, the specified node was invalid.
value: ${../../status/if/invalid-node:/name}
type: interface
|