From owner-freebsd-doc  Sun Aug 20 18:50: 8 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 715C737B424
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 18:50:04 -0700 (PDT)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id SAA68092;
	Sun, 20 Aug 2000 18:50:04 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id ABCA837B422; Sun, 20 Aug 2000 18:49:46 -0700 (PDT)
Message-Id: <20000821014946.ABCA837B422@hub.freebsd.org>
Date: Sun, 20 Aug 2000 18:49:46 -0700 (PDT)
From: freedom@csie.nctu.edu.tw
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/20738: correction and modification to clocks(7)
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20738
>Category:       docs
>Synopsis:       correction and modification to clocks(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 20 18:50:04 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Tan Koan-Sin
>Release:        5-current
>Organization:
NCTU, Taiwan
>Environment:
FreeBSD dhcp235-1.csie.nctu.edu.tw 5.0-CURRENT FreeBSD 5.0-CURRENT #49: Thu Aug 17 00:15:08 CST 2000     freedom@ThinkPad:/usr/src/sys/compile/ThinkPad  i386 mc146818A is writtend as mc14618a. That should be corrected.
        And some description are added to i8254 and TSC.

>Description:
mc146818A is writtend as mc14618a. That should be corrected.
And some description are added to i8254 and TSC.

>How-To-Repeat:

>Fix:
*** clocks.7.old        Sun Jul 30 10:53:34 2000
--- clocks.7    Mon Aug 21 06:32:11 2000
***************
*** 102,108 ****
  .Xr sysctl 3
  or by reading it from the header in the profiling data file.
  .It
! The mc14618a clock.  This is a real clock with a nominal frequency of
  32768.  It is divided down to give the statistic clock and the profiling
  clock.  It isn't available to applications.
  .It
--- 102,108 ----
  .Xr sysctl 3
  or by reading it from the header in the profiling data file.
  .It
! The mc146818A clock.  This is a real clock with a nominal frequency of
  32768.  It is divided down to give the statistic clock and the profiling
  clock.  It isn't available to applications.
  .It
***************
*** 113,132 ****
  .Xr gettimeofday 2 ,
  .Xr select 2 ,
  .Xr getitimer 2 ,
! etc...  This is the clock that should normally be used
! by BSD applications.
  .It
  The i8254 clock.  This is a real clock/timer with a nominal frequency of
! 1193182.  It is divided down to give the scheduling clock.  It isn't
! available to applications.
  .It
  The TSC clock (64-bit register) on fifth-generation or later x86 systems.
  This is a real clock with a frequency that is equivalent to the number of
  cycles per second of the CPU(s).
! Its frequency can be found using the sysctl
! .Sy machdep.tsc_freq .
  It is used to interpolate between values of the scheduling clock.
! It is only available to applications in a purely machine-dependant manner.
  .El
  .Pp
  Summary: if
--- 113,136 ----
  .Xr gettimeofday 2 ,
  .Xr select 2 ,! etc...  It could be implemented by the i8254 clock or the TSC clock. 
! This is the clock that should normally be used by BSD applications.
  .It
  The i8254 clock.  This is a real clock/timer with a nominal frequency of
! 1193182.  It has three independent time counters to be used. It 
! is divided down to give the scheduling clock.  It isn't available 
! to applications.
  .It
  The TSC clock (64-bit register) on fifth-generation or later x86 systems.
  This is a real clock with a frequency that is equivalent to the number of
  cycles per second of the CPU(s).
! Its frequency can be found using the sysctl 
! .Sy machdep.tsc_freq ,
! if it is available.
  It is used to interpolate between values of the scheduling clock.
! It could be accessed via PMIOTSTAMP request of 
! .Xr perfmon 4 .
! 
  .El
  .Pp
  Summary: if
***************
*** 140,146 ****  .Xr select 2 ,
  .Xr clock 3 ,
  .Xr moncontrol 3 ,
! .Xr times 3
  .Sh AUTHORS
  This man page has been written by
  .ie t J\(:org Wunsch
--- 144,151 ----
  .Xr select 2 ,
  .Xr clock 3 ,
  .Xr moncontrol 3 ,
! .Xr times 3 ,
! .Xr perfmon 4
  .Sh AUTHORS
  This man page has been written by
  .ie t J\(:org Wunsch


  .Xr getitimer 2 ,


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message