2 Unix SMB/CIFS implementation.
6 Copyright (C) Andrew Tridgell 1992-2006
7 Copyright (C) Volker Lendecke 2007-2011
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 #include "system/filesys.h"
25 #include "../lib/tdb/include/tdb.h"
26 #include "../lib/util/util_tdb.h"
28 /* these are little tdb utility functions that are meant to make
29 dealing with a tdb database a little less cumbersome in Samba */
31 /***************************************************************
32 Make a TDB_DATA and keep the const warning in one place
33 ****************************************************************/
35 TDB_DATA make_tdb_data(const uint8_t *dptr, size_t dsize)
38 ret.dptr = discard_const_p(uint8_t, dptr);
43 bool tdb_data_equal(TDB_DATA t1, TDB_DATA t2)
45 if (t1.dsize != t2.dsize) {
48 return (memcmp(t1.dptr, t2.dptr, t1.dsize) == 0);
51 bool tdb_data_is_empty(TDB_DATA d)
53 return (d.dsize == 0) || (d.dptr == NULL);
56 TDB_DATA string_tdb_data(const char *string)
58 return make_tdb_data((const uint8_t *)string, string ? strlen(string) : 0 );
61 TDB_DATA string_term_tdb_data(const char *string)
63 return make_tdb_data((const uint8_t *)string, string ? strlen(string) + 1 : 0);
66 /****************************************************************************
67 Lock a chain by string. Return non-zero if lock failed.
68 ****************************************************************************/
70 int tdb_lock_bystring(struct tdb_context *tdb, const char *keyval)
72 TDB_DATA key = string_term_tdb_data(keyval);
74 return tdb_chainlock(tdb, key);
77 /****************************************************************************
78 Unlock a chain by string.
79 ****************************************************************************/
81 void tdb_unlock_bystring(struct tdb_context *tdb, const char *keyval)
83 TDB_DATA key = string_term_tdb_data(keyval);
85 tdb_chainunlock(tdb, key);
88 /****************************************************************************
89 Read lock a chain by string. Return non-zero if lock failed.
90 ****************************************************************************/
92 int tdb_read_lock_bystring(struct tdb_context *tdb, const char *keyval)
94 TDB_DATA key = string_term_tdb_data(keyval);
96 return tdb_chainlock_read(tdb, key);
99 /****************************************************************************
100 Read unlock a chain by string.
101 ****************************************************************************/
103 void tdb_read_unlock_bystring(struct tdb_context *tdb, const char *keyval)
105 TDB_DATA key = string_term_tdb_data(keyval);
107 tdb_chainunlock_read(tdb, key);
111 /****************************************************************************
112 Fetch a int32_t value by a arbitrary blob key, return -1 if not found.
113 Output is int32_t in native byte order.
114 ****************************************************************************/
116 int32_t tdb_fetch_int32_byblob(struct tdb_context *tdb, TDB_DATA key)
121 data = tdb_fetch(tdb, key);
122 if (!data.dptr || data.dsize != sizeof(int32_t)) {
123 SAFE_FREE(data.dptr);
127 ret = IVAL(data.dptr,0);
128 SAFE_FREE(data.dptr);
132 /****************************************************************************
133 Fetch a int32_t value by string key, return -1 if not found.
134 Output is int32_t in native byte order.
135 ****************************************************************************/
137 int32_t tdb_fetch_int32(struct tdb_context *tdb, const char *keystr)
139 return tdb_fetch_int32_byblob(tdb, string_term_tdb_data(keystr));
142 /****************************************************************************
143 Store a int32_t value by an arbitrary blob key, return 0 on success, -ve on failure.
144 Input is int32_t in native byte order. Output in tdb is in little-endian.
145 ****************************************************************************/
147 int tdb_store_int32_byblob(struct tdb_context *tdb, TDB_DATA key, int32_t v)
153 data.dptr = (unsigned char *)&v_store;
154 data.dsize = sizeof(int32_t);
156 return tdb_store(tdb, key, data, TDB_REPLACE);
159 /****************************************************************************
160 Store a int32_t value by string key, return 0 on success, -ve on failure.
161 Input is int32_t in native byte order. Output in tdb is in little-endian.
162 ****************************************************************************/
164 int tdb_store_int32(struct tdb_context *tdb, const char *keystr, int32_t v)
166 return tdb_store_int32_byblob(tdb, string_term_tdb_data(keystr), v);
169 /****************************************************************************
170 Fetch a uint32_t value by a arbitrary blob key, return false if not found.
171 Output is uint32_t in native byte order.
172 ****************************************************************************/
174 bool tdb_fetch_uint32_byblob(struct tdb_context *tdb, TDB_DATA key, uint32_t *value)
178 data = tdb_fetch(tdb, key);
179 if (!data.dptr || data.dsize != sizeof(uint32_t)) {
180 SAFE_FREE(data.dptr);
184 *value = IVAL(data.dptr,0);
185 SAFE_FREE(data.dptr);
189 /****************************************************************************
190 Fetch a uint32_t value by string key, return false if not found.
191 Output is uint32_t in native byte order.
192 ****************************************************************************/
194 bool tdb_fetch_uint32(struct tdb_context *tdb, const char *keystr, uint32_t *value)
196 return tdb_fetch_uint32_byblob(tdb, string_term_tdb_data(keystr), value);
199 /****************************************************************************
200 Store a uint32_t value by an arbitrary blob key, return true on success, false on failure.
201 Input is uint32_t in native byte order. Output in tdb is in little-endian.
202 ****************************************************************************/
204 bool tdb_store_uint32_byblob(struct tdb_context *tdb, TDB_DATA key, uint32_t value)
210 SIVAL(&v_store, 0, value);
211 data.dptr = (unsigned char *)&v_store;
212 data.dsize = sizeof(uint32_t);
214 if (tdb_store(tdb, key, data, TDB_REPLACE) != 0)
220 /****************************************************************************
221 Store a uint32_t value by string key, return true on success, false on failure.
222 Input is uint32_t in native byte order. Output in tdb is in little-endian.
223 ****************************************************************************/
225 bool tdb_store_uint32(struct tdb_context *tdb, const char *keystr, uint32_t value)
227 return tdb_store_uint32_byblob(tdb, string_term_tdb_data(keystr), value);
229 /****************************************************************************
230 Store a buffer by a null terminated string key. Return 0 on success, -ve
232 ****************************************************************************/
234 int tdb_store_bystring(struct tdb_context *tdb, const char *keystr, TDB_DATA data, int flags)
236 TDB_DATA key = string_term_tdb_data(keystr);
238 return tdb_store(tdb, key, data, flags);
241 /****************************************************************************
242 Fetch a buffer using a null terminated string key. Don't forget to call
243 free() on the result dptr.
244 ****************************************************************************/
246 TDB_DATA tdb_fetch_bystring(struct tdb_context *tdb, const char *keystr)
248 TDB_DATA key = string_term_tdb_data(keystr);
250 return tdb_fetch(tdb, key);
253 /****************************************************************************
254 Delete an entry using a null terminated string key.
255 ****************************************************************************/
257 int tdb_delete_bystring(struct tdb_context *tdb, const char *keystr)
259 TDB_DATA key = string_term_tdb_data(keystr);
261 return tdb_delete(tdb, key);
264 /****************************************************************************
265 Atomic integer change. Returns old value. To create, set initial value in *oldval.
266 ****************************************************************************/
268 int32_t tdb_change_int32_atomic(struct tdb_context *tdb, const char *keystr, int32_t *oldval, int32_t change_val)
273 if (tdb_lock_bystring(tdb, keystr) != 0)
276 if ((val = tdb_fetch_int32(tdb, keystr)) == -1) {
277 /* The lookup failed */
278 if (tdb_error(tdb) != TDB_ERR_NOEXIST) {
279 /* but not because it didn't exist */
283 /* Start with 'old' value */
287 /* It worked, set return value (oldval) to tdb data */
291 /* Increment value for storage and return next time */
294 if (tdb_store_int32(tdb, keystr, val) != 0)
301 tdb_unlock_bystring(tdb, keystr);
305 static sig_atomic_t gotalarm;
307 /***************************************************************
308 Signal function to tell us we timed out.
309 ****************************************************************/
311 static void gotalarm_sig(int signum)
316 /****************************************************************************
317 Lock a chain with timeout (in seconds).
318 ****************************************************************************/
320 static int tdb_chainlock_with_timeout_internal( TDB_CONTEXT *tdb, TDB_DATA key, unsigned int timeout, int rw_type)
322 /* Allow tdb_chainlock to be interrupted by an alarm. */
327 CatchSignal(SIGALRM, gotalarm_sig);
328 tdb_setalarm_sigptr(tdb, &gotalarm);
332 if (rw_type == F_RDLCK)
333 ret = tdb_chainlock_read(tdb, key);
335 ret = tdb_chainlock(tdb, key);
339 tdb_setalarm_sigptr(tdb, NULL);
340 CatchSignal(SIGALRM, SIG_IGN);
341 if (gotalarm && (ret != 0)) {
342 DEBUG(0,("tdb_chainlock_with_timeout_internal: alarm (%u) timed out for key %s in tdb %s\n",
343 timeout, key.dptr, tdb_name(tdb)));
344 /* TODO: If we time out waiting for a lock, it might
345 * be nice to use F_GETLK to get the pid of the
346 * process currently holding the lock and print that
347 * as part of the debugging message. -- mbp */
352 return ret == 0 ? 0 : -1;
355 /****************************************************************************
356 Write lock a chain. Return non-zero if timeout or lock failed.
357 ****************************************************************************/
359 int tdb_chainlock_with_timeout( TDB_CONTEXT *tdb, TDB_DATA key, unsigned int timeout)
361 return tdb_chainlock_with_timeout_internal(tdb, key, timeout, F_WRLCK);
364 int tdb_lock_bystring_with_timeout(TDB_CONTEXT *tdb, const char *keyval,
367 TDB_DATA key = string_term_tdb_data(keyval);
369 return tdb_chainlock_with_timeout(tdb, key, timeout);
372 /****************************************************************************
373 Read lock a chain by string. Return non-zero if timeout or lock failed.
374 ****************************************************************************/
376 int tdb_read_lock_bystring_with_timeout(TDB_CONTEXT *tdb, const char *keyval, unsigned int timeout)
378 TDB_DATA key = string_term_tdb_data(keyval);
380 return tdb_chainlock_with_timeout_internal(tdb, key, timeout, F_RDLCK);
383 /****************************************************************************
384 Atomic unsigned integer change. Returns old value. To create, set initial value in *oldval.
385 ****************************************************************************/
387 bool tdb_change_uint32_atomic(struct tdb_context *tdb, const char *keystr, uint32_t *oldval, uint32_t change_val)
392 if (tdb_lock_bystring(tdb, keystr) != 0)
395 if (!tdb_fetch_uint32(tdb, keystr, &val)) {
397 if (tdb_error(tdb) != TDB_ERR_NOEXIST) {
398 /* and not because it didn't exist */
402 /* Start with 'old' value */
406 /* it worked, set return value (oldval) to tdb data */
411 /* get a new value to store */
414 if (!tdb_store_uint32(tdb, keystr, val))
421 tdb_unlock_bystring(tdb, keystr);
425 /****************************************************************************
426 Allow tdb_delete to be used as a tdb_traversal_fn.
427 ****************************************************************************/
429 int tdb_traverse_delete_fn(struct tdb_context *the_tdb, TDB_DATA key, TDB_DATA dbuf,
432 return tdb_delete(the_tdb, key);
435 /****************************************************************************
436 Return an NTSTATUS from a TDB_ERROR
437 ****************************************************************************/
439 NTSTATUS map_nt_error_from_tdb(enum TDB_ERROR err)
441 NTSTATUS result = NT_STATUS_INTERNAL_ERROR;
445 result = NT_STATUS_OK;
447 case TDB_ERR_CORRUPT:
448 result = NT_STATUS_INTERNAL_DB_CORRUPTION;
451 result = NT_STATUS_UNEXPECTED_IO_ERROR;
454 result = NT_STATUS_NO_MEMORY;
457 result = NT_STATUS_OBJECT_NAME_COLLISION;
462 * TDB_ERR_LOCK is very broad, we could for example
463 * distinguish between fcntl locks and invalid lock
464 * sequences. So NT_STATUS_FILE_LOCK_CONFLICT is a
467 result = NT_STATUS_FILE_LOCK_CONFLICT;
471 case TDB_ERR_LOCK_TIMEOUT:
473 * These two ones in the enum are not actually used
475 result = NT_STATUS_FILE_LOCK_CONFLICT;
477 case TDB_ERR_NOEXIST:
478 result = NT_STATUS_NOT_FOUND;
481 result = NT_STATUS_INVALID_PARAMETER;
484 result = NT_STATUS_ACCESS_DENIED;
486 case TDB_ERR_NESTING:
487 result = NT_STATUS_INTERNAL_ERROR;