appCORE - coreAppLogZoneInit()

NAME

coreAppLogZoneInit() -- initialize an application logging zone.

SYNOPSIS

include "appcore.h"

int coreAppLogZoneInit( coreAppSPEC_t* s, int Zone, int Level );

DESCRIPTION

The coreAppLogZoneInit() function is provided to initialize an application logging zone prior to starting the main dispatch thread. This is strictly a convenience function to allow different log zones to be setup before the main dispatch thread is started. This function may be called multiple times to setup multiple log zones. The valid zones are restricted to 0 through CORE_LOG_ZONE_START. The default value of CORE_LOG_ZONE_START is 100. The caller is encouraged to enumerate log zones and use the appCORE defined log level enumeration. This function operates on the coreAppSPEC_t data type and simply presets log zone levels in this array. This array is combined with internal appCORE log zones.

PARAMETERS

s
	Pointer to the specification record.	
Zone
	The zone we are setting the level for. Valid zones are between 0 and 
	CORE_LOG_ZONE_START. Zones are user defined within that range.
Level
	The level we are setting. The enumeration coreDbgLogLevel_t defines the 
	enumerated levels. However, valid levels are 0 through 255.

RETURN VALUE

If successful, coreAppLogZoneInit() returns 0. If an error occurs, it returns a value of -1 and sets errno to one of the following values:

errno Value	Condition
EINVAL	Pointer to coreAppSPEC_t NULL, or invalid zone or level.

MULTITHREAD SAFETY LEVEL

MT-safe.