libotputil: adding otputil_skey_dict_word()

5 files changed, 128 insertions, 0 deletions

diff --git a/Makefile.am b/Makefile.am
index e4a3946..fa46421 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -180,6 +180,8 @@ lib_libotputil_a_SOURCES		= $(noinst_HEADERS) \
                                           lib/libotputil/lcore.h \
                                           lib/libotputil/lmisc.c \
                                           lib/libotputil/lmisc.h \
+                                          lib/libotputil/lrfc1760-skey.c \
+                                          lib/libotputil/lrfc1760-skey.h \
                                           lib/libotputil/lrfc1760-skey-dict.c \
                                           lib/libotputil/lrfc1760-skey-dict.h \
                                           lib/libotputil/lrfc2289-otp.c \
diff --git a/include/otputil.h b/include/otputil.h
index 6af498d..a398979 100644
--- a/include/otputil.h
+++ b/include/otputil.h
@@ -365,6 +365,16 @@ otputil_otp_encode_len(
          const otputil_bv_t *          bv );
 
 
+//----------------//
+// S/KEY functions //
+//----------------//
+#pragma mark S/KEY functions (RFC 1760)
+
+_OTPUTIL_F const char *
+otputil_skey_dict_word(
+         int                           value );
+
+
 //---------------//
 // TOTP functions //
 //---------------//
diff --git a/lib/libotputil/libotputil.sym b/lib/libotputil/libotputil.sym
index dac3069..17c94e9 100644
--- a/lib/libotputil/libotputil.sym
+++ b/lib/libotputil/libotputil.sym
@@ -84,6 +84,8 @@ otputil_otp_decode
 otputil_otp_decode_len
 otputil_otp_encode
 otputil_otp_encode_len
+# S/KEY functions (RFC 1760)
+otputil_skey_dict_word
 # TOTP functions (RFC 6238)
 otputil_totp_code
 otputil_totp_str
diff --git a/lib/libotputil/lrfc1760-skey.c b/lib/libotputil/lrfc1760-skey.c
new file mode 100644
index 0000000..bb79414
--- /dev/null
+++ b/lib/libotputil/lrfc1760-skey.c
@@ -0,0 +1,67 @@
+/*
+ *  OTP Utilities
+ *  Copyright (C) 2022 David M. Syzdek <david@syzdek.net>.
+ *
+ *  Redistribution and use in source and binary forms, with or without
+ *  modification, are permitted provided that the following conditions are
+ *  met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *     * Neither the name of David M. Syzdek nor the
+ *       names of its contributors may be used to endorse or promote products
+ *       derived from this software without specific prior written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+ *  IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ *  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ *  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DAVID M SYZDEK BE LIABLE FOR
+ *  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ *  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ *  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ *  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ *  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ *  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ *  SUCH DAMAGE.
+ */
+/*
+ *  @file lib/libotputil/lrfc1760-skey.c
+ */
+#define _LIB_LIBOTPUTIL_LRFC1760_SKEY_C 1
+#include "lrfc1760-skey.h"
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+#pragma mark - Headers
+
+#include <errno.h>
+#include <string.h>
+#include <strings.h>
+
+#include "lrfc1760-skey-dict.h"
+
+
+/////////////////
+//             //
+//  Functions  //
+//             //
+/////////////////
+#pragma mark - Functions
+
+const char *
+otputil_skey_dict_word(
+         int                           value )
+{
+   if ((value < 0) || (value > 2047))
+      return(NULL);
+   return(otputil_skey_rfc1760_dict[value]);
+}
+
+
+/* end of source file */
diff --git a/lib/libotputil/lrfc1760-skey.h b/lib/libotputil/lrfc1760-skey.h
new file mode 100644
index 0000000..f5e01a6
--- /dev/null
+++ b/lib/libotputil/lrfc1760-skey.h
@@ -0,0 +1,47 @@
+/*
+ *  OTP Utilities
+ *  Copyright (C) 2022 David M. Syzdek <david@syzdek.net>.
+ *
+ *  Redistribution and use in source and binary forms, with or without
+ *  modification, are permitted provided that the following conditions are
+ *  met:
+ *
+ *     * Redistributions of source code must retain the above copyright
+ *       notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ *       notice, this list of conditions and the following disclaimer in the
+ *       documentation and/or other materials provided with the distribution.
+ *     * Neither the name of David M. Syzdek nor the
+ *       names of its contributors may be used to endorse or promote products
+ *       derived from this software without specific prior written permission.
+ *
+ *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+ *  IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ *  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ *  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DAVID M SYZDEK BE LIABLE FOR
+ *  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ *  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ *  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ *  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ *  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ *  OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ *  SUCH DAMAGE.
+ */
+/*
+ *  @file lib/libotputil/lrfc1760-skey.h
+ */
+#ifndef _LIB_LIBOTPUTIL_LRFC1760_SKEY_H
+#define _LIB_LIBOTPUTIL_LRFC1760_SKEY_H 1
+
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+#pragma mark - Headers
+
+#include "libotputil.h"
+
+
+#endif /* end of header file */