DragonFly On-Line Manual Pages

Search: Section:  

LOGC_LOGERROR(3)                 User Manuals                 LOGC_LOGERROR(3)


NAME

       logc_logError, logc_logErrorBasic, logc_logErrorWarning,
       logc_logErrorInfo, logc_logErrorFine, logc_logErrorFinest - nglogc
       error logging


SYNOPSIS

       #include <nglogc/log.h>

       logc_error_t
       logc_logError(
           uint16_t ident, logc_logLevel_t level, logc_error_t err, const
           char* format, ...
           );
       logc_error_t
       logc_logErrorBasic(
           uint16_t ident, logc_error_t err, const char* format, ...
           );
       logc_error_t
       logc_logErrorWarning(
           uint16_t ident, logc_error_t err, const char* format, ...
           );
       logc_error_t
       logc_logErrorInfo(
           uint16_t ident, logc_error_t err, const char* format, ...
           );
       logc_error_t
       logc_logErrorFine(
           uint16_t ident, logc_error_t err, const char* format, ...
           );
       logc_error_t
       logc_logErrorFinest(
           uint16_t ident, logc_error_t err, const char* format, ...
           );


DESCRIPTION

       The functions in the logc_logError() family are used for error logging.
       The function logc_logError() has an logc_logLevel_t argument for the
       log level of the statement. The rest of the functions
       logc_logErrorBasic(), logc_logErrorWarning(), logc_logErrorInfo(),
       logc_logErrorFine() and logc_logErrorFinest() have the log level in
       their name and can be also controlled by define switches.
       The functions logc_logErrorFine() and logc_logErrorFinest() 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_logError()
           function. The other functions have the log level in their name.
       err
           Error to log. Is printed as hexadecimal value.
       format
           Logmessage as format string.

   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_log(3), logc_logArray(3), logc_logEnter(3), logc_logger(3),
       logc_defines(3), the project site http://netgarage.org

Linux                            October 2009                 LOGC_LOGERROR(3)

Search: Section: