1oath_totp_validate2(3)              liboath             oath_totp_validate2(3)
2
3
4

NAME

6       oath_totp_validate2 - API function
7

SYNOPSIS

9       #include <oath.h>
10
11       int  oath_totp_validate2(const  char  *  secret,  size_t secret_length,
12       time_t now, unsigned time_step_size, time_t start_offset,  size_t  win‐
13       dow, int * otp_pos, const char * otp);
14

ARGUMENTS

16       const char * secret
17                   the shared secret string
18
19       size_t secret_length
20                   length of secret
21
22       time_t now  Unix time value to validate TOTP for
23
24       unsigned time_step_size
25                   time step system parameter (typically 30)
26
27       time_t start_offset
28                   Unix  time  of when to start counting time steps (typically
29                   0)
30
31       size_t window
32                   how many OTPs after/before start OTP to test
33
34       int * otp_pos
35                   output search position in search window (may be NULL).
36
37       const char * otp
38                   the OTP to validate.
39

DESCRIPTION

41       Validate an OTP according to OATH TOTP algorithm per RFC 6238.
42
43       Currently only OTP lengths of 6, 7 or 8 digits are supported.  This re‐
44       strictions  may be lifted in future versions, although some limitations
45       are inherent in the protocol.
46

RETURNS

48       Returns absolute value of position in OTP window (zero is  first  posi‐
49       tion), or OATH_INVALID_OTP if no OTP was found in OTP window, or an er‐
50       ror code.
51

SINCE

53       1.10.0
54

REPORTING BUGS

56       Report bugs  to  <oath-toolkit-help@nongnu.org>.   liboath  home  page:
57       https://www.nongnu.org/oath-toolkit/  General  help using GNU software:
58       http://www.gnu.org/gethelp/
59

61       Copyright © 2009-2020 Simon Josefsson.
62       Copying and distribution of this file, with  or  without  modification,
63       are  permitted in any medium without royalty provided the copyright no‐
64       tice and this notice are preserved.
65
66
67
68liboath                              2.6.7              oath_totp_validate2(3)
Impressum