5.0 from trustcommerce

[tclink.git] / tclink.h

diff --git a/tclink.h b/tclink.h
index 83862ef462a969c69259d6255e6806094c65f1cc..6623ffcdd37d6bf1ed6c3aaf7be9df17a6f2e2ef 100644 (file)
--- a/tclink.h
+++ b/tclink.h
@@ -1,24 +1,4 @@
-/* tclink.h - Header file for TCLink library.
- *
- * TCLink Copyright (c) 2013 TrustCommerce.
- * http://www.trustcommerce.com
- * techsupport@trustcommerce.com
- * (949) 387-3747
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- */
+/* tclink.h - Header file for TCLink library. */
 
 #ifndef _TCLINK_H
 #define _TCLINK_H
@@ -29,55 +9,64 @@
  * for each concurrent thread, but the same handle can be shared by transactions
  * occurring one after another (such as a for loop).
  */
-#define TCLinkHandle void *
+#define TCLinkHandle void*
 
 /* Parameter names and values cannot exceed this size.
  */
-#define PARAM_MAX_LEN 256
+#define PARAM_MAX_LEN 768
 
 /* Create a new TCLinkHandle.
  */
-TCLinkHandle TCLinkCreate();
+TCLinkHandle
+TCLinkCreate();
 
 /* Add a parameter to be sent to the server.
  */
-void TCLinkPushParam(TCLinkHandle handle, const char *name, const char *value);
+void
+TCLinkPushParam(TCLinkHandle handle, const char* name, const char* value);
 
 /* Flush the parameters to the server.
  */
-void TCLinkSend(TCLinkHandle handle);
+void
+TCLinkSend(TCLinkHandle handle);
 
 /* Look up a response value from the server.
  * Returns NULL if no such parameter, or stores the value in 'value' and
  * returns a pointer to value.  value should be at least PARAM_MAX_LEN in size.
  */
-char *TCLinkGetResponse(TCLinkHandle handle, const char *name, char *value);
+char*
+TCLinkGetResponse(TCLinkHandle handle, const char* name, char* value);
 
 /* Get all response values from the server in one giant string.
  * Stores the string into buf and returns a pointer to it.  Size should be
  * sizeof(buf), which will limit the string so that no buffer overruns occur.
  */
-char *TCLinkGetEntireResponse(TCLinkHandle handle, char *buf, int size);
+char*
+TCLinkGetEntireResponse(TCLinkHandle handle, char* buf, int size);
 
-/* Destory a handle, ending that transaction and freeing the memory associated with it. */
-void TCLinkDestroy(TCLinkHandle handle);
+/* Destory a handle, ending that transaction and freeing the memory associated
+ * with it. */
+void
+TCLinkDestroy(TCLinkHandle handle);
 
 /* Store version string into buf.  Returns a pointer to buf. */
-char *TCLinkGetVersion(char *buf);
-
+char*
+TCLinkGetVersion(char* buf);
 
 /* The API methods below are subject to change. */
 
-/* Enables (1) or Disables (0) the full SSL close_notify sequence.  By default, this is set to 1.*/
-int TCLinkSetFullClose(TCLinkHandle handle, int full_ssl_close);
+/* Enables (1) or Disables (0) the full SSL close_notify sequence.  By default,
+ * this is set to 1.*/
+int
+TCLinkSetFullClose(TCLinkHandle handle, int full_ssl_close);
 
-/* Provides a method, before the first send call is initiated, of loading a set of trusted CA certificates (PEM format). */
-void TCLinkSetTrustedCABundle(TCLinkHandle handle, const char *str, int len);
-
-/* Provides a method, once the handshake is completed, a means to verify the contents of that certificate independently.  
- * Note that the certificate may not be set depending on the negotation type (in which case the pointer would be NULL)
+/* Provides a method, once the handshake is completed, a means to verify the
+ * contents of that certificate independently. Note that the certificate may not
+ * be set depending on the negotation type (in which case the pointer would be
+ * NULL)
  */
-void TCLinkSetValidateCallback(TCLinkHandle handle, int (*validate_cert)(int, void *));
+void
+TCLinkSetValidateCallback(TCLinkHandle handle,
+                          int (*validate_cert)(int, void*));
 
 #endif
-