DragonFly On-Line Manual Pages

Search: Section:  


LOGC_LOGARRAY(3)                 User Manuals                 LOGC_LOGARRAY(3)

NAME

logc_logArray, logc_logArrayBasic, logc_logArrayWarning, logc_logArrayInfo, logc_logArrayFine, logc_logArrayFinest - nglogc data array logging

SYNOPSIS

#include <nglogc/log.h> logc_error_t logc_logArray( uint16_t ident, logc_logLevel_t level, const char* desc, const uint8_t* array, size_t len ); logc_error_t logc_logBasic( uint16_t ident, const char* desc, const uint8_t* array, size_t len ); logc_error_t logc_logWarning( uint16_t ident, const char* desc, const uint8_t* array, size_t len ); logc_error_t logc_logInfo( uint16_t ident, const char* desc, const uint8_t* array, size_t len ); logc_error_t logc_logFine( uint16_t ident, const char* desc, const uint8_t* array, size_t len ); logc_error_t logc_logFinest( uint16_t ident, const char* desc, const uint8_t* array, size_t len );

DESCRIPTION

The functions in the logc_logArray() family are used for data array logging. The array is printed as hexadecimal. The function logc_logArray() has an logc_logLevel_t argument for the log level of the statement. The rest of the functions logc_logArrayBasic(), logc_logArrayWarning(), logc_logArrayInfo(), logc_logArrayFine() and logc_logArrayFinest() have the log level in their name and can be also controlled by define switches. The functions logc_logArrayFine() and logc_logArrayFinest() are disabled per default and must be enabled with a define switch to use. See logc_defines(3). Parameters ident Identifier of the logger which must be registered first. level The log level of the statement. Could be LOG_BASIC, LOG_WARNING, LOG_INFO, LOG_FINE or LOG_FINEST. Only used for logc_logArray() function. The other functions have the log level in their name. desc Description string of the data array. array data array, printed in hexadecimal. len Length of the array. Return value Upon successful return, these functions return LOG_ERR_OK which is an uint32_t type and has the decimal value 0. In error cases these errors can be returned: LOG_ERR_NULL the format string is a NULL pointer. LOG_ERR_NOT_FOUND invalid logger ID. LOG_ERR_LEVEL log message is not processed because of the log level of the logger.

BUG REPORT

For bugreporting write a mail to ebrosius@netgarage.org or use the issues tracker on the project hosting site http://code.google.com/p/nglogc

COPYRIGHT

nglogc is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

AUTHOR

Dennis Krzyzaniak <ebrosius@netgarage.org>

SEE ALSO

logc_logError(3), logc_log(3), logc_logEnter(3), logc_logger(3), logc_defines(3), the project site http://netgarage.org Linux October 2009 LOGC_LOGARRAY(3)

Search: Section: