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, 5 insertions, 1 deletions

diff --git a/sys/kern/kern_tc.c b/sys/kern/kern_tc.c
index 54d50b1a6f7..96bc4b952c8 100644
--- a/sys/kern/kern_tc.c
+++ b/sys/kern/kern_tc.c
@@ -1,4 +1,4 @@
-/*	$OpenBSD: kern_tc.c,v 1.58 2020/06/22 21:16:07 cheloha Exp $ */
+/*	$OpenBSD: kern_tc.c,v 1.59 2020/06/26 18:48:31 cheloha Exp $ */
 
 /*
  * Copyright (c) 2000 Poul-Henning Kamp <phk@FreeBSD.org>
@@ -113,6 +113,10 @@ static struct timehands *volatile timehands = &th0;		/* [w] */
 struct timecounter *timecounter = &dummy_timecounter;		/* [t] */
 static SLIST_HEAD(, timecounter) tc_list = SLIST_HEAD_INITIALIZER(tc_list);
 
+/*
+ * These are updated from tc_windup().  They are useful when
+ * examining kernel core dumps.
+ */
 volatile time_t time_second = 1;
 volatile time_t time_uptime = 0;