1 | .. SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
2 | |
---|
3 | .. Copyright (C) 2015 embedded brains GmbH |
---|
4 | |
---|
5 | .. index:: Status Codes |
---|
6 | |
---|
7 | Directive Status Codes |
---|
8 | ********************** |
---|
9 | |
---|
10 | Introduction |
---|
11 | ============ |
---|
12 | |
---|
13 | The directive status code directives are: |
---|
14 | |
---|
15 | - rtems_status_text_ - Return the name for the status code |
---|
16 | |
---|
17 | Directives |
---|
18 | ========== |
---|
19 | |
---|
20 | The directives are: |
---|
21 | |
---|
22 | .. index:: rtems_status_code |
---|
23 | |
---|
24 | .. list-table:: |
---|
25 | :class: rtems-table |
---|
26 | |
---|
27 | * - ``RTEMS_SUCCESSFUL`` |
---|
28 | - successful completion |
---|
29 | * - ``RTEMS_TASK_EXITTED`` |
---|
30 | - returned from a task |
---|
31 | * - ``RTEMS_MP_NOT_CONFIGURED`` |
---|
32 | - multiprocessing not configured |
---|
33 | * - ``RTEMS_INVALID_NAME`` |
---|
34 | - invalid object name |
---|
35 | * - ``RTEMS_INVALID_ID`` |
---|
36 | - invalid object id |
---|
37 | * - ``RTEMS_TOO_MANY`` |
---|
38 | - too many |
---|
39 | * - ``RTEMS_TIMEOUT`` |
---|
40 | - timed out waiting |
---|
41 | * - ``RTEMS_OBJECT_WAS_DELETED`` |
---|
42 | - object was deleted while waiting |
---|
43 | * - ``RTEMS_INVALID_SIZE`` |
---|
44 | - invalid specified size |
---|
45 | * - ``RTEMS_INVALID_ADDRESS`` |
---|
46 | - invalid address specified |
---|
47 | * - ``RTEMS_INVALID_NUMBER`` |
---|
48 | - number was invalid |
---|
49 | * - ``RTEMS_NOT_DEFINED`` |
---|
50 | - item not initialized |
---|
51 | * - ``RTEMS_RESOURCE_IN_USE`` |
---|
52 | - resources outstanding |
---|
53 | * - ``RTEMS_UNSATISFIED`` |
---|
54 | - request not satisfied |
---|
55 | * - ``RTEMS_INCORRECT_STATE`` |
---|
56 | - task is in wrong state |
---|
57 | * - ``RTEMS_ALREADY_SUSPENDED`` |
---|
58 | - task already in state |
---|
59 | * - ``RTEMS_ILLEGAL_ON_SELF`` |
---|
60 | - illegal for calling task |
---|
61 | * - ``RTEMS_ILLEGAL_ON_REMOTE_OBJECT`` |
---|
62 | - illegal for remote object |
---|
63 | * - ``RTEMS_CALLED_FROM_ISR`` |
---|
64 | - invalid environment |
---|
65 | * - ``RTEMS_INVALID_PRIORITY`` |
---|
66 | - invalid task priority |
---|
67 | * - ``RTEMS_INVALID_CLOCK`` |
---|
68 | - invalid time buffer |
---|
69 | * - ``RTEMS_INVALID_NODE`` |
---|
70 | - invalid node id |
---|
71 | * - ``RTEMS_NOT_CONFIGURED`` |
---|
72 | - directive not configured |
---|
73 | * - ``RTEMS_NOT_OWNER_OF_RESOURCE`` |
---|
74 | - not owner of resource |
---|
75 | * - ``RTEMS_NOT_IMPLEMENTED`` |
---|
76 | - directive not implemented or feature not available in configuration |
---|
77 | * - ``RTEMS_INTERNAL_ERROR`` |
---|
78 | - RTEMS inconsistency detected |
---|
79 | * - ``RTEMS_NO_MEMORY`` |
---|
80 | - could not get enough memory |
---|
81 | |
---|
82 | .. raw:: latex |
---|
83 | |
---|
84 | \clearpage |
---|
85 | |
---|
86 | .. index:: rtems_status_text |
---|
87 | |
---|
88 | .. _rtems_status_text: |
---|
89 | |
---|
90 | STATUS_TEXT - Returns the enumeration name for a status code |
---|
91 | ------------------------------------------------------------ |
---|
92 | |
---|
93 | CALLING SEQUENCE: |
---|
94 | .. code-block:: c |
---|
95 | |
---|
96 | const char *rtems_status_text( |
---|
97 | rtems_status_code code |
---|
98 | ); |
---|
99 | |
---|
100 | DIRECTIVE STATUS CODES |
---|
101 | The status code enumeration name or "?" in case the status code is invalid. |
---|
102 | |
---|
103 | DESCRIPTION: |
---|
104 | Returns the enumeration name for the specified status code. |
---|