bankd: Open PC/SC by default in EXCLUSIVE mode
Let's open the cards in EXCLUSIVE mode, we don't want other applications
tinkering with the card state while we have a bankd worker running on
it. This change also means that no two bankd workers can trip on
each other accidentially anymore.
Related: OS#5527
Change-Id: I43a1c8c7bd1c0124ee5f605e2e5b04ed8f7836ab
diff --git a/doc/manuals/chapters/remsim-bankd.adoc b/doc/manuals/chapters/remsim-bankd.adoc
index 7c102de..cb3061c 100644
--- a/doc/manuals/chapters/remsim-bankd.adoc
+++ b/doc/manuals/chapters/remsim-bankd.adoc
@@ -89,6 +89,15 @@
*-P, --bind-port <1-65535>*::
Specify the local TCP port to which the socket for incoming connections
from `osmo-remsim-client`s is bound to.
+*-s, --permit-shared-pcsc*::
+ Specify whether the PC/SC readers should be accessed in SCARD_SHARE_SHARED
+ mode, instead of the default (SCARD_SHARE_EXCLUSIVE). Shared mode would
+ permit multiple application programs to access a single reader/slot/card
+ concurrently. This is potentially dangerous as the two programs operate
+ without knowledge of each other, and either of them might modify the card
+ state (such as the currently selected file, validated PIN, etc.) in a
+ way not expected by the other application.
+
==== Examples
.remsim-server is on 10.2.3.4, cardreader has 5 slots: