Key Query library - frkeyqry

$Author: francisl $
$Date: 2000/07/24 20:14:53 $
$Revision: 1.1 $

1.0 Key Query Server interface

All key queries should be done through the Key Query (KQD) server. For that, two interfaces are available:

1.1 Simple interface (fr_keyqry_fetchkey.h)

This file contains a simple interface to the Key Query server that can retreive a signing or cryption key with a single function call. The function will construct and send a query to the server, actively wait for the result and return the key.

1.2 More advanced interface (fr_keyqry.h)

This file also provides an interface to the Key Query server but it is more complex because it also provides some functionality to help improve performance when fetching keys:

2.0 pubkey DB interface

In contrast to key queries, key updates are done directly to the pubkey database (pubkeydb). Note that Nym public keys should always be updated through the Nym server.

2.1 External Key Update interface (fr_keyupd.h)

The functions contained in this file provide an interface to build and manipule database update queries. It also provides functions to send the query to the pubkey database.

2.2 Internal Key Update interface (fr_keyqry_db.h)

This file provides an interface for both fetching and writing Nym public keys directly in the pubkey database (i.e. bypassing the Key query server). This interface is currently used only within the library and should probably not be used externally.

2.3 DB key and record validation (fr_datumvrfy.h)

The function contained in fr_datumvrfy.h validate a pubkey db entry. It verify the DB key structure as well as the data (crypto key) structure. Note that the key signature is not verified.