struct _CMPIBrokerExtFT

This structure is a table of pointers to extended broker CIMOM services This table is made available by the Management Broker, whenever a provider is loaded and initialized.

Documentation

This structure is a table of pointers to extended broker CIMOM services This table is made available by the Management Broker, whenever a provider is loaded and initialized. This is an extension used by Pegasus to support platform dependencies.

[more]int ftVersion
Function table version
[more]char* (*resolveFileName)(const char* filename)
This function complements a generic dynamic library nameto its OS-dependent native format.
[more]CMPI_THREAD_TYPE (*newThread)(CMPI_THREAD_RETURN (CMPI_THREAD_CDECL* start) (void* ), void* parm, int detached)
Start a new thread using the POSIX threading semantics.
[more]int (*joinThread)(CMPI_THREAD_TYPE thread, CMPI_THREAD_RETURN* retval)
Waits until the specified thread ends using the POSIX threading semantics.
[more]int (*exitThread)(CMPI_THREAD_RETURN return_code)
Causes the current thread to exit with the passed in return code using POSIX threading semantics.
[more]int (*cancelThread)(CMPI_THREAD_TYPE thread)
Cancel the thread using the POSIX threading semantics.
[more]int (*threadSleep)(CMPIUint32 msec)
Suspends the execution of the current thread for the specified duration.
[more]int (*threadOnce)(int* once, void (*init) (void))
Executes the specified function procedure only once during the lifetime of the thread.
[more]int (*destroyThreadKey)(CMPI_THREAD_KEY_TYPE key)
Destroy a POSIX threading conformant thread key.
[more]void* (*getThreadSpecific)(CMPI_THREAD_KEY_TYPE key)
Return data from the thread local store using a thread key.
[more]int (*setThreadSpecific)(CMPI_THREAD_KEY_TYPE key, void* value)
Set a pointer to data in the therad local store using a thread key.
[more]CMPI_MUTEX_TYPE (*newMutex)(int opt)
Create a POSIX threading conformant mutex.
[more]void (*destroyMutex)(CMPI_MUTEX_TYPE mutex)
Destroy a POSIX threading conformant mutex.
[more]void (*lockMutex)(CMPI_MUTEX_TYPE mutex)
Attempt to get control of the mutex and must wait until released when not available.
[more]void (*unlockMutex)(CMPI_MUTEX_TYPE mutex)
Release control of the mutex.
[more]CMPI_COND_TYPE (*newCondition)(int opt)
Create a new POSIX threading-conformant condition variable.
[more]void (*destroyCondition)(CMPI_COND_TYPE cond)
Destroy a condition variable.
[more]int (*condWait)(CMPI_COND_TYPE cond, CMPI_MUTEX_TYPE mutex)
Wait until condition is signalled.
[more]int (*timedCondWait)(CMPI_COND_TYPE cond, CMPI_MUTEX_TYPE mutex, struct timespec* wait)
Wait until the condition is signalled using a timeout value.
[more]int (*signalCondition)(CMPI_COND_TYPE cond)
Sends a signal to a condition variable.

oint ftVersion
Function table version

ochar* (*resolveFileName)(const char* filename)
This function complements a generic dynamic library nameto its OS-dependent native format.
Parameters:
filename - Pointer to the generic library name,
Returns:
The returned char* pointer points to the complemented library name in native OS format. Space for this string has been obtained using malloc() and must be released using free() by the caller. In case no storage could be obtained for the complemented library name, NULL will be returned.

oCMPI_THREAD_TYPE (*newThread)(CMPI_THREAD_RETURN (CMPI_THREAD_CDECL* start) (void* ), void* parm, int detached)
Start a new thread using the POSIX threading semantics.
Parameters:
start - Pointer to the function to be started as a thread.
param - Pointer to the function to be started as a thread.
detached - If not zero, defines that the thread should run in detached mode.
Returns:
The return value is the thread ID.

oint (*joinThread)(CMPI_THREAD_TYPE thread, CMPI_THREAD_RETURN* retval)
Waits until the specified thread ends using the POSIX threading semantics.
Parameters:
thread - The thread ID of the thread waiting for completion.
retval - Pointer to the return value of the thread.
Returns:
Completion code as defined by POSIX threading semantics (pthread_join)

oint (*exitThread)(CMPI_THREAD_RETURN return_code)
Causes the current thread to exit with the passed in return code using POSIX threading semantics.
Parameters:
return_code - Is the return code that should be used for the thread.
Returns:
The function never exits.

oint (*cancelThread)(CMPI_THREAD_TYPE thread)
Cancel the thread using the POSIX threading semantics.
Parameters:
thread - The thread to be canceled.
Returns:
Completion code as defined by POSIX threading semantics (pthread_cancel)

oint (*threadSleep)(CMPIUint32 msec)
Suspends the execution of the current thread for the specified duration.
Parameters:
msec - The suspend duration in milliseconds.
Returns:
Completion code as defined by POSIX threading semantics (pthread_sleep)

oint (*threadOnce)(int* once, void (*init) (void))
Executes the specified function procedure only once during the lifetime of the thread.
Parameters:
once - The pointer to the counter.
The - function to be called
Returns:
Completion code as defined by POSIX threading semantics (pthread_once)

oint (*destroyThreadKey)(CMPI_THREAD_KEY_TYPE key)
Destroy a POSIX threading conformant thread key.
Parameters:
key - The key to be destroyed.
Returns:
Completion code as defined by POSIX threading semantics.

ovoid* (*getThreadSpecific)(CMPI_THREAD_KEY_TYPE key)
Return data from the thread local store using a thread key.
Parameters:
key - The key to be used to retrieve the data.
Returns:
Completion code as defined by POSIX threading semantics.

oint (*setThreadSpecific)(CMPI_THREAD_KEY_TYPE key, void* value)
Set a pointer to data in the therad local store using a thread key.
Parameters:
key - The key to be used.
- value The pointer to the data.
Returns:
Completion code as defined by POSIX threading semantics.

oCMPI_MUTEX_TYPE (*newMutex)(int opt)
Create a POSIX threading conformant mutex.
Parameters:
opt - The POSIX options. If not options are to be defined the 0 values must be used.
Returns:
Handle of newly created mutex.

ovoid (*destroyMutex)(CMPI_MUTEX_TYPE mutex)
Destroy a POSIX threading conformant mutex.
Parameters:
mutex - The mutex to be destroyed.

ovoid (*lockMutex)(CMPI_MUTEX_TYPE mutex)
Attempt to get control of the mutex and must wait until released when not available.
Parameters:
mutex - The mutex to be locked.

ovoid (*unlockMutex)(CMPI_MUTEX_TYPE mutex)
Release control of the mutex.
Parameters:
mutex - The mutex to be unlocked.

oCMPI_COND_TYPE (*newCondition)(int opt)
Create a new POSIX threading-conformant condition variable.
Parameters:
opt - The POSIX options. If not options are to be defined the 0 values must be used.
Returns:
Handle of newly created condition variable.

ovoid (*destroyCondition)(CMPI_COND_TYPE cond)
Destroy a condition variable.
Parameters:
cond - The condition variable to be destroyed.

oint (*condWait)(CMPI_COND_TYPE cond, CMPI_MUTEX_TYPE mutex)
Wait until condition is signalled. This function returns when condition has been signalled already and otherwise must wait for the signal and then return.
Parameters:
cond - The handle of the condition variable to be used.
mutex - The handle of a locked mutex guarding this condition variable.
Returns:
Return value As defined by POSIX threading specifications.

oint (*timedCondWait)(CMPI_COND_TYPE cond, CMPI_MUTEX_TYPE mutex, struct timespec* wait)
Wait until the condition is signalled using a timeout value. This function shall return when condition has been signalled already and otherwise must wait for the signal and then return. The function shall return when the timeout specification elapses before the condition is signalled.
Parameters:
cond - Specifies the handle of the condition variable to be used.
mutex - Specifies the handle of a locked mutex guarding this condition variable.
wait - Specifies the timeout value.
Returns:
As defined by POSIX threading specifications.

oint (*signalCondition)(CMPI_COND_TYPE cond)
Sends a signal to a condition variable.
Parameters:
cond - Specifies the handle of the condition variable to send the signal.
Returns:
As defined by POSIX threading specifications.

Alphabetic index