* system minus the configuration parameter FOSA_ADS_SCHEDULER_PRIO_DIFF.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of scheduler_ops was invalid
- * EAGAIN: The system lacks enough resources to create the scheduler
+ *
+ * FOSA_EINVAL: The value of scheduler_ops was invalid \n
+ * FOSA_EAGAIN: The system lacks enough resources to create the
+ * scheduler \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* the system under a fixed priority scheduler
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of attr is invalid
+ *
+ * FOSA_EINVAL: The value of attr is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* the system under a fixed priority scheduler.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of attr is invalid
+ *
+ * FOSA_EINVAL: The value of attr is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* paramsize bytes and pointed to by param into that attribute
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of attr is invalid, or paramsize is less than
+ *
+ * FOSA_EINVAL: The value of attr is invalid, or paramsize is less than
* zero or larger than FOSA_ADS_SCHEDPARAM_MAX
*
* Alternatively, in case of error the implementation is allowed to
* paramsize.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of attr is invalid
+ *
+ * FOSA_EINVAL: The value of attr is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* scheduled by the system under a fixed priority scheduler.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of thread is invalid
*
- * EREJECT: the attachment of the thread to the frsh schehduler
+ * FOSA_EINVAL: The value of thread is invalid
+ *
+ * FOSA_EREJECT: the attachment of the thread to the frsh schehduler
* was rejected by the frsh scheduler possibly because of
* incorrect attributes, or because the requested minimum
* capacity cannot be guaranteed
* scheduled by the system under a fixed priority scheduler
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of thread is invalid
+ *
+ * FOSA_EINVAL: The value of thread is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* that attribute
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of thread is invalid, or paramsize is less than
+ *
+ * FOSA_EINVAL: The value of thread is invalid, or paramsize is less than
* zero or larger than FOSA_ADS_SCHEDPARAM_MAX
*
* Alternatively, in case of error the implementation is allowed to
* bytes equal to paramsize.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: The value of thread is invalid, or paramsize is less than
+ *
+ * FOSA_EINVAL: The value of thread is invalid, or paramsize is less than
* zero or larger than FOSA_ADS_SCHEDPARAM_MAX
*
* Alternatively, in case of error the implementation is allowed to
* scheduler primitive operation, the parent of the rejected thread
* waiting on a fosa_thread_create() or the rejected thread itself
* waiting on a fosa_ads_set_appscheduled() function shall complete the
- * function with an error code of EREJECT. If no reject-thread action
+ * function with an error code of FOSA_EREJECT. If no reject-thread action
* is added during the new_thread() scheduler primitive operation, the
* thread is accepted to be scheduled by the scheduler and the
* associated fosa_thread_create() or the fosa_ads_set_appscheduled()
* scheduler.
*
* Returns 0 if successful; otherwise it returns an error code:
- * ENOMEM: There is insufficient memory to add this action
- * EPOLICY: The thread specified by thread is not the one requesting
+ *
+ * FOSA_ENOMEM: There is insufficient memory to add this action \n
+ * FOSA_EPOLICY: The thread specified by thread is not the one requesting
* attachment to the scheduler, or the function is not being
- * called from the new_thread primitive operation
- * EINVAL: The value specified by sched_actions is invalid
+ * called from the new_thread primitive operation \n
+ * FOSA_EINVAL: The value specified by sched_actions is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* with more urgency will be scheduled before those of less urgency.
*
* Returns 0 if successful; otherwise it returns an error code:
- * ENOMEM: There is insufficient memory to add this action
- * EPOLICY: The thread specified by thread has its appscheduled
- * attribute set to false,
- * EINVAL: The value specified by sched_actions is invalid
+ *
+ * FOSA_ENOMEM: There is insufficient memory to add this action \n
+ * FOSA_EPOLICY: The thread specified by thread has its appscheduled
+ * attribute set to false \n
+ * FOSA_EINVAL: The value specified by sched_actions is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* operating system.
*
* Returns 0 if successful; otherwise it returns an error code:
- * ENOMEM: There is insufficient memory to add this action
- * EPOLICY: The thread specified by thread has its appscheduled
- * attribute set to false,
- * EINVAL: The value specified by sched_actions is invalid
+ *
+ * FOSA_ENOMEM: There is insufficient memory to add this action \n
+ * FOSA_EPOLICY: The thread specified by thread has its appscheduled
+ * attribute set to false \n
+ * FOSA_EINVAL: The value specified by sched_actions is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* argument.
*
* Returns 0 if successful; otherwise it returns an error code:
- * ENOMEM: There is insufficient memory to add this action
- * EINVAL: The value specified by sched_actions is invalid
+ *
+ * FOSA_ENOMEM: There is insufficient memory to add this action \n
+ * FOSA_EINVAL: The value specified by sched_actions is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* thread specified by thread and the clock specified by clock_id.
*
* Returns 0 if successful; otherwise it returns an error code:
- * ENOMEM: There is insufficient memory to add this action
- * EPOLICY: The thread specified by thread has its appscheduled
- * attribute set to false,
- * EINVAL: The value specified by sched_actions is invalid
+ *
+ * FOSA_ENOMEM: There is insufficient memory to add this action \n
+ * FOSA_EPOLICY: The thread specified by thread has its appscheduled
+ * attribute set to false \n
+ * FOSA_EINVAL: The value specified by sched_actions is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* The size of the array is specified by argument size.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EPOLICY: The function has not been called from a scheduler
- * primitive operation
- * EINVAL: The value specified by set is invalid
+ *
+ * FOSA_EPOLICY: The function has not been called from a scheduler
+ * primitive operation \n
+ * FOSA_EINVAL: The value specified by set is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* scheduler.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EPOLICY: The function been called from inside a scheduler
- * primitive operation
- * EINVAL: The value of msg_size is less than zero or larger than
- * FOSA_ADS_SCHEDINFO_MAX
- * EMASKED: The operation cannot be executed because the primitive
- * operation explicit_call_with_data() is set to NULL
+ *
+ * FOSA_EPOLICY: The function been called from inside a scheduler
+ * primitive operation \n
+ * FOSA_EINVAL: The value of msg_size is less than zero or larger than
+ * FOSA_ADS_SCHEDINFO_MAX \n
+ * FOSA_EMASKED: The operation cannot be executed because the primitive
+ * operation explicit_call_with_data() is set to NULL \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* fosa_get_cputime_clock()
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of clockid is invalid
+ * FOSA_EINVAL: the value of clockid is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* identifier of a cpu-time clock for the thread specified by tid.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of tid is invalid
+ * FOSA_EINVAL: the value of tid is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* thread be the one who is waiting for the signal.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of clockid or signal is invalid
+ * FOSA_EINVAL: the value of clockid or signal is invalid
*
- * EAGAIN: the system lacks enough resources to create the timer
+ * FOSA_EAGAIN: the system lacks enough resources to create the timer
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* deletion.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of timerid is not valid
+ * FOSA_EINVAL: the value of timerid is not valid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* When the timer expires, it is disarmed.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of timerid or value is invalid
+ * FOSA_EINVAL: the value of timerid or value is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* If the timer is disarmed it returns 0.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of timerid or value is invalid
+ * FOSA_EINVAL: the value of timerid or value is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* disarmed a 0 value will be set.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of timerid or value is invalid
+ * FOSA_EINVAL: the value of timerid or value is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* is assigned to this mutex.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of prioceiling is invalid
- * EAGAIN: the system lacked the necessary resources to create the mutex
- * ENOMEM: Insufficient memory exists to initialize the mutex
- * EBUSY: The system has detected an attempt to reinitialize the mutex
+ *
+ * FOSA_EINVAL: the value of prioceiling is invalid \n
+ * FOSA_EAGAIN: the system lacked the necessary resources to create
+ * the mutex \n
+ * FOSA_ENOMEM: Insufficient memory exists to initialize the mutex \n
+ * FOSA_EBUSY: The system has detected an attempt to reinitialize the mutex
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* The mutex pointed to by mutex is destroyed
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex is invalid
- * EBUSY: The mutex is in use (is locked)
+ *
+ * FOSA_EINVAL: the value of mutex is invalid \n
+ * FOSA_EBUSY: The mutex is in use (is locked)\n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* old_ceiling.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex or prioceiling is invalid
+ *
+ * FOSA_EINVAL: the value of mutex or prioceiling is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* current priority ceiling of the mutex referenced by mutex
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex is invalid
+ *
+ * FOSA_EINVAL: the value of mutex is invalid \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* available. The operation returns with the mutex in the locked
* state, with the calling thread as its owner.
*
- * Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex is invalid, or the priority of the
- * calling thread is higher than the priority ceiling of the mutex
- * EDEADLK: the current thread already owns this mutex
+ * Returns 0 if successful; otherwise it returns an error code: \n
+ *
+ * FOSA_EINVAL: the value of mutex is invalid, or the priority of the
+ * calling thread is higher than the priority ceiling of
+ * the mutex \n
+ *
+ * FOSA_EDEADLK: the current thread already owns this mutex \n
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* indication.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex is invalid, or the priority of the
- * calling thread is higher than the priority ceiling of the mutex
- * EBUSY: the mutex was already locked
+ * FOSA_EINVAL: the value of mutex is invalid, or the priority of the
+ * calling thread is higher than the priority ceiling of the
+ * mutex \n
+ * FOSA_EBUSY: the mutex was already locked \n
*
- * Alternatively, except for EBUSY, in case of error the
+ * Alternatively, except for FOSA_EBUSY, in case of error the
* implementation is allowed to notify it to the system console and
* then terminate the FRSH implementation and dependant applications
**/
* awakened to acquire the mutex.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of mutex is invalid
- * EPERM: the calling thread is not the owner of the mutex
+ * FOSA_EINVAL: the value of mutex is invalid
+ * FOSA_EPERM: the calling thread is not the owner of the mutex
*
- * Alternatively, except for EBUSY, in case of error the
+ * Alternatively, except for FOSA_EBUSY, in case of error the
* implementation is allowed to notify it to the system console and
* then terminate the FRSH implementation and dependant applications
**/
* the attributes required by the FOSA implementation.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EAGAIN: the system lacked the necessary resources to create the
+ * FOSA_EAGAIN: the system lacked the necessary resources to create the
* condition variable
- * ENOMEM: Insufficient memory exists to initialize the condition variable
- * EBUSY: The system has detected an attempt to reinitialize the
+ * FOSA_ENOMEM: Insufficient memory exists to initialize the condition variable
+ * FOSA_EBUSY: The system has detected an attempt to reinitialize the
* condition variable
*
* Alternatively, in case of error the implementation is allowed to
* The condition variable pointed to by cond is destroyed
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of cond is invalid
- * EBUSY: The condition variable is in use (a thread is waiting on it)
+ * FOSA_EINVAL: the value of cond is invalid
+ * FOSA_EBUSY: The condition variable is in use (a thread is waiting on it)
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* waiting, the function has no effect
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of cond is invalid
+ * FOSA_EINVAL: the value of cond is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* waiting, the function has no effect.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of cond is invalid
+ * FOSA_EINVAL: the value of cond is invalid
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* returns with the mutex locked by the calling thread.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of cond or mutex is invalid, or different
+ * FOSA_EINVAL: the value of cond or mutex is invalid, or different
* mutexes were used for concurrent wait operations on cond, or
* the mutex was not owned by the calling thread
*
* measured by the FOSA_CLOCK_REALTIME clock.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the value of cond or mutex or abstime is invalid, or different
+ * FOSA_EINVAL: the value of cond or mutex or abstime is invalid, or different
* mutexes were used for concurrent wait operations on cond, or
* the mutex was not owned by the calling thread
- * ETIMEDOUT: the timeout expired
+ * FOSA_ETIMEDOUT: the timeout expired
*
- * Alternatively, except for ETIMEDOUT, in case of error the
+ * Alternatively, except for FOSA_ETIMEDOUT, in case of error the
* implementation is allowed to notify it to the system console and
* then terminate the FRSH implementation and dependant applications
**/
*
* Returns 0 if successful; otherwise it returs a code error:
*
- * EAGAIN: the system lacks the necessary resources to create a
+ * FOSA_EAGAIN: the system lacks the necessary resources to create a
* new thread or the maximum number of threads has been
* reached
*
- * EINVAL: the value specified by attr is invalid (for instance,
+ * FOSA_EINVAL: the value specified by attr is invalid (for instance,
* it has not been correctly initialized)
*
- * EREJECT: the cretion of the thread was rejected by the frsh scheduler
+ * FOSA_EREJECT: the cretion of the thread was rejected by the frsh scheduler
* possibly because of incorrect attributes, or because the
* requested minimum capacity cannot be guaranteed
*
* identified by key will be set to the value specified by value
*
* Returns 0 if successful; otherwise, an error code is returned
- * EINVAL: the value of key is not between 0 and FOSA_MAX_KEYS-1
+ * FOSA_EINVAL: the value of key is not between 0 and FOSA_MAX_KEYS-1
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* identified by key will be copied to the variable pointed to by value
*
* Returns 0 if successful; otherwise, an error code is returned
- * EINVAL: the value of key is not between 0 and FOSA_MAX_KEYS-1
+ * FOSA_EINVAL: the value of key is not between 0 and FOSA_MAX_KEYS-1
*
* Alternatively, in case of error the implementation is allowed to
* notify it to the system console and then terminate the FRSH
* priority
*
* Returns 0 if successful, or the following error code:
- * EINVAL: the specified priority value is not between the
+ * FOSA_EINVAL: the specified priority value is not between the
* minimum and the maximum priorities defined in this
* FRSH implementation
* Alternatively, in case of error the implementation is allowed to
* set to the value specified by prio.
*
* Returns 0 if successful, or the following error code:
- * EINVAL: the specified priority value is not between the
+ * FOSA_EINVAL: the specified priority value is not between the
* minimum and the maximum priorities defined in this
* FRSH implementation
* Alternatively, in case of error the implementation is allowed to
* which must be of size equal to size
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the array contains one or more values which are not
+ * FOSA_EINVAL: the array contains one or more values which are not
* between FOSA_SIGNAL_MIN and FOSA_SIGNAL_MAX, or size
* is less than 0
*
* thread be the one who is waiting for the signal.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the signal specified by signal is not
+ * FOSA_EINVAL: the signal specified by signal is not
* between FOSA_SIGNAL_MIN and FOSA_SIGNAL_MAX
*
- * EAGAIN: no resources are available to queue the signal; the
+ * FOSA_EAGAIN: no resources are available to queue the signal; the
* maximum number of queued signals has been reached, or a
* systemwide resource limit has been exceeded
*
* So the fosa implementation will solve this issue internally.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the signal specified by signal is not
+ * FOSA_EINVAL: the signal specified by signal is not
* between FOSA_SIGNAL_MIN and FOSA_SIGNAL_MAX
*
- * EAGAIN: no resources are available to queue the signal; the
+ * FOSA_EAGAIN: no resources are available to queue the signal; the
* maximum number of queued signals has been reached, or a
* systemwide resource limit has been exceeded
*
* is stored in the variable pointed to by info.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the array contains one or more values which are not
+ * FOSA_EINVAL: the array contains one or more values which are not
* between FOSA_SIGNAL_MIN and FOSA_SIGNAL_MAX, or size
* is less than 0
*
* the timespec structure referenced by timeout.
*
* Returns 0 if successful; otherwise it returns an error code:
- * EINVAL: the array contains one or more values which are not
+ * FOSA_EINVAL: the array contains one or more values which are not
* between FOSA_SIGNAL_MIN and FOSA_SIGNAL_MAX, or size
* is less than 0, or timeout is invalid
- * EAGAIN: The timeout expired
+ * FOSA_EAGAIN: The timeout expired
*
- * Alternatively, in case of the EINVAL error the implementation is
+ * Alternatively, in case of the FOSA_EINVAL error the implementation is
* allowed to notify it to the system console and then terminate the
* FRSH implementation and dependant applications
**/