1
This file is hash.def, from which is created hash.c.
2
It implements the builtin "hash" in Bash.
4
Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
6
This file is part of GNU Bash, the Bourne Again SHell.
8
Bash is free software; you can redistribute it and/or modify it under
9
the terms of the GNU General Public License as published by the Free
10
Software Foundation; either version 2, or (at your option) any later
13
Bash is distributed in the hope that it will be useful, but WITHOUT ANY
14
WARRANTY; without even the implied warranty of MERCHANTABILITY or
15
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18
You should have received a copy of the GNU General Public License along
19
with Bash; see the file COPYING. If not, write to the Free Software
20
Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
25
$FUNCTION hash_builtin
26
$SHORT_DOC hash [-r] [-p pathname] [-t] [name ...]
27
For each NAME, the full pathname of the command is determined and
28
remembered. If the -p option is supplied, PATHNAME is used as the
29
full pathname of NAME, and no path search is performed. The -r
30
option causes the shell to forget all remembered locations.
31
If the -t option is supplied the full pathname to which each NAME
32
corresponds is printed. If multiple NAME arguments are supplied with
33
-t, the NAME is printed before the hashed full pathname. If no arguments
34
are given, information about remembered commands is displayed.
41
#include "../bashtypes.h"
43
#if defined (HAVE_UNISTD_H)
49
#include "../bashansi.h"
52
#include "../builtins.h"
54
#include "../findcmd.h"
55
#include "../hashcmd.h"
57
#include "bashgetopt.h"
59
extern int dot_found_in_search;
60
extern char *this_command_name;
62
static int add_hashed_command __P((char *, int));
63
static int print_hashed_commands __P((void));
64
static int list_hashed_filename_targets __P((WORD_LIST *));
66
/* Print statistics on the current state of hashed commands. If LIST is
67
not empty, then rehash (or hash in the first place) the specified
73
int expunge_hash_table, list_targets, opt;
76
if (hashing_enabled == 0)
78
builtin_error ("hashing disabled");
79
return (EXECUTION_FAILURE);
82
expunge_hash_table = list_targets = 0;
83
pathname = (char *)NULL;
84
reset_internal_getopt ();
85
while ((opt = internal_getopt (list, "rp:t")) != -1)
90
expunge_hash_table = 1;
93
pathname = list_optarg;
105
/* hash -t requires at least one argument. */
106
if (list == 0 && list_targets)
108
builtin_error("-t: argument required");
109
return (EXECUTION_FAILURE);
112
/* We want hash -r to be silent, but hash -- to print hashing info. That
113
is the reason for the test of expunge_hash_table. */
114
if (list == 0 && expunge_hash_table == 0)
116
if (print_hashed_commands () == 0)
117
printf ("%s: hash table empty\n", this_command_name);
119
return (EXECUTION_SUCCESS);
122
if (expunge_hash_table)
123
flush_hashed_filenames ();
125
/* If someone runs `hash -r -t xyz' he will be disappointed. */
128
return (list_hashed_filename_targets (list));
131
#if defined (RESTRICTED_SHELL)
132
if (restricted && pathname && strchr (pathname, '/'))
134
builtin_error ("%s: restricted", pathname);
135
return (EXECUTION_FAILURE);
139
for (opt = EXECUTION_SUCCESS; list; list = list->next)
141
/* Add or rehash the specified commands. */
142
w = list->word->word;
145
if (is_directory (pathname))
148
builtin_error ("%s: %s", pathname, strerror (EISDIR));
150
builtin_error ("%s: is a directory", pathname);
152
opt = EXECUTION_FAILURE;
155
remember_filename (w, pathname, 0, 0);
157
else if (absolute_program (w))
159
else if (add_hashed_command (w, 0))
160
opt = EXECUTION_FAILURE;
168
add_hashed_command (w, quiet)
176
if (find_function (w) == 0 && find_shell_builtin (w) == 0)
178
full_path = find_user_command (w);
179
if (full_path && executable_file (full_path))
180
remember_filename (w, full_path, dot_found_in_search, 0);
184
builtin_error ("%s: not found", w);
193
/* Print information about current hashed info. */
195
print_hashed_commands ()
197
BUCKET_CONTENTS *item_list;
198
int bucket, any_printed;
200
if (hashed_filenames == 0)
203
for (bucket = any_printed = 0; bucket < hashed_filenames->nbuckets; bucket++)
205
item_list = get_hash_bucket (bucket, hashed_filenames);
209
if (any_printed == 0)
211
printf ("hits\tcommand\n");
215
for ( ; item_list; item_list = item_list->next)
216
printf ("%4d\t%s\n", item_list->times_found, pathdata(item_list)->path);
219
return (any_printed);
223
list_hashed_filename_targets (list)
226
int all_found, multiple;
231
multiple = list->next != 0;
233
for (l = list; l; l = l->next)
235
target = find_hashed_filename (l->word->word);
239
builtin_error ("%s: not found", l->word->word);
243
printf ("%s\t", l->word->word);
244
printf ("%s\n", target);
247
return (all_found ? EXECUTION_SUCCESS : EXECUTION_FAILURE);