RTEMS POSIX API

RTEMS POSIX API definitions and modules. More...

Collaboration diagram for RTEMS POSIX API:

Modules
	utsname Service
	POSIX Asynchronous I/O Support
	POSIX Asynchronous Input and Output.
	POSIX Barriers
	This encapsulates functionality which implements the RTEMS API Barrier Manager.
	POSIX Condition Variables
	POSIX Key
	Message Queues Private Support
	POSIX Mutex Support
	Private Support Information for POSIX Mutex.
	POSIX Priority Support
	Interface to the POSIX Priority Implementation.
	POSIX Signals Support
	Internal Information about POSIX Signals.
	POSIX Threads Support
	Private Support Information for POSIX Threads.
	POSIX Timers
	POSIX RWLock Manager
	Constants and Structures Associated with the POSIX RWLock Manager.
	POSIX Semaphore Private Support
	This defines the internal implementation support for POSIX semaphores.
	POSIX Spinlock Support
	Constants and Structures Associated with the POSIX Spinlock Manager.
	POSIX Thread API Extension
	POSIX Time Types
	POSIX Timer Private Support
	POSIX Semaphores Support
	Private Support Information for POSIX Semaphores.

Files
file	_execve.c
	execve()
file	adjtime.c
	Adjust the Time to Synchronize the System Clock.
file	aio_error.c
	Returns the error status for the Asynchronous I/O request.
file	aio_fsync.c
	Syncing of all Outstanding Asynchronous I/O Operations.
file	aio_misc.c
	Actual request being processed.
file	aio_read.c
	Asynchronously reads Data from a File.
file	aio_return.c
	Final return status for Asynchronous I/O request pointed to by aiobcp.
file	aio_suspend.c
	Suspends Process until Asynchronous I/O Operation completes.
file	aio_write.c
	Function queues I/O request described by buffer pointed by aiocb.
file	alarm.c
	System Generates Signal for process after realtime seconds elapsed.
file	barrierattrdestroy.c
	Function shall Destroy a Barrier Attribues Object.
file	barrierattrgetpshared.c
	Barrier Attributes Get Process Shared.
file	barrierattrinit.c
	Initialize the Barrier Attributes Object.
file	barrierattrsetpshared.c
	Set the Process-Shared Attribute of the Barrier Attributes Object.
file	cancel.c
	Canceling Execution of a Thread.
file	canceleval.c
	POSIX Function Evaluates Thread Cancellation and Enables Dispatch.
file	cancelrun.c
	Executes a thread's cancellation handlers.
file	cleanuppop.c
	Removes Routine from Top of Calling Thread's stack and Invoke it.
file	cleanuppush.c
	Establishing Cancellation Handlers.
file	clockgetcpuclockid.c
	Function Returns Clock ID of CPU-time Clock of process specified.
file	clockgetenableattr.c
	Clock get Enable Attribute Access.
file	clockgetres.c
	Function Returns the Resolution of any Clock.
file	clockgettime.c
	Retrieves the Specified Clock Time.
file	clocksetenableattr.c
	Clock set Enable Attribute Access.
file	clocksettime.c
	Set Time of Clock.
file	condattrdestroy.c
	Destroy Condition Attribute.
file	condattrgetpshared.c
	Get the Process-Shared Condition Variable Attributes.
file	condattrinit.c
	Initialization of Conditional Attributes.
file	condattrsetpshared.c
	Initialize Condition Variable Attributes.
file	condbroadcast.c
	Broadcast a Condition.
file	conddefaultattributes.c
	Condition variable Attributes structure.
file	conddestroy.c
	Destroy a Condition Variable.
file	condinit.c
	Initialize a Condition Variable.
file	condsignal.c
	Signal a Condition.
file	condtimedwait.c
	Waiting on a Condition.
file	condwait.c
	Waiting on a Condition.
file	execl.c
	Process will get Executed and then Terminated by execl.
file	execle.c
	Execute a File.
file	execlp.c
	execlp()
file	execv.c
	Inoperable implementation of execv for POSIX threads.
file	execve.c
	Execute a Program.
file	fork.c
	Inoperable implementation of fork() for POSIX threads.
file	getitimer.c
	Function Gets Value of an Interval Timer.
file	keycreate.c
	Thread-Specific Data Key Create.
file	keydelete.c
	Deletes Thread-specific Data Key Previously Returned by keycreate.c.
file	keyfreememory.c
	POSIX Function Keys Free Memory.
file	keygetspecific.c
	Thread-Specific Data Management.
file	keysetspecific.c
	Set Specific Key.
file	kill.c
	Send a Signal to a Process.
file	kill_r.c
	Send a Signal to a Process.
file	killinfo.c
	Send a Signal to a Process.
file	lio_listio.c
	Function Initiates a List of I/O Requests with Single Function Call.
file	mprotect.c
	Change Memory Protection12.2.3 Change Memory Protection, P1003.1b-1996, p.
file	mqueueclose.c
	Function closes the Message Queue.
file	mqueuegetattr.c
	Message Queue Attributes.
file	mqueueopen.c
	Creates a new POSIX Message Queue or Opens an Existing Queue.
file	mqueuesend.c
	Adds Message Pointed by msg_ptr to Message Queue Reffered by mqdes.
file	mqueuesendsupp.c
	POSIX Message Queue and Send Support.
file	mqueuetimedreceive.c
	Receive Message from Message Queue.
file	mqueuetranslatereturncode.c
	POSIX Error Translation in Message Queue.
file	mutexattrdestroy.c
	Destroy Mutex Attributes Object.
file	mutexattrgetprioceiling.c
	Mutex Initialization Scheduling Attributes.
file	mutexattrgetprotocol.c
	Get protocol Attribute of Mutex Attribute Obect.
file	mutexattrgetpshared.c
	Obtaining process-shared Attribute Value from the Attributes Object.
file	mutexattrgettype.c
	Function gets the Mutex Type Attribute.
file	mutexattrinit.c
	Mutex Initialization Attribute.
file	mutexattrsetprioceiling.c
	Mutex Initialization Scheduling Attributes.
file	mutexattrsetprotocol.c
	Mutex Initialization Scheduling Attributes.
file	mutexattrsetpshared.c
	Function sets Current pshared Attribute for Mutex Attributes Object.
file	mutexattrsettype.c
	Set a Mutex Type.
file	mutexdestroy.c
	Initializing and Destroying a Mutex.
file	mutexget.c
	Convert POSIX Mutex ID to local object pointer.
file	mutexgetprioceiling.c
	Returns the Current Priority Ceiling of the Mutex.
file	mutexinit.c
	Initialize a Mutex.
file	mutexlock.c
	Call to function enables locking of Mutex Object referenced by mutex.
file	mutexlocksupp.c
	Support Call to function Enables Locking of Mutex Object.
file	mutexsetprioceiling.c
	Changes the Priority Ceiling of a Mutex and Releases it.
file	mutextimedlock.c
	Mutex Timed Lock.
file	mutextrylock.c
	Try to Lock Mutex.
file	mutexunlock.c
	Locking and Unlocking a Mutex.
file	nanosleep.c
	Suspends Execution of calling thread until Time elapses.
file	pause.c
	Suspend Process Execution.
file	pbarrierdestroy.c
	Destroy a Barrier Object.
file	pbarrierinit.c
	Call to Function Enables Reinitializing of the Barrier.
file	pbarriertranslatereturncode.c
	Function Translates POSIX Barrier Status Code.
file	pbarrierwait.c
	Wait at a Barrier.
file	prwlockdestroy.c
	Destroy a RWLock.
file	prwlockinit.c
	Allocate resources to use the read-write lock and Initialize it.
file	prwlockrdlock.c
	Obtain a Read Lock on a RWLock Instance.
file	prwlocktimedrdlock.c
	Attempt to Obtain a Read Lock on a RWLock Instance.
file	prwlocktimedwrlock.c
	Function applies a Write lock to RWLock referenced by rwlock.
file	prwlocktryrdlock.c
	Attempt to Obtain a Read Lock on a RWLock Instance.
file	prwlocktrywrlock.c
	Attempt to Obtain a Write Lock on a RWLock Instance.
file	prwlockunlock.c
	Function Releases a lock held on RWLock object referenced by rwlock.
file	prwlockwrlock.c
	Obtain a Write Lock on a RWlock Instance.
file	psignalclearprocesssignals.c
	POSIX_signals clear_process_signals.
file	pspindestroy.c
	Destroy a Spinlock.
file	pspininit.c
	POSIX Function Initializes a Spinlock Instance.
file	pspinlock.c
	Wait at a Spinlock.
file	pspintrylock.c
	Wait at a Spinlock.
file	pspinunlock.c
	Function Unlocks a Spin Lock Object.
file	psxnametoid.c
	POSIX Name to ID.
file	pthreadatfork.c
	Register Fork Handlers.
file	pthreadattrdestroy.c
	Thread Creation Attributes.
file	pthreadattrgetaffinitynp.c
	Pthread Attribute Get Affinity.
file	pthreadattrgetdetachstate.c
	Function gets the detachstate Attribute in the attr Object.
file	pthreadattrgetguardsize.c
	Thread Creation Attributes.
file	pthreadattrgetinheritsched.c
	Thread Creation Scheduling Attributes.
file	pthreadattrgetschedparam.c
	Returns Scheduling Parameter Attributes of Thread Attributes Object.
file	pthreadattrgetschedpolicy.c
	Get The Schedpolicy Attribute.
file	pthreadattrgetscope.c
	Function gets the Contentionscope Attribute in the attr object.
file	pthreadattrgetstack.c
	Function Gets the Thread Creation Stack Attributes in the attr.
file	pthreadattrgetstackaddr.c
	Thread Creation Attributes.
file	pthreadattrgetstacksize.c
	Thread Creation Attributes.
file	pthreadattrinit.c
	Thread Attributes Creation.
file	pthreadattrsetaffinitynp.c
	Pthread Attribute Set Affinity.
file	pthreadattrsetdetachstate.c
	Thread Creation Attributes.
file	pthreadattrsetguardsize.c
	Thread Creation Attributes.
file	pthreadattrsetinheritsched.c
	Function sets the inheritsched Attribute in the attr Argument.
file	pthreadattrsetschedparam.c
	Thread Creation Scheduling Parameters.
file	pthreadattrsetschedpolicy.c
	Sets Scheduling policy Attributes of Thread Attributes Object.
file	pthreadattrsetscope.c
	Function Sets the Contentionscope Attribute in the attr Object.
file	pthreadattrsetstack.c
	Function Sets Thread Creation Stack Attributes in the attr object.
file	pthreadattrsetstackaddr.c
	Sets the Thread Creation stackaddr Attribute in the attr Object.
file	pthreadattrsetstacksize.c
	Sets the Thread Creation Stacksize Attribute in the attr object.
file	pthreadcreate.c
	Function Starts a New Thread in The Calling Process.
file	pthreaddetach.c
	Detaching a Thread.
file	pthreadequal.c
	Compare Thread IDs.
file	pthreadgetaffinitynp.c
	Pthread Get Affinity.
file	pthreadgetattrnp.c
	Pthread Get Attribute.
file	pthreadgetcpuclockid.c
	Returns Clock ID for CPU time clock of the thread.
file	pthreadgetschedparam.c
	Gets Scheduling Policy and Parameters of Individual Threads.
file	pthreadjoin.c
	Suspends Execution of Calling Thread until Target Thread Terminates.
file	pthreadkill.c
	Sends a signal Asynchronously directed to a thread.
file	pthreadonce.c
	Call to function by Thread will call init_routine with no Arguments.
file	pthreadself.c
	Function returns the ID of the Calling Thread.
file	pthreadsetaffinitynp.c
	Pthread Set Affinity.
file	pthreadsetschedparam.c
	Function sets scheduling policy and parameters of the thread.
file	pthreadsigmask.c
	Examine and/or change the calling thread's signal mask.
file	ptimer.c
	Process Timer.
file	rwlockattrdestroy.c
	Function Destroys a read-write lock Attributes object.
file	rwlockattrgetpshared.c
	Get the Process-Shared Attribute of the RWLock.
file	rwlockattrinit.c
	Initialises a RWLock Attributes object attr with the default value.
file	rwlockattrsetpshared.c
	RWLock Attributes Set Process Shared.
file	sched_getparam.c
	Set Scheduling Parameters.
file	sched_getprioritymax.c
	Returns the Appropriate Maximum for Scheduling policy.
file	sched_getprioritymin.c
	Get the Minimum Priority Limit.
file	sched_getscheduler.c
	Function Returns Scheduling Policy of the process specified by pid.
file	sched_rr_get_interval.c
	Limits for Scheduling Parameter.
file	sched_setparam.c
	Sets Scheduling Parameters Associated with Scheduling Policies.
file	sched_setscheduler.c
	Set Scheduling Policy and Scheduling Parameters.
file	sched_yield.c
	Yield Processor.
file	semaphore.c
	POSIX Function Initializes Semaphore Manager.
file	semaphorecreatesupp.c
	Function does Actual creation and Initialization of POSIX Semaphore.
file	semaphoretranslatereturncode.c
	POSIX Semaphore Code Translation Error.
file	seminit.c
	Initializing of an Unnamed Semaphore.
file	semopen.c
	Function Creates New POSIX semaphore or Opens an existing Semaphore.
file	setcancelstate.c
	Setting Cancelability State.
file	setcanceltype.c
	Sets the Cancelability Type of Calling Thread to value given in type.
file	setitimer.c
	Set the Timer.
file	sigaction.c
	Allows calling process to examine action of a Specific Signal.
file	sigaddset.c
	Function Adds Signal from Set.
file	sigdelset.c
	Deleted Signal from Set.
file	sigemptyset.c
	Manipulate Signal Sets.
file	sigfillset.c
	Manipulate Signal Sets.
file	sigismember.c
	Manipulate Signal Sets.
file	signal_2.c
	POSIX Function Installs signal Handler.
file	sigpending.c
	Examine Pending Signals.
file	sigprocmask.c
	Examine and Change Blocked Signals.
file	sigqueue.c
	Queue a Signal to a Process.
file	sigsuspend.c
	Replacing signal mask with *sigmask and suspending calling process.
file	sigtimedwait.c
	Wait for Queued Signals.
file	sigwait.c
	Synchronously Accept a Signal.
file	sysconf.c
	Get Configurable System Variables.
file	testcancel.c
	Setting test on Cancelability State.
file	timerdelete.c
	Deletes a POSIX Interval Timer.
file	timergettime.c
	Function Fetches State of POSIX Per-Process Timers.
file	timerinserthelper.c
	Helper Routine for POSIX TIMERS.
file	timersettime.c
	Function Arms or Disarms the Timer Identified by timerid.
file	ualarm.c
	Schedule Alarm.
file	vfork.c
	Creates Child process Of The Calling process.
file	wait.c
	Wait for Process to Change State.
file	waitpid.c
	Wait for Process to Change State.

Enumerations
enum	POSIX_Fatal_domain { POSIX_FD_PTHREAD, POSIX_FD_PTHREAD_ONCE }
	POSIX API Fatal domains. More...

Functions
void	_POSIX_Fatal_error (POSIX_Fatal_domain domain, int eno)
	POSIX API Fatal error. More...
void	_POSIX_API_Initialize (void)
	Initialize POSIX API. More...
int	_POSIX_Name_to_id (Objects_Information *information, const char *name, Objects_Id *id, size_t *len)
	Queries the object identifier id for a name. More...

Detailed Description

RTEMS POSIX API definitions and modules.

Enumeration Type Documentation

POSIX_Fatal_domain

enum POSIX_Fatal_domain

POSIX API Fatal domains.

Enumerator
POSIX_FD_PTHREAD	A pthread thread error.
POSIX_FD_PTHREAD_ONCE	A pthread once error.

Function Documentation

_POSIX_API_Initialize()

void _POSIX_API_Initialize

(

void

)

Initialize POSIX API.

This method is responsible for initializing each of the POSIX API managers.

References _Objects_Information_table.

_POSIX_Fatal_error()

void _POSIX_Fatal_error	(	POSIX_Fatal_domain	domain,
		int	eno
	)

POSIX API Fatal error.

A common method of rasing a POSIX API fatal error.

Parameters

[in]	domain	The POSIX error domain.
[in]	eno	The error number as defined in errno.h.

References _Terminate(), and INTERNAL_ERROR_POSIX_API.

_POSIX_Name_to_id()

int _POSIX_Name_to_id	(	Objects_Information *	information,
		const char *	name,
		Objects_Id *	id,
		size_t *	len
	)

Queries the object identifier id for a name.

Parameters

[in]	information	Object information.
[in]	name	Zero terminated name string to look up.
[out]	id	Pointer for identifier. The pointer must be valid.
[out]	len	Pointer for string length. The pointer must be valid.

Return values

0	Successful operation.
EINVAL	The name pointer is NULL or the name string has zero length.
ENAMETOOLONG	The name string length is greater than or equal to NAME_MAX.
ENOENT	Found no corresponding identifier.

Referenced by _POSIX_Message_queue_Name_to_id(), and _POSIX_Semaphore_Name_to_id().