RTEMS
taskident.c
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-2-Clause */
2 
11 /*
12  * Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
13  * Copyright (C) 1989 On-Line Applications Research Corporation (OAR).
14  *
15  * Redistribution and use in source and binary forms, with or without
16  * modification, are permitted provided that the following conditions
17  * are met:
18  * 1. Redistributions of source code must retain the above copyright
19  * notice, this list of conditions and the following disclaimer.
20  * 2. Redistributions in binary form must reproduce the above copyright
21  * notice, this list of conditions and the following disclaimer in the
22  * documentation and/or other materials provided with the distribution.
23  *
24  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
28  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34  * POSSIBILITY OF SUCH DAMAGE.
35  */
36 
37 #ifdef HAVE_CONFIG_H
38 #include "config.h"
39 #endif
40 
41 #include <rtems/rtems/tasksimpl.h>
42 #include <rtems/rtems/objectimpl.h>
43 #include <rtems/score/percpu.h>
44 
46  rtems_name name,
47  uint32_t node,
48  rtems_id *id
49 )
50 {
51  if ( id == NULL ) {
52  return RTEMS_INVALID_ADDRESS;
53  }
54 
55  if ( name == OBJECTS_ID_OF_SELF ) {
57  return RTEMS_SUCCESSFUL;
58  }
59 
60  return _RTEMS_Name_to_id(
61  name,
62  node,
63  id,
65  );
66 }
uint32_t rtems_name
This type is used to represent a Classic API object name.
Definition: types.h:227
rtems_status_code rtems_task_ident(rtems_name name, uint32_t node, rtems_id *id)
Identifies a task object by the specified object name.
Definition: taskident.c:45
#define OBJECTS_ID_OF_SELF
Definition: object.h:194
rtems_status_code _RTEMS_Name_to_id(uint32_t name, uint32_t node, Objects_Id *id, const Objects_Information *information)
Calls _Objects_Name_to_id_u32() and converts the status.
Definition: rtemsnametoid.c:43
Objects_Information Objects
The object information.
Definition: thread.h:1004
Thread_Information _RTEMS_tasks_Information
static __inline__ struct _Thread_Control * _Thread_Get_executing(void)
Returns the thread control block of the executing thread.
Definition: percpu.h:878
This status code indicates successful completion.
Definition: status.h:86
rtems_status_code
This enumeration provides status codes for directives of the Classic API.
Definition: status.h:82
Objects_Control Object
Definition: thread.h:727
This status code indicates that a specified address was invalid.
Definition: status.h:133
Objects_Id rtems_id
Values of this type identify an RTEMS object.
Definition: types.h:99
Classic Tasks Manager Implementation.
Implementation Interfaces for Classic Objects.
Objects_Id id
Definition: objectdata.h:43