oath_hotp_validate(3)

oath_hotp_validate3

Api function

Usage

#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);

Arguments

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.

Overview

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

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.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

Reporting bugs

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

From oath-toolkit 2.6.15-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.