fpagliughi#97 Allow acceptors to choose the reuse option in the constructor

Author: fpagliughi

include/sockpp/acceptor.h

@@ -11,7 +11,7 @@
 // --------------------------------------------------------------------------
 // This file is part of the "sockpp" C++ socket library.
 //
-// Copyright (c) 2014-2023 Frank Pagliughi
+// Copyright (c) 2014-2024 Frank Pagliughi
 // All rights reserved.
 //
 // Redistribution and use in source and binary forms, with or without
@@ -108,7 +108,7 @@ class acceptor : public socket
      * address.
      * @param addr The address to which this server should be bound.
      * @param queSize The listener queue size.
-     * @param reuse A reuse option for the socket. This can be SO_REUSE_ADDR
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
      *              or SO_REUSEPORT, and is set before it tries to bind. A
      *              value of zero doesn;t set an option.
      * @throws std::system_error
@@ -127,6 +127,19 @@ class acceptor : public socket
     acceptor(const sock_address& addr, int queSize, error_code& ec) noexcept {
         ec = open(addr, queSize).error();
     }
+    /**
+     * Creates an acceptor socket and starts it listening to the specified
+     * address.
+     * @param addr The address to which this server should be bound.
+     * @param queSize The listener queue size.
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
+     *              or SO_REUSEPORT, and is set before it tries to bind. A
+     *              value of zero doesn;t set an option.
+     * @param ec The error code, on failure
+     */
+    acceptor(const sock_address& addr, int queSize, int reuse, error_code& ec) noexcept {
+        ec = open(addr, queSize, reuse).error();
+    }
     /**
      * Move constructor.
      * Creates an acceptor by moving the other acceptor to this one.
@@ -163,7 +176,7 @@ class acceptor : public socket
      * listening.
      * @param addr The address to which this server should be bound.
      * @param queSize The listener queue size.
-     * @param reuse A reuse option for the socket. This can be SO_REUSE_ADDR
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
      *              or SO_REUSEPORT, and is set before it tries to bind. A
      *              value of zero doesn;t set an option.
      * @return The error code on failure.
@@ -221,14 +234,26 @@ class acceptor_tmpl : public acceptor
             throw std::system_error{res.error()};
     }
     /**
-     * Creates a acceptor and starts it listening on the specified address.
+     * Creates an acceptor and starts it listening on the specified address.
      * @param addr The TCP address on which to listen.
      * @param queSize The listener queue size.
      * @param ec The error code, on failure
      */
     acceptor_tmpl(const addr_t& addr, int queSize, error_code& ec) noexcept {
         ec = open(addr, queSize).error();
     }
+    /**
+     * Creates a acceptor and starts it listening on the specified address.
+     * @param addr The TCP address on which to listen.
+     * @param queSize The listener queue size.
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
+     *              or SO_REUSEPORT, and is set before it tries to bind. A
+     *              value of zero doesn't set an option.
+     * @param ec The error code, on failure
+     */
+    acceptor_tmpl(const addr_t& addr, int queSize, int reuse, error_code& ec) noexcept {
+        ec = open(addr, queSize, reuse).error();
+    }
     /**
      * Creates a acceptor and starts it listening on the specified port.
      * The acceptor binds to the specified port for any address on the local
@@ -252,6 +277,20 @@ class acceptor_tmpl : public acceptor
     acceptor_tmpl(in_port_t port, int queSize, error_code& ec) noexcept {
         ec = open(port, queSize).error();
     }
+    /**
+     * Creates a acceptor and starts it listening on the specified port.
+     * The acceptor binds to the specified port for any address on the local
+     * host.
+     * @param port The TCP port on which to listen.
+     * @param queSize The listener queue size.
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
+     *              or SO_REUSEPORT, and is set before it tries to bind. A
+     *              value of zero doesn't set an option.
+     * @param ec The error code, on failure
+     */
+    acceptor_tmpl(in_port_t port, int queSize, int reuse, error_code& ec) noexcept {
+        ec = open(port, queSize, reuse).error();
+    }
     /**
      * Move constructor.
      * Creates an acceptor by moving the other acceptor to this one.
@@ -290,7 +329,7 @@ class acceptor_tmpl : public acceptor
      * listening.
      * @param addr The address to which this server should be bound.
      * @param queSize The listener queue size.
-     * @param reuse A reuse option for the socket. This can be SO_REUSE_ADDR
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
      *              or SO_REUSEPORT, and is set before it tries to bind. A
      *              value of zero doesn;t set an option.
      * @return @em true on success, @em false on error
@@ -303,7 +342,7 @@ class acceptor_tmpl : public acceptor
      * listening.
      * @param port The TCP port on which to listen.
      * @param queSize The listener queue size.
-     * @param reuse A reuse option for the socket. This can be SO_REUSE_ADDR
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
      *              or SO_REUSEPORT, and is set before it tries to bind. A
      *              value of zero doesn;t set an option.
      * @return @em true on success, @em false on error

include/sockpp/socket.h

@@ -384,7 +384,7 @@ class socket
     /**
      * Binds the socket to the specified address.
      * @param addr The address to which we get bound.
-     * @param reuse A reuse option for the socket. This can be SO_REUSE_ADDR
+     * @param reuse A reuse option for the socket. This can be SO_REUSEADDR
      *              or SO_REUSEPORT if supported on the platform, and is set
      *              before it tries to bind. A value of zero doesn't set any
      *              option on the socket.

include/sockpp/tls/context.h

@@ -167,15 +167,23 @@ class tls_context_builder
             ctx_.set_verify(tls_context::verify_t::PEER);
         return *this;
     }
-
+    /**
+     * Load the certificate chain from a file.
+     * @param certFile The certificate chain file.
+     * @return Error code on failure.
+     */
     auto cert_file(const string& certFile) -> self& {
         if (!ec_) {
             if (auto res = ctx_.set_cert_file(certFile); !res)
                 ec_ = res.error();
         }
         return *this;
     }
-
+    /**
+     * Set the private key from a file.
+     * @param keyFile The private key file.
+     * @return Error code on faliure.
+     */
     auto key_file(const string& keyFile) -> self& {
         if (!ec_) {
             if (auto res = ctx_.set_key_file(keyFile); !res)

include/sockpp/tls/openssl_context.h

@@ -174,7 +174,7 @@ class tls_context
      */
     result<> set_cert_file(const string& certFile);
     /**
-     * Set the private key file.
+     * Set the private key from a file.
      * @param keyFile The private key file.
      * @return Error code on faliure.
      */