base: Tag API methods in socket.hh
authorHoa Nguyen <hoanguyen@ucdavis.edu>
Fri, 21 Aug 2020 01:09:52 +0000 (18:09 -0700)
committerHoa Nguyen <hoanguyen@ucdavis.edu>
Tue, 8 Sep 2020 16:24:56 +0000 (16:24 +0000)
Change-Id: Ifdbe1d9367df602e45fa3d39c91de9e0f8f1d87e
Signed-off-by: Hoa Nguyen <hoanguyen@ucdavis.edu>
Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/33078
Reviewed-by: Jason Lowe-Power <power.jg@gmail.com>
Maintainer: Jason Lowe-Power <power.jg@gmail.com>
Tested-by: kokoro <noreply+kokoro@google.com>
src/base/socket.hh

index 74a379b087c6ff34a9e310cd8f02ffb9d13cd056..4b426746fa14648cdaa28c86b3a943d17e160b96 100644 (file)
 class ListenSocket
 {
   protected:
+    /**
+     * The following variables are only used by socket unit tests:
+     * listeningDisabled, anyListening, bindToLoopback.
+     */
     static bool listeningDisabled;
     static bool anyListening;
 
@@ -54,14 +58,20 @@ class ListenSocket
 
 
   public:
+    /**
+     * @ingroup api_socket
+     * @{
+     */
     ListenSocket();
     virtual ~ListenSocket();
 
     virtual int accept(bool nodelay = false);
+
     virtual bool listen(int port, bool reuse = true);
 
     int getfd() const { return fd; }
     bool islistening() const { return listening; }
+    /** @} */ // end of api_socket
 };
 
 #endif //__SOCKET_HH__