1 /* Kernel Object Display generic routines and callbacks 2 Copyright 1998, 1999, 2000 Free Software Foundation, Inc. 3 4 Written by Fernando Nasser <fnasser@cygnus.com> for Cygnus Solutions. 5 6 This file is part of GDB. 7 8 This program is free software; you can redistribute it and/or modify 9 it under the terms of the GNU General Public License as published by 10 the Free Software Foundation; either version 2 of the License, or 11 (at your option) any later version. 12 13 This program is distributed in the hope that it will be useful, 14 but WITHOUT ANY WARRANTY; without even the implied warranty of 15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 GNU General Public License for more details. 17 18 You should have received a copy of the GNU General Public License 19 along with this program; if not, write to the Free Software 20 Foundation, Inc., 59 Temple Place - Suite 330, 21 Boston, MA 02111-1307, USA. */ 22 23 #include "defs.h" 24 #include "command.h" 25 #include "gdbcmd.h" 26 #include "target.h" 27 #include "gdb_string.h" 28 #include "kod.h" 29 30 /* Prototypes for exported functions. */ 31 void _initialize_kod (void); 32 33 /* Prototypes for local functions. */ 34 static void info_kod_command (char *, int); 35 static void load_kod_library (char *); 36 37 /* Prototypes for callbacks. These are passed into the KOD modules. */ 38 static void gdb_kod_display (char *); 39 static void gdb_kod_query (char *, char *, int *); 40 41 /* These functions are imported from the KOD module. 42 43 gdb_kod_open - initiates the KOD connection to the remote. The 44 first argument is the display function the module should use to 45 communicate with the user. The second argument is the query 46 function the display should use to communicate with the target. 47 This should call error() if there is an error. Otherwise it should 48 return a malloc()d string of the form: 49 50 NAME VERSION - DESCRIPTION 51 52 Neither NAME nor VERSION should contain a hyphen. 53 54 55 gdb_kod_request - This is used when the user enters an "info 56 <module>" request. The remaining arguments are passed as the first 57 argument. The second argument is the standard `from_tty' 58 argument. 59 60 61 gdb_kod_close - This is called when the KOD connection to the 62 remote should be terminated. */ 63 64 static char *(*gdb_kod_open) (kod_display_callback_ftype *display, 65 kod_query_callback_ftype *query); 66 static void (*gdb_kod_request) (char *, int); 67 static void (*gdb_kod_close) (); 68 69 70 /* Name of inferior's operating system. */ 71 char *operating_system; 72 73 /* We save a copy of the OS so that we can properly reset when 74 switching OS's. */ 75 static char *old_operating_system; 76 77 /* Print a line of data generated by the module. */ 78 79 static void 80 gdb_kod_display (char *arg) 81 { 82 printf_filtered ("%s", arg); 83 } 84 85 /* Queries the target on behalf of the module. */ 86 87 static void 88 gdb_kod_query (char *arg, char *result, int *maxsiz) 89 { 90 LONGEST bufsiz = 0; 91 92 /* Check if current target has remote_query capabilities. If not, 93 it does not have kod either. */ 94 bufsiz = target_read_partial (¤t_target, TARGET_OBJECT_KOD, 95 NULL, NULL, 0, 0); 96 if (bufsiz < 0) 97 { 98 strcpy (result, 99 "ERR: Kernel Object Display not supported by current target\n"); 100 return; 101 } 102 103 /* Just get the maximum buffer size. */ 104 105 /* Check if *we* were called just for getting the buffer size. */ 106 if (*maxsiz == 0) 107 { 108 *maxsiz = bufsiz; 109 strcpy (result, "OK"); 110 return; 111 } 112 113 /* Check if caller can handle a buffer this large, if not, adjust. */ 114 if (bufsiz > *maxsiz) 115 bufsiz = *maxsiz; 116 117 /* See if buffer can hold the query (usually it can, as the query is 118 short). */ 119 if (strlen (arg) >= bufsiz) 120 error ("kod: query argument too long"); 121 122 /* Send actual request. */ 123 if (target_read_partial (¤t_target, TARGET_OBJECT_KOD, 124 arg, result, 0, bufsiz) < 0) 125 strcpy (result, "ERR: remote query failed"); 126 } 127 128 /* Print name of kod command after selecting the appropriate kod 129 formatting library module. As a side effect we create a new "info" 130 subcommand which is what the user actually uses to query the OS. */ 131 132 static void 133 kod_set_os (char *arg, int from_tty, struct cmd_list_element *command) 134 { 135 char *p; 136 137 /* NOTE: cagney/2002-03-17: The deprecated_add_show_from_set() 138 function clones the set command passed as a parameter. The clone 139 operation will include (BUG?) any ``set'' command callback, if 140 present. Commands like ``info set'' call all the ``show'' 141 command callbacks. Unfortunately, for ``show'' commands cloned 142 from ``set'', this includes callbacks belonging to ``set'' 143 commands. Making this worse, this only occures if 144 deprecated_add_show_from_set() is called after add_cmd_sfunc() 145 (BUG?). */ 146 147 if (cmd_type (command) != set_cmd) 148 return; 149 150 /* If we had already had an open OS, close it. */ 151 if (gdb_kod_close) 152 (*gdb_kod_close) (); 153 154 /* Also remove the old OS's command. */ 155 if (old_operating_system) 156 { 157 delete_cmd (old_operating_system, &infolist); 158 xfree (old_operating_system); 159 } 160 161 if (! operating_system || ! *operating_system) 162 { 163 /* If user set operating system to empty, we want to forget we 164 had a module open. Setting these variables is just nice for 165 debugging and clarity. */ 166 gdb_kod_open = NULL; 167 gdb_kod_request = NULL; 168 gdb_kod_close = NULL; 169 } 170 else 171 { 172 char *kodlib; 173 174 old_operating_system = xstrdup (operating_system); 175 176 load_kod_library (operating_system); 177 178 kodlib = (*gdb_kod_open) (gdb_kod_display, gdb_kod_query); 179 180 /* Add kod related info commands to gdb. */ 181 add_info (operating_system, info_kod_command, 182 "Displays information about Kernel Objects."); 183 184 p = strrchr (kodlib, '-'); 185 if (p != NULL) 186 p++; 187 else 188 p = "Unknown KOD library"; 189 printf_filtered ("%s - %s\n", operating_system, p); 190 191 xfree (kodlib); 192 } 193 } 194 195 /* Print information about currently known kernel objects of the 196 specified type or a list of all known kernel object types if 197 argument is empty. */ 198 199 static void 200 info_kod_command (char *arg, int from_tty) 201 { 202 (*gdb_kod_request) (arg, from_tty); 203 } 204 205 /* Print name of kod command after selecting the appropriate kod 206 formatting library module. */ 207 208 static void 209 load_kod_library (char *lib) 210 { 211 #if 0 212 /* FIXME: Don't have the eCos code here. */ 213 if (! strcmp (lib, "ecos")) 214 { 215 gdb_kod_open = ecos_kod_open; 216 gdb_kod_request = ecos_kod_request; 217 gdb_kod_close = ecos_kod_close; 218 } 219 else 220 #endif /* 0 */ 221 if (! strcmp (lib, "cisco")) 222 { 223 gdb_kod_open = cisco_kod_open; 224 gdb_kod_request = cisco_kod_request; 225 gdb_kod_close = cisco_kod_close; 226 } 227 else 228 error ("Unknown operating system: %s\n", operating_system); 229 } 230 231 void 232 _initialize_kod (void) 233 { 234 struct cmd_list_element *c; 235 236 c = add_set_cmd ("os", no_class, var_string, 237 (char *) &operating_system, 238 "Set operating system", 239 &setlist); 240 set_cmd_sfunc (c, kod_set_os); 241 deprecated_add_show_from_set (c, &showlist); 242 } 243