1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/*
* BRLTTY - A background process providing access to the console screen (when in
* text mode) for a blind person using a refreshable braille display.
*
* Copyright (C) 1995-2014 by The BRLTTY Developers.
*
* BRLTTY comes with ABSOLUTELY NO WARRANTY.
*
* This is free software, placed under the terms of the
* GNU General Public License, as published by the Free Software
* Foundation; either version 2 of the License, or (at your option) any
* later version. Please see the file LICENSE-GPL for details.
*
* Web Page: http://mielke.cc/brltty/
*
* This software is maintained by Dave Mielke <dave@mielke.cc>.
*/
#ifndef BRLTTY_INCLUDED_LOG
#define BRLTTY_INCLUDED_LOG
#include "prologue.h"
#include <stdarg.h>
#ifdef HAVE_SYSLOG_H
#include <syslog.h>
#endif /* HAVE_SYSLOG_H */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
extern unsigned char systemLogLevel;
extern unsigned char stderrLogLevel;
#ifndef LOG_INFO
typedef enum {
LOG_EMERG,
LOG_ALERT,
LOG_CRIT,
LOG_ERR,
LOG_WARNING,
LOG_NOTICE,
LOG_INFO,
LOG_DEBUG
} SyslogLevel;
#endif /* log level definitions */
extern const char *const logLevelNames[];
extern const unsigned int logLevelCount;
#define LOG_FLG_CATEGORY 0X80
#define LOG_MSK_CATEGORY (LOG_FLG_CATEGORY - 1)
#define LOG_CATEGORY_INDEX(name) LOG_CTG_##name
#define LOG_CATEGORY(name) (LOG_FLG_CATEGORY | LOG_CATEGORY_INDEX(name))
typedef enum {
LOG_CATEGORY_INDEX(GENERIC_INPUT),
LOG_CATEGORY_INDEX(INPUT_PACKETS),
LOG_CATEGORY_INDEX(OUTPUT_PACKETS),
LOG_CATEGORY_INDEX(BRAILLE_KEYS),
LOG_CATEGORY_INDEX(KEYBOARD_KEYS),
LOG_CATEGORY_INDEX(CURSOR_TRACKING),
LOG_CATEGORY_INDEX(CURSOR_ROUTING),
LOG_CATEGORY_INDEX(UPDATE_EVENTS),
LOG_CATEGORY_INDEX(SPEECH_EVENTS),
LOG_CATEGORY_INDEX(ASYNC_EVENTS),
LOG_CATEGORY_INDEX(SERVER_EVENTS),
LOG_CATEGORY_INDEX(SERIAL_IO),
LOG_CATEGORY_INDEX(USB_IO),
LOG_CATEGORY_INDEX(BLUETOOTH_IO),
LOG_CATEGORY_INDEX(BRAILLE_DRIVER),
LOG_CATEGORY_INDEX(SPEECH_DRIVER),
LOG_CATEGORY_INDEX(SCREEN_DRIVER),
LOG_CATEGORY_COUNT /* must be last */
} LogCategoryIndex;
extern const char *getLogCategoryName (LogCategoryIndex index);
extern const char *getLogCategoryTitle (LogCategoryIndex index);
extern void disableAllLogCategories (void);
extern int setLogCategory (const char *name);
extern const char logCategoryName_all[];
extern const char logCategoryPrefix_disable;
extern unsigned char categoryLogLevel;
extern unsigned char logCategoryFlags[LOG_CATEGORY_COUNT];
#define LOG_CATEGORY_FLAG(name) logCategoryFlags[LOG_CATEGORY_INDEX(name)]
extern void openLogFile (const char *path);
extern void closeLogFile (void);
extern void openSystemLog (void);
extern void closeSystemLog (void);
extern int pushLogPrefix (const char *prefix);
extern int popLogPrefix (void);
typedef size_t LogDataFormatter (char *buffer, size_t size, const void *data);
extern void logData (int level, LogDataFormatter *formatLogData, const void *data);
extern void logMessage (int level, const char *format, ...) PRINTF(2, 3);
extern void vlogMessage (int level, const char *format, va_list *arguments);
extern void logBytes (int level, const char *label, const void *data, size_t length, ...) PRINTF(2, 5);
extern void logSymbol (int level, void *address, const char *format, ...) PRINTF(3, 4);
extern void logActionError (int error, const char *action);
extern void logSystemError (const char *action);
extern void logMallocError (void);
extern void logUnsupportedFeature (const char *name);
extern void logUnsupportedOperation (const char *name);
#define logUnsupportedFunction() logUnsupportedOperation(__func__)
extern void logPossibleCause (const char *cause);
#ifdef WINDOWS
extern void logWindowsError (DWORD code, const char *action);
extern void logWindowsSystemError (const char *action);
#ifdef __MINGW32__
extern void logWindowsSocketError (const char *action);
#endif /* __MINGW32__ */
#endif /* WINDOWS */
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* BRLTTY_INCLUDED_LOG */
|
