oath_hotp_validate (3) - Linux Manuals

oath_hotp_validate: API function


oath_hotp_validate - API function


#include <oath.h>

int oath_hotp_validate(const char * secret, size_t secret_length, uint64_t start_moving_factor, size_t window, const char * otp);


const char * secret
the shared secret string
size_t secret_length
length of secret
uint64_t start_moving_factor
start counter in OTP stream
size_t window
how many OTPs after start counter to test
const char * otp
the OTP to validate.


Validate an OTP according to OATH HOTP algorithm per RFC 4226.

Currently only OTP lengths of 6, 7 or 8 digits are supported. This restrictions may be lifted in future versions, although some limitations are inherent in the protocol.


Returns position in OTP window (zero is first position), or OATH_INVALID_OTP if no OTP was found in OTP window, or an error code.


Report bugs to <oath-toolkit-help [at] nongnu.org>. liboath home page: http://www.gnu.org/software/liboath/ General help using GNU software: http://www.gnu.org/gethelp/


Copyright © 2009-2012 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.