-Wpointer-sign: gdb_byte -> char.

[binutils-gdb.git] / gdb / gdb.h

diff --git a/gdb/gdb.h b/gdb/gdb.h
index aa75612a6c62241accb3c62540212999de6f4507..8060443149ffeb8abb35a02434de4e0c8eb78220 100644 (file)
--- a/gdb/gdb.h
+++ b/gdb/gdb.h
@@ -1,12 +1,11 @@
 /* Library interface into GDB.
-   Copyright 1999, 2001
-   Free Software Foundation, Inc.
+   Copyright (C) 1999-2013 Free Software Foundation, Inc.
 
    This file is part of GDB.
 
    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
+   the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
@@ -15,46 +14,45 @@
    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., 59 Temple Place - Suite 330,
-   Boston, MA 02111-1307, USA.  */
+   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
 #ifndef GDB_H
 #define GDB_H
 
+struct ui_out;
+
 /* Return-code (RC) from a gdb library call.  (The abreviation RC is
    taken from the sim/common directory.) */
 
 enum gdb_rc {
   /* The operation failed.  The failure message can be fetched by
-     calling ``char *error_last_message(void)''. The value is
-     determined by the catch_errors() interface. */
+     calling ``char *error_last_message(void)''.  The value is
+     determined by the catch_errors() interface.  The MSG parameter is
+     set to a freshly allocated copy of the error message.  */
   /* NOTE: Since ``defs.h:catch_errors()'' does not return an error /
      internal / quit indication it is not possible to return that
-     here. */
+     here.  */
   GDB_RC_FAIL = 0,
-  /* No error occured but nothing happened. Due to the catch_errors()
-     interface, this must be non-zero. */
+  /* No error occured but nothing happened.  Due to the catch_errors()
+     interface, this must be non-zero.  */
   GDB_RC_NONE = 1,
-  /* The operation was successful. Due to the catch_errors()
-     interface, this must be non-zero. */
+  /* The operation was successful.  Due to the catch_errors()
+     interface, this must be non-zero.  */
   GDB_RC_OK = 2
 };
 
 
-/* Print the specified breakpoint on GDB_STDOUT. (Eventually this
-   function will ``print'' the object on ``output''). */
-enum gdb_rc gdb_breakpoint_query (/* struct {ui,gdb}_out *output, */ int bnum);
-
-/* Create a breakpoint at ADDRESS (a GDB source and line). */
-enum gdb_rc gdb_breakpoint (char *address, char *condition,
-                           int hardwareflag, int tempflag,
-                           int thread, int ignore_count);
+/* Print the specified breakpoint on GDB_STDOUT.  (Eventually this
+   function will ``print'' the object on ``output'').  */
+enum gdb_rc gdb_breakpoint_query (struct ui_out *uiout, int bnum,
+                                 char **error_message);
 
-/* Switch thread and print notification. */
-enum gdb_rc gdb_thread_select (/* output object */ char *tidstr);
+/* Switch thread and print notification.  */
+enum gdb_rc gdb_thread_select (struct ui_out *uiout, char *tidstr,
+                              char **error_message);
 
-/* Print a list of known thread ids. */
-enum gdb_rc gdb_list_thread_ids (/* output object */);
+/* Print a list of known thread ids.  */
+enum gdb_rc gdb_list_thread_ids (struct ui_out *uiout,
+                                char **error_message);
 
 #endif