This file is hash.def, from which is created hash.c.
It implements the builtin "hash" in Bash.
-Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
+Copyright (C) 1987-2013 Free Software Foundation, Inc.
This file is part of GNU Bash, the Bourne Again SHell.
-Bash 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, or (at your option) any later
-version.
+Bash 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 3 of the License, or
+(at your option) any later version.
-Bash 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.
+Bash 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 Bash; see the file COPYING. If not, write to the Free Software
-Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
+You should have received a copy of the GNU General Public License
+along with Bash. If not, see <http://www.gnu.org/licenses/>.
$PRODUCES hash.c
$BUILTIN hash
$FUNCTION hash_builtin
-$SHORT_DOC hash [-r] [-p pathname] [name ...]
-For each NAME, the full pathname of the command is determined and
-remembered. If the -p option is supplied, PATHNAME is used as the
-full pathname of NAME, and no path search is performed. The -r
-option causes the shell to forget all remembered locations. If no
-arguments are given, information about remembered commands is displayed.
+$SHORT_DOC hash [-lr] [-p pathname] [-dt] [name ...]
+Remember or display program locations.
+
+Determine and remember the full pathname of each command NAME. If
+no arguments are given, information about remembered commands is displayed.
+
+Options:
+ -d forget the remembered location of each NAME
+ -l display in a format that may be reused as input
+ -p pathname use PATHNAME as the full pathname of NAME
+ -r forget all remembered locations
+ -t print the remembered location of each NAME, preceding
+ each location with the corresponding NAME if multiple
+ NAMEs are given
+Arguments:
+ NAME Each NAME is searched for in $PATH and added to the list
+ of remembered commands.
+
+Exit Status:
+Returns success unless NAME is not found or an invalid option is given.
$END
#include <config.h>
# include <unistd.h>
#endif
+#include <errno.h>
+
#include "../bashansi.h"
+#include "../bashintl.h"
#include "../shell.h"
#include "../builtins.h"
#include "common.h"
#include "bashgetopt.h"
+extern int posixly_correct;
extern int dot_found_in_search;
extern char *this_command_name;
-static int add_hashed_command ();
-static int print_hashed_commands ();
+static int add_hashed_command __P((char *, int));
+static int print_hash_info __P((BUCKET_CONTENTS *));
+static int print_portable_hash_info __P((BUCKET_CONTENTS *));
+static int print_hashed_commands __P((int));
+static int list_hashed_filename_targets __P((WORD_LIST *, int));
/* Print statistics on the current state of hashed commands. If LIST is
not empty, then rehash (or hash in the first place) the specified
hash_builtin (list)
WORD_LIST *list;
{
- int expunge_hash_table, opt;
+ int expunge_hash_table, list_targets, list_portably, delete, opt;
char *w, *pathname;
if (hashing_enabled == 0)
{
- builtin_error ("hashing disabled");
+ builtin_error (_("hashing disabled"));
return (EXECUTION_FAILURE);
}
- expunge_hash_table = 0;
+ expunge_hash_table = list_targets = list_portably = delete = 0;
pathname = (char *)NULL;
reset_internal_getopt ();
- while ((opt = internal_getopt (list, "rp:")) != -1)
+ while ((opt = internal_getopt (list, "dlp:rt")) != -1)
{
switch (opt)
{
- case 'r':
- expunge_hash_table = 1;
+ case 'd':
+ delete = 1;
+ break;
+ case 'l':
+ list_portably = 1;
break;
case 'p':
pathname = list_optarg;
break;
+ case 'r':
+ expunge_hash_table = 1;
+ break;
+ case 't':
+ list_targets = 1;
+ break;
default:
builtin_usage ();
return (EX_USAGE);
}
list = loptend;
- /* We want hash -r to be silent, but hash -- to print hashing info. That
- is the reason for the test of expunge_hash_table. */
+ /* hash -t requires at least one argument. */
+ if (list == 0 && list_targets)
+ {
+ sh_needarg ("-t");
+ return (EXECUTION_FAILURE);
+ }
+
+ /* We want hash -r to be silent, but hash -- to print hashing info, so
+ we test expunge_hash_table. */
if (list == 0 && expunge_hash_table == 0)
{
- if (print_hashed_commands () == 0)
- printf ("%s: hash table empty\n", this_command_name);
+ opt = print_hashed_commands (list_portably);
+ if (opt == 0 && posixly_correct == 0)
+ printf (_("%s: hash table empty\n"), this_command_name);
return (EXECUTION_SUCCESS);
}
if (expunge_hash_table)
- flush_hashed_filenames ();
+ phash_flush ();
+ /* If someone runs `hash -r -t xyz' he will be disappointed. */
+ if (list_targets)
+ return (list_hashed_filename_targets (list, list_portably));
+
#if defined (RESTRICTED_SHELL)
if (restricted && pathname && strchr (pathname, '/'))
{
- builtin_error ("%s: restricted", pathname);
+ sh_restricted (pathname);
return (EXECUTION_FAILURE);
}
#endif
for (opt = EXECUTION_SUCCESS; list; list = list->next)
{
- /* Add or rehash the specified commands. */
+ /* Add, remove or rehash the specified commands. */
w = list->word->word;
- if (pathname)
- remember_filename (w, pathname, 0, 0);
- else if (absolute_program (w))
+ if (absolute_program (w))
continue;
+ else if (pathname)
+ {
+ if (is_directory (pathname))
+ {
+#ifdef EISDIR
+ builtin_error ("%s: %s", pathname, strerror (EISDIR));
+#else
+ builtin_error (_("%s: is a directory"), pathname);
+#endif
+ opt = EXECUTION_FAILURE;
+ }
+ else
+ phash_insert (w, pathname, 0, 0);
+ }
+ else if (delete)
+ {
+ if (phash_remove (w))
+ {
+ sh_notfound (w);
+ opt = EXECUTION_FAILURE;
+ }
+ }
else if (add_hashed_command (w, 0))
opt = EXECUTION_FAILURE;
}
rv = 0;
if (find_function (w) == 0 && find_shell_builtin (w) == 0)
{
+ phash_remove (w);
full_path = find_user_command (w);
if (full_path && executable_file (full_path))
- remember_filename (w, full_path, dot_found_in_search, 0);
+ phash_insert (w, full_path, dot_found_in_search, 0);
else
{
if (quiet == 0)
- builtin_error ("%s: not found", w);
+ sh_notfound (w);
rv++;
}
- if (full_path)
- free (full_path);
+ FREE (full_path);
}
return (rv);
}
/* Print information about current hashed info. */
static int
-print_hashed_commands ()
+print_hash_info (item)
+ BUCKET_CONTENTS *item;
{
- BUCKET_CONTENTS *item_list;
- int bucket, any_printed;
+ printf ("%4d\t%s\n", item->times_found, pathdata(item)->path);
+ return 0;
+}
- if (hashed_filenames == 0)
+static int
+print_portable_hash_info (item)
+ BUCKET_CONTENTS *item;
+{
+ printf ("builtin hash -p %s %s\n", pathdata(item)->path, item->key);
+ return 0;
+}
+
+static int
+print_hashed_commands (fmt)
+ int fmt;
+{
+ if (hashed_filenames == 0 || HASH_ENTRIES (hashed_filenames) == 0)
return (0);
- for (bucket = any_printed = 0; bucket < hashed_filenames->nbuckets; bucket++)
- {
- item_list = get_hash_bucket (bucket, hashed_filenames);
- if (item_list == 0)
- continue;
+ if (fmt == 0)
+ printf (_("hits\tcommand\n"));
+ hash_walk (hashed_filenames, fmt ? print_portable_hash_info : print_hash_info);
+ return (1);
+}
- if (any_printed == 0)
- {
- printf ("hits\tcommand\n");
- any_printed++;
- }
+static int
+list_hashed_filename_targets (list, fmt)
+ WORD_LIST *list;
+ int fmt;
+{
+ int all_found, multiple;
+ char *target;
+ WORD_LIST *l;
- for ( ; item_list; item_list = item_list->next)
- printf ("%4d\t%s\n", item_list->times_found, pathdata(item_list)->path);
+ all_found = 1;
+ multiple = list->next != 0;
+ for (l = list; l; l = l->next)
+ {
+ target = phash_search (l->word->word);
+ if (target == 0)
+ {
+ all_found = 0;
+ sh_notfound (l->word->word);
+ continue;
+ }
+ if (fmt)
+ printf ("builtin hash -p %s %s\n", target, l->word->word);
+ else
+ {
+ if (multiple)
+ printf ("%s\t", l->word->word);
+ printf ("%s\n", target);
+ }
+ free (target);
}
- return (any_printed);
+
+ return (all_found ? EXECUTION_SUCCESS : EXECUTION_FAILURE);
}