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:
-
Embedded key cache for faster access of often used keys
-
Provides seperate interface for sending query and getting the result so
that the user can perform other action while the key is being fetched.
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.