From: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Date: Fri, 8 Jun 2012 07:20:32 +0000 (+0200)
Subject: documented pin_callback expectations.
X-Git-Tag: gnutls_3_0_21~52
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2576a9d933e4f29f69a7182faa9c4210eeec8fee;p=thirdparty%2Fgnutls.git

documented pin_callback expectations.
---

diff --git a/doc/examples/ex-cert-select-pkcs11.c b/doc/examples/ex-cert-select-pkcs11.c
index e8cb21e367..83c2e64c9f 100644
--- a/doc/examples/ex-cert-select-pkcs11.c
+++ b/doc/examples/ex-cert-select-pkcs11.c
@@ -46,6 +46,11 @@ pin_callback (void *user, int attempt, const char *token_url,
 {
   const char *password;
   int len;
+  
+  /* Note that a PIN callback may be called multiple times during a
+   * session. It is expected to cache and return the same PIN for
+   * the same token_url, unless flags is set to GNUTLS_PKCS11_PIN_WRONG.
+   */
 
   printf ("PIN required for token '%s' with URL '%s'\n", token_label,
           token_url);