/usr/include/gammu/gammu-debug.h is in libgammu-dev 1.38.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 | /**
* \file gammu-debug.h
* \author Michal Čihař
*
* Debuging handling.
*/
#ifndef __gammu_debug_h
#define __gammu_debug_h
/**
* \defgroup Debug Debug
* Debuging handling.
*/
#ifdef __cplusplus
extern "C" {
#endif
#include <stdio.h>
#include <gammu-error.h>
#include <gammu-misc.h>
/**
* Debugging configuration.
* \ingroup Debug
*/
typedef struct _GSM_Debug_Info GSM_Debug_Info;
/**
* Sets logging function.
*
* \param info Function to call.
* \param data User data to pass as a second parameter to callback.
* \param privdi Pointer to debug information data.
* \return Error code.
*
* \ingroup Debug
*/
GSM_Error GSM_SetDebugFunction(GSM_Log_Function info, void *data,
GSM_Debug_Info * privdi);
/**
* Sets debug file.
*
* \param info File path.
* \param privdi Pointer to debug information data.
* \return Error code.
*
* \ingroup Debug
*/
GSM_Error GSM_SetDebugFile(const char *info, GSM_Debug_Info * privdi);
/**
* Sets debug file.
*
* \param fd File descriptor.
* \param privdi Pointer to debug information data.
* \param closable Whether Gammu can close the file when it is no longer
* needed for debug output. Please note that stderr or stdout are never
* closed.
* \return Error code.
*
* \ingroup Debug
*/
GSM_Error GSM_SetDebugFileDescriptor(FILE * fd, gboolean closable,
GSM_Debug_Info * privdi);
/**
* Returns global debug settings.
*
* \return Pointer to global settings.
*
* \ingroup Debug
*/
GSM_Debug_Info *GSM_GetGlobalDebug(void);
/**
* Gets debug information for state machine.
*
* \param s State machine data
* \return Debug information.
*
* \ingroup StateMachine
*/
GSM_Debug_Info *GSM_GetDebug(GSM_StateMachine * s);
/**
* Returns debug information active for state machine. Please note that
* it can be either global debug or state machine debug structure,
* depending on use_global flag. For configuring usite GSM_GetDebug.
*
* \param s State machine data
* \return Debug information.
*
* \ingroup StateMachine
*/
GSM_Debug_Info *GSM_GetDI(GSM_StateMachine * s);
/**
* Sets debug level.
*
* \param info Level as text.
* \param privdi Pointer to debug information data.
* \return True on success.
*
* \ingroup Debug
*/
gboolean GSM_SetDebugLevel(const char *info, GSM_Debug_Info * privdi);
/**
* Sets debug encoding.
*
* \param info Encoding to set.
* \param privdi Pointer to debug information data.
* \return True on success.
*
* \ingroup Debug
*/
gboolean GSM_SetDebugCoding(const char *info, GSM_Debug_Info * privdi);
/**
* Enables using of global debugging configuration. Makes no effect on
* global debug configuration.
*
* \param info Enable global debug usage..
* \param privdi Pointer to debug information data.
* \return True on success.
*
* \ingroup Debug
*/
gboolean GSM_SetDebugGlobal(gboolean info, GSM_Debug_Info * privdi);
/**
* Logs error to debug log with additional message.
*
* \param s State machine structure pointer.
* \param message String to be show in message.
* \param err Error code.
*
* \ingroup Debug
*/
void GSM_LogError(GSM_StateMachine * s, const char *message,
const GSM_Error err);
/**
* Prints string to defined debug log.
*
* \param s State machine, where to print.
* \param format Format string as for printf.
* \return Upon successful return, these functions return the number of characters printed (as printf).
*
* \ingroup Debug
*/
PRINTF_STYLE(2, 3)
int smprintf(GSM_StateMachine * s, const char *format, ...);
#ifdef __cplusplus
}
#endif
#endif
/* Editor configuration
* vim: noexpandtab sw=8 ts=8 sts=8 tw=72:
*/
|