From 35491f0a12ef0c75f1b4e4f099163d448ad8d84e Mon Sep 17 00:00:00 2001
From: Berke Viktor <bviktor@hexchat.org>
Date: Mon, 20 May 2013 12:38:50 +0200
Subject: [PATCH] Sample code docs for challengeauth_response()

---
 src/common/util.c | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/common/util.c b/src/common/util.c
index d14122d..6f49580 100644
--- a/src/common/util.c
+++ b/src/common/util.c
@@ -1624,6 +1624,21 @@ str_sha256hash (char *string)
 	return g_strdup (buf);
 }
 
+/**
+ * \brief Generate CHALLENGEAUTH response for QuakeNet login.
+ *
+ * \param username QuakeNet user name
+ * \param password password for the user
+ * \param challenge the CHALLENGE response we got from Q
+ *
+ * After a successful connection to QuakeNet a CHALLENGE is requested from Q.
+ * Generate the CHALLENGEAUTH response from this CHALLENGE and our user
+ * credentials as per the
+ * <a href="http://www.quakenet.org/development/challengeauth">CHALLENGEAUTH</a>
+ * docs. As for using OpenSSL HMAC, see
+ * <a href="http://www.askyb.com/cpp/openssl-hmac-hasing-example-in-cpp/">example 1</a>,
+ * <a href="http://stackoverflow.com/questions/242665/understanding-engine-initialization-in-openssl">example 2</a>.
+ */
 char *
 challengeauth_response (char *username, char *password, char *challenge)
 {
-- 
2.11.4.GIT