From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29105 invoked by alias); 15 Jul 2006 05:49:15 -0000 Received: (qmail 28922 invoked by uid 22791); 15 Jul 2006 05:49:11 -0000 X-Spam-Check-By: sourceware.org Received: from nile.gnat.com (HELO nile.gnat.com) (205.232.38.5) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 15 Jul 2006 05:49:07 +0000 Received: from localhost (localhost [127.0.0.1]) by filtered-nile.gnat.com (Postfix) with ESMTP id BC36048CDD6 for ; Sat, 15 Jul 2006 01:49:04 -0400 (EDT) Received: from nile.gnat.com ([127.0.0.1]) by localhost (nile.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 15197-03-2 for ; Sat, 15 Jul 2006 01:49:04 -0400 (EDT) Received: from takamaka.act-europe.fr (unknown [70.71.0.212]) by nile.gnat.com (Postfix) with ESMTP id 94E8648CDC8 for ; Sat, 15 Jul 2006 01:49:03 -0400 (EDT) Received: by takamaka.act-europe.fr (Postfix, from userid 507) id 8F13D47EFA; Fri, 14 Jul 2006 22:49:02 -0700 (PDT) Date: Sat, 15 Jul 2006 05:49:00 -0000 From: Joel Brobecker To: gdb-patches@sources.redhat.com Subject: [RFA] set/unset/show substitute-path commands (take 2) Message-ID: <20060715054902.GD1393@adacore.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="bg08WKrSYDhXBjb5" Content-Disposition: inline User-Agent: Mutt/1.4i Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-07/txt/msg00170.txt.bz2 --bg08WKrSYDhXBjb5 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 1723 Hello, :ADDPATCH source.c: Here is a second crack at implementing the substitute-path feature taking into account all suggestions made so far (hopefully). It also includes Eli's suggestion to have "show substitute-path FROM". I have added a first attempt at making a test. It only tests the manipulation of the list of substitution rules, but not the applying of them while debugging a program, because I am not sure how to do that without resorting to shell commands such as mkdir et al. It's still better than nothing, though. Documentatio will be revised as soon as the code goes it. It's a waste of time to have Eli review it if anything during the review changes the feature in such a way that the documentation needs to be updated. 2006-07-14 Joel Brobecker * source.c: #include gdb_assert.h. (substitute_path_rule): New struct. (substitute_path_rules): New static global variable. (substitute_path_rule_matches): New function. (get_substitute_path_rule): New function. (rewrite_source_path): New function. (find_and_open_source): Add source path rewriting support. (strip_trailing_directory_separator): New function. (make_cleanup_argv): New function. (add_substitute_path_rule): New function. (delete_substitute_path_rule): New function. (show_substitute_path_command): New function. (unset_substitute_path_command): New function. (set_substitute_path_command): New function. (_initialize_source): Add new substitute-path commands. 2006-07-14 Joel Brobecker * gdb.base/subst.exp: New testcase. OK to commit? Thanks, -- Joel --bg08WKrSYDhXBjb5 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="subst.diff" Content-length: 11825 Index: source.c =================================================================== RCS file: /cvs/src/src/gdb/source.c,v retrieving revision 1.75 diff -u -p -r1.75 source.c --- source.c 15 May 2006 15:50:13 -0000 1.75 +++ source.c 15 Jul 2006 05:35:50 -0000 @@ -29,6 +29,7 @@ #include "gdbcmd.h" #include "frame.h" #include "value.h" +#include "gdb_assert.h" #include #include "gdb_string.h" @@ -73,6 +74,17 @@ static void show_directories (char *, in char *source_path; +/* Support for source path substitution commands. */ + +struct substitute_path_rule +{ + char *from; + char *to; + struct substitute_path_rule *next; +}; + +static struct substitute_path_rule *substitute_path_rules = NULL; + /* Symtab of default file for listing lines of. */ static struct symtab *current_source_symtab; @@ -828,6 +840,74 @@ source_full_path_of (char *filename, cha return 1; } +/* Return non-zero if RULE matches PATH, that is if the rule can be + applied to PATH. */ + +static int +substitute_path_rule_matches (const struct substitute_path_rule *rule, + const char *path) +{ + const int from_len = strlen (rule->from); + + /* The substitution rules are anchored at the start of the path, + so the path should start with rule->from. */ + + if (strncmp (path, rule->from, from_len) != 0) + return 0; + + /* Make sure that the region in the path that matches the substitution + rule is immediately followed by a directory separator (or the end of + string character). */ + + if (path[from_len] != '\0' && !IS_DIR_SEPARATOR (path[from_len])) + return 0; + + return 1; +} + +/* Find the substitute-path rule that applies to PATH and return it. + Return NULL if no rule applies. */ + +static struct substitute_path_rule * +get_substitute_path_rule (const char *path) +{ + struct substitute_path_rule *rule = substitute_path_rules; + + while (rule != NULL && !substitute_path_rule_matches (rule, path)) + rule = rule->next; + + return rule; +} + +/* If the user specified a source path substitution rule that applies + to PATH, then apply it and return the new path. This new path must + be deallocated afterwards. + + Return NULL if no substitution rule was specified by the user, + or if no rule applied to the given PATH. */ + +static char * +rewrite_source_path (const char *path) +{ + const struct substitute_path_rule *rule = get_substitute_path_rule (path); + char *new_path; + int from_len; + + if (rule == NULL) + return NULL; + + from_len = strlen (rule->from); + + /* Compute the rewritten path and return it. */ + + new_path = + (char *) xmalloc (strlen (path) + 1 + strlen (rule->to) - from_len); + strcpy (new_path, rule->to); + strcat (new_path, path + from_len); + + return new_path; +} + /* This function is capable of finding the absolute path to a source file, and opening it, provided you give it an OBJFILE and FILENAME. Both the DIRNAME and FULLNAME are only @@ -844,7 +924,7 @@ source_full_path_of (char *filename, cha FULLNAME is set to the absolute path to the file just opened. On Failure - A non valid file descriptor is returned. ( the return value is negitive ) + An invalid file descriptor is returned. ( the return value is negative ) FULLNAME is set to NULL. */ int find_and_open_source (struct objfile *objfile, @@ -857,8 +937,22 @@ find_and_open_source (struct objfile *ob int result; /* Quick way out if we already know its full name */ + if (*fullname) { + { + /* The user may have requested that source paths be rewritten + according to substitution rules he provided. If a substitution + rule applies to this path, then apply it. */ + char *rewritten_fullname = rewrite_source_path (*fullname); + + if (rewritten_fullname != NULL) + { + xfree (*fullname); + *fullname = rewritten_fullname; + } + } + result = open (*fullname, OPEN_MODE); if (result >= 0) return result; @@ -869,6 +963,17 @@ find_and_open_source (struct objfile *ob if (dirname != NULL) { + /* If necessary, rewrite the compilation directory name according + to the source path substitution rules specified by the user. */ + + char *rewritten_dirname = rewrite_source_path (dirname); + + if (rewritten_dirname != NULL) + { + make_cleanup (xfree, rewritten_dirname); + dirname = rewritten_dirname; + } + /* Replace a path entry of $cdir with the compilation directory name */ #define cdir_len 5 /* We cast strstr's result in case an ANSIhole has made it const, @@ -1587,6 +1692,207 @@ reverse_search_command (char *regex, int fclose (stream); return; } + +/* If the last character of PATH is a directory separator, then strip it. */ + +static void +strip_trailing_directory_separator (char *path) +{ + const int last = strlen (path) - 1; + + if (last < 0) + return; /* No stripping is needed if PATH is the empty string. */ + + if (IS_DIR_SEPARATOR (path[last])) + path[last] = '\0'; +} + +/* A convenience function to push ARGV in the cleanup queue. */ + +static void +make_cleanup_argv (char **argv) +{ + make_cleanup ((make_cleanup_ftype *) freeargv, argv); +} + +/* Add a new substitute-path rule at the end of the current list of rules. + The new rule will replace FROM into TO. */ + +static void +add_substitute_path_rule (char *from, char *to) +{ + struct substitute_path_rule *last; + struct substitute_path_rule *rule; + + rule = xmalloc (sizeof (struct substitute_path_rule)); + rule->from = xstrdup (from); + rule->to = xstrdup (to); + rule->next = NULL; + + /* If the list of rules are empty, then insert the new rule + at the head of the list. */ + + if (substitute_path_rules == NULL) + { + substitute_path_rules = rule; + return; + } + + /* Otherwise, skip to the last rule in our list and then append + the new rule. */ + + last = substitute_path_rules; + while (last->next != NULL) + last = last->next; + + last->next = rule; +} + +/* Remove the given source path substitution rule from the current list + of rules. The memory allocated for that rule is also deallocated. */ + +static void +delete_substitute_path_rule (struct substitute_path_rule *rule) +{ + if (rule == substitute_path_rules) + substitute_path_rules = rule->next; + else + { + struct substitute_path_rule *prev = substitute_path_rules; + + while (prev != NULL && prev->next != rule) + prev = prev->next; + + gdb_assert (prev != NULL); + + prev->next = rule->next; + } + + xfree (rule->from); + xfree (rule->to); + xfree (rule); +} + +/* Implement the "show substitute-path" command. */ + +static void +show_substitute_path_command (char *args, int from_tty) +{ + struct substitute_path_rule *rule = substitute_path_rules; + char **argv; + char *from = NULL; + + argv = buildargv (args); + make_cleanup_argv (argv); + + /* We expect zero or one argument. */ + + if (argv != NULL && argv[0] != NULL && argv[1] != NULL) + error (_("Too many arguments in command")); + + if (argv != NULL && argv[0] != NULL) + from = argv[0]; + + /* Print the substitution rules. */ + + if (from != NULL) + printf_filtered + (_("Source path substitution rules matching `%s':\n"), from); + else + printf_filtered (_("List of all source path substitution rules:\n")); + + while (rule != NULL) + { + if (from == NULL || strcmp (rule->from, from) == 0) + printf_filtered (" `%s' -> `%s'.\n", rule->from, rule->to); + rule = rule->next; + } +} + +/* Implement the "unset substitute-path" command. */ + +static void +unset_substitute_path_command (char *args, int from_tty) +{ + struct substitute_path_rule *rule = substitute_path_rules; + char **argv = buildargv (args); + char *from = NULL; + int rule_found = 0; + + /* This function takes either 0 or 1 argument. */ + + if (argv != NULL && argv[0] != NULL && argv[1] != NULL) + error (_("Incorrect usage, too many arguments in command")); + + if (argv != NULL && argv[0] != NULL) + from = argv[0]; + + /* If the user asked for all the rules to be deleted, ask him + to confirm and give him a chance to abort before the action + is performed. */ + + if (from == NULL + && !query (_("Delete all source path substitution rules? "))) + error (_("Canceled")); + + /* Delete all the rules matching the argument. + No argument means that all rules should be deleted. */ + + while (rule != NULL) + { + struct substitute_path_rule *next = rule->next; + + if (from == NULL || strcmp (from, rule->from) == 0) + { + delete_substitute_path_rule (rule); + rule_found = 1; + } + + rule = next; + } + + /* If no rule matching the argument was found, then print an error + message to the user. */ + + if (!rule_found) + { + if (from != NULL) + error (_("No substitution rule defined for `%s'"), from); + else + error (_("No substitution rule defined")); + } +} + +/* Add a new source path substitution rule. */ + +static void +set_substitute_path_command (char *args, int from_tty) +{ + char *from_path, *to_path; + char **argv; + + argv = buildargv (args); + make_cleanup_argv (argv); + + if (argv == NULL || argv[0] == NULL || argv [1] == NULL) + error (_("Incorrect usage, too few arguments in command")); + + if (argv[2] != NULL) + error (_("Incorrect usage, too many arguments in command")); + + if (*(argv[0]) == '\0') + error (_("First argument must be at least one character long")); + + /* Strip any trailing directory separator character in either FROM + or TO. The substitution rule already implicitly contains them. */ + strip_trailing_directory_separator (argv[0]); + strip_trailing_directory_separator (argv[1]); + + /* Insert the new substitution rule. */ + + add_substitute_path_rule (argv[0], argv[1]); +} + void _initialize_source (void) @@ -1666,4 +1972,19 @@ Show number of source lines gdb will lis NULL, show_lines_to_list, &setlist, &showlist); + + add_cmd ("substitute-path", class_files, set_substitute_path_command, + _("\ +Add a source path substitution rule. If a substitution rule was previously\n\ +set, it is overridden."), &setlist); + + add_cmd ("substitute-path", class_files, unset_substitute_path_command, + _("\ +Remove the current source path substitution rule. This has no effect\n\ +if no path substitution rule was previously specified."), + &unsetlist); + + add_cmd ("substitute-path", class_files, show_substitute_path_command, + _("Show the current source path substitution rule."), + &showlist); } Index: Makefile.in =================================================================== RCS file: /cvs/src/src/gdb/Makefile.in,v retrieving revision 1.822 diff -u -p -r1.822 Makefile.in --- Makefile.in 23 Jun 2006 13:01:05 -0000 1.822 +++ Makefile.in 15 Jul 2006 05:35:51 -0000 @@ -2630,7 +2630,8 @@ source.o: source.c $(defs_h) $(symtab_h) $(command_h) $(source_h) $(gdbcmd_h) $(frame_h) $(value_h) \ $(gdb_string_h) $(gdb_stat_h) $(gdbcore_h) $(gdb_regex_h) \ $(symfile_h) $(objfiles_h) $(annotate_h) $(gdbtypes_h) $(linespec_h) \ - $(filenames_h) $(completer_h) $(ui_out_h) $(readline_h) + $(filenames_h) $(completer_h) $(ui_out_h) $(readline_h) \ + $(gdb_assert_h) sparc64fbsd-nat.o: sparc64fbsd-nat.c $(defs_h) $(regcache_h) $(target_h) \ $(fbsd_nat_h) $(sparc64_tdep_h) $(sparc_nat_h) $(bsd_kvm_h) sparc64fbsd-tdep.o: sparc64fbsd-tdep.c $(defs_h) $(frame_h) \ --bg08WKrSYDhXBjb5 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="subst.exp" Content-length: 5477 # Copyright 2006 Free Software Foundation, Inc. # 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 # (at your option) 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., 51 Franklin Street, Fifth Floor, Boston, # MA 02110-1301, USA if $tracelevel { strace $tracelevel } gdb_exit gdb_start gdb_reinitialize_dir $srcdir/$subdir # Do a bunch of testing of the set/unset/show substitute-path # commands that do not require the presence of an executable. gdb_test "set confirm off" \ "" \ "deactivate GDB's confirmation interface" gdb_test "show substitute-path" \ "List of all source path substitution rules:" \ "show substitute-path, no rule entered yet" gdb_test "show substitute-path from" \ "Source path substitution rules matching `from':" \ "show substitute-path from, no rule entered yet" gdb_test "show substitute-path too many" \ "Too many arguments in command" \ "show substitute-path, too many arguments" gdb_test "unset substitute-path from" \ "No substitution rule defined for `from'" \ "unset substitute-path from, no rule entered yet" gdb_test "unset substitute-path" \ "No substitution rule defined" \ "unset substitute-path, no rule entered yet" gdb_test "unset substitute-path from" \ "No substitution rule defined for `from'" \ "unset substitute-path from, no rule entered yet" gdb_test "unset substitute-path from to" \ "Incorrect usage, too many arguments in command" \ "unset substitute-path, too many arguments" gdb_test "set substitute-path too many arguments" \ "Incorrect usage, too many arguments in command" \ "set substitute-path, too many arguments" gdb_test "set substitute-path missing" \ "Incorrect usage, too few arguments in command" \ "set substitute-path, too few arguments" gdb_test "set substitute-path '' to" \ "First argument must be at least one character long" \ "set substitute-path, first argument is empty string" gdb_test "set substitute-path from to" \ "" \ "add from -> to substitution rule" gdb_test "set substitute-path from1 to1/" \ "" \ "add from1 -> to1 substitution rule" gdb_test "set substitute-path source destination" \ "" \ "add source -> destination substitution rule" gdb_test "set substitute-path depuis/ vers" \ "" \ "add depuis -> vers substitution rule" gdb_test "set substitute-path empty ''" \ "" \ "add substitution rule to empty string" gdb_test "show substitute-path" \ "List of all source path substitution rules:\r\n +`from' -> `to'.\r\n +`from1' -> `to1'.\r\n +`source' -> `destination'.\r\n\ +`depuis' -> `vers'.\r\n +`empty' -> `'." \ "show substitute-path after all paths added" gdb_test "show substitute-path from" \ "Source path substitution rules matching `from':\r\n +`from' -> `to'." \ "show substitute-path from, after all paths added" gdb_test "show substitute-path depuis" \ "Source path substitution rules matching `depuis':\r\n +`depuis' -> `vers'." \ "show substitute-path depuis, after all paths added" gdb_test "show substitute-path garbage" \ "Source path substitution rules matching `garbage':" \ "show substitute-path garbage, after all paths added" gdb_test "unset substitute-path from" \ "" \ "unset substitute-path from" gdb_test "show substitute-path from" \ "Source path substitution rules matching `from':" \ "" gdb_test "show substitute-path" \ "List of all source path substitution rules:\r\n +`from1' -> `to1'.\r\n +`source' -> `destination'.\r\n\ +`depuis' -> `vers'.\r\n +`empty' -> `'." \ "show substitute-path after from rule removed" gdb_test "unset substitute-path from" \ "No substitution rule defined for `from'" \ "unset substitute-path from after the rule was removed" gdb_test "unset substitute-path depuis" \ "" \ "unset substitute-path depuis (middle of list)" gdb_test "show substitute-path" \ "List of all source path substitution rules:\r\n +`from1' -> `to1'.\r\n +`source' -> `destination'.\r\n\ +`empty' -> `'." \ "show substitute-path after depuis rule removed" gdb_test "unset substitute-path empty" \ "" \ "unset substitute-path empty (end of list)" gdb_test "show substitute-path" \ "List of all source path substitution rules:\r\n +`from1' -> `to1'.\r\n +`source' -> `destination'." \ "show substitute-path after empty rule removed" gdb_test "unset substitute-path" \ "" \ "remove all remaining substitution rules" gdb_test "show substitute-path" \ "List of all source path substitution rules:" \ "show substitute-path after all remaining rules removed" --bg08WKrSYDhXBjb5--