---
name: "tdb_fetch"
section: "3"
platform: "linux"
package: "libtdb-dev"
version: "2:1.4.13+samba4.22.11+dfsg-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tdb_fetch"
---

# tdb\_fetch(3)

fetch a record from a tdb database

## NAME

tdb\_fetch - fetch a record from a tdb database

## SYNOPSIS

```
#include <tdb.h>

TDB_DATA tdb_fetch(TDB_CONTEXT *tdb, TDB_DATA key);

```

## DESCRIPTION

Fetch the record from the *tdb* database whose key matches *key* , a lump of data that is used as the index into the database.

The TDB\_DATA structure used for both the key and the return value is defined as:

```
typedef struct {
	char *dptr;
	size_t dsize;
} TDB_DATA;
```

## RETURN VALUE

If the call succeeds, then a TDB\_DATA structure is returned with the *dptr* structure filled in. If the call fails then *dptr* will be set to NULL.

**NOTE:** The caller is responsible for freeing the data pointed to by *dptr.*

## AUTHORS

Software: Andrew Tridgell \<tridge@linuxcare.com\> and Luke Kenneth Casson Leighton Man page: Ben Woodard \<ben@valinux.com\>

## SEE ALSO

[**gdbm**(3)](/gdbm/3.md), **[tdb(3)](/tdb/3.md)**