GLib.on_error_stack_trace
Description: Reference for GLib.on_error_stack_trace

### Function

# GLibon_error_stack_trace

#### Declaration [src]

    void
    g_on_error_stack_trace (
      const gchar* prg_name
    )

#### Description [src]

Invokes gdb, which attaches to the current process and shows a stack trace. Called by `g_on_error_query()` when the “[S]tack trace” option is selected. You can get the current process’s program name with g_get_prgname(), assuming that you have called `gtk_init()` or gdk_init().

This function may cause different actions on non-UNIX platforms.

When running on Windows, this function is not called by g_on_error_query(). If called directly, it will raise an exception, which will crash the program. If the `G_DEBUGGER` environment variable is set, a debugger will be invoked to attach and handle that exception (see Running GLib Applications).

#### Parameters

`prg_name`

  Type: `const gchar*`

  The program name, needed by gdb for the “[S]tack trace” option, or `NULL` to use a default string.

  The argument can be `NULL`.
  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.