Debug

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

Sets logging function.

Parameters:
  • info -

    Function to call.

  • data -

    User data to pass as a second parameter to callback.

  • privdi -

    Pointer to debug information data.

Return:

Error code.

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

Sets debug file.

Parameters:
  • info -

    File path.

  • privdi -

    Pointer to debug information data.

Return:

Error code.

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

Sets debug file.

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.

Return:

Error code.

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.

Parameters:
  • s -

    State machine data

Return:

Debug information.

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.

Parameters:
  • s -

    State machine data

Return:

Debug information.

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

Sets debug level.

Parameters:
  • info -

    Level as text.

  • privdi -

    Pointer to debug information data.

Return:

True on success.

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

Sets debug encoding.

Parameters:
  • info -

    Encoding to set.

  • privdi -

    Pointer to debug information data.

Return:

True on success.

gboolean GSM_SetDebugGlobal(gboolean info, GSM_Debug_Info * privdi)

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

Parameters:
  • info -

    Enable global debug usage..

  • privdi -

    Pointer to debug information data.

Return:

True on success.

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.

Parameters:
  • s -

    State machine, where to print.

  • format -

    Format string as for printf.

Return:

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

typedef struct _GSM_Debug_Info GSM_Debug_Info

Debugging configuration.

Previous topic

Date and time

Next topic

Error handling

This Page