Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

oath_totp_validate(3)		    liboath		 oath_totp_validate(3)

NAME
       oath_totp_validate - API function

SYNOPSIS
       #include <oath.h>

       int  oath_totp_validate(const  char  *  secret,	size_t	secret_length,
       time_t now, unsigned time_step_size, time_t start_offset,  size_t  win‐
       dow, const char * otp);

ARGUMENTS
       const char * secret
		   the shared secret string

       size_t secret_length
		   length of secret

       time_t now  Unix time value to validate TOTP for

       unsigned time_step_size
		   time step system parameter (typically 30)

       time_t start_offset
		   Unix	 time  of when to start counting time steps (typically
		   0)

       size_t window
		   how many OTPs after/before start OTP to test

       const char * otp
		   the OTP to validate.

DESCRIPTION
       Validate an OTP according to OATH TOTP algorithm per RFC 6238.

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

RETURNS
       Returns absolute value of position in OTP window (zero is  first	 posi‐
       tion),  or  OATH_INVALID_OTP  if	 no OTP was found in OTP window, or an
       error code.

SINCE
       1.6.0

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

COPYRIGHT
       Copyright © 2009-2015 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.

liboath				     2.6.1		 oath_totp_validate(3)

Vote for polarhome