History log of /openbsd-current/lib/libc/gen/times.3
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.16 11-Sep-2022 jmc

.Li -> .Vt where appropriate;
from josiah frentsos, tweaked by schwarze

ok schwarze


Revision tags: OPENBSD_6_3_BASE OPENBSD_6_4_BASE OPENBSD_6_5_BASE OPENBSD_6_6_BASE OPENBSD_6_7_BASE OPENBSD_6_8_BASE OPENBSD_6_9_BASE OPENBSD_7_0_BASE OPENBSD_7_1_BASE
# 1.15 02-Mar-2018 cheloha

Return monotonically increasing values.

The latest POSIX description of times(3) (and all others I can find)
suggests that times(3) should return monotonically increasing values
and that these values are only useful for real time interval measurement.
All extant uses of times(3) confirm that this expectation is shared by
application programmers.

So, change gettimeofday(2) to clock_gettime(2)/CLOCK_MONOTONIC to ensure
the return value increases monotonically, even if the system clock is
changed by the superuser. Then update the manpage accordingly.

While we're updating the manpage, move the information about the return
values to a new RETURN VALUES section to bring times.3 up to speed with
other library man pages.

Manpage changes kicked around on tech@ with millert@ and jmc@.

times.3 ok millert@ tb@ jmc@
times.c ok millert@ tb@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.14 17-Jul-2013 schwarze

more library history
facts checked by sobrado@
style tweaks and ok jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.12 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.11 22-Jul-2005 jaredy

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.10 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.9 22-May-2002 vincent

put a real struct definition instead of the weird "typedef struct
{};" thing

ok millert


Revision tags: OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE
# 1.8 24-Dec-2000 aaron

Various repairs, mostly to get rid of short lines.


Revision tags: OPENBSD_2_6_BASE OPENBSD_2_7_BASE OPENBSD_2_8_BASE
# 1.7 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.6 05-Jun-1999 aaron

change some .Em/.Va to .Li, looks nicer


# 1.5 29-May-1999 aaron

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL


# 1.4 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.3 28-Apr-1998 deraadt

use Xr more often


Revision tags: OPENBSD_2_0_BASE OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.15 02-Mar-2018 cheloha

Return monotonically increasing values.

The latest POSIX description of times(3) (and all others I can find)
suggests that times(3) should return monotonically increasing values
and that these values are only useful for real time interval measurement.
All extant uses of times(3) confirm that this expectation is shared by
application programmers.

So, change gettimeofday(2) to clock_gettime(2)/CLOCK_MONOTONIC to ensure
the return value increases monotonically, even if the system clock is
changed by the superuser. Then update the manpage accordingly.

While we're updating the manpage, move the information about the return
values to a new RETURN VALUES section to bring times.3 up to speed with
other library man pages.

Manpage changes kicked around on tech@ with millert@ and jmc@.

times.3 ok millert@ tb@ jmc@
times.c ok millert@ tb@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.14 17-Jul-2013 schwarze

more library history
facts checked by sobrado@
style tweaks and ok jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.12 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.11 22-Jul-2005 jaredy

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.10 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.9 22-May-2002 vincent

put a real struct definition instead of the weird "typedef struct
{};" thing

ok millert


Revision tags: OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE
# 1.8 24-Dec-2000 aaron

Various repairs, mostly to get rid of short lines.


Revision tags: OPENBSD_2_6_BASE OPENBSD_2_7_BASE OPENBSD_2_8_BASE
# 1.7 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.6 05-Jun-1999 aaron

change some .Em/.Va to .Li, looks nicer


# 1.5 29-May-1999 aaron

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL


# 1.4 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.3 28-Apr-1998 deraadt

use Xr more often


Revision tags: OPENBSD_2_0_BASE OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.14 17-Jul-2013 schwarze

more library history
facts checked by sobrado@
style tweaks and ok jmc@


# 1.13 05-Jun-2013 tedu

Use the fancy .In macro for includes. From Jan Klemkow. ok jmc schwarze


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.12 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.11 22-Jul-2005 jaredy

- sync prototypes and header file excerpts to reality
- many grammar, punctuation, macro, layout, spelling/typos,
rewording, etc. fixes
- avoid first person
- sprinkle crossrefs where relevant

help & ok jmc


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.10 02-Jun-2003 millert

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.


Revision tags: OPENBSD_3_2_BASE OPENBSD_3_3_BASE
# 1.9 22-May-2002 vincent

put a real struct definition instead of the weird "typedef struct
{};" thing

ok millert


Revision tags: OPENBSD_2_9_BASE OPENBSD_3_0_BASE OPENBSD_3_1_BASE
# 1.8 24-Dec-2000 aaron

Various repairs, mostly to get rid of short lines.


Revision tags: OPENBSD_2_6_BASE OPENBSD_2_7_BASE OPENBSD_2_8_BASE
# 1.7 09-Jul-1999 aaron

- remove all trailing whitespace
* except when it is escaped with a `\' at the end of the line
- fix remaining .Nm usage as well
- this is from a patch I received from kwesterback@home.com, who has been
working on some scripts for fixing formatting errors in mdoc'd man pages

Ok, so there could be a cost/benefit debate with this commit, but since I have
the patch we might as well commit it...


# 1.6 05-Jun-1999 aaron

change some .Em/.Va to .Li, looks nicer


# 1.5 29-May-1999 aaron

repairs; go back over some old files, because we should properly distinguish
between NUL and NULL, i.e., don't use the .Dv (defined variable) macro when
referring to an ASCII NUL


# 1.4 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_4_BASE OPENBSD_2_5_BASE
# 1.3 28-Apr-1998 deraadt

use Xr more often


Revision tags: OPENBSD_2_0_BASE OPENBSD_2_1_BASE OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.2 19-Aug-1996 tholo

Fix RCS ids
Make sure everything uses {SYS,}LIBC_SCCS properly


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision