[multiple] add summaries to top of some modules

26 files changed, 156 insertions, 8 deletions

diff --git a/src/burl.c b/src/burl.c
index ca8c8bd6..af7f18df 100644
--- a/src/burl.c
+++ b/src/burl.c
@@ -1,3 +1,9 @@
+/*
+ * burl - buffer URL normalization
+ *
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 #include "burl.h"
 
diff --git a/src/gw_backend.c b/src/gw_backend.c
index 7526351d..b86e2408 100644
--- a/src/gw_backend.c
+++ b/src/gw_backend.c
@@ -1,3 +1,9 @@
+/*
+ * gw_backend - gateway backend code shared by dynamic socket backends
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "gw_backend.h"
diff --git a/src/http_auth.c b/src/http_auth.c
index a4767bd3..176a50f5 100644
--- a/src/http_auth.c
+++ b/src/http_auth.c
@@ -1,3 +1,10 @@
+/*
+ * http_auth - HTTP Auth backend registration, low-level shared funcs
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2016 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "http_auth.h"
diff --git a/src/http_chunk.c b/src/http_chunk.c
index 89b18e6a..6f24d558 100644
--- a/src/http_chunk.c
+++ b/src/http_chunk.c
@@ -1,10 +1,11 @@
-#include "first.h"
-
-/**
- * the HTTP chunk-API
- *
+/*
+ * http_chunk - append response to chunkqueue, possibly in "chunked" encoding
  *
+ * Fully-rewritten from original
+ * Copyright(c) 2019 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
  */
+#include "first.h"
 
 #include "http_chunk.h"
 #include "base.h"
diff --git a/src/http_header.c b/src/http_header.c
index 897a0fd3..a4f5a573 100644
--- a/src/http_header.c
+++ b/src/http_header.c
@@ -1,3 +1,9 @@
+/*
+ * http_header - HTTP header manipulation interfaces
+ *
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "http_header.h"
diff --git a/src/http_kv.c b/src/http_kv.c
index 5c4e89a2..35c8e860 100644
--- a/src/http_kv.c
+++ b/src/http_kv.c
@@ -1,3 +1,10 @@
+/*
+ * http_kv - HTTP version, method, status key-value string mapping
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "http_kv.h"
diff --git a/src/http_vhostdb.c b/src/http_vhostdb.c
index db8871ce..6328ac6e 100644
--- a/src/http_vhostdb.c
+++ b/src/http_vhostdb.c
@@ -1,3 +1,9 @@
+/*
+ * http_vhostdb - virtual hosts mapping backend registration
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "http_vhostdb.h"
diff --git a/src/keyvalue.c b/src/keyvalue.c
index 7b647b5c..2adde419 100644
--- a/src/keyvalue.c
+++ b/src/keyvalue.c
@@ -1,3 +1,10 @@
+/*
+ * keyvalue - PCRE matching and substitution for mod_redirect and mod_rewrite
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "keyvalue.h"
diff --git a/src/mod_authn_ldap.c b/src/mod_authn_ldap.c
index 6c452490..b4d482b7 100644
--- a/src/mod_authn_ldap.c
+++ b/src/mod_authn_ldap.c
@@ -1,3 +1,10 @@
+/*
+ * mod_authn_ldap - HTTP Auth LDAP backend
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2016 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <ldap.h>
diff --git a/src/mod_authn_pam.c b/src/mod_authn_pam.c
index 23594525..a803d1f5 100644
--- a/src/mod_authn_pam.c
+++ b/src/mod_authn_pam.c
@@ -1,3 +1,9 @@
+/*
+ * mod_authn_pam - PAM backend for lighttpd HTTP auth
+ *
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 /* mod_authn_pam
diff --git a/src/mod_authn_sasl.c b/src/mod_authn_sasl.c
index 90fc4c13..7b1f6336 100644
--- a/src/mod_authn_sasl.c
+++ b/src/mod_authn_sasl.c
@@ -1,3 +1,9 @@
+/*
+ * mod_authn_sasl - SASL backend for lighttpd HTTP auth
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 /* mod_authn_sasl
diff --git a/src/mod_extforward.c b/src/mod_extforward.c
index 84d54e1f..30fe61e5 100644
--- a/src/mod_extforward.c
+++ b/src/mod_extforward.c
@@ -21,6 +21,12 @@
  *                  extended, modified by Lionel Elie Mamane (LEM), lionel <at> mamane <dot> lu
  *                  support chained proxies by glen@delfi.ee, #1528
  *
+ *
+ * Mostly rewritten
+ * Portions:
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ *
  * Config example:
  *
  *       Trust proxy 10.0.0.232 and 10.0.0.232
diff --git a/src/mod_geoip.c b/src/mod_geoip.c
index f72896d8..a66c57ef 100644
--- a/src/mod_geoip.c
+++ b/src/mod_geoip.c
@@ -52,6 +52,11 @@
  *
  * Note:
  * 	GeoIP Library and API must be installed!
+ *
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2016 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
  */
 
 
diff --git a/src/mod_maxminddb.c b/src/mod_maxminddb.c
index 5fb8c4ca..2102a310 100644
--- a/src/mod_maxminddb.c
+++ b/src/mod_maxminddb.c
@@ -1,3 +1,9 @@
+/*
+ * mod_maxminddb - MaxMind GeoIP2 support for lighttpd
+ *
+ * Copyright(c) 2019 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 /**
  *
  * Name:
diff --git a/src/mod_openssl.c b/src/mod_openssl.c
index 62febfad..b6970623 100644
--- a/src/mod_openssl.c
+++ b/src/mod_openssl.c
@@ -1,5 +1,9 @@
 /*
  * mod_openssl - openssl support for lighttpd
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2016 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
  */
 /*
  * future possible enhancements: OCSP stapling
diff --git a/src/mod_sockproxy.c b/src/mod_sockproxy.c
index 90e3219b..c0056c90 100644
--- a/src/mod_sockproxy.c
+++ b/src/mod_sockproxy.c
@@ -1,3 +1,9 @@
+/*
+ * mod_sockproxy - socket-level proxy support for lighttpd
+ *
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <stdlib.h>
diff --git a/src/mod_vhostdb.c b/src/mod_vhostdb.c
index 428c5abd..7ebefe55 100644
--- a/src/mod_vhostdb.c
+++ b/src/mod_vhostdb.c
@@ -1,3 +1,9 @@
+/*
+ * mod_vhostdb - virtual hosts mapping from backend database
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "base.h"
diff --git a/src/mod_vhostdb_dbi.c b/src/mod_vhostdb_dbi.c
index 14414199..200275dc 100644
--- a/src/mod_vhostdb_dbi.c
+++ b/src/mod_vhostdb_dbi.c
@@ -1,3 +1,9 @@
+/*
+ * mod_vhostdb_dbi - virtual hosts mapping from backend DBI interface
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <dbi/dbi.h>
diff --git a/src/mod_vhostdb_ldap.c b/src/mod_vhostdb_ldap.c
index db87bd48..b33d3374 100644
--- a/src/mod_vhostdb_ldap.c
+++ b/src/mod_vhostdb_ldap.c
@@ -1,3 +1,9 @@
+/*
+ * mod_vhostdb_ldap - virtual hosts mapping from backend LDAP database
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <ldap.h>
diff --git a/src/mod_vhostdb_mysql.c b/src/mod_vhostdb_mysql.c
index c63dbf00..989616cf 100644
--- a/src/mod_vhostdb_mysql.c
+++ b/src/mod_vhostdb_mysql.c
@@ -1,3 +1,9 @@
+/*
+ * mod_vhostdb_mysql - virtual hosts mapping from backend MySQL/MariaDB database
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <mysql.h>
@@ -12,7 +18,7 @@
 #include "plugin.h"
 
 /*
- * virtual host plugin using MySQL for domain to directory lookups
+ * virtual host plugin using MySQL/MariaDB for domain to directory lookups
  */
 
 typedef struct {
diff --git a/src/mod_vhostdb_pgsql.c b/src/mod_vhostdb_pgsql.c
index 1c87145f..73b0a8af 100644
--- a/src/mod_vhostdb_pgsql.c
+++ b/src/mod_vhostdb_pgsql.c
@@ -1,3 +1,9 @@
+/*
+ * mod_vhostdb_pgsql - virtual hosts mapping from backend PostgreSQL database
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include <libpq-fe.h>
@@ -11,7 +17,7 @@
 #include "plugin.h"
 
 /*
- * virtual host plugin using Postgres for domain to directory lookups
+ * virtual host plugin using PostgreSQL for domain to directory lookups
  */
 
 typedef struct {
diff --git a/src/mod_webdav.c b/src/mod_webdav.c
index 2f24a92b..e8bbbd64 100644
--- a/src/mod_webdav.c
+++ b/src/mod_webdav.c
@@ -1,5 +1,9 @@
 /*
- * mod_webdav
+ * mod_webdav - WEBDAV support for lighttpd
+ *
+ * Fully-rewritten from original
+ * Copyright(c) 2019 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
  */
 
 /*
diff --git a/src/rand.c b/src/rand.c
index 6cf2da6a..d8941be8 100644
--- a/src/rand.c
+++ b/src/rand.c
@@ -1,3 +1,9 @@
+/*
+ * rand - generate random bytes
+ *
+ * Copyright(c) 2016 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "rand.h"
diff --git a/src/request.c b/src/request.c
index 847b0c28..67a2ba5f 100644
--- a/src/request.c
+++ b/src/request.c
@@ -1,3 +1,10 @@
+/*
+ * request - HTTP request processing
+ *
+ * Fully-rewritten from original EXCEPT for request_check_hostname()
+ * Copyright(c) 2018 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "request.h"
diff --git a/src/sock_addr.c b/src/sock_addr.c
index 64582374..405e6b89 100644
--- a/src/sock_addr.c
+++ b/src/sock_addr.c
@@ -1,3 +1,9 @@
+/*
+ * sock_addr - sockaddr manipulation
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
+ */
 #include "first.h"
 
 #include "sock_addr.h"
diff --git a/tests/scgi-responder.c b/tests/scgi-responder.c
index 0c4244b7..969c616b 100644
--- a/tests/scgi-responder.c
+++ b/tests/scgi-responder.c
@@ -6,6 +6,9 @@
  * - expect recv data for request headers netstring every 10ms or less
  * - no read timeouts for request body; might block reading request body
  * - no write timeouts; might block writing response
+ *
+ * Copyright(c) 2017 Glenn Strauss gstrauss()gluelogic.com  All rights reserved
+ * License: BSD 3-clause (same as lighttpd)
  */
 
 #include <sys/types.h>