---
name: "DlpReadDBList"
section: "3"
platform: "linux"
package: "coldsync"
version: "3.0+pre3-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/DlpReadDBList"
---

# DlpReadDBList(3)

get information about databases on a PalmOS device

## NAME

**DlpReadDBList** – get information about databases on a PalmOS device

## LIBRARY

*libpconn*

## SYNOPSIS

**#include \<palm.h\>**

**#include \<pconn/pconn.h\>**

*int*\

**DlpReadDBList**(*PConnection \*pconn*, *const ubyte iflags*, *const int card*, *const uword start*, *uword \*last\_index*, *ubyte \*oflags*, *ubyte \*num*, *struct dlp\_dbinfo \*dbs*);

## DESCRIPTION

**DlpReadDBList** reads information about databases on the Palm.

*card* specifies the number of the memory card on which to look. Card numbers begin at 0.

*iflags* specifies which databases to retrieve. It is the bitwise-or of one or more of the following:

- DLPCMD\_READDBLFLAG\_RAM

  RAM databases

- DLPCMD\_READDBLFLAG\_ROM

  ROM (read-only) databases

- DLPCMD\_READDBLFLAG\_MULT

  Return multiple database entries (available as of DLP v1.2).

*start* specifies the number of the first database to read.

*last\_index* is filled in with the index of the last database read.

*oflags* is filled in with output flags. The only one defined is

- DLPRET\_READDBLFLAG\_MORE

  There are more databases after these.

*dbs* is filled in with descriptions of the databases.

## RETURN VALUE

## SEE ALSO

[libpconn(3)](/libpconn/3.md).

## BUGS

DLPCMD\_READDBLFLAG\_MULT doesn't work.