Copyright (C) 2009-2013 Simon Josefsson.  Licensed under the GPLv3+.

The OATH Toolkit makes it easy to build one-time password
authentication systems.  It contains shared libraries, command line
tools and a PAM module.  Supported technologies include the
event-based HOTP algorithm (RFC4226) and the time-based TOTP algorithm
(RFC6238).  OATH stands for Open AuTHentication, which is the
organization that specify the algorithms.  For managing secret key
files, the Portable Symmetric Key Container (PSKC) format described in
RFC6030 is supported.

The components included in the package is:

  * liboath: A shared and static C library for OATH handling.

  * oathtool: A command line tool for generating and validating OTPs.

  * pam_oath: A PAM module for pluggable login authentication for OATH.

  * libpskc: A shared and static C library for PSKC handling.

  * pskctool: A command line tool for manipulating PSKC data.

See each sub-directory for more information.

The file INSTALL contains generic installation and configuration
instructions, however briefly the typical process is:

$ ./configure
$ make check install

If the builtin self-tests fail, you should report it as a bug and not
install the software.

The file HACKING contains information that is useful if you are
building for version controlled sources.

For updates on the project please visit our web page:

  https://savannah.nongnu.org/projects/oath-toolkit/
  http://gitorious.org/oath-toolkit

For e-mail discussions related the OATH Toolkit, please send e-mail to
oath-toolkit-help@nongnu.org after subscribing to the mailing list
through this web page:

  http://lists.nongnu.org/mailman/listinfo/oath-toolkit-help

Note that the OATH Toolkit project used to be called "HOTP Toolkit",
and there are still references to the old project name elsewhere.
Please help and change them to point at OATH Toolkit instead.