timecounting: deprecate time_second(9), time_uptime(9)

time_second(9) has been replaced in the kernel by gettime(9).
time_uptime(9) has been replaced in the kernel by getuptime(9).

New code should use the replacement interfaces.  They do not suffer
from the split-read problem inherent to the time_* variables on 32-bit
platforms.

The variables remain in sys/kern/kern_tc.c for use via kvm(3) when
examining kernel core dumps.

This commit completes the deprecation process:

- Remove the extern'd definitions for time_second and time_uptime
  from sys/time.h.
- Replace manpage cross-references to time_second(9)/time_uptime(9)
  with references to microtime(9) or a related interface.
- Move the time_second.9 manpage to the attic.

With input from dlg@, kettenis@, visa@, and tedu@.

ok kettenis@

1 files changed, 4 insertions, 4 deletions

diff --git a/share/man/man4/man4.octeon/octrtc.4 b/share/man/man4/man4.octeon/octrtc.4
index b05d76b544d..191b4714463 100644
--- a/share/man/man4/man4.octeon/octrtc.4
+++ b/share/man/man4/man4.octeon/octrtc.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: octrtc.4,v 1.4 2020/04/06 00:01:08 pirofti Exp $
+.\"	$OpenBSD: octrtc.4,v 1.5 2020/06/26 18:48:31 cheloha Exp $
 .\"
 .\" Copyright (c) 2014 Paul Irofti <paul@irofti.net>
 .\"
@@ -15,7 +15,7 @@
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .\"
-.Dd $Mdocdate: April 6 2020 $
+.Dd $Mdocdate: June 26 2020 $
 .Dt OCTRTC 4 octeon
 .Os
 .Sh NAME
@@ -46,9 +46,9 @@ Known models missing a DS1377 clock:
 .El
 .Sh SEE ALSO
 .Xr intro 4 ,
+.Xr gettime 9 ,
 .Xr inittodr 9 ,
-.Xr resettodr 9 ,
-.Xr time_second 9
+.Xr resettodr 9
 .Sh HISTORY
 The
 .Nm