next up previous contents index
Next: 15.19 Annotations Up: 15.18 Serial-line Remote Debugging Previous: 15.18.8 gdb_serial_send: vector to

gdb_pc_com_init: (X86 PC) set up serial-line debugging over a COM port

   

SYNOPSIS

#include <oskit/gdb.h>

void gdb_pc_com_init(int com_port, struct termios *com_params);

DESCRIPTION

This is a simple ``wrapper'' function which ties together all of the OSKit's remote debugging facilities to automatically create a complete remote debugging environment for a specific, typical configuration: namely, remote serial-line debugging on a PC through a COM port. This function can be used as-is if this configuration happens to suit your purposes, or it can be used as an example for setting up the debugging facilities for other configurations.

Specifically, this function does the following:

PARAMETERS

com_port
The COM port number through which to communicate: must be 1, 2, 3, or 4.
com_params
A pointer to a termios structure defining the required serial port communication parameters. If this parameter is NULL, the serial port is set up for 9600,8,N,1 by default.

DEPENDENCIES

gdb_trap
15.17.5
gdb_signal
15.17.9
gdb_serial_signal
15.18.2
gdb_serial_recv
15.18.7
gdb_serial_send
15.18.8
com_cons_init
15.13.8
com_cons_getchar
15.13.9
com_cons_putchar
15.13.10
com_cons_enable_receive_interrupt
15.13.12
base_idt
15.7.4
base_raw_termios
15.13.4


next up previous contents index
Next: 15.19 Annotations Up: 15.18 Serial-line Remote Debugging Previous: 15.18.8 gdb_serial_send: vector to

Utah Flux Research Group