diff options
author | Stef Walter <stefw@gnome.org> | 2013-01-09 13:41:34 +0100 |
---|---|---|
committer | Stef Walter <stefw@gnome.org> | 2013-01-09 13:43:16 +0100 |
commit | 8b4c3561d9681096d588d599d049a77bea68470b (patch) | |
tree | e12c79b54cc215ee9b98cd23bca01937858a79a7 /p11-kit | |
parent | e8aa2fa8f3a085ca514e7b305ff91e2c77e5e6f4 (diff) |
Documentation fixes for PIN functions
Diffstat (limited to 'p11-kit')
-rw-r--r-- | p11-kit/pin.c | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/p11-kit/pin.c b/p11-kit/pin.c index 260d94e..96511e6 100644 --- a/p11-kit/pin.c +++ b/p11-kit/pin.c @@ -127,8 +127,7 @@ * P11_KIT_PIN_FALLBACK: * * Used with p11_kit_pin_register_callback() to register a fallback callback. - * This callback will be called if no other - * String of URI scheme for PKCS\#11 URIs. + * This callback will be called if no other callback is registered for a 'pin-source'. */ typedef struct _PinCallback { @@ -429,17 +428,18 @@ p11_kit_pin_request (const char *pin_source, * where an application is expecting to interact with a prompter, but * instead is interacting with this callback reading a file over and over. * - * This callback fail on larger than 4 Kilobytes. + * This callback fails on files larger than 4 Kilobytes. * - * This callback is not registered by default. To register it use code like - * the following: + * This callback is not registered by default. It may have security + * implications depending on the source of the PKCS\#11 URI and the PKCS\#11 + * in use. To register it, use code like the following: * * <informalexample><programlisting> * p11_kit_pin_register_callback (P11_KIT_PIN_FALLBACK, p11_kit_pin_file_callback, * NULL, NULL); * </programlisting></informalexample> * - * Returns: a referenced PIN with the pinfile contents, or %NULL if the file + * Returns: a referenced PIN with the file contents, or %NULL if the file * could not be read */ P11KitPin * |