Debug

GSM_Error GSM_SetDebugFunction(GSM_Log_Function info, void * data, GSM_Debug_Info * privdi)

Sets logging function.

Return

Error code.

Parameters

• info -

  Function to call.

• data -

  User data to pass as a second parameter to callback.

• privdi -

  Pointer to debug information data.

GSM_Error GSM_SetDebugFile(const char * info, GSM_Debug_Info * privdi)

Sets debug file.

Return

Error code.

Parameters

• info -

  File path.

• privdi -

  Pointer to debug information data.

GSM_Error GSM_SetDebugFileDescriptor(FILE * fd, gboolean closable, GSM_Debug_Info * privdi)

Sets debug file.

Return

Error code.

Parameters

• fd -

  File descriptor.

• privdi -

  Pointer to debug information data.

• 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.

GSM_Debug_Info* GSM_GetGlobalDebug(void)

Returns global debug settings.

Return

Pointer to global settings.

GSM_Debug_Info* GSM_GetDebug(GSM_StateMachine * s)

Gets debug information for state machine.

Return

Debug information.

Parameters

• s -

  State machine data

GSM_Debug_Info* GSM_GetDI(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.

Return

Debug information.

Parameters

• s -

  State machine data

gboolean GSM_SetDebugLevel(const char * info, GSM_Debug_Info * privdi)

Sets debug level.

Return

True on success.

Parameters

• info -

  Level as text.

• privdi -

  Pointer to debug information data.

gboolean GSM_SetDebugCoding(const char * info, GSM_Debug_Info * privdi)

Sets debug encoding.

Return

True on success.

Parameters

• info -

  Encoding to set.

• privdi -

  Pointer to debug information data.

gboolean GSM_SetDebugGlobal(gboolean info, GSM_Debug_Info * privdi)

Enables using of global debugging configuration. Makes no effect on global debug configuration.

Return

True on success.

Parameters

• info -

  Enable global debug usage..

• privdi -

  Pointer to debug information data.

void GSM_LogError(GSM_StateMachine * s, const char * message, const GSM_Error err)

Logs error to debug log with additional message.

Parameters

• s -

  State machine structure pointer.

• message -

  String to be show in message.

• err -

  Error code.

int smprintf(GSM_StateMachine * s, const char * format, ...)

Prints string to defined debug log.

Return

Upon successful return, these functions return the number of characters printed (as printf).

Parameters

• s -

  State machine, where to print.

• format -

  Format string as for printf.

typedef GSM_Debug_Info

Debugging configuration.