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, 2 insertions, 3 deletions

diff --git a/share/man/man9/hardclock.9 b/share/man/man9/hardclock.9
index bf4a0fd0b79..a53388f4a45 100644
--- a/share/man/man9/hardclock.9
+++ b/share/man/man9/hardclock.9
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: hardclock.9,v 1.12 2016/09/27 17:06:24 schwarze Exp $
+.\"	$OpenBSD: hardclock.9,v 1.13 2020/06/26 18:48:31 cheloha Exp $
 .\"
 .\" Copyright (c) 2001 Kenneth R Westerback
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 27 2016 $
+.Dd $Mdocdate: June 26 2020 $
 .Dt HARDCLOCK 9
 .Os
 .Sh NAME
@@ -74,5 +74,4 @@ is implemented in the file
 .Xr hz 9 ,
 .Xr microtime 9 ,
 .Xr spl 9 ,
-.Xr time_second 9 ,
 .Xr timeout 9