@@ -189,7 +189,16 @@ key_info_manager = "sqlite-manager"
189189# (Required) TPM TCTI device to use with this provider. The string can include configuration values - if no
190190# configuration value is given, the defaults are used. Options are:
191191# - "device": uses a TPM device available as a file node; path can be given as a configuration string,
192- # e.g "device:/path/to/tpm"; the default path is /dev/tpm0
192+ # e.g "device:/path/to/tpm". The default path is /dev/tpm0, but this default is only suitable in deployments
193+ # where Parsec would have exclusive usage of the device, and where Parsec is executing at a sufficiently high
194+ # privilege for such access. It is more common for the TPM device to be managed by an Access Broker / Resource
195+ # Manager (ABRM) component, either within the kernel or via a userspace daemon (the TABRMD). Trying to
196+ # use /dev/tpm0 directly in such cases will lead to "device busy" errors on service start-up. Instead, Parsec should
197+ # normally be configured to access the TPM via the suitable ABRM. To use the in-kernel ABRM, the "device"
198+ # setting should be configured to use the managed TPM device path, typically /dev/tpmrm0. Permissions on this
199+ # device are normally less restrictive. In most Linux distributions, this device can be accessed by any user
200+ # within the "tss" group, so whatever user the Parsec service is running as should be made a member of this group.
201+ # To use the userspace ABRMD, adopt the "tabrmd" setting below, instead of "device".
193202# - "mssim": uses the TPM simulator server with the socket; server path and/or port can be given as configuration values,
194203# e.g. "mssim:host=168.0.1.1,port=1234"; "host" can be set to IPv4, IPv6 or a hostname; default values are
195204# "localhost" for "host" and 2321 for "port"
0 commit comments