-
/*
- * $Id: SquidTime.h,v 1.2 2006/08/12 01:43:11 robertc Exp $
- *
- * DEBUG: section 21 Time Functions
- * AUTHOR: Harvest Derived
- *
- * SQUID Web Proxy Cache http://www.squid-cache.org/
- * ----------------------------------------------------------
- *
- * Squid is the result of efforts by numerous individuals from
- * the Internet community; see the CONTRIBUTORS file for full
- * details. Many organizations have provided support for Squid's
- * development; see the SPONSORS file for full details. Squid is
- * Copyrighted (C) 2001 by the Regents of the University of
- * California; see the COPYRIGHT file for full details. Squid
- * incorporates software developed and/or copyrighted by other
- * sources; see the CREDITS file for full details.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * 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., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
+ * Copyright (C) 1996-2020 The Squid Software Foundation and contributors
*
+ * Squid software is distributed under GPLv2+ license and includes
+ * contributions from numerous individuals and organizations.
+ * Please see the COPYING and CONTRIBUTORS files for details.
*/
+/* DEBUG: section 21 Time Functions */
+
#ifndef SQUID_TIME_H
#define SQUID_TIME_H
-#include "squid.h"
+#include "rfc1123.h"
-extern time_t squid_curtime; /* 0 */
+#include <ctime>
+/* NP: sys/time.h is provided by libcompat */
+
+/* Use uint64_t to store milliseconds */
+typedef uint64_t time_msec_t;
+
+/* globals for accessing time */
+extern struct timeval current_time;
+extern double current_dtime;
+extern time_t squid_curtime;
time_t getCurrentTime(void);
+int tvSubMsec(struct timeval, struct timeval);
+
+/// timeval substraction operation
+/// \param[out] res = t2 - t1
+void tvSub(struct timeval &res, struct timeval const &t1, struct timeval const &t2);
+
+/// timeval addition operation
+/// \param[out] res = t1 + t2
+void tvAdd(struct timeval &res, struct timeval const &t1, struct timeval const &t2);
+
+/// timeval addition assignment operation
+/// \param[out] t += add
+void tvAssignAdd(struct timeval &t, struct timeval const &add);
-/* event class for doing synthetic time etc */
+/// Convert timeval to milliseconds
+inline long int tvToMsec(struct timeval &t)
+{
+ return t.tv_sec * 1000 + t.tv_usec / 1000;
+}
+/** event class for doing synthetic time etc */
class TimeEngine
{
public:
virtual ~TimeEngine();
- /* tick the clock - update from the OS or other time source, */
+
+ /** tick the clock - update from the OS or other time source, */
virtual void tick();
};
+namespace Time
+{
+
+/** Display time as a formatted human-readable string.
+ * Time syntax is
+ * "YYYY/MM/DD hh:mm:ss"
+ *
+ * Output is only valid until next call to this function.
+ */
+const char *FormatStrf(time_t t);
+
+/** Display time as a formatted human-readable string.
+ * Time string syntax used is that of Apache httpd.
+ * "DD/MMM/YYYY:hh:mm:ss zzzz"
+ *
+ * Output is only valid until next call to this function.
+ */
+const char *FormatHttpd(time_t t);
+
+} // namespace Time
#endif /* SQUID_TIME_H */
+