aboutsummaryrefslogtreecommitdiffstats
path: root/src/lib/ffi
diff options
context:
space:
mode:
authorJack Lloyd <[email protected]>2018-09-13 10:12:17 -0400
committerJack Lloyd <[email protected]>2018-09-13 10:12:17 -0400
commit5e97d0a489e31fc2fcbb552bda4257534cb9d964 (patch)
tree3c0edb6e87850939c9984fa2f075d85ec118d820 /src/lib/ffi
parent2b378c73f5b5a4576336dba5bdd8c2f642702b02 (diff)
Some document fixes
Downgrade min Sphinx to 1.2 again - I checked and while Sphinx 1.2 produce many warnings it does generate usable output.
Diffstat (limited to 'src/lib/ffi')
-rw-r--r--src/lib/ffi/ffi.h21
1 files changed, 13 insertions, 8 deletions
diff --git a/src/lib/ffi/ffi.h b/src/lib/ffi/ffi.h
index 306fbb0a0..57631bc28 100644
--- a/src/lib/ffi/ffi.h
+++ b/src/lib/ffi/ffi.h
@@ -1476,7 +1476,7 @@ int botan_key_unwrap3394(const uint8_t wrapped_key[], size_t wrapped_key_len,
typedef struct botan_hotp_struct* botan_hotp_t;
/**
-* Initialize an HOTP instance
+* Initialize a HOTP instance
*/
BOTAN_PUBLIC_API(2,8)
int botan_hotp_init(botan_hotp_t* hotp,
@@ -1491,7 +1491,7 @@ BOTAN_PUBLIC_API(2,8)
int botan_hotp_destroy(botan_hotp_t hotp);
/**
-* Generate an HOTP code for the provided counter
+* Generate a HOTP code for the provided counter
*/
BOTAN_PUBLIC_API(2,8)
int botan_hotp_generate(botan_hotp_t hotp,
@@ -1499,7 +1499,7 @@ int botan_hotp_generate(botan_hotp_t hotp,
uint64_t hotp_counter);
/**
-* Verify an HOTP code
+* Verify a HOTP code
*/
BOTAN_PUBLIC_API(2,8)
int botan_hotp_check(botan_hotp_t hotp,
@@ -1516,7 +1516,7 @@ int botan_hotp_check(botan_hotp_t hotp,
typedef struct botan_totp_struct* botan_totp_t;
/**
-* Initialize an TOTP instance
+* Initialize a TOTP instance
*/
BOTAN_PUBLIC_API(2,8)
int botan_totp_init(botan_totp_t* totp,
@@ -1532,7 +1532,10 @@ BOTAN_PUBLIC_API(2,8)
int botan_totp_destroy(botan_totp_t totp);
/**
-* Generate an TOTP code for the provided counter
+* Generate a TOTP code for the provided timestamp
+* @param totp the TOTP object
+* @param totp_code the OTP code will be written here
+* @param timestamp the current local timestamp
*/
BOTAN_PUBLIC_API(2,8)
int botan_totp_generate(botan_totp_t totp,
@@ -1540,10 +1543,12 @@ int botan_totp_generate(botan_totp_t totp,
uint64_t timestamp);
/**
-* Verify an TOTP code
+* Verify a TOTP code
* @param totp the TOTP object
-* @param clock_drift if non-null and otp code is valid,
-* set to the drift between the two clocks.
+* @param totp_code the presented OTP
+* @param timestamp the current local timestamp
+* @param acceptable_clock_drift specifies the acceptable amount
+* of clock drift (in terms of time steps) between the two hosts.
*/
BOTAN_PUBLIC_API(2,8)
int botan_totp_check(botan_totp_t totp,