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

# RDLP\_ROMToken(3)

find a ROM token on a PalmOS device

## NAME

**RDLP\_ROMToken** – find a ROM token on a PalmOS device

## LIBRARY

*libpconn*

## SYNOPSIS

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

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

*int*\

**RDLP\_ROMToken**(*PConnection \*pconn*, *uword cardno*, *udword token*, *udword \*data\_ptr*, *uword \*data\_len*);

## DESCRIPTION

Palm devices appear to have “ROM tokens”, which are essentially named pointers. The most useful token that the author is aware of is ‘snum’, which indicates the location of the serial number, on those Palm devices that have a serial number that can be read in software (*e.g.*, Palm III).

To read the serial number, you must first call **RDLP\_ROMToken** to find the location and length of the serial number, then call RDLP\_MemMove to actually read the serial number.

*cardno* specifies the memory card on which to look. This is usually 0.

*token* specifies the four-character identifier (first letter in the most-significant eight bits) of the ROM token to look for.

*data\_ptr* will be filled in with the starting address of the data that the token refers to.

*data\_len* will be filled in with the length of the data that the token refers to.

## RETURN VALUE

**RDLP\_ROMToken** returns 0 if successful, or a negative value otherwise.

## SEE ALSO

[libpconn(3)](/libpconn/3.md), [DlpRPC(3)](/DlpRPC/3.md), [RDLP\_MemMove(3)](/RDLP_MemMove/3.md).