Referencia del Archivo src/libdigidoc/libxml2/threads.c

#include "libxml.h"
#include <string.h>
#include <libxml/threads.h>
#include <libxml/globals.h>
#include "elfgcchack.h"

Clases
struct	_xmlMutex
struct	_xmlRMutex
'defines'
#define	IN_LIBXML
#define	bottom_threads
Funciones
xmlMutexPtr	xmlNewMutex (void)
void	xmlFreeMutex (xmlMutexPtr tok)
void	xmlMutexLock (xmlMutexPtr tok)
void	xmlMutexUnlock (xmlMutexPtr tok)
xmlRMutexPtr	xmlNewRMutex (void)
void	xmlFreeRMutex (xmlRMutexPtr tok ATTRIBUTE_UNUSED)
void	xmlRMutexLock (xmlRMutexPtr tok)
void	xmlRMutexUnlock (xmlRMutexPtr tok ATTRIBUTE_UNUSED)
void	__xmlGlobalInitMutexLock (void)
void	__xmlGlobalInitMutexUnlock (void)
void	__xmlGlobalInitMutexDestroy (void)
xmlGlobalStatePtr	xmlGetGlobalState (void)
int	xmlGetThreadId (void)
int	xmlIsMainThread (void)
void	xmlLockLibrary (void)
void	xmlUnlockLibrary (void)
void	xmlInitThreads (void)
void	xmlCleanupThreads (void)

---

Documentación de los 'defines'

#define bottom_threads

DllMain: : handle to DLL instance : Reason code for entry : generic pointer (depends upon reason code)

Entry point for Windows library. It is being used to free thread-specific storage.

Returns TRUE always

#define IN_LIBXML

threads.c: set of generic threading related routines

See Copyright for the status of this software.

Gary Pennington <Gary.Pennington@uk.sun.com> daniel@veillard.com

---

Documentación de las funciones

void __xmlGlobalInitMutexDestroy

(

void

)

xmlGlobalInitMutexDestroy

Makes sure that the global initialization mutex is destroyed before application termination.

void __xmlGlobalInitMutexLock

(

void

)

xmlGlobalInitMutexLock

Makes sure that the global initialization mutex is initialized and locks it.

void __xmlGlobalInitMutexUnlock

(

void

)

void xmlCleanupThreads

(

void

)

xmlCleanupThreads:

xmlCleanupThreads() is used to to cleanup all the thread related data of the libxml2 library once processing has ended.

WARNING: if your application is multithreaded or has plugin support calling this may crash the application if another thread or a plugin is still using libxml2. It's sometimes very hard to guess if libxml2 is in use in the application, some libraries or plugins may use it without notice. In case of doubt abstain from calling this function or do it just before calling exit() to avoid leak reports from valgrind !

void xmlFreeMutex

(

xmlMutexPtr

tok

)

xmlFreeMutex: : the simple mutex

xmlFreeMutex() is used to reclaim resources associated with a libxml2 token struct.

void xmlFreeRMutex

(

xmlRMutexPtr tok

ATTRIBUTE_UNUSED

)

xmlFreeRMutex: : the reentrant mutex

xmlRFreeMutex() is used to reclaim resources associated with a reentrant mutex.

xmlGlobalStatePtr xmlGetGlobalState

(

void

)

xmlGetGlobalState:

xmlGetGlobalState() is called to retrieve the global state for a thread.

Returns the thread global state or NULL in case of error

int xmlGetThreadId

(

void

)

xmlGetThreadId:

xmlGetThreadId() find the current thread ID number Note that this is likely to be broken on some platforms using pthreads as the specification doesn't mandate pthread_t to be an integer type

Returns the current thread ID number

void xmlInitThreads

(

void

)

xmlInitThreads:

xmlInitThreads() is used to to initialize all the thread related data of the libxml2 library.

int xmlIsMainThread

(

void

)

xmlIsMainThread:

xmlIsMainThread() check whether the current thread is the main thread.

Returns 1 if the current thread is the main thread, 0 otherwise

void xmlLockLibrary

(

void

)

xmlLockLibrary:

xmlLockLibrary() is used to take out a re-entrant lock on the libxml2 library.

void xmlMutexLock

(

xmlMutexPtr

tok

)

xmlMutexLock: : the simple mutex

xmlMutexLock() is used to lock a libxml2 token.

void xmlMutexUnlock

(

xmlMutexPtr

tok

)

xmlMutexUnlock: : the simple mutex

xmlMutexUnlock() is used to unlock a libxml2 token.

xmlMutexPtr xmlNewMutex

(

void

)

xmlNewMutex:

xmlNewMutex() is used to allocate a libxml2 token struct for use in synchronizing access to data.

Returns a new simple mutex pointer or NULL in case of error

xmlRMutexPtr xmlNewRMutex

(

void

)

xmlNewRMutex:

xmlRNewMutex() is used to allocate a reentrant mutex for use in synchronizing access to data. token_r is a re-entrant lock and thus useful for synchronizing access to data structures that may be manipulated in a recursive fashion.

Returns the new reentrant mutex pointer or NULL in case of error

void xmlRMutexLock

(

xmlRMutexPtr

tok

)

xmlRMutexLock: : the reentrant mutex

xmlRMutexLock() is used to lock a libxml2 token_r.

void xmlRMutexUnlock

(

xmlRMutexPtr tok

ATTRIBUTE_UNUSED

)

xmlRMutexUnlock: : the reentrant mutex

xmlRMutexUnlock() is used to unlock a libxml2 token_r.

void xmlUnlockLibrary

(

void

)

xmlUnlockLibrary:

xmlUnlockLibrary() is used to release a re-entrant lock on the libxml2 library.