Context Navigation

-              r102a729
+              r4cf8ca6
  * @{
  */
 /** @file
+/** @file Time measurement support.
  */
 …
 #define SECS_PER_DAY (SECS_PER_HOUR * HOURS_PER_DAY)
+/**
+ *
+ * @param year
+ * @return
+ */
 static bool _is_leap_year(time_t year)
+{
 …
+}
+/**
+ *
+ * @param year
+ * @param mon
+ * @return
+ */
 static int _days_in_month(time_t year, time_t mon)
+{
 …
+}
+/**
+ *
+ * @param year
+ * @param mon
+ * @param mday
+ * @return
+ */
 static int _day_of_year(time_t year, time_t mon, time_t mday)
+{
 …
+}
+/* Integer division that rounds to negative infinity.
+/**
+ * Integer division that rounds to negative infinity.
+ *
+ * @param op1
+ * @param op2
+ * @return
  */
 static time_t _floor_div(time_t op1, time_t op2)
 …
+}
+/* Modulo that rounds to negative infinity.
+/**
+ * Modulo that rounds to negative infinity.
+ *
+ * @param op1
+ * @param op2
+ * @return
  */
 static time_t _floor_mod(time_t op1, time_t op2)
 …
+}
+/**
+ *
+ * @param year
+ * @param mon
+ * @param mday
+ * @return
+ */
 static time_t _days_since_epoch(time_t year, time_t mon, time_t mday)
+{
 …
+}
+/* Assumes normalized broken-down time. */
+/**
+ * Assumes normalized broken-down time.
+ *
+ * @param tm
+ * @return
+ */
 static time_t _secs_since_epoch(const struct posix_tm *tm)
+{
 …
+}
+/**
+ *
+ * @param year
+ * @param mon
+ * @param mday
+ * @return
+ */
 static int _day_of_week(time_t year, time_t mon, time_t mday)
+{
 …
 };
+/**
+ *
+ * @param ltm
+ * @param ptm
+ */
 static void _posix_to_long_tm(struct _long_tm *ltm, struct posix_tm *ptm)
+{
 …
+}
+/**
+ *
+ * @param ptm
+ * @param ltm
+ */
 static void _long_to_posix_tm(struct posix_tm *ptm, struct _long_tm *ltm)
+{
 …
+}
+/**
+ *
+ * @param tm
+ */
 static void _normalize_time(struct _long_tm *tm)
+{
 …
+}
+/* Which day the week-based year starts on relative to the first calendar day.
+/**
+ * Which day the week-based year starts on relative to the first calendar day.
  * E.g. if the year starts on December 31st, the return value is -1.
+ *
+ * @param year
+ * @return
  */
 static int _wbyear_offset(int year)
 …
+}
+/* Returns week-based year of the specified time.
+/**
+ * Returns week-based year of the specified time.
  * Assumes normalized broken-down time.
+ *
+ * @param tm
+ * @return
  */
 static int _wbyear(const struct posix_tm *tm)
 …
+}
+/** Week number of the year, assuming weeks start on sunday.
+ *  The first Sunday of January is the first day of week 1;
+ *  days in the new year before this are in week 0.
+/**
+ * Week number of the year, assuming weeks start on sunday.
+ * The first Sunday of January is the first day of week 1;
+ * days in the new year before this are in week 0.
+ *
  * @param tm Normalized broken-down time.
 …
+}
+/** Week number of the year, assuming weeks start on monday.
+ *  If the week containing January 1st has four or more days in the new year,
+ *  then it is considered week 1. Otherwise, it is the last week of the previous
+ *  year, and the next week is week 1. Both January 4th and the first Thursday
+ *  of January are always in week 1.
+/**
+ * Week number of the year, assuming weeks start on monday.
+ * If the week containing January 1st has four or more days in the new year,
+ * then it is considered week 1. Otherwise, it is the last week of the previous
+ * year, and the next week is week 1. Both January 4th and the first Thursday
+ * of January are always in week 1.
+ *
  * @param tm Normalized broken-down time.
 …
+}
+/** Week number of the year, assuming weeks start on monday.
+ *  The first Monday of January is the first day of week 1;
+ *  days in the new year before this are in week 0.
+/**
+ * Week number of the year, assuming weeks start on monday.
+ * The first Monday of January is the first day of week 1;
+ * days in the new year before this are in week 0.
+ *
  * @param tm Normalized broken-down time.
 …
 char *posix_tzname[2];
+/**
+ *
+ */
 void posix_tzset(void)
+{
 …
+}
+/**
+ *
+ * @param time1
+ * @param time0
+ * @return
+ */
 double posix_difftime(time_t time1, time_t time0)
+{
 …
+}
+/** This function first normalizes the provided broken-down time
+ *  (moves all values to their proper bounds) and then tries to
+ *  calculate the appropriate time_t representation.
+ *
+ * @param timeptr Broken-down time.
+/**
+ * This function first normalizes the provided broken-down time
+ * (moves all values to their proper bounds) and then tries to
+ * calculate the appropriate time_t representation.
+ *
+ * @param tm Broken-down time.
  * @return time_t representation of the time, undefined value on overflow
  */
 …
+}
+/**
+ *
+ * @param timer
+ * @return
+ */
 struct posix_tm *posix_gmtime(const time_t *timer)
+{
 …
+}
+/**
+ *
+ * @param timer
+ * @param result
+ * @return
+ */
 struct posix_tm *posix_gmtime_r(const time_t *restrict timer,
     struct posix_tm *restrict result)
 …
 /**
+ *
  * @param timep
+ * @param timer
  * @return
  */
 …
+}
+/**
+ *
+ * @param timer
+ * @param result
+ * @return
+ */
 struct posix_tm *posix_localtime_r(const time_t *restrict timer,
     struct posix_tm *restrict result)
 …
 /**
+ *
  * @param tm
+ * @param timeptr
  * @return
  */
 …
+}
+/**
+ *
+ * @param timeptr
+ * @param buf
+ * @return
+ */
 char *posix_asctime_r(const struct posix_tm *restrict timeptr,
     char *restrict buf)
 …
 /**
+ *
  * @param timep
+ * @param timer
  * @return
  */
 …
+}
+/**
+ *
+ * @param timer
+ * @param buf
+ * @return
+ */
 char *posix_ctime_r(const time_t *timer, char *buf)
+{
 …
  * @return
  */
 size_t posix_strftime(char *s, size_t maxsize,
     const char *format, const struct posix_tm *tm)
+size_t posix_strftime(char *restrict s, size_t maxsize,
+    const char *restrict format, const struct posix_tm *restrict tm)
+{
         // TODO: use locale
 …
+}
+/**
+ *
+ * @param s
+ * @param maxsize
+ * @param format
+ * @param tm
+ * @param loc
+ * @return
+ */
+extern size_t posix_strftime_l(char *restrict s, size_t maxsize,
+    const char *restrict format, const struct posix_tm *restrict tm,
+    posix_locale_t loc)
+{
+        // TODO
+        not_implemented();
+}
+/**
+ *
+ * @param clock_id
+ * @param res
+ * @return
+ */
 int posix_clock_getres(posix_clockid_t clock_id, struct posix_timespec *res)
+{
 …
+}
+/**
+ *
+ * @param clock_id
+ * @param tp
+ * @return
+ */
 int posix_clock_gettime(posix_clockid_t clock_id, struct posix_timespec *tp)
+{
 …
+}
+/**
+ *
+ * @param clock_id
+ * @param tp
+ * @return
+ */
 int posix_clock_settime(posix_clockid_t clock_id,
     const struct posix_timespec *tp)
 …
+}
+/**
+ *
+ * @param clock_id
+ * @param flags
+ * @param rqtp
+ * @param rmtp
+ * @return
+ */
 int posix_clock_nanosleep(posix_clockid_t clock_id, int flags,
     const struct posix_timespec *rqtp, struct posix_timespec *rmtp)
 …
 };
+/**
+ *
+ * @param clockid
+ * @param evp
+ * @param timerid
+ * @return
+ */
 int posix_timer_create(posix_clockid_t clockid,
     struct posix_sigevent *restrict evp,
 …
+}
+/**
+ *
+ * @param timerid
+ * @return
+ */
 int posix_timer_delete(posix_timer_t timerid)
+{
 …
+}
+/**
+ *
+ * @param timerid
+ * @return
+ */
 int posix_timer_getoverrun(posix_timer_t timerid)
+{
 …
+}
+/**
+ *
+ * @param timerid
+ * @param value
+ * @return
+ */
 int posix_timer_gettime(posix_timer_t timerid,
     struct posix_itimerspec *value)
 …
+}
+/**
+ *
+ * @param timerid
+ * @param flags
+ * @param value
+ * @param ovalue
+ * @return
+ */
 int posix_timer_settime(posix_timer_t timerid, int flags,
     const struct posix_itimerspec *restrict value,

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 4cf8ca6 in mainline for uspace/lib/posix/time.c

Legend:

uspace/lib/posix/time.c

Download in other formats: