From b73f4ef126bdead47262e29e47d159a89984d65f Mon Sep 17 00:00:00 2001
From: Stef Walter <stefw@gnome.org>
Date: Tue, 19 Feb 2013 14:05:34 +0100
Subject: Add the log-calls module config option

If 'log-calls = yes' is set then all the PKCS#11 modules are logged
to stderr.
---
 doc/manual/Makefile.am         |  1 +
 doc/manual/p11-kit-sharing.xml |  5 +++++
 doc/manual/pkcs11.conf.xml     | 19 +++++++++++++++++++
 3 files changed, 25 insertions(+)

(limited to 'doc')

diff --git a/doc/manual/Makefile.am b/doc/manual/Makefile.am
index 084e941..e306fb1 100644
--- a/doc/manual/Makefile.am
+++ b/doc/manual/Makefile.am
@@ -52,6 +52,7 @@ IGNORE_HFILES= \
 	conf.h \
 	debug.h \
 	dict.h \
+	log.h \
 	mock.h \
 	modules.h \
 	pkcs11.h \
diff --git a/doc/manual/p11-kit-sharing.xml b/doc/manual/p11-kit-sharing.xml
index 0989923..bf0ed01 100644
--- a/doc/manual/p11-kit-sharing.xml
+++ b/doc/manual/p11-kit-sharing.xml
@@ -94,6 +94,11 @@
 			<literal>C_CloseAllSessions</literal> function to be used without closing
 			sessions for other callers of the same PKCS#11 module.</para>
 		</listitem>
+		<listitem>
+			<para>Managed modules have ability to log PKCS#11 method calls for debugging
+			purposes. See the <link linkend="option-log-calls"><literal>log-calls = yes</literal></link>
+			module configuration option.</para>
+		</listitem>
 		</itemizedlist>
 	</section>
 </chapter>
diff --git a/doc/manual/pkcs11.conf.xml b/doc/manual/pkcs11.conf.xml
index 1051ee1..1ff2562 100644
--- a/doc/manual/pkcs11.conf.xml
+++ b/doc/manual/pkcs11.conf.xml
@@ -157,6 +157,15 @@ x-custom : text
 			of trust policy information such as certificate anchors and black lists.</para>
 		</listitem>
 	</varlistentry>
+	<varlistentry id="option-log-calls">
+		<term>log-calls:</term>
+		<listitem>
+			<para>Set to <literal>yes</literal> to write a log to stderr of all the
+			calls into the module. This is only supported for managed modules.</para>
+
+			<para>This argument is optonal and defaults to <literal>no</literal>.</para>
+		</listitem>
+	</varlistentry>
 	</variablelist>
 
 	<para>Do not specify both <literal>enable-in</literal> and <literal>disable-in</literal>
@@ -196,6 +205,16 @@ x-custom : text
 			<para>This argument is optonal.</para>
 		</listitem>
 	</varlistentry>
+	<varlistentry>
+		<term>log-calls:</term>
+		<listitem>
+			<para>Set to <literal>yes</literal> to write a log to stderr of all the
+			calls into all configured modules. This is only supported for managed
+			modules.</para>
+
+			<para>This argument is optional.</para>
+		</listitem>
+	</varlistentry>
 	</variablelist>
 
 	<para>Other fields may be present, but it is recommended that field names
-- 
cgit v1.1