aboutsummaryrefslogtreecommitdiff
path: root/src/findkey.c
blob: 488ff472eafe8b8df95dfc720c7e731773e8fc39 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
/* findkey.c - The routine that finds a key entry in the file. */

/* This file is part of GDBM, the GNU data base manager.
   Copyright (C) 1990-2023 Free Software Foundation, Inc.

   GDBM 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, or (at your option)
   any later version.

   GDBM 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 GDBM. If not, see <http://www.gnu.org/licenses/>.    */

/* Include system configuration before all else. */
#include "autoconf.h"

#include "gdbmdefs.h"

/* Return true if OFF is a valid offset for GDBM_FILE */
static inline int
gdbm_offset_ok (GDBM_FILE dbf, off_t off)
{
  off_t filesize;

  if (_gdbm_file_size (dbf, &filesize))
    return 0;
  return off <= filesize;
}

/* Return true if the element of hash table at index ELEM_LOC is a valid
   hash element and represents a key/data pair that can be retrieved from
   DBF. */
static inline int
gdbm_bucket_element_valid_p (GDBM_FILE dbf, int elem_loc)
{
  return elem_loc < dbf->header->bucket_elems
    && dbf->bucket->h_table[elem_loc].hash_value != -1
    && dbf->bucket->h_table[elem_loc].key_size >= 0
    && off_t_sum_ok (dbf->bucket->h_table[elem_loc].data_pointer,
		     dbf->bucket->h_table[elem_loc].key_size)
    && dbf->bucket->h_table[elem_loc].data_size >= 0
    && off_t_sum_ok (dbf->bucket->h_table[elem_loc].data_pointer
		     + dbf->bucket->h_table[elem_loc].key_size,
		     dbf->bucket->h_table[elem_loc].data_size)
    && gdbm_offset_ok (dbf,
		       dbf->bucket->h_table[elem_loc].data_pointer
		       + dbf->bucket->h_table[elem_loc].key_size
		       + dbf->bucket->h_table[elem_loc].data_size);
}
  
/* Read the data found in bucket entry ELEM_LOC in file DBF and
   return a pointer to it.  Also, cache the read value. */

char *
_gdbm_read_entry (GDBM_FILE dbf, int elem_loc)
{
  int rc;
  off_t file_pos;
  int key_size;
  int data_size;
  size_t dsize;
  data_cache_elem *data_ca;

  /* Is it already in the cache? */
  if (dbf->cache_mru->ca_data.elem_loc == elem_loc)
    return dbf->cache_mru->ca_data.dptr;

  if (!gdbm_bucket_element_valid_p (dbf, elem_loc))
    {
      GDBM_SET_ERRNO (dbf, GDBM_BAD_HASH_TABLE, TRUE);
      return NULL;
    }
  
  /* Set sizes and pointers. */
  key_size = dbf->bucket->h_table[elem_loc].key_size;
  data_size = dbf->bucket->h_table[elem_loc].data_size;
  dsize = key_size + data_size;
  data_ca = &dbf->cache_mru->ca_data;

  /* Make sure data_ca has sufficient space to accommodate both
     key and content. */
  if (dsize <= data_ca->dsize)
    {
      if (data_ca->dsize == 0)
	{
	  data_ca->dptr = malloc (1);
	  if (data_ca->dptr)
	    data_ca->dsize = 1;
	  else
	    {
	      GDBM_SET_ERRNO2 (dbf, GDBM_MALLOC_ERROR, FALSE, GDBM_DEBUG_LOOKUP);
	      _gdbm_fatal (dbf, _("malloc error"));
	      return NULL;
	    }
	}
    }
  else
    {
      char *p = realloc (data_ca->dptr, dsize);
      if (p)
	{
	  data_ca->dptr = p;
	  data_ca->dsize = dsize;
	}
      else
	{
	  GDBM_SET_ERRNO2 (dbf, GDBM_MALLOC_ERROR, FALSE, GDBM_DEBUG_LOOKUP);
	  _gdbm_fatal (dbf, _("malloc error"));
	  return NULL;
	}
    }

  /* Read into the cache. */
  file_pos = gdbm_file_seek (dbf, dbf->bucket->h_table[elem_loc].data_pointer,
                             SEEK_SET);
  if (file_pos != dbf->bucket->h_table[elem_loc].data_pointer)
    {
      GDBM_SET_ERRNO2 (dbf, GDBM_FILE_SEEK_ERROR, TRUE, GDBM_DEBUG_LOOKUP);
      _gdbm_fatal (dbf, _("lseek error"));
      return NULL;
    }

  rc = _gdbm_full_read (dbf, data_ca->dptr, key_size+data_size);
  if (rc)
    {
      GDBM_DEBUG (GDBM_DEBUG_ERR|GDBM_DEBUG_LOOKUP|GDBM_DEBUG_READ,
                 "%s: error reading entry: %s",
                 dbf->name, gdbm_db_strerror (dbf));
      dbf->need_recovery = TRUE;
      _gdbm_fatal (dbf, gdbm_db_strerror (dbf));
      return NULL;
    }
  
  /* Set up the cache. */
  data_ca->key_size = key_size;
  data_ca->data_size = data_size;
  data_ca->elem_loc = elem_loc;
  data_ca->hash_val = dbf->bucket->h_table[elem_loc].hash_value;

  return data_ca->dptr;
}

/* Find the KEY in the file and get ready to read the associated data.  The
   return value is the location in the current hash bucket of the KEY's
   entry.  If it is found, additional data are returned as follows:

   If RET_DPTR is not NULL, a pointer to the actual data is stored in it.
   If RET_HASH_VAL is not NULL, it is assigned the actual hash value.

   If KEY is not found, the value -1 is returned and gdbm_errno is
   set to GDBM_ITEM_NOT_FOUND.  */
int
_gdbm_findkey (GDBM_FILE dbf, datum key, char **ret_dptr, int *ret_hash_val)
{
  int    bucket_hash_val;	/* The hash value from the bucket. */
  int    new_hash_val;          /* Computed hash value for the key */
  char  *file_key;		/* The complete key as stored in the file. */
  int    bucket_dir;            /* Number of the bucket in directory. */
  int    elem_loc;		/* The location in the bucket. */
  int    home_loc;		/* The home location in the bucket. */
  int    key_size;		/* Size of the key on the file.  */

  GDBM_DEBUG_DATUM (GDBM_DEBUG_LOOKUP, key, "%s: fetching key:", dbf->name);
  
  /* Compute hash value and load proper bucket.  */
  _gdbm_hash_key (dbf, key, &new_hash_val, &bucket_dir, &elem_loc);

  GDBM_DEBUG (GDBM_DEBUG_LOOKUP, "%s: location = %#4x:%d:%d", dbf->name,
	      new_hash_val, bucket_dir, elem_loc);

  if (ret_hash_val)
    *ret_hash_val = new_hash_val;
  if (_gdbm_get_bucket (dbf, bucket_dir))
    return -1;
  
  /* Is the element the last one found for this bucket? */
  if (dbf->cache_mru->ca_data.elem_loc != -1 
      && new_hash_val == dbf->cache_mru->ca_data.hash_val
      && dbf->cache_mru->ca_data.key_size == key.dsize
      && dbf->cache_mru->ca_data.dptr != NULL
      && memcmp (dbf->cache_mru->ca_data.dptr, key.dptr, key.dsize) == 0)
    {
      GDBM_DEBUG (GDBM_DEBUG_LOOKUP, "%s: found in cache", dbf->name);
      /* This is it. Return the cache pointer. */
      if (ret_dptr)
	*ret_dptr = dbf->cache_mru->ca_data.dptr + key.dsize;
      return dbf->cache_mru->ca_data.elem_loc;
    }
      
  /* It is not the cached value, search for element in the bucket. */
  home_loc = elem_loc;
  bucket_hash_val = dbf->bucket->h_table[elem_loc].hash_value;
  while (bucket_hash_val != -1)
    {
      key_size = dbf->bucket->h_table[elem_loc].key_size;
      if (bucket_hash_val != new_hash_val
	 || key_size != key.dsize
	 || memcmp (dbf->bucket->h_table[elem_loc].key_start, key.dptr,
			(SMALL < key_size ? SMALL : key_size)) != 0) 
	{
	  /* Current elem_loc is not the item, go to next item. */
	  elem_loc = (elem_loc + 1) % dbf->header->bucket_elems;
	  if (elem_loc == home_loc)
	    break;
	  bucket_hash_val = dbf->bucket->h_table[elem_loc].hash_value;
	}
      else
	{
	  /* This may be the one we want.
	     The only way to tell is to read it. */
	  file_key = _gdbm_read_entry (dbf, elem_loc);
	  if (!file_key)
	    {
	      GDBM_DEBUG (GDBM_DEBUG_LOOKUP, "%s: error reading entry: %s",
			  dbf->name, gdbm_db_strerror (dbf));
	      return -1;
	    }
	  if (memcmp (file_key, key.dptr, key_size) == 0)
	    {
	      /* This is the item. */
	      GDBM_DEBUG (GDBM_DEBUG_LOOKUP, "%s: found", dbf->name);
	      if (ret_dptr)
		*ret_dptr = file_key + key.dsize;
	      return elem_loc;
	    }
	  else
	    {
	      /* Not the item, try the next one.  Return if not found. */
	      elem_loc = (elem_loc + 1) % dbf->header->bucket_elems;
	      if (elem_loc == home_loc)
		break;
	      bucket_hash_val = dbf->bucket->h_table[elem_loc].hash_value;
	    }
	}
      GDBM_DEBUG (GDBM_DEBUG_LOOKUP, "%s: next location = %#4x:%d:%d",
		  dbf->name, bucket_hash_val, bucket_dir, elem_loc);
    }

  /* If we get here, we never found the key. */
  GDBM_SET_ERRNO2 (dbf, GDBM_ITEM_NOT_FOUND, FALSE, GDBM_DEBUG_LOOKUP);
  return -1;

}

Return to:

Send suggestions and report system problems to the System administrator.