os/ossrv/genericopenlibs/openenvcore/liblogger/inc/liblogger.dosc
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
     1 /** @file ../inc/liblogger.h
     2 @internalComponent
     3 */
     4 
     5 /** @fn  LibTracer(TLibTraceMessageType aLogMessageType,char *aFileName,int aLine,char *aFormat,...)
     6 
     7 @param aLogMessageType Type of the log message
     8 @param aFileName pointer to the file name 
     9 @param aLine line number
    10 @param aFormat pointer to the message format and ... Variable arguments
    11 
    12 Description:
    13 This is a message logging interface.
    14 
    15 @return   Upon successful completion it returns number to bytes write into the file .
    16 
    17 
    18 @publishedAll
    19 @externallyDefinedApi
    20 
    21 */
    22 /** @fn  LibTracerMarkerList(TLibTraceMessageType aLogMessageType,char *aFileName,int aLine,char *aFormat,VA_LIST* aMarkerList)
    23 
    24 @param aLogMessageType Type of the log message
    25 @param aFileName pointer to the file name 
    26 @param aLine line number
    27 @param aFormat pointer to the message format
    28 @param aMarkerList Variable list
    29 
    30 Description:
    31 This is a message logging interface.
    32 
    33 @return   Upon successful completion it returns number to bytes write into the file .
    34 
    35 @publishedAll
    36 @externallyDefinedApi
    37 
    38 */
    39 
    40 /** @fn  LibTracerPartialHexDump(TLibTraceMessageType aLogMessageType,char *aFileName,int aLine,char *aMessage,char *aStr,int aStrLen)
    41 
    42 @param aLogMessageType Type of the log message
    43 @param aFileName pointer to the file name 
    44 @param aLine line number
    45 @param aMessage pointer to the message as first line
    46 @param aStr Dump string.  
    47 @param aStrLen Dump string length. 
    48 
    49 Description:
    50 It dumps the message in hex format of specific dumps.
    51 
    52 @return   Upon successful completion it returns number to bytes write into the file .
    53 
    54 @publishedAll
    55 @externallyDefinedApi
    56 
    57 */
    58 
    59 /** @fn  LibTracerHexDump(TLibTraceMessageType aLogMessageType,char *aFileName,int aLine,char *aMessage,char *aFormat,...)
    60 
    61 @param aLogMessageType Type of the log message
    62 @param aFileName pointer to the file name 
    63 @param aLine line number
    64 @param aMessage pointer to the message as first line
    65 @param aFormat pointer to the message format and ... Variable arguments
    66 
    67 
    68 Description:
    69 It dumps the message in hex format.
    70 
    71 @return   Upon successful completion it returns number to bytes write into the file .
    72 
    73 @publishedAll
    74 @externallyDefinedApi
    75 
    76 */
    77 
    78 /** @fn  LibTracerHexDumpMarkerList(TLibTraceMessageType aLogMessageType,char *aFileName,int aLine,char *aMessage,char *aFormat,VA_LIST* aMarkerList)
    79 
    80 @param aLogMessageType Type of the log message
    81 @param aFileName pointer to the file name 
    82 @param aLine line number
    83 @param aMessage pointer to the message as first line
    84 @param aFormat pointer to the message format 
    85 @param aMarkerList Variable list
    86 
    87 
    88 Description:
    89 It dumps the message in hex format.
    90 
    91 @return   Upon successful completion it returns number to bytes write into the file .
    92 
    93 @publishedAll
    94 @externallyDefinedApi
    95 
    96 */
    97 
    98 /** @fn  LibLineExecTracer(char *aFileName, int aLine)
    99 
   100 @param aFileName pointer to the file name 
   101 @param aLine line number
   102 
   103 Description:
   104 It Only logs filename and line no with timestamp.
   105 
   106 @return   Upon successful completion it returns number to bytes write into the file .
   107 
   108 @publishedAll
   109 @externallyDefinedApi
   110 
   111 */
   112 
   113 
   114 /** @fn  LibMessageTracer(TLibTraceMessageType aLogMessageType,char *aFormat,VA_LIST* aMarkerList)
   115 
   116 @param aLogMessageType Type of the log message
   117 @param aFormat pointer to the message format 
   118 @param aMarkerList Variable list
   119 
   120 Description:
   121 It Only logs/traces message without timestamp
   122 
   123 @return   Upon successful completion it returns number to bytes write into the file .
   124 
   125 @publishedAll
   126 @externallyDefinedApi
   127 
   128 */
   129 
   130 
   131 /** @fn  LibHexDumpMessagePartTracer(TLibTraceMessageType aLogMessageType,char* aMessage,char *aFormat,VA_LIST* aMarkerList)
   132 
   133 @param aLogMessageType Type of the log message
   134 @param aMessage pointer to the message as first line
   135 @param aFormat pointer to the message format 
   136 @param aMarkerList Variable list
   137 
   138 Description:
   139 It Only logs/traces message without timestamp
   140 
   141 @return   Upon successful completion it returns number to bytes write into the file .
   142 
   143 @publishedAll
   144 @externallyDefinedApi
   145 
   146 */
   147 
   148 /** @typedef typedef enum TLibTraceMessageType TLibTraceMessageType
   149 
   150 enums,defines log message type (Info/Minor/Major/Critical)
   151 
   152 @publishedAll
   153 @released
   154 */
   155 
   156 /** @def LOG_BITS
   157 
   158 only logging for critical/major
   159 
   160 @publishedAll
   161 @released
   162 */
   163 
   164 /** @def LOG_FILE_NAME_LINE
   165 
   166 This macro will be used for file and line no.
   167 
   168 @publishedAll
   169 @released
   170 */
   171 
   172 
   173 /** @def LIB_TRACE
   174 
   175 Usage:
   176 @code
   177 LIB_TRACE(<messagetype>{ELibTraceTypeInfo|ELibTraceTypeMinor|ELibTraceTypeMajor|ELibTraceTypeCritical},format,args);
   178 @endcode
   179 
   180 @publishedAll
   181 @released
   182 */
   183 
   184 /** @def LIB_TRACE_DUMP
   185 
   186 Usage:
   187 @code
   188 LIB_TRACE_DUMP(<messagetype>{ELibTraceTypeInfo|ELibTraceTypeMinor|ELibTraceTypeMajor|ELibTraceTypeCritical},message, // user wants to add any message before dump, (i.e. TCP message)format,args);@publishedAll
   189 @endcode
   190 
   191 @released
   192 */
   193 
   194 
   195 /** @def LIB_TRACE_DUMP_LEN
   196 
   197 Usage:
   198 @code
   199 LIB_TRACE_DUMP_LEN(<messagetype>{ELibTraceTypeInfo|ELibTraceTypeMinor|ELibTraceTypeMajor|ELibTraceTypeCritical},message, // user wants to add any message before dump, (i.e. TCP message)umpstring,stringlength);
   200 @endcode
   201 
   202 @publishedAll
   203 @released
   204 */