Merge pull request #13 from sys4/libredesign

Modified directory structure to prepare pre-release

LICENSE

@@ -1,3 +1,3 @@
 The TLSRPT tools are released under the GNU General Public License (GPL) version 3 or later (see doc/COPYING for the license terms).
 
-The TLSRPT C library in the "clibrary" subdirectory is released under the GNU Lesser General Public License (LGPL) version 3 or later (see clibrary/library/doc/COPYING.LESSER for the license terms).
+The TLSRPT C library in the "libtlsrpt" subdirectory is released under the GNU Lesser General Public License (LGPL) version 3 or later (see libtlsrpt/COPYING.LESSER for the license terms).

clibrary/library/doc/TLSRPT-c-library-API-Documentation.adoc → doc/TLSRPT-c-library-API-Documentation.adoc

@@ -5,8 +5,8 @@
 :title-page:
 
 = TLSRPT for MTAs - API documentation of the C library
-Version 0.04
-2024-09-05
+Version 0.5.0-pre20240929
+2024-09-29
 
 == Error handling
 
@@ -204,6 +204,13 @@ The default is non-blocking.
 ==== `tlsrpt_set_nonblocking`
 The `tlsrpt_set_nonblocking` function restores the `sendto` call within `tlsrpt_finish_delivery_request` to its default non-blocking behaviour.
 
+==== `tlsrpt_get_socket`
+Parameters:::
+ truct tlsrpt_connection_t* con:: A pointer to the `tlsrpt_connection_t` struct.
+
+The `tlsrpt_get_socket` function returns the socket file descriptor used within a `tlsrpt_connection_t`.
+This can be useful to set socket options.
+
 
 === Error code inspection
 ==== `tlsrpt_errno_from_error_code`

clibrary/INSTALL → libtlsrpt/INSTALL

@@ -2,9 +2,11 @@ libtlsrpt - Installation
 
 To install the libtlsrpt in /usr/local/lib and the header files to /usr/local/include:
 
-1. Change directory to the library´s source directory 
+1. Build library
+
+    make
+
 2. Call "make install" with PREFIX set to "/usr/local"
 
-cd library/src
-make install PREFIX=/usr/local
+    make install PREFIX=/usr/local
 

libtlsrpt/LICENSE

@@ -0,0 +1 @@
+The TLSRPT C library is released under the GNU Lesser General Public License (LGPL) version 3 or later (see COPYING.LESSER for the license terms).

clibrary/library/src/Makefile → libtlsrpt/Makefile

@@ -19,7 +19,7 @@ CC=gcc
 INSTALL=install
 
 DEBUG=-g
-CFLAGS += -Wall -I ../include -fPIC -O2 ${DEBUG}
+CFLAGS += -Wall -I . -fPIC -O2 ${DEBUG}
 LDFLAGS += -Wall -L. ${DEBUG}
 LDLIBS += libtlsrpt.a
 
@@ -42,8 +42,8 @@ libtlsrpt.so : libtlsrpt.o json-escape-initializer-list.o
 
 demo : demo.o libtlsrpt.a
 
-demo.o : ../include/tlsrpt.h
-libtlsrpt.o : ../include/tlsrpt.h
+demo.o : tlsrpt.h
+libtlsrpt.o : tlsrpt.h
 
 
 json-escape-initializer-list.c : create-json-escape-initializer-list
@@ -54,4 +54,4 @@ create-json-escape-initializer-list : LDLIBS =
 
 install: ${TARGETLIBS} 
 	${INSTALL} -D -t ${DESTDIR}${PREFIX}/lib ${TARGETLIBS} 
-	${INSTALL} -D -t ${DESTDIR}${PREFIX}/include ../include/tlsrpt.h 
+	${INSTALL} -D -t ${DESTDIR}${PREFIX}/include tlsrpt.h 

clibrary/library/src/demo.c → libtlsrpt/demo.c

@@ -19,6 +19,7 @@
 
 #include <stdio.h>
 #include <stdlib.h>
+#include <string.h>
 #include <time.h>
 #include "tlsrpt.h"
 
@@ -56,6 +57,13 @@ void testrun() {
   res = tlsrpt_finish_delivery_request(&dr);
 
   printf("Result code is %d\n", res);
+  if(tlsrpt_error_code_is_internal(res)) {
+    printf("Internal library error :  %s\n", tlsrpt_strerror(res));
+  } else {
+    int e = tlsrpt_errno_from_error_code(res);
+    printf("%s : errno=%d : %s\n", tlsrpt_strerror(res), e, strerror(e));
+  }
+
 
   tlsrpt_close(&con);