gdbstub.h File Reference

GDB remote debugging. More...

#include <stdint.h>
#include <ipxe/tables.h>
#include <bits/gdbmach.h>

Go to the source code of this file.

Data Structures
struct	gdb_transport
	A transport mechanism for the GDB protocol. More...

Macros
#define	GDB_TRANSPORTS   __table ( struct gdb_transport, "gdb_transports" )
#define	__gdb_transport   __table_entry ( GDB_TRANSPORTS, 01 )

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (FORBIDDEN)
struct gdb_transport *	find_gdb_transport (const char *name)
	Look up GDB transport by name.
void	gdbstub_start (struct gdb_transport *trans)
	Break into the debugger using the given transport.
void	gdbstub_handler (int signo, gdbreg_t *regs)
	Interrupt handler.

Detailed Description

GDB remote debugging.

Definition in file gdbstub.h.

Macro Definition Documentation

GDB_TRANSPORTS

#define GDB_TRANSPORTS   __table ( struct gdb_transport, "gdb_transports" )

Definition at line 51 of file gdbstub.h.

Referenced by find_gdb_transport().

__gdb_transport

struct gdb_transport udp_gdb_transport __gdb_transport   __table_entry ( GDB_TRANSPORTS, 01 )

Definition at line 53 of file gdbstub.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

FORBIDDEN

)

find_gdb_transport()

struct gdb_transport * find_gdb_transport ( const char * name )

extern

Look up GDB transport by name.

Parameters

name	Name of transport

Return values

GDB	transport or NULL

Definition at line 392 of file gdbstub.c.

                                                              {
        struct gdb_transport *trans;
 
        for_each_table_entry ( trans, GDB_TRANSPORTS ) {
                if ( strcmp ( trans->name, name ) == 0 ) {
                        return trans;
                }
        }
        return NULL;
}

References for_each_table_entry, GDB_TRANSPORTS, gdb_transport::name, name, NULL, and strcmp().

Referenced by parse_gdb_transport().

gdbstub_start()

void gdbstub_start ( struct gdb_transport * trans )

extern

Break into the debugger using the given transport.

Parameters

trans

GDB transport

Definition at line 403 of file gdbstub.c.

                                                   {
        stub.trans = trans;
        stub.payload = &stub.buf [ 1 ];
        gdbmach_init();
        gdbmach_breakpoint();
}

References gdbmach_breakpoint(), gdbmach_init(), and stub.

Referenced by gdbstub_exec().

gdbstub_handler()

void gdbstub_handler ( int signo, gdbreg_t * regs )

extern

Interrupt handler.

@signo POSIX signal number @regs CPU register snapshot

Definition at line 372 of file gdbstub.c.

                                                   {
        char packet [ SIZEOF_PAYLOAD + 4 ];
        size_t len, i;
 
        /* A transport must be set up */
        if ( !stub.trans ) {
                return;
        }
 
        stub.signo = signo;
        stub.regs = regs;
        stub.exit_handler = 0;
        gdbstub_report_signal ( &stub );
        while ( !stub.exit_handler && ( len = stub.trans->recv ( packet, sizeof ( packet ) ) ) > 0 ) {
                for ( i = 0; i < len; i++ ) {
                        gdbstub_parse ( &stub, packet [ i ] );
                }
        }
}

References gdbstub_parse(), gdbstub_report_signal(), len, regs, gdbstub::signo, SIZEOF_PAYLOAD, and stub.

Referenced by gdbmach_handler().