]> granicus.if.org Git - p11-kit/commitdiff
More fine tuning of the pin APIs.
authorStef Walter <stefw@collabora.co.uk>
Wed, 6 Jul 2011 10:48:52 +0000 (12:48 +0200)
committerStef Walter <stefw@collabora.co.uk>
Wed, 6 Jul 2011 10:49:26 +0000 (12:49 +0200)
doc/p11-kit-sections.txt
p11-kit/pin.c
p11-kit/pin.h

index ab672c46b16e93e2bd222034b295a4931b6409f0..7d9a825af58d798d51fef1413feede62b238307a 100644 (file)
@@ -34,6 +34,7 @@ p11_kit_pin_new
 p11_kit_pin_new_for_buffer
 p11_kit_pin_new_for_string
 p11_kit_pin_get_value
+p11_kit_pin_get_length
 p11_kit_pin_ref
 p11_kit_pin_unref
 P11KitPinFlags
index 5ede97a1842d30246418bc895daaa2dfc4b42245..572c138490e54d5d56339e9acbe293f24e25526d 100644 (file)
@@ -509,7 +509,7 @@ p11_kit_pin_file_callback (const char *pinfile,
  * A structure representing a PKCS\#11 PIN. There are no public fields
  * visible in this structure. Use the various accessor functions.
  */
-struct _P11KitPin {
+struct p11_kit_pin {
        int ref_count;
        unsigned char *buffer;
        size_t length;
@@ -617,7 +617,7 @@ p11_kit_pin_new_for_buffer (unsigned char *buffer, size_t length,
  *
  * The value returned is owned by the P11KitPin and should not be modified.
  * It remains valid as long as a reference to the PIN is held. The PIN value
- * will contain an extra null-terminator character.
+ * will not contain an extra null-terminator character.
  *
  * Returns: the value for the PIN.
  */
@@ -629,6 +629,20 @@ p11_kit_pin_get_value (P11KitPin *pin, size_t *length)
        return pin->buffer;
 }
 
+/**
+ * p11_kit_pin_get_length
+ * @pin: the P11KitPin
+ *
+ * Get the length of the PIN value from a P11KitPin.
+ *
+ * Returns: the length of the PIN value.
+ */
+size_t
+p11_kit_pin_get_length (P11KitPin *pin)
+{
+       return pin->length;
+}
+
 /**
  * p11_kit_pin_ref:
  * @pin: the P11KitPin
index 9d05331dd7de1317dd7a3a03a484f7052797e151..07e7f6a5b3bdf113c612001f6a6864320cec2a52 100644 (file)
@@ -41,7 +41,7 @@
 extern "C" {
 #endif
 
-typedef struct _P11KitPin P11KitPin;
+typedef struct p11_kit_pin P11KitPin;
 
 typedef enum {
        P11_KIT_PIN_FLAGS_USER_LOGIN = 1,
@@ -72,6 +72,8 @@ void                  p11_kit_pin_unref                     (P11KitPin *pin);
 const unsigned char * p11_kit_pin_get_value                 (P11KitPin *pin,
                                                              size_t *length);
 
+size_t                p11_kit_pin_get_length                (P11KitPin *pin);
+
 typedef P11KitPin*  (*p11_kit_pin_callback)                 (const char *pinfile,
                                                              P11KitUri *pin_uri,
                                                              const char *pin_description,