RTEMS CPU Kit with SuperCore  4.10.99.0
Data Structures | Files | Functions
Semaphores
RTEMS Classic API

This encapsulates functionality related to the Classic API Semaphore Manager. More...

Collaboration diagram for Semaphores:

Data Structures

struct  Semaphore_Control
 The following defines the control block used to manage each semaphore. More...

Files

file  sem.h
 

Classic Semaphores API.


file  semimpl.h
 

Classic Semaphores Implementation.


Functions

rtems_status_code rtems_semaphore_create (rtems_name name, uint32_t count, rtems_attribute attribute_set, rtems_task_priority priority_ceiling, rtems_id *id)
 rtems_semaphore_create
rtems_status_code rtems_semaphore_ident (rtems_name name, uint32_t node, rtems_id *id)
 RTEMS Semaphore Name to Id.
rtems_status_code rtems_semaphore_delete (rtems_id id)
 RTEMS Delete Semaphore.
rtems_status_code rtems_semaphore_obtain (rtems_id id, rtems_option option_set, rtems_interval timeout)
 RTEMS Obtain Semaphore.
rtems_status_code rtems_semaphore_release (rtems_id id)
 RTEMS Semaphore Release.
rtems_status_code rtems_semaphore_flush (rtems_id id)
 RTEMS Semaphore Flush.

Detailed Description

This encapsulates functionality related to the Classic API Semaphore Manager.


Function Documentation

rtems_status_code rtems_semaphore_create ( rtems_name  name,
uint32_t  count,
rtems_attribute  attribute_set,
rtems_task_priority  priority_ceiling,
rtems_id id 
)

rtems_semaphore_create

This routine implements the rtems_semaphore_create directive. The semaphore will have the name name. The starting count for the semaphore is count. The attribute_set determines if the semaphore is global or local and the thread queue discipline. It returns the id of the created semaphore in ID.

Semaphore Manager

rtems_status_code rtems_semaphore_delete ( rtems_id  id)

RTEMS Delete Semaphore.

This routine implements the rtems_semaphore_delete directive. The semaphore indicated by ID is deleted.

Parameters:
[in]idis the semaphore id
Return values:
Thismethod returns RTEMS_SUCCESSFUL if there was not an error. Otherwise, a status code is returned indicating the source of the error.
rtems_status_code rtems_semaphore_flush ( rtems_id  id)

RTEMS Semaphore Flush.

DESCRIPTION: This package is the implementation of the flush directive of the Semaphore Manager.

This directive allows a thread to flush the threads pending on the semaphore.

Parameters:
[in]idis the semaphore id
Return values:
RTEMS_SUCCESSFULif successful or error code if unsuccessful
rtems_status_code rtems_semaphore_ident ( rtems_name  name,
uint32_t  node,
rtems_id id 
)

RTEMS Semaphore Name to Id.

This routine implements the rtems_semaphore_ident directive. This directive returns the semaphore ID associated with name. If more than one semaphore is named name, then the semaphore to which the ID belongs is arbitrary. node indicates the extent of the search for the ID of the semaphore named name. The search can be limited to a particular node or allowed to encompass all nodes.

Parameters:
[in]nameis the user defined semaphore name
[in]nodeis(are) the node(s) to be searched
[in]idis the pointer to semaphore id
Return values:
RTEMS_SUCCESSFULif successful or error code if unsuccessful and *id filled in with the semaphore id
rtems_status_code rtems_semaphore_obtain ( rtems_id  id,
rtems_option  option_set,
rtems_interval  timeout 
)

RTEMS Obtain Semaphore.

This routine implements the rtems_semaphore_obtain directive. It attempts to obtain a unit from the semaphore associated with ID. If a unit can be allocated, the calling task will return immediately. If no unit is available, then the task may return immediately or block waiting for a unit with an optional timeout of timeout clock ticks. Whether the task blocks or returns immediately is based on the RTEMS_NO_WAIT option in the option_set.

Parameters:
[in]idis the semaphore id
[in]option_setis the wait option
[in]timeoutis the number of ticks to wait (0 means wait forever)
Return values:
Thismethod returns RTEMS_SUCCESSFUL if there was not an error. Otherwise, a status code is returned indicating the source of the error.
rtems_status_code rtems_semaphore_release ( rtems_id  id)

RTEMS Semaphore Release.

Semaphore Manager

This routine implements the rtems_semaphore_release directive. It frees a unit to the semaphore associated with ID. If a task was blocked waiting for a unit from this semaphore, then that task will be readied and the unit given to that task. Otherwise, the unit will be returned to the semaphore.