DragonFly On-Line Manual Pages

Search: Section:  

LOGC_LOG(3)                      User Manuals                      LOGC_LOG(3)


NAME

       logc_log, logc_logBasic, logc_logWarning, logc_logInfo, logc_logFine,
       logc_logFinest - nglogc info logging


SYNOPSIS

       #include <nglogc/log.h>

       logc_error_t
       logc_log(
           uint16_t ident, logc_logLevel_t level, const char* format, ...
           );
       logc_error_t
       logc_logBasic(
           uint16_t ident, const char* format, ...
           );
       logc_error_t
       logc_logWarning(
           uint16_t ident, const char* format, ...
           );
       logc_error_t
       logc_logInfo(
           uint16_t ident, const char* format, ...
           );
       logc_error_t
       logc_logFine(
           uint16_t ident, const char* format, ...
           );
       logc_error_t
       logc_logFinest(
           uint16_t ident, const char* format, ...
           );


DESCRIPTION

       The functions in the logc_log() family are used for info logging.  The
       function logc_log() has an logc_logLevel_t argument for the log level
       of the statement. The rest of the functions logc_logBasic(),
       logc_logWarning(), logc_logInfo(), logc_logFine() and logc_logFinest()
       have the log level in their name and can be also controlled by define
       switches.
       The functions logc_logFine() and logc_logFinest() 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_log()
           function. The other functions have the log level in their name.
       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_logError(3), logc_logArray(3), logc_logEnter(3), logc_logger(3),
       logc_defines(3), the project site http://netgarage.org

Linux                            October 2009                      LOGC_LOG(3)

Search: Section: