feat(init-close): initial commit

https/readme.md

@@ -27,6 +27,19 @@ Common Name (e.g. server FQDN or YOUR name) []:hello.swingbe.de
 Email Address []:admin@swingbe.de
 ```
 
+* create self-signed key/certificate without pass phrase
+```
+openssl req \
+    -new \
+    -newkey rsa:4096 \
+    -days 365 \
+    -nodes \
+    -x509 \
+    -subj "/C=DE/ST=Lower Saxony/L=Brunswick/O=Software Ingenieur Begerad/CN=swingbe.de" \
+    -keyout key.pem \
+    -out cert.pem
+```
+
 * run in http mode
 ```
 ./main <port>

init-close/main.c

@@ -0,0 +1,116 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <arpa/inet.h>
+#include <ulfius.h>
+
+#define ROUTE_HELLO "/hello"
+
+/**
+ * callback functions declaration
+ */
+int callback_get_hello (const struct _u_request * request, struct _u_response * response, void * user_data);
+
+int callback_default (const struct _u_request * request, struct _u_response * response, void * user_data);
+
+int main(int argc, char *argv[]) {
+  /*declaration*/
+  struct _u_instance instance;
+  unsigned int port;
+  int ret;
+
+  printf("main() Started...\n");
+  if (argc != 2) {
+    fprintf(stderr, "Usage: %s <port>\n", argv[0]);
+    exit(1);
+  }
+
+  printf("main() argv[1]: %s\n", argv[1]);
+
+  /*store command line argument in int variable*/
+  /*validate user input*/
+  /*omit injection*/
+  /*stream:argv*/
+  ret = sscanf(argv[1], "%d", &port);
+
+  /*valid user input:1 successfully filled item*/
+  if (ret != 1) {
+    fprintf(stderr, "The argument must be an integer\n");
+    exit(1);
+  }
+
+  if (port < 0) {
+    fprintf(stderr, "Error passing a negative port\n");
+    exit(1);
+  }
+  printf("main() port: %d\n", port);
+
+  //initialize ulfius globaly
+  int ugi=ulfius_global_init();
+  if(ugi==U_OK){
+    printf("main() global ulfius initialization successful\n");
+  }else{
+    printf("main() global ulfius NOT initialization successful\n");
+  }
+
+  //initialize ulfius instance
+  if (ulfius_init_instance(&instance, port, NULL, NULL) != U_OK) {
+    printf("main() Error ulfius_init_instance, abort");
+    return(1);
+  }
+
+  //TODO Why?
+  u_map_put(instance.default_headers, "Access-Control-Allow-Origin", "*");  
+
+  // Maximum body size sent by the client is 1 Kb
+  instance.max_post_body_size = 1024;
+
+  // Endpoint list declaration
+  ulfius_add_endpoint_by_val(&instance, "GET", ROUTE_HELLO, NULL, 0, &callback_get_hello, NULL);
+
+  // default_endpoint declaration
+  ulfius_set_default_endpoint(&instance, &callback_default, NULL);
+
+  // Start the framework
+  // Open an http connection
+  ret = ulfius_start_framework(&instance);
+
+  if (ret == U_OK) {
+    printf("main() Start framework on port %d", instance.port);
+    
+    // Wait for the user to press <enter> on the console to quit the application
+    getchar();
+  } else {
+    printf("main() Error starting framework\n");
+  }
+
+  printf("main() End framework\n");
+  
+  ulfius_stop_framework(&instance);
+  ulfius_clean_instance(&instance);
+
+  //close ulfius globaly
+  ulfius_global_close();
+
+  printf("main() Done.\n");
+
+  return 0;
+}
+    
+/**
+ * Callback function that put a "Hello World!" string in the response
+ */
+int callback_get_hello (const struct _u_request * request, struct _u_response * response, void * user_data) {
+  ulfius_set_string_body_response(response, 200, "Hello World!");
+  return U_CALLBACK_CONTINUE;
+}
+
+/**
+ * Default callback function called if no endpoint has a match
+ */
+int callback_default (const struct _u_request * request, struct _u_response * response, void * user_data) {
+  ulfius_set_string_body_response(response, 404, "Page not found, do what you want");
+  return U_CALLBACK_CONTINUE;
+}

init-close/makefile

@@ -0,0 +1,24 @@
+# Docu
+#
+#$@ is the name of the file to be made
+#$? is the names of the changed dependents
+#$< the name of the related file that caused the action
+#$* the prefix shared by target and dependent files
+#
+# Others
+RM      = /bin/rm -f
+#
+# Source, Executable, Includes, Library Defines
+EXE    = main
+#
+# Compiler, Linker Defines
+CC      = /usr/bin/gcc
+#
+all: main.o
+	$(CC) main.c -L/usr/lib/x86_64-linux-gnu -lulfius -Wall -o $(EXE)
+#
+main.o:
+	$(CC) -c main.c
+# Clean Up Objects, Exectuables, Dumps out of source directory
+clean:
+	$(RM) *.o $(EXE) *~

init-close/readme.md

@@ -0,0 +1,17 @@
+* install dependencies on Debian Bullseye
+
+```
+sudo apt install libulfius-dev --no-install-recommends
+```
+
+* build
+
+```
+make
+```
+
+* run
+
+```
+./main <port>
+```