4 * Hashing names in the index state
6 * Copyright (C) 2008 Linus Torvalds
8 #define NO_THE_INDEX_COMPATIBILITY_MACROS
12 * This removes bit 5 if bit 6 is set.
14 * That will make US-ASCII characters hash to their upper-case
15 * equivalent. We could easily do this one whole word at a time,
16 * but that's for future worries.
18 static inline unsigned char icase_hash(unsigned char c)
20 return c & ~((c & 0x40) >> 1);
23 static unsigned int hash_name(const char *name, int namelen)
25 unsigned int hash = 0x123;
28 unsigned char c = *name++;
36 struct dir_entry *next;
37 struct dir_entry *parent;
38 struct cache_entry *ce;
43 static struct dir_entry *find_dir_entry(struct index_state *istate,
44 const char *name, unsigned int namelen)
46 unsigned int hash = hash_name(name, namelen);
47 struct dir_entry *dir;
49 for (dir = lookup_hash(hash, &istate->dir_hash); dir; dir = dir->next)
50 if (dir->namelen == namelen &&
51 !strncasecmp(dir->ce->name, name, namelen))
56 static struct dir_entry *hash_dir_entry(struct index_state *istate,
57 struct cache_entry *ce, int namelen)
60 * Throw each directory component in the hash for quick lookup
61 * during a git status. Directory components are stored with their
62 * closing slash. Despite submodules being a directory, they never
63 * reach this point, because they are stored without a closing slash
64 * in index_state.name_hash (as ordinary cache_entries).
66 * Note that the cache_entry stored with the dir_entry merely
67 * supplies the name of the directory (up to dir_entry.namelen). We
68 * track the number of 'active' files in a directory in dir_entry.nr,
69 * so we can tell if the directory is still relevant, e.g. for git
70 * status. However, if cache_entries are removed, we cannot pinpoint
71 * an exact cache_entry that's still active. It is very possible that
72 * multiple dir_entries point to the same cache_entry.
74 struct dir_entry *dir;
76 /* get length of parent directory */
77 while (namelen > 0 && !is_dir_sep(ce->name[namelen - 1]))
82 /* lookup existing entry for that directory */
83 dir = find_dir_entry(istate, ce->name, namelen);
85 /* not found, create it and add to hash table */
87 unsigned int hash = hash_name(ce->name, namelen);
89 dir = xcalloc(1, sizeof(struct dir_entry));
90 dir->namelen = namelen;
93 pdir = insert_hash(hash, dir, &istate->dir_hash);
99 /* recursively add missing parent directories */
100 dir->parent = hash_dir_entry(istate, ce, namelen - 1);
105 static void add_dir_entry(struct index_state *istate, struct cache_entry *ce)
107 /* Add reference to the directory entry (and parents if 0). */
108 struct dir_entry *dir = hash_dir_entry(istate, ce, ce_namelen(ce));
109 while (dir && !(dir->nr++))
113 static void remove_dir_entry(struct index_state *istate, struct cache_entry *ce)
116 * Release reference to the directory entry (and parents if 0).
118 * Note: we do not remove / free the entry because there's no
119 * hash.[ch]::remove_hash and dir->next may point to other entries
120 * that are still valid, so we must not free the memory.
122 struct dir_entry *dir = hash_dir_entry(istate, ce, ce_namelen(ce));
123 while (dir && dir->nr && !(--dir->nr))
127 static void hash_index_entry(struct index_state *istate, struct cache_entry *ce)
132 if (ce->ce_flags & CE_HASHED)
134 ce->ce_flags |= CE_HASHED;
136 hash = hash_name(ce->name, ce_namelen(ce));
137 pos = insert_hash(hash, ce, &istate->name_hash);
143 if (ignore_case && !(ce->ce_flags & CE_UNHASHED))
144 add_dir_entry(istate, ce);
147 static void lazy_init_name_hash(struct index_state *istate)
151 if (istate->name_hash_initialized)
153 if (istate->cache_nr)
154 preallocate_hash(&istate->name_hash, istate->cache_nr);
155 for (nr = 0; nr < istate->cache_nr; nr++)
156 hash_index_entry(istate, istate->cache[nr]);
157 istate->name_hash_initialized = 1;
160 void add_name_hash(struct index_state *istate, struct cache_entry *ce)
162 /* if already hashed, add reference to directory entries */
163 if (ignore_case && (ce->ce_flags & CE_STATE_MASK) == CE_STATE_MASK)
164 add_dir_entry(istate, ce);
166 ce->ce_flags &= ~CE_UNHASHED;
167 if (istate->name_hash_initialized)
168 hash_index_entry(istate, ce);
172 * We don't actually *remove* it, we can just mark it invalid so that
173 * we won't find it in lookups.
175 * Not only would we have to search the lists (simple enough), but
176 * we'd also have to rehash other hash buckets in case this makes the
177 * hash bucket empty (common). So it's much better to just mark
180 void remove_name_hash(struct index_state *istate, struct cache_entry *ce)
182 /* if already hashed, release reference to directory entries */
183 if (ignore_case && (ce->ce_flags & CE_STATE_MASK) == CE_HASHED)
184 remove_dir_entry(istate, ce);
186 ce->ce_flags |= CE_UNHASHED;
189 static int slow_same_name(const char *name1, int len1, const char *name2, int len2)
195 unsigned char c1 = *name1++;
196 unsigned char c2 = *name2++;
208 static int same_name(const struct cache_entry *ce, const char *name, int namelen, int icase)
210 int len = ce_namelen(ce);
213 * Always do exact compare, even if we want a case-ignoring comparison;
214 * we do the quick exact one first, because it will be the common case.
216 if (len == namelen && !cache_name_compare(name, namelen, ce->name, len))
222 return slow_same_name(name, namelen, ce->name, len);
225 struct cache_entry *index_name_exists(struct index_state *istate, const char *name, int namelen, int icase)
227 unsigned int hash = hash_name(name, namelen);
228 struct cache_entry *ce;
230 lazy_init_name_hash(istate);
231 ce = lookup_hash(hash, &istate->name_hash);
234 if (!(ce->ce_flags & CE_UNHASHED)) {
235 if (same_name(ce, name, namelen, icase))
242 * When looking for a directory (trailing '/'), it might be a
243 * submodule or a directory. Despite submodules being directories,
244 * they are stored in the name hash without a closing slash.
245 * When ignore_case is 1, directories are stored in a separate hash
246 * table *with* their closing slash.
248 * The side effect of this storage technique is we have need to
249 * lookup the directory in a separate hash table, and if not found
250 * remove the slash from name and perform the lookup again without
251 * the slash. If a match is made, S_ISGITLINK(ce->mode) will be
254 if (icase && name[namelen - 1] == '/') {
255 struct dir_entry *dir = find_dir_entry(istate, name, namelen);
259 ce = index_name_exists(istate, name, namelen - 1, icase);
260 if (ce && S_ISGITLINK(ce->ce_mode))
266 static int free_dir_entry(void *entry, void *unused)
268 struct dir_entry *dir = entry;
270 struct dir_entry *next = dir->next;
277 void free_name_hash(struct index_state *istate)
279 if (!istate->name_hash_initialized)
281 istate->name_hash_initialized = 0;
283 /* free directory entries */
284 for_each_hash(&istate->dir_hash, free_dir_entry, NULL);
286 free_hash(&istate->name_hash);
287 free_hash(&istate->dir_hash);