This library contains many useful functions and data structures. More...
|
Modules
- Dynamic strings
Dynamic strings were introduced to satisfy needs of presence modules when building presence documents.
- Memory management
Memory operations are common for whole CDS library.
- Message Queue
Message queue is a structure useful for sending data between processes.
- Reference counting
Experimental functions for reference counting (to simplify this code elsewhere).
Detailed Description
It is possible to use it with Sip Express Router (SER) or without it. In the first case it is able to use some internal SER's data types like strings.
Conventions
- data types (structures, enums, ...) have their names with suffix
_t(str_t,dstring_t, ...) - many functions have prefix according to data structure on which are operating (like dstr_append which operates on dstring_t data structure)
- most functions return 0 as successful result and nonzero value as error
Dependencies
This library depends only on standard C libraries and needs no other external libraries.
Usage with SER
There can be problems with using shared libraries on different platforms. Currently supported solution is that user must supply LD_LIBRARY_PATH (or something similar on his OS) with the path to the library before starting SER with modules needed the library.
Usage without SER
The library can be compiled without dependencies on SER and can be linked to whatever program as any other dynamic library. This style of usage is probably used only when debugging problems which is hard to find with SER (outside of SER is possible to use tools like Valgrind) and for author's little programs and need not to be documented more... ;-)
- History
- There were following reasons to introduce this library:
- many duplicated functions in modules (copy&pasted between modules) without touching SER's core
- possibility to debug programs outside of SER due to its simplicity and many usefull tools
