Scroll to navigation

PKCSSLOTD(8) openCryptoki PKCSSLOTD(8)

NAME

pkcsslotd - shared memory manager for openCryptoki

SYNOPSIS

pkcsslotd

DESCRIPTION

The pkcsslotd daemon coordinates PKCS#11-enabled applications that use openCryptoki. It maintains a shared memory segment that tracks, per slot, the number of open sessions across all processes, and reclaims sessions of processes that terminate without calling C_Finalize.

pkcsslotd also delivers asynchronous events to running openCryptoki applications over a Unix domain socket. This includes notifications about cryptographic adapters (APQNs) becoming available or unavailable, and coordination events used by the pkcshsm_mk_change(1) tool when changing a hardware security module's master key.

At startup, pkcsslotd reads the opencryptoki.conf(5) configuration file to determine which slots and tokens are available. It passes this slot and token configuration to openCryptoki applications over the same Unix domain socket during their C_Initialize call.

NOTES

Only one instance of the pkcsslotd daemon should be running on any given host. If a prior instance of pkcsslotd did not shut down cleanly, then it may leave an allocated shared memory segment on the system. The allocated memory segment can be identified by its key and can be safely removed once the daemon is stopped with the ipcrm command, such as:

ipcrm -M 0x6202AB38

The daemon creates the shared memory segment with group ownership by the pkcs11 group. All non-root users that should be able to use openCryptoki need to be members of the group. Only trusted users should be assigned to the group, see the "SECURITY NOTE" in the opencryptoki(7) manual page for details.

pkcsslotd normally runs under the pkcsslotd user (and the pkcs11 group). If started as root, it performs its privileged initialization steps and then drops privileges to the pkcsslotd user before proceeding.

SEE ALSO

opencryptoki(7),
opencryptoki.conf(5),
pkcsconf(1),
pkcsstats(1),
pkcshsm_mk_change(1).
August 2026 3.28.0