Low-level IPC mechanism for Sequoia.
Sequoia makes use of background services e.g. for managing and updating public keys.
We use the filesystem as namespace to discover services. Every service has a file called rendezvous point. Access to this file is serialized using file locking. This file contains a socket address and a cookie that we use to connect to the server and authenticate us. If the file does not exist, is malformed, or does not point to a usable server, we start a new one on demand.
This design mimics Unix sockets, but works on Windows too.
These servers can be either in external processes, or co-located within the current process. We will first start an external process, and fall back to starting a thread instead.
Using an external process is the preferred option. It allows us to continuously update the keys in the keystore, for example. It also means that we do not spawn a thread in your process, which is frowned upon for various reasons.
Please see IPCPolicy for more information.
Windows support is currently not implemented, but should be straight forward.
Assuan RPC support.
Contexts and errors.
GnuPG RPC support.
S-Expressions for communicating cryptographic primitives.
A descriptor is used to connect to a service.
A proprietary, protocol agnostic identifier for public keys.
Errors returned from the network routines.
Servers need to implement this trait.
A factory for handlers.