added basic ssl support to ircu

[ircu2.10.12-pk.git] / ircd / opercmds.c

diff --git a/ircd/opercmds.c b/ircd/opercmds.c
index 0cc35a428b4530af50f8931f8695b9422167db8c..f208f94d3eeb8f32d128340066e422915a6f2ed4 100644 (file)
--- a/ircd/opercmds.c
+++ b/ircd/opercmds.c
@@ -19,8 +19,10 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- *
- * $Id$
+ */
+/** @file
+ * @brief Implementation of AsLL ping helper commands.
+ * @version $Id$
  */
 #include "config.h"
 
@@ -45,6 +47,21 @@
 #include <string.h>
 #include <sys/time.h>
 
+/** Calculate current time or elapsed time.
+ *
+ * If neither \a sec nor \a usec are NULL, calculate milliseconds
+ * elapsed since that time, and return a string containing that
+ * number.
+ *
+ * If either \a sec or \a usec are NULL, format a timestamp containing
+ * Unix timestamp and microseconds since that second (separated by
+ * spaces), and return a string containing that timestamp.
+ *
+ * @todo This should be made into two functions.
+ * @param[in] sec Either NULL or a Unix timestamp in seconds.
+ * @param[in] usec Either NULL or an offset to \a sec in microseconds.
+ * @return A static buffer with contents as described above.
+ */
 char *militime(char* sec, char* usec)
 {
   struct timeval tv;
@@ -59,6 +76,24 @@ char *militime(char* sec, char* usec)
   return timebuf;
 }
 
+/** Calculate current time or elapsed time.
+ *
+ * If \a start is NULL, create a timestamp containing Unix timestamp
+ * and microseconds since that second (separated by a period), and
+ * return a string containing that timestamp.
+ *
+ * Otherwise, if \a start does not contain a period, return a string
+ * equal to "0".
+ *
+ * Otherwise, calculate milliseconds elapsed since the Unix time
+ * described in \a start (in the format described above), and return a
+ * string containing that number.
+ *
+ * @todo This should be made into two functions.
+ * @param[in] start Either NULL or a Unix timestamp in
+ * pseudo-floating-point format.
+ * @return A static buffer with contents as described above.
+ */
 char *militime_float(char* start)
 {
   struct timeval tv;
@@ -74,7 +109,7 @@ char *militime_float(char* start)
       sprintf(timebuf, "%ld",
           (tv.tv_sec - atoi(start)) * 1000 + (tv.tv_usec - atoi(p)) / 1000);
     }
-    else 
+    else
       strcpy(timebuf, "0");
   }
   else