.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "oath_init" 3 "2.6.11" "liboath" "liboath"
.SH NAME
oath_init \- API function
.SH SYNOPSIS
.B #include <oath.h>
.sp
.BI "int oath_init( " void ");"
.SH ARGUMENTS
.IP " void" 12
.SH "DESCRIPTION"

This function initializes the OATH library.  Every user of this
library needs to call this function before using other functions.
You should call \fBoath_done()\fP when use of the OATH library is no
longer needed.

Note that this function may also initialize Libgcrypt, if the OATH
library is built with libgcrypt support and libgcrypt has not been
initialized before.  Thus if you want to manually initialize
libgcrypt you must do it before calling this function.  This is
useful in cases you want to disable libgcrypt's internal lockings
etc.
.SH "RETURNS"
On success, \fBOATH_OK\fP (zero) is returned, otherwise an
error code is returned.
.SH "REPORTING BUGS"
Report bugs to <oath-toolkit-help@nongnu.org>.
liboath home page: https://www.nongnu.org/oath-toolkit/
General help using GNU software: http://www.gnu.org/gethelp/
.SH COPYRIGHT
Copyright \(co 2009-2020 Simon Josefsson.
.br
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.