david/ipxe
Archived
1
0
This repository has been archived on 2020-12-06. You can view files and clone it, but cannot push or open issues or pull requests.
ipxe/src/hci/commands/gdbstub_cmd.c
Michael Brown 7d5dcc9299 [parseopt] Refer to online documentation for command help
The online documentation (e.g. http://ipxe.org/cmd/ifopen), though not
yet complete, is far more comprehensive than could be provided within
the iPXE binary.  Save around 200 bytes (compressed) by removing the
command descriptions from the interactive help, and instead referring
users directly to the web page describing the relevant command.

Signed-off-by: Michael Brown <mcb30@ipxe.org>
2011-03-04 12:18:51 +00:00

111 lines
2.5 KiB
C

/*
* Copyright (C) 2008 Stefan Hajnoczi <stefanha@gmail.com>.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
FILE_LICENCE ( GPL2_OR_LATER );
#include <stdio.h>
#include <errno.h>
#include <assert.h>
#include <getopt.h>
#include <ipxe/command.h>
#include <ipxe/parseopt.h>
#include <ipxe/gdbstub.h>
/** @file
*
* GDB stub command
*
*/
/**
* Parse GDB transport name
*
* @v text Text
* @ret trans GDB transport
* @ret rc Return status code
*/
static int parse_gdb_transport ( const char *text,
struct gdb_transport **trans ) {
/* Sanity check */
assert ( text != NULL );
/* Find transport */
*trans = find_gdb_transport ( text );
if ( ! *trans ) {
printf ( "\"%s\": no such transport (is it compiled in?)\n",
text );
return -ENOTSUP;
}
return 0;
}
/** "gdbstub" options */
struct gdbstub_options {};
/** "gdbstub" option list */
static struct option_descriptor gdbstub_opts[] = {};
/** "gdbstub" command descriptor */
static struct command_descriptor gdbstub_cmd =
COMMAND_DESC ( struct gdbstub_options, gdbstub_opts, 1, MAX_ARGUMENTS,
"<transport> [<options>...]" );
/**
* The "gdbstub" command
*
* @v argc Argument count
* @v argv Argument list
* @ret rc Return status code
*/
static int gdbstub_exec ( int argc, char **argv ) {
struct gdbstub_options opts;
struct gdb_transport *trans;
int rc;
/* Parse options */
if ( ( rc = parse_options ( argc, argv, &gdbstub_cmd, &opts ) ) != 0 )
return rc;
/* Parse transport name */
if ( ( rc = parse_gdb_transport ( argv[optind++], &trans ) ) != 0 )
return rc;
/* Initialise transport */
if ( trans->init ) {
if ( ( rc = trans->init ( argc - optind,
&argv[optind] ) ) != 0 ) {
return rc;
}
}
/* Enter GDB stub */
gdbstub_start ( trans );
return 0;
}
/** GDB stub commands */
struct command gdbstub_commands[] __command = {
{
.name = "gdbstub",
.exec = gdbstub_exec,
},
};