MPR Native API

The Multithreaded Portable Runtime (MPR) is a portable runtime library for embedded applications.

Description:

The MPR provides management for logging, error handling, events, files, http, memory, ssl, sockets, strings, xml parsing, and date/time functions. It also provides a foundation of safe routines for secure programming, that help to prevent buffer overflows and other security threats. The MPR is a library and a C API that can be used in both C and C++ programs.

The MPR uses a set extended typedefs for common types. These include: bool, cchar, cvoid, uchar, short, ushort, int, uint, long, ulong, int32, uint32, int64, uint64, float, and double. The cchar type is a const char, cvoid is const void. Several types have "u" prefixes to denote unsigned qualifiers.

The MPR includes a memory allocator and generational garbage collector. The allocator is a fast, immediate coalescing allocator that will return memory back to the O/S if not required. It is optimized for frequent allocations of small blocks (< 4K) and uses a scheme of free queues for fast allocation.

The MPR provides a high-performance thread-pool to share threads as required to service clients. When a client request arrives, the MPR allocates an event queue called a dispatcher. This dispatcher then serializes all activity for the request so that it essentially runs single-threaded This simplifies the code as most interactions do not need to be lock protected. When a request has activity, it borrows a thread from the thread pool, does its work and then returns the thread to the thread pool. This all happens very quickly, so a small pool of threads are effectivelyshared over many requests. Thread are free to block if required, but typically non-blocking patterns are more economical. If you have non-MPR threads that need to call into the MPR, you must synchronize such calls via mprCreateEvent.

Extensions

Mpr	Primary MPR application control structure.
MprBuf	Dynamic Buffer Module.
MprCache	In-memory caching.
MprCmd	Command execution Service.
MprDispatcher	Event Dispatcher.
MprEvent	Event object.
MprFile	File I/O Module.
MprFileSystem	File system service.
MprFloat	Floating Point Services.
MprHash	Hash table entry structure.
MprJson	JSON Object.
MprList	List data structure.
MprLog	Logging Services.
MprMem	Memory Allocation Service.
MprMime	Mime Type hash table entry (the URL extension is the key).
MprModule	Loadable Module Service.
MprModuleSerivce	Loadable module service.
MprPath	Path (filename) Information.
MprSignal	Signal control structure.
MprSocket	Socket Service.
MprSsl	SSL control structure.
MprString	Safe String Module.
MprSync	Multithreaded Synchronization Services.
MprThread	Thread Service.
MprTime	Date and Time Service.
MprWaitHandler	Wait Handler Service.
MprWorker	Worker thread structure.
MprXml	Per XML session structure.

Functions

PUBLIC void	assert(bool cond)
	Assert that a condition is true.
PUBLIC char*	fmt(char *buf, ssize maxSize, cchar *fmt, ...)
	Format a string into a static buffer.
PUBLIC char*	fmtv(char *buf, ssize maxSize, cchar *fmt, va_list args)
	Format a string into a statically allocated buffer.
PUBLIC char*	itos(int64 value)
	Convert an integer to a string.
PUBLIC char*	itosbuf(char *buf, ssize size, int64 value, int radix)
	Convert an integer to a string buffer.
PUBLIC char*	itosradix(int64 value, int radix)
	Convert an integer to a string.
PUBLIC MprSocket*	mprAcceptSocket(MprSocket *listen)
	Accept an incoming connection.
PUBLIC MprKey*	mprAddDuplicateKey(MprHash *table, cvoid *key, cvoid *ptr)
	Add a duplicate symbol value into the hash table.
PUBLIC void	mprAddFileSystem(MprFileSystem *fs)
	Create and initialize the disk FileSystem.
PUBLIC int	mprAddItem(MprList *list, cvoid *item)
	Add an item to a list.
PUBLIC MprKey*	mprAddKey(MprHash *table, cvoid *key, cvoid *ptr)
	Add a symbol value into the hash table.
PUBLIC MprKey*	mprAddKeyFmt(MprHash *table, cvoid *key, cchar *fmt, ...)
	Add a key with a formatting value into the hash table.
PUBLIC MprKey*	mprAddKeyWithType(MprHash *table, cvoid *key, cvoid *ptr, int type)
	Add a symbol value into the hash table and set the key type.
PUBLIC MprMime*	mprAddMime(MprHash *table, cchar *ext, cchar *mimeType)
	Add a mime type to the mime type table.
PUBLIC int	mprAddNullItem(MprList *list)
	Add a null item to the list.
PUBLIC void	mprAddNullToBuf(MprBuf *buf)
	Add a null character to the buffer contents.
PUBLIC void	mprAddRoot(cvoid *ptr)
	Add a memory block as a root for garbage collection.
PUBLIC MprSignal*	mprAddSignalHandler(int signo, void *handler, void *arg, MprDispatcher *dispatcher, int flags)
	Add a signal handler.
PUBLIC MprWaitHandler*	mprAddSocketHandler(MprSocket *sp, int mask, MprDispatcher *dispatcher, void *proc, void *data, int flags)
	Add a wait handler to a socket.
PUBLIC void	mprAddSslCiphers(struct MprSsl *ssl, cchar *ciphers)
	Add the ciphers to use for SSL.
PUBLIC void	mprAddStandardSignals(void)
	Add standard trapping of system signals.
PUBLIC void	mprAddTerminator(MprTerminator terminator)
	Add a service terminator.
PUBLIC void	mprAdjustBufEnd(MprBuf *buf, ssize count)
	Adjust the buffer end position.
PUBLIC void	mprAdjustBufStart(MprBuf *buf, ssize count)
	Adjust the buffer start position.
PUBLIC void*	mprAlloc(size_t size)
	Allocate a block of memory.
PUBLIC void*	mprAllocMem(size_t size, int flags)
	Allocate a block of memory.
PUBLIC void*	mprAllocObj(Type type, MprManager manager)
	Allocate an object of a given type.
PUBLIC void*	mprAllocObjWithFlags(Type type, MprManager manager, int flags)
	Allocate an object of a given type.
PUBLIC void*	mprAllocZeroed(size_t size)
	Allocate a zeroed block of memory.
PUBLIC MprList*	mprAppendList(MprList *list, MprList *add)
	Append a list.
PUBLIC bool	mprAreCmdEventsEnabled(MprCmd *cmd, int channel)
	Return true if command events are enabled.
PUBLIC void	mprAssert(cchar *loc, cchar *msg)
	Output an assure assertion failed message.
PUBLIC void	mprAtomicAdd(volatile int *target, int value)
	Atomic Add.
PUBLIC void	mprAtomicAdd64(volatile int64 *target, int64 value)
	Atomic 64 bit Add.
PUBLIC void	mprAtomicBarrier(int model)
	Apply a full (read+write) memory barrier.
PUBLIC int	mprAtomicCas(void *volatile *target, void *expected, cvoid *value)
	Atomic Compare and Swap.
PUBLIC void	mprAtomicListInsert(void **head, void **link, void *item)
	Atomic list insertion.
PUBLIC void	mprAtomicOpen(void)
	Open and initialize the atomic subystem.
PUBLIC MprFile*	mprAttachFileFd(int fd, cchar *name, int omode)
	Attach to an existing file descriptor.
PUBLIC int	mprAvailableWorkers(void)
	Get the count of available worker threads Return the count of free threads in the worker thread pool.
PUBLIC int	mprBackupLog(cchar *path, int count)
	Backup a log.
PUBLIC MprHash*	mprBlendHash(MprHash *target, MprHash *other)
	Blend two hash tables.
PUBLIC int	mprBlendJson(MprJson *dest, MprJson *src, int flags)
	Blend two JSON objects.
PUBLIC void	mprBreakpoint(void)
	Trigger a breakpoint.
PUBLIC char*	mprBufToString(MprBuf *buf)
	Convert the buffer contents to a string.
PUBLIC bool	mprCancelShutdown(void)
	Cancel a shutdown request.
PUBLIC bool	mprCheckPassword(cchar *plainTextPassword, cchar *passwordHash)
	Check a plain-text password against the defined hashed password.
PUBLIC void	mprClearList(MprList *list)
	Clears the list of all items.
PUBLIC void	mprClearWaiting(void)
	Clear the event service waiting flag.
PUBLIC MprBuf*	mprCloneBuf(MprBuf *orig)
	Clone a buffer.
PUBLIC char*	mprCloneBufAsString(MprBuf *bp)
	Clone a buffer contents.
PUBLIC char*	mprCloneBufMem(MprBuf *bp)
	Clone a buffer contents.
PUBLIC MprHash*	mprCloneHash(MprHash *table)
	Copy a hash table.
PUBLIC MprJson*	mprCloneJson(MprJson *obj)
	Clone a JSON object.
PUBLIC MprList*	mprCloneList(MprList *src)
	Clone a list and all elements.
PUBLIC MprSocket*	mprCloneSocket(MprSocket *sp)
	Clone a socket object.
PUBLIC struct,MprSsl*	mprCloneSsl(MprSsl *src)
	Create the a new SSL control structure based on an existing structure.
PUBLIC void	mprCloseCmdFd(MprCmd *cmd, int channel)
	Close the command channel.
PUBLIC int	mprCloseFile(MprFile *file)
	Close a file.
PUBLIC void	mprCloseSocket(MprSocket *sp, bool graceful)
	Close a socket.
PUBLIC void	mprCompactBuf(MprBuf *buf)
	Compact the buffer contents.
PUBLIC int	mprCompareTime(MprTime t1, MprTime t2)
	Compare two times.
PUBLIC int	mprConnectSocket(MprSocket *sp, cchar *ip, int port, int flags)
	Connect a client socket.
PUBLIC int	mprCopyListContents(MprList *dest, MprList *src)
	Copy list contents.
PUBLIC int	mprCopyPath(cchar *from, cchar *to, int omode)
	Copy a file.
PUBLIC Mpr*	mprCreate(int argc, char **argv, int flags)
	Initialize the application by creating an instance of the MPR.
PUBLIC MprBuf*	mprCreateBuf(ssize initialSize, ssize maxSize)
	Create a new buffer.
PUBLIC MprCache*	mprCreateCache(int options)
	Create a new cache object.
PUBLIC int	mprCreateCacheService(void)
	Initialize the cache service on startup.
PUBLIC MprCmd*	mprCreateCmd(MprDispatcher *dispatcher)
	Create a new Command object.
PUBLIC MprCond*	mprCreateCond(void)
	Create a condition lock variable.
PUBLIC MprDiskFileSystem*	mprCreateDiskFileSystem(cchar *path)
	Create and initialize the disk FileSystem.
PUBLIC MprDispatcher*	mprCreateDispatcher(cchar *name, int flags)
	Create a new event dispatcher.
PUBLIC MprEvent*	mprCreateEvent(MprDispatcher *dispatcher, cchar *name, MprTicks period, void *proc, void *data, int flags)
	Queue an new event on a dispatcher.
PUBLIC MprHash*	mprCreateHash(int hashSize, int flags)
	Create a hash table.
PUBLIC MprHash*	mprCreateHashFromWords(cchar *str)
	Create a hash of words.
PUBLIC void	mprCreateIOEvent(MprDispatcher *dispatcher, void *proc, void *data, struct MprWaitHandler *wp, struct MprSocket *sock)
	Create and queue an IO event for a wait handler.
PUBLIC MprJson*	mprCreateJson(int type)
	Create a JSON object.
PUBLIC MprJson*	mprCreateJsonValue(cchar *value, int type)
	Create a JSON object value.
PUBLIC MprKeyValue*	mprCreateKeyPair(cchar *key, cchar *value, int flags)
	Create a key / value pair.
PUBLIC MprList*	mprCreateList(int size, int flags)
	Create a list.
PUBLIC MprList*	mprCreateListFromWords(cchar *str)
	Create a list of words.
PUBLIC MprEvent*	mprCreateLocalEvent(MprDispatcher *dispatcher, cchar *name, MprTicks period, void *proc, void *data, int flags)
	Optimized variety of mprCreateEvent for use by local MPR threads only.
PUBLIC MprMutex*	mprCreateLock(void)
	Create a Mutex lock object.
PUBLIC void	mprCreateLogService(void)
	Initialize the log service.
PUBLIC struct,Mpr*	mprCreateMemService(MprManager manager, int flags)
	Create and initialize the Memory service.
PUBLIC MprHash*	mprCreateMimeTypes(cchar *path)
	Create the mime types.
PUBLIC MprModule*	mprCreateModule(cchar *name, cchar *path, cchar *entry, void *data)
	Create a module.
PUBLIC MprModuleService*	mprCreateModuleService(void)
	Create and initialize the module service.
PUBLIC int	mprCreateNotifierService(MprWaitService *ws)
	Internal.
PUBLIC int	mprCreateOsService(void)
	Create and initialze the O/S dependent subsystem.
PUBLIC MprRomFileSystem*	mprCreateRomFileSystem(cchar *path, MprRomInode *inodes)
	Create and initialize the ROM FileSystem.
PUBLIC MprSocket*	mprCreateSocket(void)
	Create a socket.
PUBLIC MprSpin*	mprCreateSpinLock(void)
	Create a spin lock lock object.
PUBLIC struct,MprSsl*	mprCreateSsl(int server)
	Create the SSL control structure.
PUBLIC MprThread*	mprCreateThread(cchar *name, void *proc, void *data, ssize stackSize)
	Create a new thread.
PUBLIC int	mprCreateTimeService(void)
	Mpr time structure.
PUBLIC MprEvent*	mprCreateTimerEvent(MprDispatcher *dispatcher, cchar *name, MprTicks period, void *proc, void *data, int flags)
	Create a timer event.
PUBLIC MprWaitHandler*	mprCreateWaitHandler(int fd, int mask, MprDispatcher *dispatcher, void *proc, void *data, int flags)
	Create a wait handler.
PUBLIC char*	mprCryptPassword(cchar *password, cchar *salt, int rounds)
	Encrypt a password using the Blowfish algorithm.
PUBLIC int	mprDaemon(void)
	Convert the process into a daemon on unix systems.
PUBLIC void	mprDebug(cchar *tags, int level, cchar *fmt, ...)
	Write a log message to the log file when the product is built in debug mode.
PUBLIC char*	mprDecode64(cchar *str)
	Decode a null terminated string using base-46 encoding.
PUBLIC char*	mprDecode64Block(cchar *buf, ssize *len, int flags)
	Decode a null terminated string using base-46 encoding.
PUBLIC void	mprDecodeLocalTime(struct tm *timep, MprTime time)
	Decode a time value into a tokenized local time value.
PUBLIC void	mprDecodeUniversalTime(struct tm *timep, MprTime time)
	Decode a time value into a tokenized UTC time structure.
PUBLIC void	mprDedicateWorker(MprWorker *worker)
	Dedicate a worker thread to a current real thread.
PUBLIC void	mprDefaultLogHandler(cchar *tags, int level, cchar *msg)
	Default MPR log handler.
PUBLIC int	mprDeletePath(cchar *path)
	Delete a file.
PUBLIC MprHash*	mprDeserialize(cchar *str)
	Deserialize a simple JSON string and return a hash of properties.
PUBLIC MprHash*	mprDeserializeInto(cchar *str, MprHash *hash)
	Deserialize a simple JSON string into the given hash object.
PUBLIC bool	mprDestroy(void)
	Destroy the MPR and all services using the MPR.
PUBLIC void*	mprDestroyCache(MprCache *cache)
	Destroy a new cache object.
PUBLIC void	mprDestroyCmd(MprCmd *cmd)
	Destroy the command.
PUBLIC void	mprDestroyDispatcher(MprDispatcher *dispatcher)
	Disable a dispatcher from service events.
PUBLIC void	mprDestroyWaitHandler(MprWaitHandler *wp)
	Destroy a wait handler.
PUBLIC void	mprDisableCmdEvents(MprCmd *cmd, int channel)
	Disable command I/O events.
PUBLIC void	mprDisableFileBuffering(MprFile *file)
	Disable file buffering.
PUBLIC void	mprDisconnectCmd(MprCmd *cmd)
	Disconnect a command its underlying I/O channels.
PUBLIC void	mprDisconnectSocket(MprSocket *sp)
	Disconnect a socket by closing its underlying file descriptor.
PUBLIC char*	mprEmptyString(void)
	Reference to a permanent preallocated empty string.
PUBLIC void	mprEnableCmdEvents(MprCmd *cmd, int channel)
	Enable command I/O events.
PUBLIC void	mprEnableCmdOutputEvents(MprCmd *cmd, bool on)
	Enable command I/O events for the command's STDOUT and STDERR channels.
PUBLIC void	mprEnableContinuousEvent(MprEvent *event, int enable)
	Enable or disable an event being continous.
PUBLIC int	mprEnableFileBuffering(MprFile *file, ssize size, ssize maxSize)
	Enable file buffering.
PUBLIC bool	mprEnableGC(bool on)
	Enable or disable the garbage collector.
PUBLIC void	mprEnableSocketEvents(MprSocket *sp, int mask)
	Enable socket events for a socket callback.
PUBLIC char*	mprEncode64(cchar *str)
	Encode a string using base-46 encoding.
PUBLIC char*	mprEncode64Block(cchar *buf, ssize len)
	Encode buffer using base-46 encoding.
PUBLIC ssize	mprEprintf(cchar *fmt, ...)
	Print a formatted message to the standard error channel.
PUBLIC void	mprError(cchar *fmt, ...)
	Log an error message.
PUBLIC char*	mprEscapeCmd(cchar *cmd, int escChar)
	Encode a string escaping typical command (shell) characters.
PUBLIC char*	mprEscapeHtml(cchar *html)
	Encode a string by escaping typical HTML characters.
PUBLIC char*	mprEscapeSQL(cchar *cmd)
	Encode a string by escaping SQL special characters.
PUBLIC int	mprExpireCacheItem(MprCache *cache, cchar *key, MprTicks expires)
	Set the expiry date for a cache item.
PUBLIC void	mprFinalizeCmd(MprCmd *cmd)
	Finalize the writing of data to the command process.
PUBLIC void	mprFlushBuf(MprBuf *buf)
	Flush the buffer contents.
PUBLIC int	mprFlushFile(MprFile *file)
	Flush any buffered write data.
PUBLIC ssize	mprFlushSocket(MprSocket *sp)
	Flush a socket.
PUBLIC void	mprFormatJsonName(MprBuf *buf, cchar *name, int flags)
	Format a JSON name into and output buffer.
PUBLIC void	mprFormatJsonString(MprBuf *buf, cchar *value)
	Format a string as a JSON string.
PUBLIC void	mprFormatJsonValue(MprBuf *buf, int type, cchar *value, int flags)
	Format a value as a simple JSON string.
PUBLIC char*	mprFormatLocalTime(cchar *fmt, MprTime time)
	Convert a time value to local time and format as a string.
PUBLIC char*	mprFormatTm(cchar *fmt, struct tm *timep)
	Format a time value as a local time.
PUBLIC char*	mprFormatUniversalTime(cchar *fmt, MprTime time)
	Convert a time value to universal time and format as a string.
PUBLIC ssize	mprFprintf(struct MprFile *file, cchar *fmt, ...)
	Print a formatted message to a file descriptor.
PUBLIC int	mprGC(int flags)
	Collect garbage.
PUBLIC char*	mprGetAbsPath(cchar *path)
	Convert a path to an absolute path.
PUBLIC ssize	mprGetActiveCmdCount(void)
	Get the count of active commands.
PUBLIC cchar*	mprGetAppDir(void)
	Get the application directory.
PUBLIC cchar*	mprGetAppName(void)
	Get the application name defined via mprSetAppName.
PUBLIC cchar*	mprGetAppPath(void)
	Get the application executable path.
PUBLIC cchar*	mprGetAppTitle(void)
	Get the application title string.
PUBLIC cchar*	mprGetAppVersion(void)
	Get the application version string.
PUBLIC ssize	mprGetBlockFromBuf(MprBuf *buf, char *blk, ssize count)
	Get a block of data from the buffer.
PUBLIC size_t	mprGetBlockSize(cvoid *ptr)
	Get the allocated size of a memory block.
PUBLIC char*	mprGetBuf(MprBuf *buf)
	Get the origin of the buffer content storage.
PUBLIC char*	mprGetBufEnd(MprBuf *buf)
	Get a reference to the end of the buffer contents.
PUBLIC ssize	mprGetBufLength(MprBuf *buf)
	Get the buffer content length.
PUBLIC MprBufProc	mprGetBufRefillProc(MprBuf *buf)
	Get the buffer refill procedure.
PUBLIC ssize	mprGetBufSize(MprBuf *buf)
	Get the current size of the buffer content storage.
PUBLIC ssize	mprGetBufSpace(MprBuf *buf)
	Get the space available to store content.
PUBLIC char*	mprGetBufStart(MprBuf *buf)
	Get the start of the buffer contents.
PUBLIC ssize	mprGetBusyWorkerCount(void)
	Get the count of workers in the busy queue.
PUBLIC uint64	mprGetCPU(void)
	Return the process CPU usage.
PUBLIC void	mprGetCacheStats(MprCache *cache, int *numKeys, ssize *mem)
	Get the Cache statistics.
PUBLIC int	mprGetCharFromBuf(MprBuf *buf)
	Get a character from the buffer.
PUBLIC MprBuf*	mprGetCmdBuf(MprCmd *cmd, int channel)
	Get the underlying buffer for a channel.
PUBLIC int	mprGetCmdExitStatus(MprCmd *cmd)
	Get the command exit status.
PUBLIC int	mprGetCmdFd(MprCmd *cmd, int channel)
	Get the underlying file descriptor for an I/O channel.
PUBLIC bool	mprGetCmdlineLogging(void)
	Get if command line logging is being used.
PUBLIC MprOsThread	mprGetCurrentOsThread(void)
	Get the O/S thread.
PUBLIC cchar*	mprGetCurrentPath(void)
	Return the current working directory.
PUBLIC MprThread*	mprGetCurrentThread(void)
	Get the currently executing thread.
PUBLIC cchar*	mprGetCurrentThreadName(void)
	Return the name of the current thread.
PUBLIC MprWorker*	mprGetCurrentWorker(void)
	Get the worker object if the current thread is actually a worker thread.
PUBLIC char*	mprGetDate(char *fmt)
	Get a string representation of the current date/time.
PUBLIC bool	mprGetDebugMode(void)
	Get the debug mode.
PUBLIC MprDispatcher*	mprGetDispatcher(void)
	Get the MPR primary dispatcher.
PUBLIC cchar*	mprGetDomainName(void)
	Get the application domain name string.
PUBLIC MprTicks	mprGetElapsedTicks(MprTicks mark)
	Get the elapsed time since a ticks mark.
PUBLIC MprTime	mprGetElapsedTime(MprTime mark)
	Get the elapsed time since a starting time mark.
PUBLIC int	mprGetEndian(void)
	Return the endian byte ordering for the application.
PUBLIC int	mprGetError(void)
	Return the error code for the most recent system or library operation.
PUBLIC int64	mprGetEventMark(MprDispatcher *dispatcher)
	Get an event mark for a dispatcher.
PUBLIC int	mprGetExitStatus(void)
	Get the exit status.
PUBLIC int	mprGetFileChar(MprFile *file)
	Read a character from the file.
PUBLIC int	mprGetFileFd(MprFile *file)
	Get the file descriptor for a file.
PUBLIC MprOff	mprGetFilePosition(MprFile *file)
	Return the current file position.
PUBLIC MprOff	mprGetFileSize(MprFile *file)
	Get the size of the file.
PUBLIC void*	mprGetFirstItem(MprList *list)
	Get the first item in the list.
PUBLIC MprKey*	mprGetFirstKey(MprHash *table)
	Return the first symbol in a symbol entry.
PUBLIC cchar*	mprGetFirstPathSeparator(cchar *path)
	Get the first path separator in a path.
PUBLIC int	mprGetHashLength(MprHash *table)
	Return the count of symbols in a symbol entry.
PUBLIC uint64	mprGetHiResTicks(void)
	Get the CPU tick count.
PUBLIC cchar*	mprGetHostName(void)
	Get the application host name string.
PUBLIC cchar*	mprGetIpAddr(void)
	Get the application IP address string.
PUBLIC void*	mprGetItem(MprList *list, int index)
	Get an list item.
PUBLIC cchar*	mprGetJson(MprJson *obj, cchar *key)
	Get a JSON key and return a string value.
PUBLIC ssize	mprGetJsonLength(MprJson *obj)
	Get the number of child properties in a JSON object.
PUBLIC MprJson*	mprGetJsonObj(MprJson *obj, cchar *key)
	Get a parsed JSON object for a key value.
PUBLIC void*	mprGetKey(cchar *key)
	Get a key value.
PUBLIC void*	mprGetLastItem(MprList *list)
	Get the last item in the list.
PUBLIC int	mprGetListCapacity(MprList *list)
	Get the current capacity of the list.
PUBLIC int	mprGetListLength(MprList *list)
	Get the number of items in the list.
PUBLIC struct,MprFile*	mprGetLogFile(void)
	Get the log file object.
PUBLIC MprLogHandler	mprGetLogHandler(void)
	Get the current MPR debug log handler.
PUBLIC int	mprGetLogLevel(void)
	Get the current logging level.
PUBLIC char*	mprGetMD5(cchar *str)
	Get an MD5 checksum.
PUBLIC char*	mprGetMD5WithPrefix(cchar *buf, ssize len, cchar *prefix)
	Get an MD5 checksum with optional prefix string and buffer length.
PUBLIC int	mprGetMaxWorkers(void)
	Get the maximum count of worker pool threads Get the maximum limit of worker pool threads.
PUBLIC size_t	mprGetMem(void)
	Return the amount of memory currently used by the application.
PUBLIC MprMemStats*	mprGetMemStats(void)
	Return the current allocation memory statistics block.
PUBLIC cchar*	mprGetMimeProgram(MprHash *table, cchar *mimeType)
	Get the mime type program for a given mimeType.
PUBLIC cchar*	mprGetModuleSearchPath(void)
	Get the module search path.
PUBLIC Mpr*	mprGetMpr(void)
	Return the MPR control instance.
PUBLIC char*	mprGetNativePath(cchar *path)
	Get a path formatted according to the native O/S conventions.
PUBLIC void*	mprGetNextItem(MprList *list, int *lastIndex)
	Get the next item in the list.
PUBLIC MprKey*	mprGetNextKey(MprHash *table, MprKey *last)
	Return the next symbol in a symbol entry.
PUBLIC void*	mprGetNextStableItem(MprList *list, int *lastIndex)
	Get the next item in a stable list.
PUBLIC int	mprGetOsError(void)
	Return the O/S error code.
PUBLIC int	mprGetPageSize(void)
	Get the current O/S virtual page size.
PUBLIC char*	mprGetPassword(cchar *prompt)
	Get a password from the terminal console.
PUBLIC char*	mprGetPathBase(cchar *path)
	Get the base portion of a path.
PUBLIC cchar*	mprGetPathBaseRef(cchar *path)
	Get a reference to the base portion of a path.
PUBLIC char*	mprGetPathDir(cchar *path)
	Get the directory portion of a path.
PUBLIC char*	mprGetPathExt(cchar *path)
	Get the file extension portion of a path.
PUBLIC MprList*	mprGetPathFiles(cchar *dir, int flags)
	Create a list of files in a directory or subdirectories.
PUBLIC char*	mprGetPathFirstDir(cchar *path)
	Get the first directory portion of a path.
PUBLIC int	mprGetPathInfo(cchar *path, MprPath *info)
	Return information about a file represented by a path.
PUBLIC char*	mprGetPathLink(cchar *path)
	Get the target of a symbolic link.
PUBLIC cchar*	mprGetPathNewline(cchar *path)
	Get the file newline character string for a given path.
PUBLIC char*	mprGetPathParent(cchar *path)
	Get the parent directory of a path.
PUBLIC char	mprGetPathSeparator(cchar *path)
	Get the default path directory separator.
PUBLIC cchar*	mprGetPathSeparators(cchar *path)
	Get the path directory separator.
PUBLIC char*	mprGetPortablePath(cchar *path)
	Get a portable path.
PUBLIC void*	mprGetPrevItem(MprList *list, int *lastIndex)
	Get the previous item in the list.
PUBLIC int	mprGetRandomBytes(char *buf, ssize size, bool block)
	Get some random data.
PUBLIC char*	mprGetRandomString(ssize size)
	Get some random data in ascii.
PUBLIC char*	mprGetRelPath(cchar *dest, cchar *origin)
	Get a path relative to another path.
PUBLIC MprTicks	mprGetRemainingTicks(MprTicks mark, MprTicks timeout)
	Return the time remaining until a timeout has elapsed.
PUBLIC MprRomInode*	mprGetRomFiles(void)
	Get the ROM file system data.
PUBLIC char*	mprGetSHA(cchar *str)
	Get an SHA1 checksum.
PUBLIC char*	mprGetSHABase64(cchar *str)
	Get an SHA1 checksum of a null terminated string.
PUBLIC char*	mprGetSHAWithPrefix(cchar *buf, ssize len, cchar *prefix)
	Get an SHA1 checksum with optional prefix string and buffer length.
PUBLIC cchar*	mprGetServerName(void)
	Get the application server name string.
PUBLIC bool	mprGetSocketBlockingMode(MprSocket *sp)
	Get the socket blocking mode.
PUBLIC int	mprGetSocketError(MprSocket *sp)
	Get a socket error code.
PUBLIC Socket	mprGetSocketHandle(MprSocket *sp)
	Get the socket file descriptor.
PUBLIC int	mprGetSocketInfo(cchar *ip, int port, int *family, int *protocol, struct sockaddr **addr, Socklen *addrlen)
	Get the socket for an IP:Port address.
PUBLIC int	mprGetSocketPort(MprSocket *sp)
	Get the port used by a socket.
PUBLIC char*	mprGetSocketState(MprSocket *sp)
	Get the socket state.
PUBLIC int	mprGetState(void)
	Get the MPR execution state.
PUBLIC MprFile*	mprGetStderr(void)
	Return a file object for the Stderr I/O channel.
PUBLIC MprFile*	mprGetStdin(void)
	Return a file object for the Stdin I/O channel.
PUBLIC MprFile*	mprGetStdout(void)
	Return a file object for the Stdout I/O channel.
PUBLIC char*	mprGetTempPath(cchar *tmpDir)
	Make a temporary file.
PUBLIC cchar*	mprGetThreadName(MprThread *thread)
	Get the thread name.
PUBLIC MprTicks	mprGetTicks(void)
	Get the system time.
PUBLIC MprTime	mprGetTime(void)
	Get the time.
PUBLIC int	mprGetTimeZoneOffset(MprTime when)
	Get the current timezone offset for a given time.
PUBLIC char*	mprGetWinPath(cchar *path)
	Convert a path to an absolute windows path.
PUBLIC void	mprGetWorkerStats(MprWorkerStats *stats)
	Get the Worker service statistics.
PUBLIC MprList*	mprGlobPathFiles(cchar *path, cchar *patterns, int flags)
	Create a list of files in a directory or subdirectories that match the given wildcard pattern.
PUBLIC void	mprGlobalLock(void)
	Globally lock the application.
PUBLIC void	mprGlobalUnlock(void)
	Unlock the global mutex.
PUBLIC int	mprGrowBuf(MprBuf *buf, ssize count)
	Grow the buffer.
PUBLIC bool	mprHasDualNetworkStack(void)
	has the system got a dual IPv4 + IPv6 network stack.
PUBLIC bool	mprHasIPv6(void)
	Determine if the system support IPv6.
PUBLIC bool	mprHasMemError(void)
	Determine if the MPR has encountered memory allocation errors.
PUBLIC bool	mprHasSecureSockets(void)
	Determine if SSL is available.
PUBLIC char*	mprHashKeysToString(MprHash *hash, cchar *join)
	Convert hash keys to a single string.
PUBLIC MprJson*	mprHashToJson(MprHash *hash)
	Convert a hash object into a JSON object.
PUBLIC char*	mprHashToString(MprHash *hash, cchar *join)
	Convert a hash of strings to a single string.
PUBLIC void	mprHiddenSocketData(MprSocket *sp, ssize len, int dir)
	Indicate that the application layer has buffered data for the socket.
PUBLIC void	mprHold(cvoid *ptr)
	Hold a memory block.
PUBLIC void	mprHoldBlocks(cvoid *ptr, ...)
	Hold memory blocks.
PUBLIC int64	mprIncCache(MprCache *cache, cchar *key, int64 amount)
	Increment a numeric cache item.
PUBLIC void	mprInitFileSystem(MprFileSystem *fs, cchar *path)
	Create and initialize the FileSystem subsystem.
PUBLIC void	mprInitList(MprList *list, int flags)
	Initialize a list structure.
PUBLIC MprMutex*	mprInitLock(MprMutex *mutex)
	Initialize a statically allocated Mutex lock object.
PUBLIC MprSpin*	mprInitSpinLock(MprSpin *lock)
	Initialize a statically allocated spinlock object.
PUBLIC int	mprInsertCharToBuf(MprBuf *buf, int c)
	Insert a character into the buffer.
PUBLIC int	mprInsertItemAtPos(MprList *list, int index, cvoid *item)
	Insert an item into a list at a specific position.
PUBLIC bool	mprIsAbsPathContained(cchar *path, cchar *dir)
	Fast version of mprIsPathContained that works only for absolute paths.
PUBLIC int	mprIsCmdComplete(MprCmd *cmd)
	Test if a command is complete.
PUBLIC bool	mprIsCmdRunning(MprCmd *cmd)
	Test if the command is still running.
PUBLIC bool	mprIsDestroyed(void)
	Determine if the MPR has finished.
PUBLIC bool	mprIsDestroying(void)
	Test if the application is terminating and core services are being destroyed All request should immediately terminate.
PUBLIC bool	mprIsIPv6(cchar *ip)
	Determine if the IP address is an IPv6 address.
PUBLIC bool	mprIsIdle(bool traceRequests)
	Determine if the App is idle.
PUBLIC int	mprIsInfinite(double value)
	Test if a double value is infinte.
PUBLIC int	mprIsNan(double value)
	Test if a double value is not-a-number.
PUBLIC bool	mprIsPathAbs(cchar *path)
	Determine if a path is absolute.
PUBLIC bool	mprIsPathContained(cchar *path, cchar *dir)
	Determine if a directory is the same as or a parent of a path.
PUBLIC bool	mprIsPathDir(cchar *path)
	Determine if a path is a directory.
PUBLIC bool	mprIsPathRel(cchar *path)
	Determine if a path is relative.
PUBLIC bool	mprIsPathSeparator(cchar *path, cchar c)
	Test if a character is a path separarator.
PUBLIC bool	mprIsSocketEof(MprSocket *sp)
	Test if the other end of the socket has been closed.
PUBLIC bool	mprIsSocketSecure(MprSocket *sp)
	Determine if the socket is secure.
PUBLIC bool	mprIsSocketV6(MprSocket *sp)
	Determine if the socket is using IPv6 Currently only works for server side addresses.
PUBLIC bool	mprIsStopped(void)
	Test if the application is stopped If this routine returns true, the application shutdown has passed the point of no return.
PUBLIC bool	mprIsStopping(void)
	Test if the application is stopping If mprIsStopping is true, the application has commenced a shutdown.
PUBLIC int	mprIsValid(cvoid *ptr)
	Test is a pointer is a valid memory context.
PUBLIC int	mprIsZero(double value)
	Test if a double value is zero.
PUBLIC char*	mprJoinPath(cchar *base, cchar *path)
	Join paths.
PUBLIC char*	mprJoinPathExt(cchar *path, cchar *ext)
	Join an extension to a path.
PUBLIC char*	mprJoinPaths(cchar *base, ...)
	Join paths.
PUBLIC MprList*	mprJsonToEnv(MprJson *json, cchar *prefix, MprList *list)
	Convert a JSON object to a string of environment variables.
PUBLIC MprHash*	mprJsonToHash(MprJson *json)
	Convert a JSON object into a Hash object.
PUBLIC char*	mprJsonToString(MprJson *obj, int flags)
	Serialize a JSON object into a string.
PUBLIC char*	mprListToString(MprList *list, cchar *join)
	Convert a list of strings to a single string.
PUBLIC Socket	mprListenOnSocket(MprSocket *sp, cchar *ip, int port, int flags)
	Listen on a server socket for incoming connections.
PUBLIC MprJson*	mprLoadJson(cchar *path)
	Load a JSON object from a filename.
PUBLIC int	mprLoadModule(MprModule *mp)
	Load a module.
PUBLIC int	mprLoadNativeModule(MprModule *mp)
	Load a native module.
PUBLIC int	mprLoadSsl(void)
	Load the SSL module.
PUBLIC void	mprLog(cchar *tags, int level, cchar *fmt, ...)
	Write a message to the error log file.
PUBLIC void	mprLogConfig(void)
	Show the product configuration at the start of the log file.
PUBLIC void	mprLogJson(int level, MprJson *obj, cchar *fmt, ...)
	Trace the JSON object to the debug log.
PUBLIC int	mprLookAtLastCharInBuf(MprBuf *buf)
	Peek at the last character in the buffer.
PUBLIC int	mprLookAtNextCharInBuf(MprBuf *buf)
	Peek at the next character in the buffer.
PUBLIC char*	mprLookupCache(MprCache *cache, cchar *key, MprTime *modified, int64 *version)
	Lookup an item in the cache.
PUBLIC MprFileSystem*	mprLookupFileSystem(cchar *path)
	Lookup a file system.
PUBLIC int	mprLookupItem(MprList *list, cvoid *item)
	Find an item and return its index.
PUBLIC void*	mprLookupKey(MprHash *table, cvoid *key)
	Lookup a symbol in the hash table.
PUBLIC MprKey*	mprLookupKeyEntry(MprHash *table, cvoid *key)
	Lookup a symbol in the hash table and return the hash entry.
PUBLIC cchar*	mprLookupMime(MprHash *table, cchar *ext)
	Get the mime type for an extension.
PUBLIC MprModule*	mprLookupModule(cchar *name)
	Lookup a module.
PUBLIC void*	mprLookupModuleData(cchar *name)
	Lookup a module and return the module data.
PUBLIC int	mprLookupStringItem(MprList *list, cchar *str)
	Find a string item and return its index.
PUBLIC int	mprMakeArgv(cchar *command, cchar ***argv, int flags)
	Make a argv style array of command arguments.
PUBLIC int	mprMakeDir(cchar *path, int perms, int owner, int group, bool makeMissing)
	Make a directory.
PUBLIC int	mprMakeLink(cchar *path, cchar *target, bool hard)
	Make a link.
PUBLIC char*	mprMakePassword(cchar *password, int saltLength, int rounds)
	Make a password hash for a plain-text password using the Blowfish algorithm.
PUBLIC char*	mprMakeSalt(ssize size)
	Make salt for adding to a password.
PUBLIC void	mprMapSeparators(char *path, int separator)
	Map the separators in a path.
PUBLIC void	mprMark(void *ptr)
	Mark a memory block as in-use.
PUBLIC int	mprMemcmp(cvoid *b1, size_t b1Len, cvoid *b2, size_t b2Len)
	Compare two byte strings.
PUBLIC size_t	mprMemcpy(void *dest, size_t destMax, cvoid *src, size_t nbytes)
	Safe copy for a block of data.
PUBLIC void*	mprMemdup(cvoid *ptr, size_t size)
	Duplicate a block of memory.
PUBLIC void	mprNap(MprTicks msec)
	Nap for a while.
PUBLIC bool	mprNeedYield(void)
	Test if a thread should call mprYield.
PUBLIC char*	mprNormalizePath(cchar *path)
	Normalize a path.
PUBLIC int	mprNotifyOn(MprWaitHandler *wp, int mask)
	Begin I/O notification services on a wait handler.
PUBLIC MprFile*	mprOpenFile(cchar *filename, int omode, int perms)
	Open a file.
PUBLIC int	mprParseArgs(char *command, char **argv, int maxArgs)
	Make a argv style array of command arguments.
PUBLIC MprJson*	mprParseJson(cchar *str)
	Parse a JSON string into an object tree.
PUBLIC MprJson*	mprParseJsonEx(cchar *str, MprJsonCallback *callback, void *data, MprJson *obj, cchar **errorMsg)
	Extended JSON parsing from a JSON string into an object tree.
PUBLIC MprJson*	mprParseJsonInto(cchar *str, MprJson *obj)
	Parse a JSON string into an existing object.
PUBLIC int	mprParseSocketAddress(cchar *address, cchar **ip, int *port, int *secure, int defaultPort)
	Parse an socket address IP address.
PUBLIC bool	mprPathExists(cchar *path, int omode)
	Determine if a file exists for a path name and can be accessed.
PUBLIC int	mprPeekFileChar(MprFile *file)
	Non-destructively read a character from the file.
PUBLIC void*	mprPopItem(MprList *list)
	Pop an item.
PUBLIC int	mprPreloadSsl(struct MprSsl *ssl, int flags)
	Preload SSL configuration.
PUBLIC void	mprPrintMem(cchar *msg, int flags)
	Print a memory usage report to stdout.
PUBLIC ssize	mprPrintf(cchar *fmt, ...)
	Formatted print.
PUBLIC char*	mprPrintfCore(char *buf, ssize maxsize, cchar *fmt, va_list args)
	Format a string into a buffer.
PUBLIC void	mprPruneCache(MprCache *cache)
	Prune the cache.
PUBLIC int	mprPushItem(MprList *list, cvoid *item)
	Push an item onto the list.
PUBLIC ssize	mprPutBlockToBuf(MprBuf *buf, cchar *ptr, ssize size)
	Put a block to the buffer.
PUBLIC int	mprPutCharToBuf(MprBuf *buf, int c)
	Put a character to the buffer.
PUBLIC ssize	mprPutFileChar(MprFile *file, int c)
	Write a character to the file.
PUBLIC ssize	mprPutFileString(MprFile *file, cchar *str)
	Write a string to the file.
PUBLIC ssize	mprPutIntToBuf(MprBuf *buf, int64 i)
	Put an integer to the buffer.
PUBLIC ssize	mprPutPadToBuf(MprBuf *buf, int c, ssize count)
	Put padding characters to the buffer.
PUBLIC ssize	mprPutStringToBuf(MprBuf *buf, cchar *str)
	Put a string to the buffer.
PUBLIC ssize	mprPutSubStringToBuf(MprBuf *buf, cchar *str, ssize count)
	Put a substring to the buffer.
PUBLIC ssize	mprPutToBuf(MprBuf *buf, cchar *fmt, ...)
	Put a formatted string to the buffer.
PUBLIC MprJson*	mprQueryJson(MprJson *obj, cchar *key, cchar *value, int type)
	Query a JSON object for a property key path and execute the given command.
PUBLIC void	mprQueueIOEvent(MprWaitHandler *wp)
	Queue an IO event for dispatch on the wait handler dispatcher.
PUBLIC int	mprRandom(void)
	Return a random number.
PUBLIC char*	mprReadCache(MprCache *cache, cchar *key, MprTime *modified, int64 *version)
	Read an item from the cache.
PUBLIC ssize	mprReadCmd(MprCmd *cmd, int channel, char *buf, ssize bufsize)
	Make the I/O channels to send and receive data to and from the command.
PUBLIC ssize	mprReadFile(MprFile *file, void *buf, ssize size)
	Read data from a file.
PUBLIC cchar*	mprReadJson(MprJson *obj, cchar *name)
	Read a JSON property.
PUBLIC MprJson*	mprReadJsonObj(MprJson *obj, cchar *name)
	Read a JSON object.
PUBLIC MprJson*	mprReadJsonValue(MprJson *obj, cchar *value)
	Read a JSON object by value.
PUBLIC char*	mprReadLine(MprFile *file, ssize size, ssize *len)
	Read a line from the file.
PUBLIC ssize	mprReadSocket(MprSocket *sp, void *buf, ssize size)
	Read from a socket.
PUBLIC void*	mprRealloc(void *ptr, size_t size)
	Reallocate a block.
PUBLIC int	mprReapCmd(MprCmd *cmd, MprTicks timeout)
	Reap the command.
PUBLIC void	mprRecallWaitHandler(MprWaitHandler *wp)
	Recall a wait handler.
PUBLIC void	mprRecallWaitHandlerByFd(Socket fd)
	Recall a wait handler by fd.
PUBLIC int	mprRefillBuf(MprBuf *buf)
	Refill the buffer with data.
PUBLIC void	mprRelease(cvoid *ptr)
	Release a memory block.
PUBLIC void	mprReleaseBlocks(cvoid *ptr, ...)
	Release a memory blocks.
PUBLIC void	mprReleaseWorker(MprWorker *worker)
	Release a worker thread.
PUBLIC bool	mprRemoveCache(MprCache *cache, cchar *key)
	Remove items from the cache.
PUBLIC void	mprRemoveEvent(MprEvent *event)
	Remove an event.
PUBLIC int	mprRemoveItem(MprList *list, cvoid *item)
	Remove an item from the list.
PUBLIC int	mprRemoveItemAtPos(MprList *list, int index)
	Remove an item from the list.
PUBLIC MprJson*	mprRemoveJson(MprJson *obj, cchar *key)
	Remove a property from a JSON object.
PUBLIC MprJson*	mprRemoveJsonChild(MprJson *obj, MprJson *child)
	Remove a child from a JSON object WARNING: do not call this API when traversing the object in question using ITERATE_JSON.
PUBLIC int	mprRemoveKey(MprHash *table, cvoid *key)
	Remove a symbol entry from the hash table.
PUBLIC int	mprRemoveLastItem(MprList *list)
	Remove the last item from the list.
PUBLIC int	mprRemoveRangeOfItems(MprList *list, int start, int end)
	Remove a range of items from the list.
PUBLIC void	mprRemoveRoot(cvoid *ptr)
	Remove a memory block as a root for garbage collection.
PUBLIC void	mprRemoveSocketHandler(MprSocket *sp)
	Remove a socket wait handler.
PUBLIC int	mprRemoveStringItem(MprList *list, cchar *str)
	Remove a string item from the list.
PUBLIC void	mprRemoveWaitHandler(MprWaitHandler *wp)
	Remove a wait handler from the wait service.
PUBLIC char*	mprReplacePathExt(cchar *path, cchar *ext)
	Replace an extension to a path.
PUBLIC void	mprRescheduleEvent(MprEvent *event, MprTicks period)
	Reschedule an event.
PUBLIC void	mprResetBufIfEmpty(MprBuf *buf)
	Reset the buffer.
PUBLIC void	mprResetCond(MprCond *cond)
	Reset a condition variable.
PUBLIC void	mprResetMemError(void)
	Reset the memory allocation error flag.
PUBLIC void	mprResetYield(void)
	Reset a sticky yield.
PUBLIC char*	mprResolvePath(cchar *base, cchar *path)
	Resolve paths.
PUBLIC void	mprRestart(void)
	Restart the application.
PUBLIC void	mprRestartContinuousEvent(MprEvent *event)
	Restart an event.
PUBLIC int	mprRun(MprDispatcher *dispatcher, cchar *command, cchar *input, char **output, char **error, MprTicks timeout)
	Run a simple blocking command using a string command line.
PUBLIC int	mprRunCmd(MprCmd *cmd, cchar *command, cchar **envp, cchar *in, char **out, char **err, MprTicks timeout, int flags)
	Run a command using a string command line.
PUBLIC int	mprRunCmdV(MprCmd *cmd, int argc, cchar **argv, cchar **envp, cchar *in, char **out, char **err, MprTicks timeout, int flags)
	Run a command using an argv[] array of arguments.
PUBLIC int	mprSamePath(cchar *path1, cchar *path2)
	Compare two paths if they are the same.
PUBLIC int	mprSamePathCount(cchar *path1, cchar *path2, ssize len)
	Compare two paths if they are the same for a given length.
PUBLIC int	mprSaveJson(MprJson *obj, cchar *path, int flags)
	Save a JSON object to a filename.
PUBLIC char*	mprSearchForModule(cchar *module)
	Search for a module on the current module path.
PUBLIC char*	mprSearchPath(cchar *path, int flags, cchar *search, ...)
	Search for a path.
PUBLIC MprOff	mprSeekFile(MprFile *file, int seekType, MprOff distance)
	Seek the I/O pointer to a new location in the file.
PUBLIC char*	mprSerialize(MprHash *hash, int flags)
	Serialize a hash of properties as a JSON string.
PUBLIC int	mprServiceEvents(MprTicks delay, int flags)
	Service events.
PUBLIC bool	mprServicesAreIdle(bool traceRequests)
	Determine if the MPR services.
PUBLIC int	mprSetAppName(cchar *name, cchar *title, cchar *version)
	Set the application name, title and version.
PUBLIC void	mprSetAppPath(cchar *path)
	Set the application executable path.
PUBLIC void	mprSetBufMax(MprBuf *buf, ssize maxSize)
	Set the maximum buffer size.
PUBLIC void	mprSetBufRefillProc(MprBuf *buf, MprBufProc fn, void *arg)
	Set the buffer refill procedure.
PUBLIC int	mprSetBufSize(MprBuf *buf, ssize size, ssize maxSize)
	Set the buffer size.
PUBLIC void	mprSetCacheLimits(MprCache *cache, int64 keys, MprTicks lifespan, int64 memory, int resolution)
	Set the cache resource limits.
PUBLIC int	mprSetCacheLink(MprCache *cache, cchar *key, void *link)
	Set a linked managed memory reference for a cached item.
PUBLIC void	mprSetCacheNotify(MprCache *cache, MprCacheProc notify)
	Set a notification callback to be invoked for events of interest on cached items.
PUBLIC void	mprSetCmdCallback(MprCmd *cmd, MprCmdProc callback, void *data)
	Define a callback to be invoked to receive response data from the command.
PUBLIC void	mprSetCmdDefaultEnv(MprCmd *cmd, cchar **env)
	Set the default environment to use for commands.
PUBLIC void	mprSetCmdDir(MprCmd *cmd, cchar *dir)
	Set the home directory for the command.
PUBLIC void	mprSetCmdEnv(MprCmd *cmd, cchar **env)
	Set the command environment.
PUBLIC void	mprSetCmdSearchPath(MprCmd *cmd, cchar *search)
	Set the default command search path.
PUBLIC bool	mprSetCmdlineLogging(bool on)
	Set if command line logging was requested.
PUBLIC void	mprSetDebugMode(bool on)
	Turn on debug mode.
PUBLIC void	mprSetDomainName(cchar *s)
	Set the application domain name string.
PUBLIC void	mprSetEnv(cchar *key, cchar *value)
	Set an environment variable value.
PUBLIC void	mprSetError(int error)
	Set the error code.
PUBLIC void	mprSetEventServiceSleep(MprTicks delay)
	Set the maximum sleep time for the event service.
PUBLIC void	mprSetExitStatus(int status)
	Set the proposed exit status.
PUBLIC void	mprSetExitTimeout(MprTicks timeout)
	Set the exit timeout for a shutdown.
PUBLIC void	mprSetFilesLimit(int limit)
	Set the maximum number of open file/socket descriptors.
PUBLIC void	mprSetHostName(cchar *s)
	Set the application host name string.
PUBLIC MprIdleCallback	mprSetIdleCallback(MprIdleCallback idleCallback)
	Define a new idle callback to be invoked by mprIsIdle()
PUBLIC void	mprSetIpAddr(cchar *ip)
	Sete the application IP address string.
PUBLIC void*	mprSetItem(MprList *list, int index, cvoid *item)
	Set a list item.
PUBLIC int	mprSetJson(MprJson *obj, cchar *key, cchar *value, int type)
	Update a key/value in the JSON object with a string value.
PUBLIC void	mprSetJsonError(MprJsonParser *jp, cchar *fmt, ...)
	Signal a parse error in the JSON input stream.
PUBLIC int	mprSetJsonObj(MprJson *obj, cchar *key, MprJson *value)
	Update a property in a JSON object.
PUBLIC void	mprSetKey(cchar *key, void *value)
	Store a key/value pair.
PUBLIC int	mprSetListLimits(MprList *list, int initialSize, int maxSize)
	Define the list size limits.
PUBLIC void	mprSetLogBackup(ssize logSize, int backupCount, int flags)
	Set the log rotation parameters.
PUBLIC void	mprSetLogFile(struct MprFile *file)
	Set a file to be used for logging.
PUBLIC MprLogHandler	mprSetLogHandler(MprLogHandler handler)
	Set an MPR debug log handler.
PUBLIC void	mprSetLogLevel(int level)
	Set the current logging verbosity level.
PUBLIC void*	mprSetManager(void *ptr, MprManager manager)
	Update the manager for a block of memory.
PUBLIC int	mprSetMaxSocketAccept(int max)
	Set the maximum number of accepted client connections that are permissable.
PUBLIC void	mprSetMaxWorkers(int count)
	Set the maximum count of worker threads Set the maximum number of worker pool threads for the MPR.
PUBLIC void	mprSetMemError(void)
	Set an memory allocation error condition on a memory context.
PUBLIC void	mprSetMemLimits(ssize warnHeap, ssize maximum, ssize cache)
	Configure the application memory limits.
PUBLIC void	mprSetMemNotifier(MprMemNotifier cback)
	Define a memory notifier.
PUBLIC void	mprSetMemPolicy(int policy)
	Set the memory allocation policy for when allocations fail.
PUBLIC int	mprSetMimeProgram(MprHash *table, cchar *mimeType, cchar *program)
	Set the mime type program.
PUBLIC void	mprSetMinWorkers(int count)
	Set the minimum count of worker threads Set the count of threads the worker pool will have.
PUBLIC void	mprSetModuleFinalizer(MprModule *module, MprModuleProc stop)
	Define a module finalizer that will be called before a module is stopped.
PUBLIC void	mprSetModuleSearchPath(char *searchPath)
	Set the module search path.
PUBLIC void	mprSetModuleTimeout(MprModule *module, MprTicks timeout)
	Set a module timeout.
PUBLIC void	mprSetOsError(int error)
	Set the O/S error code.
PUBLIC void	mprSetPathNewline(cchar *path, cchar *newline)
	Set the file system new line character string.
PUBLIC void	mprSetPathSeparators(cchar *path, cchar *separators)
	Set the file system path separators.
PUBLIC void	mprSetServerName(cchar *s)
	Set the application server name string.
PUBLIC int	mprSetSocketBlockingMode(MprSocket *sp, bool on)
	Set the socket blocking mode.
PUBLIC void	mprSetSocketDispatcher(MprSocket *sp, MprDispatcher *dispatcher)
	Set the dispatcher to use for socket events.
PUBLIC void	mprSetSocketEof(MprSocket *sp, bool eof)
	Set an EOF condition on the socket.
PUBLIC int	mprSetSocketNoDelay(MprSocket *sp, bool on)
	Set the socket delay mode.
PUBLIC void	mprSetSslAlpn(struct MprSsl *ssl, cchar *protocols)
	Set the ALPN protocols for SSL.
PUBLIC void	mprSetSslCaFile(struct MprSsl *ssl, cchar *caFile)
	Set the client certificate file to use for SSL.
PUBLIC void	mprSetSslCaPath(struct MprSsl *ssl, cchar *caPath)
	Set the path for the client certificate directory.
PUBLIC void	mprSetSslCertFile(struct MprSsl *ssl, cchar *certFile)
	Set certificate to use for SSL.
PUBLIC void	mprSetSslCiphers(MprSsl *ssl, cchar *ciphers)
	Set the ciphers to use.
PUBLIC void	mprSetSslHostname(MprSsl *ssl, cchar *hostname)
	Set the desired hostname for this SSL configuration when using SNI.
PUBLIC void	mprSetSslKeyFile(struct MprSsl *ssl, cchar *keyFile)
	Set the key file to use for SSL.
PUBLIC void	mprSetSslLogLevel(struct MprSsl *ssl, int level)
	Set the SSL log level at which to start tracing SSL events.
PUBLIC void	mprSetSslMatch(struct MprSsl *ssl, MprMatchSsl match)
	Set a match callback to select the appropriate SSL configuration to use in response to a client SNI hello.
PUBLIC void	mprSetSslProtocols(struct MprSsl *ssl, int protocols)
	Set the SSL protocol to use.
PUBLIC void	mprSetSslProvider(MprSocketProvider *provider)
	Set the SSL provider to use.
PUBLIC void	mprSetSslRenegotiate(MprSsl *ssl, bool enable)
	Control SSL session renegotiation.
PUBLIC void	mprSetSslRevoke(struct MprSsl *ssl, cchar *revoke)
	Define a list of certificates to revoke.
PUBLIC void	mprSetSslTicket(MprSsl *ssl, bool enable)
	Enable SSL session tickets.
PUBLIC bool	mprSetThreadYield(MprThread *tp, bool on)
	Set whether a thread can yield for GC.
PUBLIC void	mprSetWorkerStackSize(int size)
	Set the default worker stack size.
PUBLIC bool	mprShouldAbortRequests(void)
	Test if requests should be aborted.
PUBLIC bool	mprShouldDenyNewRequests(void)
	Test if new requests should be denied.
PUBLIC void	mprShutdown(int exitStrategy, int status, MprTicks timeout)
	Initiate shutdown of the MPR and application.
PUBLIC void	mprSignalCond(MprCond *cond)
	Signal a condition lock variable.
PUBLIC void	mprSignalDispatcher(MprDispatcher *dispatcher)
	Signal the dispatcher to wakeup and re-examine its queues.
PUBLIC void	mprSignalMultiCond(MprCond *cond)
	Signal a condition lock variable for use with multiple waiters.
PUBLIC void	mprSleep(MprTicks msec)
	Sleep for a while.
PUBLIC bool	mprSocketHandshaking(MprSocket *sp)
	Test if the socket is doing an SSL handshake.
PUBLIC bool	mprSocketHasBuffered(MprSocket *sp)
	Test if the socket has buffered data.
PUBLIC bool	mprSocketHasBufferedRead(MprSocket *sp)
	Test if the socket has buffered read data.
PUBLIC bool	mprSocketHasBufferedWrite(MprSocket *sp)
	Test if the socket has buffered write data.
PUBLIC void*	mprSort(void *base, ssize num, ssize width, MprSortProc compare, void *ctx)
	Quicksort.
PUBLIC MprList*	mprSortList(MprList *list, MprSortProc compare, void *ctx)
	Sort a list.
PUBLIC int	mprSslInit(void *unused, MprModule *module)
	Initialize the SSL provider.
PUBLIC int	mprStart(void)
	Start the Mpr services.
PUBLIC int	mprStartCmd(MprCmd *cmd, int argc, cchar **argv, cchar **envp, int flags)
	Start the command.
PUBLIC int	mprStartDispatcher(MprDispatcher *dispatcher)
	Start a dispatcher by setting it on the run queue.
PUBLIC int	mprStartEventsThread(void)
	Start an thread dedicated to servicing events.
PUBLIC int	mprStartLogging(cchar *logSpec, int flags)
	Start logging.
PUBLIC int	mprStartModule(MprModule *mp)
	Start a module.
PUBLIC int	mprStartModuleService(void)
	Start the module service.
PUBLIC int	mprStartOsService(void)
	Start the O/S dependent subsystem.
PUBLIC int	mprStartOsThread(cchar *name, void *proc, void *data, MprThread *tp)
	Start an O/S thread.
PUBLIC int	mprStartThread(MprThread *thread)
	Start a thread.
PUBLIC int	mprStartWorker(MprWorkerProc proc, void *data)
	Start a worker thread.
PUBLIC Socket	mprStealSocketHandle(MprSocket *sp)
	Steal the socket handle.
PUBLIC int	mprStopCmd(MprCmd *cmd, int signal)
	Stop the command.
PUBLIC void	mprStopContinuousEvent(MprEvent *event)
	Stop an event.
PUBLIC int	mprStopDispatcher(MprDispatcher *dispatcher)
	Stop a dispatcher by removing it from the run queue.
PUBLIC int	mprStopModule(MprModule *mp)
	Stop a module.
PUBLIC void	mprStopModuleService(void)
	Stop the module service.
PUBLIC void	mprStopOsService(void)
	Stop the O/S dependent subsystem.
PUBLIC void	mprSuspendThread(MprTicks timeout)
	Suspend the current thread.
PUBLIC char*	mprTransformPath(cchar *path, int flags)
	Transform a path.
PUBLIC char*	mprTrimPathComponents(cchar *path, int count)
	Trim path components from a path.
PUBLIC char*	mprTrimPathDrive(cchar *path)
	Trim the drive from a path.
PUBLIC char*	mprTrimPathExt(cchar *path)
	Trim an extension from a path.
PUBLIC int	mprTruncateFile(cchar *path, MprOff size)
	Truncate a file.
PUBLIC bool	mprTryLock(MprMutex *lock)
	Attempt to lock access.
PUBLIC bool	mprTrySpinLock(MprSpin *lock)
	Attempt to lock access on a spin lock.
PUBLIC int	mprUnloadModule(MprModule *mp)
	Unload a module.
PUBLIC int	mprUnloadNativeModule(MprModule *mp)
	Unload a native module.
PUBLIC int	mprUpgradeSocket(MprSocket *sp, struct MprSsl *ssl, cchar *peerName)
	Upgrade a socket to use SSL/TLS.
PUBLIC char*	mprUriDecode(cchar *uri)
	Decode a URI string by de-scaping URI characters.
PUBLIC char*	mprUriDecodeInSitu(char *uri)
	Decode a URI string by de-scaping URI characters.
PUBLIC char*	mprUriEncode(cchar *uri, int map)
	Encode a string by escaping URI characters.
PUBLIC int	mprUsingDefaultLogHandler(void)
	Determine if the app is using the default MPR log handler.
PUBLIC void	mprVerifySslDepth(struct MprSsl *ssl, int depth)
	Control the depth of SSL SSL certificate verification.
PUBLIC void	mprVerifySslIssuer(struct MprSsl *ssl, bool on)
	Control the verification of SSL certificate issuers.
PUBLIC void	mprVerifySslPeer(struct MprSsl *ssl, bool on)
	Require verification of peer certificates.
PUBLIC void*	mprVirtAlloc(size_t size, int mode)
	Memory virtual memory into the applications address space.
PUBLIC void	mprVirtFree(void *ptr, size_t size)
	Free (unpin) a mapped section of virtual memory.
PUBLIC int	mprWaitForCmd(MprCmd *cmd, MprTicks timeout)
	Wait for the command to complete.
PUBLIC int	mprWaitForCond(MprCond *cond, MprTicks timeout)
	Wait for a condition lock variable.
PUBLIC int	mprWaitForEvent(MprDispatcher *dispatcher, MprTicks timeout, int64 mark)
	Wait for an event to occur on the given dispatcher.
PUBLIC void	mprWaitForIO(MprWaitService *ws, MprTicks timeout)
	Wait for I/O.
PUBLIC int	mprWaitForMultiCond(MprCond *cond, MprTicks timeout)
	Wait for a condition lock variable for use with multiple waiters.
PUBLIC int	mprWaitForSingleIO(int fd, int mask, MprTicks timeout)
	Wait for I/O on a file descriptor.
PUBLIC void	mprWaitOn(MprWaitHandler *wp, int desiredMask)
	Subscribe for desired wait events.
PUBLIC void	mprWakeEventService(void)
	Wake the event service.
PUBLIC ssize	mprWriteCache(MprCache *cache, cchar *key, cchar *value, MprTime modified, MprTicks lifespan, int64 version, int options)
	Write a cache item.
PUBLIC ssize	mprWriteCmd(MprCmd *cmd, int channel, cchar *buf, ssize bufsize)
	Write data to an I/O channel.
PUBLIC ssize	mprWriteCmdBlock(MprCmd *cmd, int channel, cchar *buf, ssize bufsize)
	Write data to an I/O channel.
PUBLIC ssize	mprWriteFile(MprFile *file, cvoid *buf, ssize count)
	Write data to a file.
PUBLIC ssize	mprWriteFileFmt(MprFile *file, cchar *fmt, ...)
	Write formatted data to a file.
PUBLIC ssize	mprWriteFileString(MprFile *file, cchar *str)
	Write a string to a file.
PUBLIC int	mprWriteJson(MprJson *obj, cchar *key, cchar *value, int type)
	Write a key/value in the JSON object with a string value.
PUBLIC int	mprWriteJsonObj(MprJson *obj, cchar *key, MprJson *value)
	Write a property in a JSON object.
PUBLIC ssize	mprWritePathContents(cchar *path, cchar *buf, ssize len, int mode)
	Create a file and write contents.
PUBLIC ssize	mprWriteSocket(MprSocket *sp, cvoid *buf, ssize len)
	Write to a socket.
PUBLIC ssize	mprWriteSocketString(MprSocket *sp, cchar *str)
	Write to a string to a socket.
PUBLIC ssize	mprWriteSocketVector(MprSocket *sp, MprIOVec *iovec, int count)
	Write a vector of buffers to a socket.
PUBLIC cchar*	mprXmlGetErrorMsg(MprXml *xp)
	Get the XML error message if mprXmlParse fails.
PUBLIC int	mprXmlGetLineNumber(MprXml *xp)
	Get the source XML line number.
PUBLIC void*	mprXmlGetParseArg(MprXml *xp)
	Get the XML callback argument.
PUBLIC MprXml*	mprXmlOpen(ssize initialSize, ssize maxSize)
	Open an XML parser instance.
PUBLIC int	mprXmlParse(MprXml *xp)
	Run the XML parser.
PUBLIC void	mprXmlSetInputStream(MprXml *xp, MprXmlInputStream fn, void *arg)
	Define the XML parser input stream.
PUBLIC void	mprXmlSetParseArg(MprXml *xp, void *parseArg)
	Set the XML callback argument.
PUBLIC void	mprXmlSetParserHandler(MprXml *xp, MprXmlHandler h)
	Set the XML parser data handle.
PUBLIC void	mprYield(int flags)
	Signify to the garbage collector that the thread is ready for garbage collection.
PUBLIC void*	palloc(size_t size)
	Allocate a "permanent" block of memory that is not subject GC.
PUBLIC void	pfree(void *ptr)
	Free a "permanent" block of memory allocated via "palloc".
PUBLIC void*	prealloc(void *ptr, size_t size)
	Reallocate a "permanent" block of memory allocated via "palloc".
PUBLIC ssize	print(cchar *fmt, ...)
	Print to stdout and add a trailing newline.
PUBLIC size_t	psize(void *ptr)
	Return the size of the block.
PUBLIC char*	scamel(cchar *str)
	Create a camel case version of the string.
PUBLIC int	scaselesscmp(cchar *s1, cchar *s2)
	Compare strings ignoring case.
PUBLIC char*	scaselesscontains(cchar *str, cchar *pattern)
	Find a pattern in a string with a caseless comparision.
PUBLIC bool	scaselessmatch(cchar *s1, cchar *s2)
	Compare strings ignoring case.
PUBLIC char*	schr(cchar *str, int c)
	Find a character in a string.
PUBLIC char*	sclone(cchar *str)
	Clone a string.
PUBLIC int	scmp(cchar *s1, cchar *s2)
	Compare strings.
PUBLIC char*	scontains(cchar *str, cchar *pattern)
	Find a pattern in a string.
PUBLIC ssize	scopy(char *dest, ssize destMax, cchar *src)
	Copy a string.
PUBLIC cchar*	sends(cchar *str, cchar *suffix)
	Test if the string ends with a given pattern.
PUBLIC void	serase(char *str)
	Erase the contents of a string.
PUBLIC char*	sfmt(cchar *fmt, ...)
	Format a string.
PUBLIC char*	sfmtv(cchar *fmt, va_list args)
	Format a string.
PUBLIC uint	shash(cchar *str, ssize len)
	Compute a hash code for a string.
PUBLIC uint	shashlower(cchar *str, ssize len)
	Compute a caseless hash code for a string.
PUBLIC char*	sjoin(cchar *str, ...)
	Catenate strings.
PUBLIC cchar*	sjoinArgs(int argc, cchar **argv, cchar *sep)
	Join an array of strings.
PUBLIC char*	sjoinv(cchar *str, va_list args)
	Catenate strings.
PUBLIC ssize	slen(cchar *str)
	Return the length of a string.
PUBLIC char*	slower(cchar *str)
	Convert a string to lower case.
PUBLIC bool	smatch(cchar *s1, cchar *s2)
	Compare strings.
PUBLIC bool	smatchsec(cchar *s1, cchar *s2)
	Secure compare strings.
PUBLIC int	sncaselesscmp(cchar *s1, cchar *s2, ssize len)
	Compare strings ignoring case.
PUBLIC char*	sncaselesscontains(cchar *str, cchar *pattern, ssize limit)
	Find a pattern in a string with a limit and a caseless comparision.
PUBLIC char*	snclone(cchar *str, ssize len)
	Clone a substring.
PUBLIC int	sncmp(cchar *s1, cchar *s2, ssize len)
	Compare strings.
PUBLIC char*	sncontains(cchar *str, cchar *pattern, ssize limit)
	Find a pattern in a string with a limit.
PUBLIC ssize	sncopy(char *dest, ssize destMax, cchar *src, ssize len)
	Copy characters from a string.
PUBLIC char*	spbrk(cchar *str, cchar *set)
	Locate the a character from a set in a string.
PUBLIC char*	sptok(char *str, cchar *pattern, char **last)
	Tokenize a string.
PUBLIC char*	srchr(cchar *str, int c)
	Find a character in a string by searching backwards.
PUBLIC char*	srejoin(char *buf, ...)
	Append strings to an existing string and reallocate as required.
PUBLIC char*	srejoinv(char *buf, va_list args)
	Append strings to an existing string and reallocate as required.
PUBLIC char*	ssplit(char *str, cchar *delim, char **last)
	Split a string at a delimiter.
PUBLIC ssize	sspn(cchar *str, cchar *set)
	Find the end of a spanning prefix.
PUBLIC bool	sstarts(cchar *str, cchar *prefix)
	Test if the string starts with a given pattern.
PUBLIC char*	ssub(cchar *str, ssize offset, ssize length)
	Create a substring.
PUBLIC char*	stemplate(cchar *str, struct MprHash *tokens)
	Replace template tokens in a string with values from a lookup table.
PUBLIC char*	stemplateJson(cchar *str, struct MprJson *tokens)
	Replace template tokens in a string with values from a lookup table.
PUBLIC char*	stitle(cchar *str)
	Create a Title Case version of the string.
PUBLIC double	stof(cchar *str)
	Convert a string to a double.
PUBLIC int64	stoi(cchar *str)
	Convert a string to an integer.
PUBLIC int64	stoiradix(cchar *str, int radix, int *err)
	Convert a string to an integer.
PUBLIC char*	stok(char *str, cchar *delim, char **last)
	Tokenize a string.
PUBLIC struct,MprList*	stolist(cchar *src)
	String to list.
PUBLIC char*	strim(cchar *str, cchar *set, int where)
	Trim a string.
PUBLIC char*	supper(cchar *str)
	Convert a string to upper case.

Typedefs

MprBufProc	Buffer refill callback function.
MprCacheProc	Cache item expiry callback.
MprCmdService	Command execution service.
MprCond	Condition variable for single and multi-thread synchronization.
MprDirEntry	Directory entry description.
MprEventProc	Event callback function.
MprForkCallback	Callback function before doing a fork().
MprFreeMem	Block structure when on a free list.
MprFreeQueue	Free queue head structure.
MprHash	Hash table control structure.
MprHashProc	Hashing function to use for the table.
MprHeap	Memory allocator heap.
MprIOVec	Vectored write array.
MprJsonCallback	JSON parsing callbacks.
MprJsonParser	JSON parser.
MprKeyValue	Key value pairs for use with MprList or MprKey.
MprListCompareProc	List comparison procedure for sorting.
MprLogHandler	Log handler callback type.
MprManager	Mpr memory block manager prototype.
MprMemNotifier	Memory allocation error callback.
MprMemStats	Memory allocator statistics.
MprModuleEntry	Loadable module entry point signature.
MprModuleProc	Module start/stop point function signature.
MprMutex	Multithreading lock control structure.
MprOff	Signed file offset data type.
MprRegion	Memmory regions allocated from the O/S.
MprRomInode	A RomInode is created for each file in the Rom file system.
MprSignalInfo	Per signal structure.
MprSignalProc	Signal callback procedure.
MprSignalService	Signal service control.
MprSocketPrebind	Callback before binding a socket.
MprSocketProc	Socket I/O callback procedure.
MprSocketProvider	Socket service provider interface.
MprSocketService	Mpr socket service class.
MprSortProc	Quicksort callback function.
MprSpin	Multithreading spin lock control structure.
MprSsl	Callback function for SNI connections.
MprTerminator	Service shutdown notifier.
MprThreadLocal	Thread local data storage.
MprThreadProc	Thread main procedure.
MprThreadService	Thread service.
MprTicks	Elapsed time data type.
MprWaitService	Wait Service.
MprWorkerProc	Worker thread callback signature.
MprWorkerService	Worker Thread Service.
MprWorkerStats	Statistics for Workers.
MprXmlHandler	XML callback handler.
MprXmlInputStream	XML input stream function.
Socket	Argument for sockets.
size_t	Unsigned integral type.

Defines

#define	ME_MAX_EVENTS   32
	Maximum number of notifier events.
#define	ME_MPR_ALLOC_TRACE   0
	Trace to stdout.
#define	ME_MPR_LOGGING   1
	Default for logging is "on".
#define	ME_MPR_MAX_PASSWORD   256
	Max password length.
#define	MPR_ALLOC_HOLD   0x4
	Allocate and hold immune from GC until mprRelease.
#define	MPR_ALLOC_MANAGER   0x1
	Reserve room for a manager.
#define	MPR_ALLOC_PAD_MASK   0x1
	Flags that impact padding.
#define	MPR_ALLOC_POLICY_ABORT   4
	Abort the app and dump core.
#define	MPR_ALLOC_POLICY_EXIT   3
	Exit the app cleanly.
#define	MPR_ALLOC_POLICY_NOTHING   0
	Do nothing.
#define	MPR_ALLOC_POLICY_PRUNE   1
	Prune all non-essential memory and continue.
#define	MPR_ALLOC_POLICY_RESTART   2
	Gracefully restart the app.
#define	MPR_ALLOC_ZERO   0x2
	Zero memory.
#define	MPR_ARGV_ARGS_ONLY   0x1
	Command is missing program name.
#define	MPR_BACKGROUND_PRIORITY   15
	May only get CPU if idle.
#define	MPR_CACHE_ADD   0x2
	mprWriteCache option to add key only if not already existing.
#define	MPR_CACHE_APPEND   0x8
	mprWriteCache option to set and append if already existing.
#define	MPR_CACHE_NOTIFY_CREATE   1
	Item has been created.
#define	MPR_CACHE_NOTIFY_REMOVE   2
	Item is about to be removed.
#define	MPR_CACHE_NOTIFY_UPDATE   4
	Item has been updated.
#define	MPR_CACHE_PREPEND   0x10
	mprWriteCache option to set and prepend if already existing.
#define	MPR_CACHE_SET   0x4
	mprWriteCache option to update key value, create if required.
#define	MPR_CACHE_SHARED   0x1
	Use shared cache for mprCreateCache()
#define	MPR_CG_DEFAULT   0x0
	mprGC flag to run GC if necessary.
#define	MPR_CMD_DETACH   0x4
	mprRunCmd flag to detach the child process and don't wait.
#define	MPR_CMD_ERR   0x4000
	mprRunCmd flag to capture stdout.
#define	MPR_CMD_EXACT_ENV   0x8
	mprRunCmd flag to use the exact environment (no inherit from parent).
#define	MPR_CMD_IN   0x1000
	mprRunCmd flag to connect to stdin.
#define	MPR_CMD_NEW_SESSION   0x1
	mprRunCmd flag to create a new session on unix.
#define	MPR_CMD_OUT   0x2000
	mprRunCmd flag to capture stdout.
#define	MPR_CMD_SHOW   0x2
	mprRunCmd flag to show the window of the created process on windows.
#define	MPR_CMD_STDERR   2
	Stderr for the client side.
#define	MPR_CMD_STDIN   0
	Stdout for the client side.
#define	MPR_CMD_STDOUT   1
	Stdin for the client side.
#define	MPR_CMD_VXWORKS_EOF   "_ _EOF_ _"
	Special string for VxWorks CGI to emit to signal EOF.
#define	MPR_CMD_VXWORKS_EOF_LEN   9
	Length of MPR_CMD_VXWORKS_EOF.
#define	MPR_CREATED   1
	Applicationa and MPR services started.
#define	MPR_CRITICAL_PRIORITY   99
	May not yield.
#define	MPR_DAEMON   0x10
	Make the process a daemon.
#define	MPR_DECODE_TOKEQ   1
	Decode base 64 blocks up to a NULL or equals.
#define	MPR_DEFAULT_DATE   "%a %b %d %T %Y %Z"
	Default date format used in mprFormatLocalTime/mprFormatUniversalTime when no format supplied.
#define	MPR_DEFAULT_MAX_THREADS   5
	Default max threads.
#define	MPR_DEFAULT_MIN_THREADS   0
	Default min threads.
#define	MPR_DELAY_GC_THREAD   0x8
	Delay starting the GC thread.
#define	MPR_DESTROYED   6
	Application and MPR object destroyed
#define	MPR_DESTROYING   5
	Destroying core MPR services and releasing memory.
#define	MPR_DISABLE_GC   0x1
	Disable GC.
#define	MPR_DISPATCHER_AUTO   0x8
	Dispatcher was auto created in response to accept event.
#define	MPR_DISPATCHER_COMPLETE   0x10
	Test operation is complete.
#define	MPR_DISPATCHER_DESTROYED   0x4
	Dispatcher has been destroyed.
#define	MPR_DISPATCHER_IMMEDIATE   0x1
	Dispatcher should run using the service events thread.
#define	MPR_DISPATCHER_WAITING   0x2
	Dispatcher waiting for an event in mprWaitForEvent.
#define	MPR_ERR   -1
	Default error code.
#define	MPR_ERR_ABORTED   -2
	Action aborted.
#define	MPR_ERR_ALREADY_EXISTS   -3
	Item already exists.
#define	MPR_ERR_BAD_ARGS   -4
	Bad arguments or paramaeters.
#define	MPR_ERR_BAD_FORMAT   -5
	Bad input format.
#define	MPR_ERR_BAD_HANDLE   -6
	Bad file handle.
#define	MPR_ERR_BAD_STATE   -7
	Module is in a bad state.
#define	MPR_ERR_BAD_SYNTAX   -8
	Input has bad syntax.
#define	MPR_ERR_BAD_TYPE   -9
	Bad object type.
#define	MPR_ERR_BAD_VALUE   -10
	Bad or unexpected value.
#define	MPR_ERR_BASE   -1
	Base error code.
#define	MPR_ERR_BUSY   -11
	Resource is busy.
#define	MPR_ERR_CANT_ACCESS   -12
	Cannot access the file or resource.
#define	MPR_ERR_CANT_ALLOCATE   -13
	Cannot allocate resource.
#define	MPR_ERR_CANT_COMPLETE   -14
	Operation cannot complete.
#define	MPR_ERR_CANT_CONNECT   -15
	Cannot connect to network or resource.
#define	MPR_ERR_CANT_CREATE   -16
	Cannot create the file or resource.
#define	MPR_ERR_CANT_DELETE   -17
	Cannot delete the resource.
#define	MPR_ERR_CANT_FIND   -18
	Cannot find resource.
#define	MPR_ERR_CANT_INITIALIZE   -19
	Cannot initialize resource.
#define	MPR_ERR_CANT_LOAD   -20
	Cannot load the resource.
#define	MPR_ERR_CANT_OPEN   -21
	Cannot open the file or resource.
#define	MPR_ERR_CANT_READ   -22
	Cannot read from the file or resource.
#define	MPR_ERR_CANT_WRITE   -23
	Cannot write to the file or resource.
#define	MPR_ERR_DELETED   -24
	Resource has been deleted.
#define	MPR_ERR_MEMORY   -25
	Memory allocation error.
#define	MPR_ERR_NETWORK   -26
	Underlying network error.
#define	MPR_ERR_NOT_INITIALIZED   -27
	Module or resource is not initialized.
#define	MPR_ERR_NOT_READY   -28
	Resource is not ready.
#define	MPR_ERR_OK   0
	Success.
#define	MPR_ERR_READ_ONLY   -29
	The operation timed out.
#define	MPR_ERR_TIMEOUT   -30
	Operation exceeded specified time allowed.
#define	MPR_ERR_TOO_MANY   -31
	Too many requests or resources.
#define	MPR_ERR_WONT_FIT   -32
	Requested operation won't fit in available space.
#define	MPR_ERR_WOULD_BLOCK   -33
	Blocking operation would block.
#define	MPR_EVENT_ALWAYS   0x10
	Always invoke the callback even if the event not run
#define	MPR_EVENT_ASYNC   1
	Windows async select.
#define	MPR_EVENT_CONTINUOUS   0x1
	Timer event runs is automatically rescheduled.
#define	MPR_EVENT_DONT_QUEUE   0x4
	Don't queue the event.
#define	MPR_EVENT_EPOLL   2
	epoll_wait.
#define	MPR_EVENT_KQUEUE   3
	BSD kqueue.
#define	MPR_EVENT_LOCAL   0x20
	Invoked from an MPR local thread.
#define	MPR_EVENT_PRIORITY   50
	Normal priority.
#define	MPR_EVENT_QUICK   0x2
	Execute inline without executing via a thread.
#define	MPR_EVENT_SELECT   4
	traditional select().
#define	MPR_EVENT_SELECT_PIPE   5
	Select with pipe for wakeup.
#define	MPR_EVENT_STATIC_DATA   0x8
	Event data is permanent and should not be marked by GC.
#define	MPR_EVENT_TIME_SLICE   20 /* 20 msec */
	Events.
#define	MPR_EXIT_ABORT   0x1
	Abort everything and call exit().
#define	MPR_EXIT_NORMAL   0x0
	Normal (graceful) exit.
#define	MPR_EXIT_RESTART   0x4
	Restart after exiting.
#define	MPR_EXIT_SAFE   0x2
	Graceful shutdown only if all requests complete.
#define	MPR_EXIT_TIMEOUT   -1
	Use timeout specified via mprSetExitTimeout
#define	MPR_GC_COMPLETE   0x4
	mprGC flag to force start a GC and wait until the GC cycle fully completes including sweep phase.
#define	MPR_GC_FORCE   0x1
	mprGC flag to force start a GC sweep whether it is required or not.
#define	MPR_GC_NO_BLOCK   0x2
	mprGC flag to run GC if ncessary and return without yielding.
#define	MPR_HASH_CASELESS   0x10
	Key comparisons ignore case.
#define	MPR_HASH_MANAGED_KEYS   0x100
	Keys are managed - mark but don't dup.
#define	MPR_HASH_MANAGED_VALUES   0x200
	Values are managed - mark but don't dup.
#define	MPR_HASH_STABLE   0x800
	Contents are stable or only accessed by one thread.
#define	MPR_HASH_STATIC_KEYS   0x40
	Keys are permanent - don't dup or mark.
#define	MPR_HASH_STATIC_VALUES   0x80
	Values are permanent - don't mark.
#define	MPR_HASH_UNICODE   0x20
	Hash keys are unicode strings.
#define	MPR_HASH_UNIQUE   0x400
	Add to existing will fail.
#define	MPR_HTTP_DATE   "%a, %d %b %Y %T GMT"
	Date format for use in HTTP (headers).
#define	MPR_JSON_APPEND   0x4
	Default to append to existing '+' (default).
#define	MPR_JSON_ARRAY   0x2
	The property is an array.
#define	MPR_JSON_COMBINE   0x1
	Combine properties using '+' '-' '=' '?' prefixes.
#define	MPR_JSON_CREATE   0x10
	Create if not already existing '?'.
#define	MPR_JSON_DATA_TYPE   0xFF8
	Mask for core type of obj (obj|array|value).
#define	MPR_JSON_ENCODE_TYPES   0x8
	Encode dates and regexp with {type:date} or {type:regexp}.
#define	MPR_JSON_FALSE   0x8
	The property is false.
#define	MPR_JSON_NULL   0x10
	The property is null.
#define	MPR_JSON_NUMBER   0x20
	The property is a number.
#define	MPR_JSON_OBJ   0x1
	The property is an object.
#define	MPR_JSON_OBJ_TYPE   0x7
	Mask for core type of obj (obj|array|value).
#define	MPR_JSON_OVERWRITE   0x2
	Default to overwrite existing properties '='.
#define	MPR_JSON_PRETTY   0x1
	Serialize output in a more human readable, multiline "pretty" format.
#define	MPR_JSON_QUOTES   0x2
	Serialize output quoting keys.
#define	MPR_JSON_REGEXP   0x40
	The property is a regular expression.
#define	MPR_JSON_REPLACE   0x8
	Replace existing properties '-'.
#define	MPR_JSON_STRING   0x80
	The property is a string.
#define	MPR_JSON_STRINGS   0x4
	Emit all values as quoted strings.
#define	MPR_JSON_TRUE   0x100
	The property is true.
#define	MPR_JSON_UNDEFINED   0x200
	The property is undefined.
#define	MPR_JSON_VALUE   0x4
	The property is a value (false|true|null|undefined|regexp|number|string)
#define	MPR_LIST_STABLE   0x40
	Contents are stable or only accessed by one thread.
#define	MPR_LIST_STATIC_VALUES   0x20
	Flag for mprCreateList when values are permanent.
#define	MPR_LOCAL_TIMEZONE   MAXINT
	Constants for mprParseTime.
#define	MPR_LOG_ANEW   0x1
	Start anew on restart after backup.
#define	MPR_LOG_CMDLINE   0x4
	Command line log switch uses.
#define	MPR_LOG_CONFIG   0x2
	Show the configuration at the start of the log.
#define	MPR_LOG_DATE   "%D %T"
	Date for use in log files (compact).
#define	MPR_LOG_DETAILED   0x8
	Use detailed log formatting with timestamps and tags.
#define	MPR_LOG_HEXDUMP   0x10
	Emit hexdump.
#define	MPR_LOG_TAGGED   0x10
	Use tagged message formatting.
#define	MPR_MANAGE_FREE   0x1
	Block being freed.
#define	MPR_MANAGE_MARK   0x2
	Block being marked by GC.
#define	MPR_MAX_FILE   256
	Maximum number of files to close when forking.
#define	MPR_MEM_FAIL   0x4
	Memory allocation failed - immediate exit.
#define	MPR_MEM_LIMIT   0x2
	Memory use exceeds memory limit - invoking policy.
#define	MPR_MEM_TOO_BIG   0x8
	Memory allocation request is too big - immediate exit.
#define	MPR_MEM_WARNING   0x1
	Memory use exceeds warnHeap level limit.
#define	MPR_MIN_TIME_FOR_GC   2
	Wait till 2 milliseconds of idle time possible.
#define	MPR_MODULE_DATA_MANAGED   0x8
	Module.moduleData is managed.
#define	MPR_MODULE_LOADED   0x4
	Dynamic module loaded.
#define	MPR_MODULE_STARTED   0x1
	Module stared.
#define	MPR_MODULE_STOPPED   0x2
	Module stopped.
#define	MPR_NO_WINDOW   0x4
	Don't create a windows Window.
#define	MPR_NORMAL_PRIORITY   50
	Normal (default) priority.
#define	MPR_NOT_ALL   0x20
	Don't invoke all destructors when terminating.
#define	MPR_OBJ_HASH   0x1
	Object is a hash.
#define	MPR_OBJ_LIST   0x1
	Object is a hash.
#define	MPR_PATH_DEPTH_FIRST   0x2
	Flag for mprGetPathFiles to do a depth-first traversal.
#define	MPR_PATH_DESCEND   0x1
	Flag for mprGetPathFiles to traverse subdirectories.
#define	MPR_PATH_INC_HIDDEN   0x4
	Flag for mprGetPathFiles to include hidden files.
#define	MPR_PATH_NO_DIRS   0x8
	Flag for mprGetPathFiles to exclude subdirectories.
#define	MPR_PATH_RELATIVE   0x10
	Flag for mprGetPathFiles to return paths relative to the directory.
#define	MPR_PROTO_ALL   0xF3
	All protocols.
#define	MPR_PROTO_SSLV2   0x1
	SSL V2 protocol.
#define	MPR_PROTO_SSLV3   0x2
	SSL V3 protocol.
#define	MPR_PROTO_TLSV1_0   0x10
	TLS V1.0 protocol.
#define	MPR_PROTO_TLSV1_1   0x20
	TLS V1.1 protocol.
#define	MPR_PROTO_TLSV1_2   0x40
	TLS V1.2 protocol.
#define	MPR_PROTO_TLSV1_3   0x80
	TLS V1.3 protocol.
#define	MPR_READABLE   0x2
	Read event mask.
#define	MPR_REQUEST_PRIORITY   50
	Normal priority.
#define	MPR_RFC3399_DATE   "%FT%TZ"
	Date format for RFC 3399 for use in HTML 5.
#define	MPR_RFC_DATE   "%a, %d %b %Y %T %Z"
	Format a date according to RFC822: (Fri, 07 Jan 2003 12:12:21 PDT).
#define	MPR_SERVICE_NO_BLOCK   0x4
	Do not block in mprServiceEvents.
#define	MPR_SERVICE_NO_GC   0x8
	Don't run GC.
#define	MPR_SIGNAL_AFTER   0x2
	Flag to mprAddSignalHandler to run handler after existing handlers.
#define	MPR_SIGNAL_BEFORE   0x1
	Flag to mprAddSignalHandler to run handler before existing handlers.
#define	MPR_SOCKET_BLOCK   0x1
	Use blocking I/O.
#define	MPR_SOCKET_BROADCAST   0x2
	Broadcast mode.
#define	MPR_SOCKET_BUFFERED_READ   0x800
	Socket has buffered read data (in SSL stack).
#define	MPR_SOCKET_BUFFERED_WRITE   0x1000
	Socket has buffered write data (in SSL stack).
#define	MPR_SOCKET_CERT_ERROR   0x10000
	Error when validating peer certificate.
#define	MPR_SOCKET_CLOSED   0x4
	MprSocket has been closed.
#define	MPR_SOCKET_CONNECTING   0x8
	MprSocket is connecting.
#define	MPR_SOCKET_DATAGRAM   0x10
	Use datagrams.
#define	MPR_SOCKET_DISCONNECTED   0x4000
	The mprDisconnectSocket has been called.
#define	MPR_SOCKET_EOF   0x20
	Seen end of file.
#define	MPR_SOCKET_ERROR   0x20000
	Hard error (not just eof).
#define	MPR_SOCKET_GRACEFUL   1
	Do a graceful shutdown.
#define	MPR_SOCKET_HANDSHAKING   0x8000
	Doing an SSL handshake.
#define	MPR_SOCKET_LISTENER   0x40
	MprSocket is server listener.
#define	MPR_SOCKET_NODELAY   0x100
	Disable Nagle algorithm.
#define	MPR_SOCKET_NOREUSE   0x80
	Don't set SO_REUSEADDR option.
#define	MPR_SOCKET_REUSE_PORT   0x40000
	Set SO_REUSEPORT option.
#define	MPR_SOCKET_SERVER   0x400
	Socket is on the server-side.
#define	MPR_SOCKET_THREAD   0x200
	Process callbacks on a worker thread.
#define	MPR_STARTED   2
	Applicationa and MPR services started.
#define	MPR_STOPPED   4
	App is idle and now stopped.
#define	MPR_STOPPING   3
	App has been instructed to shutdown.
#define	MPR_TIMEOUT_GC_SYNC   100
	Short wait period for threads to synchronize.
#define	MPR_TIMEOUT_LINGER   2000
	Close socket linger timeout.
#define	MPR_TIMEOUT_NAP   20
	Short pause.
#define	MPR_TIMEOUT_NO_BUSY   1000
	Wait period to minimize CPU drain.
#define	MPR_TIMEOUT_PRUNER   120000
	Time between worker thread pruner runs (2 min).
#define	MPR_TIMEOUT_START_TASK   10000
	Time to start tasks running.
#define	MPR_TIMEOUT_STOP   30000
	Default wait when stopping resources (30 sec).
#define	MPR_TIMEOUT_STOP_TASK   10000
	Time to stop or reap tasks (vxworks).
#define	MPR_TIMEOUT_WORKER   60000
	Prune worker that has been idle for 1 min.
#define	MPR_TRIM_BOTH   0x3
	Flag for strim to trim from both the start and the end of the string.
#define	MPR_TRIM_END   0x2
	Flag for strim to trim from the end of the string.
#define	MPR_TRIM_START   0x1
	Flag for strim to trim from the start of the string.
#define	MPR_USER_EVENTS_THREAD   0x2
	User will explicitly manage own mprServiceEvents calls.
#define	MPR_UTC_TIMEZONE   0
	Use UTC timezone.
#define	MPR_WAIT_IMMEDIATE   0x4
	Wait handler flag to immediately service event on same thread.
#define	MPR_WAIT_NEW_DISPATCHER   0x2
	Wait handler flag to create a new dispatcher for each I/O event.
#define	MPR_WAIT_NOT_SOCKET   0x8
	I/O file descriptor is not a socket - windows will ignore.
#define	MPR_WAIT_RECALL_HANDLER   0x1
	Wait handler flag to recall the handler asap.
#define	MPR_WORKER_BUSY   0x1
	Worker currently running to a callback.
#define	MPR_WORKER_IDLE   0x4
	Worker is sleeping (idle) on idleCond.
#define	MPR_WORKER_PRIORITY   50
	Normal priority.
#define	MPR_WORKER_PRUNED   0x2
	Worker has been pruned and will be terminated.
#define	MPR_WRITABLE   0x4
	Write event mask.
#define	MPR_XML_AFTER_LS   2
	Seen "<"
#define	MPR_XML_ATT_EQ   6
	Seen "<tag att" =
#define	MPR_XML_ATT_NAME   5
	Seen "<tag att"
#define	MPR_XML_BEGIN   1
	Before next tag
#define	MPR_XML_CDATA   13
	Seen "<![CDATA[" U
#define	MPR_XML_COMMENT   3
	Seen "<!—" (usr) U
#define	MPR_XML_ELT_DATA   10
	Seen "<tag>....<" U
#define	MPR_XML_ELT_DEFINED   9
	Seen "<tag...>" U
#define	MPR_XML_END_ELT   11
	Seen "<tag>....</tag>" U
#define	MPR_XML_EOF   -2
	End of input.
#define	MPR_XML_ERR   -1
	Error.
#define	MPR_XML_NEW_ATT   7
	Seen "<tag att = "val" U
#define	MPR_XML_NEW_ELT   4
	Seen "<tag" (usr) U
#define	MPR_XML_PI   12
	Seen "<?processingInst" U
#define	MPR_XML_SOLO_ELT_DEFINED   8
	Seen "<tag../>" U
#define	MPR_YIELD_COMPLETE   0x1
	mprYield flag to wait until the GC entirely completes including sweep phase.
#define	MPR_YIELD_DEFAULT   0x0
	mprYield flag if GC is required, yield and wait for mark phase to coplete, otherwise return without blocking.
#define	MPR_YIELD_STICKY   0x2
	mprYield flag to yield and remain yielded until reset.

Mpr

MprBuf

MprCache

MprCmd