more doxygen doku.
[citadel.git] / webcit / locate_host.c
index 034fd05e9ef0c2bb4231a368cbcf265b81b64fb9..bf018214c7ad748b827307be693a5319e1c1d36d 100644 (file)
@@ -1,12 +1,19 @@
 /*
  * $Id$
- *
- * Examine a socket and determine the name/address of the originating host.
  */
-
+/**
+ * \defgroup Hostlookup Examine a socket and determine the name/address of the originating host.
+ */
+/*@{*/
 
 #include "webcit.h"
 
+/**
+ * \brief get a hostname 
+ * \todo buffersize?
+ * \param tbuf the returnbuffer
+ * \param client_socket the sock fd where the client is connected
+ */
 void locate_host(char *tbuf, int client_socket)
 {
        struct sockaddr_in cs;
@@ -32,3 +39,5 @@ void locate_host(char *tbuf, int client_socket)
        }
        safestrncpy(tbuf, ch->h_name, 64);
 }
+
+/*@}*/