Minor documentation updates.

diff --git a/src/connection.c b/src/connection.c
index f608339f8014ba0427f515c36a14f1d29a51e894..e053df2ee23e187a9399acc39c4cc403149c01a8 100644 (file)
--- a/src/connection.c
+++ b/src/connection.c
@@ -85,7 +85,7 @@ void handle_connection(int client_socket) {
     char host[MAX_REQUEST_LINE];
     char port[5 + 1];
 
-    int version_minor; /* HTTP/1.x */
+    int version_minor; /* x in HTTP/1.x */
     int result;
 
     /* client_x509_cred is used when talking to the client (acting as a TSL
@@ -122,11 +122,9 @@ void handle_connection(int client_socket) {
     /* Read request line (CONNECT ..) and headers (they are discarded). */
     result = read_http_request(client_fd, buffer, sizeof(buffer));
     if (result == -1) {
-        /* Read error. */
         LOG(LOG_WARNING, "read_http_request(): client read error");
         goto out;
     } else if (result == -2) {
-        /* EOF */
         LOG(LOG_WARNING, "read_http_request(): client EOF");
         send_bad_request(client_fd);
         goto out;
@@ -170,12 +168,10 @@ void handle_connection(int client_socket) {
         /* Read response line from proxy server. */
         result = read_http_request(server_fd, buffer, sizeof(buffer));
         if (result == -1) {
-            /* Read error. */
             LOG(LOG_WARNING, "read_http_request(): proxy read error");
             send_forwarding_failure(client_fd);
             goto out;
         } else if (result == -2) {
-            /* EOF */
             LOG(LOG_WARNING, "read_http_request(): proxy EOF");
             send_forwarding_failure(client_fd);
             goto out;
@@ -247,7 +243,7 @@ void handle_connection(int client_socket) {
     /* Make sure the server certificate is valid and known. */
     if (verify_tls_connection(server_session, host) != 0) {
         LOG(LOG_ERROR, "server certificate validation failed!");
-        /* We send the error message over our TLS connection to the client,
+        /* We'll send the error message over our TLS connection to the client,
          * but with an invalid certificate. No data is transfered from/to the
          * target server. */
         validation_failed = 1;
@@ -504,7 +500,7 @@ static int read_http_request(FILE *client_fd, char *request, size_t length) {
             LOG_PERROR(LOG_WARNING, "read_http_request(): fgets()");
             return -1;
         }
-
+        /* EOF */
         return -2;
     }
 
@@ -584,7 +580,7 @@ static void transfer_data(int client, int server) {
     fds[1].revents = 0;
 
     for (;;) {
-        int result = poll(fds, 2, -1 /* no timeout */);
+        int result = poll(fds, 2 /* fd count */, -1 /* no timeout */);
         if (result < 0) {
             LOG_PERROR(LOG_ERROR, "transfer_data(): poll()");
             return;
@@ -673,7 +669,7 @@ static void transfer_data_tls(int client, int server,
                    (long int)buffer_size);
 
     for (;;) {
-        int result = poll(fds, 2, -1 /* no timeout */);
+        int result = poll(fds, 2 /* fd count */, -1 /* no timeout */);
         if (result < 0) {
             LOG_PERROR(LOG_ERROR, "transfer_data(): poll()");
             return;

diff --git a/src/tlsproxy.c b/src/tlsproxy.c
index 401553f52e4d922846c4c9da664f9cf3bd67c416..77c6d0293228735f370dc1fdb898ffd62a738aec 100644 (file)
--- a/src/tlsproxy.c
+++ b/src/tlsproxy.c
@@ -31,9 +31,8 @@
 #include <sys/types.h>
 #include <unistd.h>
 
-/* For GnuTLS. */
+/* Necessary for GnuTLS when used with threads. */
 #include <gcrypt.h>
-
 GCRY_THREAD_OPTION_PTHREAD_IMPL;
 
 

diff --git a/src/tlsproxy.h b/src/tlsproxy.h
index f23167e6e2e143f3c7298d4cd4741826a48d9f48..23740a79b480a6665ab88bf2802ec6e7fb953677 100644 (file)
--- a/src/tlsproxy.h
+++ b/src/tlsproxy.h
@@ -26,7 +26,6 @@
 #include <stdio.h>
 #include <string.h>
 
-/* GnuTLS */
 #include <gnutls/gnutls.h>
 
 #include "log.h"

diff --git a/tests/client.c b/tests/client.c
index d4edf7f8ba6f911fe674c1d1a697e21eb8bb908b..9bb23f392ab2831a896dc859d5fc76b9d05c6acc 100644 (file)
--- a/tests/client.c
+++ b/tests/client.c
@@ -231,7 +231,7 @@ static int read_http_request(FILE *client_fd, char *request, size_t length) {
             perror("read_http_request(): fgets()");
             return -1;
         }
-
+        /* EOF */
         return -2;
     }