1 | SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause |
---|
2 | brief: | |
---|
3 | Sets the processor affinity of the task. |
---|
4 | copyrights: |
---|
5 | - Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de) |
---|
6 | - Copyright (C) 1988, 2017 On-Line Applications Research Corporation (OAR) |
---|
7 | definition: |
---|
8 | default: |
---|
9 | attributes: null |
---|
10 | body: null |
---|
11 | params: |
---|
12 | - ${../../type/if/id:/name} ${.:/params[0]/name} |
---|
13 | - ${/c/if/size_t:/name} ${.:/params[1]/name} |
---|
14 | - const ${/c/if/cpu_set_t:/name} *${.:/params[2]/name} |
---|
15 | return: ${../../status/if/code:/name} |
---|
16 | variants: [] |
---|
17 | description: | |
---|
18 | This directive sets the processor affinity of the task specified by |
---|
19 | ${.:/params[0]/name}. |
---|
20 | enabled-by: true |
---|
21 | index-entries: [] |
---|
22 | interface-type: function |
---|
23 | links: |
---|
24 | - role: interface-placement |
---|
25 | uid: header |
---|
26 | - role: interface-ingroup |
---|
27 | uid: group |
---|
28 | - role: constraint |
---|
29 | uid: /constraint/directive-ctx-isr |
---|
30 | - role: constraint |
---|
31 | uid: /constraint/directive-ctx-devinit |
---|
32 | - role: constraint |
---|
33 | uid: /constraint/directive-ctx-task |
---|
34 | - role: constraint |
---|
35 | uid: /constraint/affinity-may-preempt |
---|
36 | name: rtems_task_set_affinity |
---|
37 | notes: null |
---|
38 | params: |
---|
39 | - description: | |
---|
40 | is the task identifier. The constant ${self-define:/name} may be used to |
---|
41 | specify the calling task. |
---|
42 | dir: null |
---|
43 | name: id |
---|
44 | - description: | |
---|
45 | is the size of the processor set referenced by ${.:/params[2]/name} in |
---|
46 | bytes. |
---|
47 | dir: null |
---|
48 | name: cpusetsize |
---|
49 | - description: | |
---|
50 | is the pointer to a ${/c/if/cpu_set_t:/name} object. The processor set |
---|
51 | defines the new processor affinity set of the task. A set bit in the |
---|
52 | processor set means that the corresponding processor shall be in the |
---|
53 | processor affinity set of the task, otherwise the bit shall be cleared. |
---|
54 | dir: null |
---|
55 | name: cpuset |
---|
56 | return: |
---|
57 | return: null |
---|
58 | return-values: |
---|
59 | - description: | |
---|
60 | The requested operation was successful. |
---|
61 | value: ${../../status/if/successful:/name} |
---|
62 | - description: | |
---|
63 | The ${.:/params[2]/name} parameter was ${/c/if/null:/name}. |
---|
64 | value: ${../../status/if/invalid-address:/name} |
---|
65 | - description: | |
---|
66 | There was no task associated with the identifier specified by |
---|
67 | ${.:/params[0]/name}. |
---|
68 | value: ${../../status/if/invalid-id:/name} |
---|
69 | - description: | |
---|
70 | The referenced processor set was not a valid new processor affinity set |
---|
71 | for the task. |
---|
72 | value: ${../../status/if/invalid-number:/name} |
---|
73 | - description: | |
---|
74 | The task resided on a remote node. |
---|
75 | value: ${../../status/if/illegal-on-remote-object:/name} |
---|
76 | type: interface |
---|