1994-09-18 20:40:01 +00:00
|
|
|
/******************************************************************************
|
|
|
|
* *
|
|
|
|
* Copyright (c) David L. Mills 1993, 1994 *
|
|
|
|
* *
|
|
|
|
* Permission to use, copy, modify, and distribute this software and its *
|
|
|
|
* documentation for any purpose and without fee is hereby granted, provided *
|
|
|
|
* that the above copyright notice appears in all copies and that both the *
|
|
|
|
* copyright notice and this permission notice appear in supporting *
|
|
|
|
* documentation, and that the name University of Delaware not be used in *
|
|
|
|
* advertising or publicity pertaining to distribution of the software *
|
|
|
|
* without specific, written prior permission. The University of Delaware *
|
|
|
|
* makes no representations about the suitability this software for any *
|
|
|
|
* purpose. It is provided "as is" without express or implied warranty. *
|
|
|
|
* *
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Modification history kern_ntptime.c
|
|
|
|
*
|
1996-12-30 18:26:28 +00:00
|
|
|
* 24 Sep 94 David L. Mills
|
|
|
|
* Tightened code at exits.
|
|
|
|
*
|
1994-09-18 20:40:01 +00:00
|
|
|
* 24 Mar 94 David L. Mills
|
|
|
|
* Revised syscall interface to include new variables for PPS
|
|
|
|
* time discipline.
|
|
|
|
*
|
|
|
|
* 14 Feb 94 David L. Mills
|
|
|
|
* Added code for external clock
|
|
|
|
*
|
|
|
|
* 28 Nov 93 David L. Mills
|
|
|
|
* Revised frequency scaling to conform with adjusted parameters
|
|
|
|
*
|
|
|
|
* 17 Sep 93 David L. Mills
|
|
|
|
* Created file
|
|
|
|
*/
|
|
|
|
/*
|
|
|
|
* ntp_gettime(), ntp_adjtime() - precision time interface for SunOS
|
1996-12-30 18:26:28 +00:00
|
|
|
* V4.1.1 and V4.1.3
|
1994-09-18 20:40:01 +00:00
|
|
|
*
|
|
|
|
* These routines consitute the Network Time Protocol (NTP) interfaces
|
|
|
|
* for user and daemon application programs. The ntp_gettime() routine
|
|
|
|
* provides the time, maximum error (synch distance) and estimated error
|
|
|
|
* (dispersion) to client user application programs. The ntp_adjtime()
|
|
|
|
* routine is used by the NTP daemon to adjust the system clock to an
|
|
|
|
* externally derived time. The time offset and related variables set by
|
|
|
|
* this routine are used by hardclock() to adjust the phase and
|
|
|
|
* frequency of the phase-lock loop which controls the system clock.
|
|
|
|
*/
|
|
|
|
#include <sys/param.h>
|
|
|
|
#include <sys/systm.h>
|
1995-11-12 06:43:28 +00:00
|
|
|
#include <sys/sysproto.h>
|
1994-09-18 20:40:01 +00:00
|
|
|
#include <sys/kernel.h>
|
|
|
|
#include <sys/proc.h>
|
|
|
|
#include <sys/timex.h>
|
|
|
|
#include <sys/sysctl.h>
|
|
|
|
|
|
|
|
/*
|
|
|
|
* The following variables are used by the hardclock() routine in the
|
1995-05-30 08:16:23 +00:00
|
|
|
* kern_clock.c module and are described in that module.
|
1994-09-18 20:40:01 +00:00
|
|
|
*/
|
|
|
|
extern int time_state; /* clock state */
|
|
|
|
extern int time_status; /* clock status bits */
|
|
|
|
extern long time_offset; /* time adjustment (us) */
|
|
|
|
extern long time_freq; /* frequency offset (scaled ppm) */
|
|
|
|
extern long time_maxerror; /* maximum error (us) */
|
|
|
|
extern long time_esterror; /* estimated error (us) */
|
|
|
|
extern long time_constant; /* pll time constant */
|
|
|
|
extern long time_precision; /* clock precision (us) */
|
|
|
|
extern long time_tolerance; /* frequency tolerance (scaled ppm) */
|
|
|
|
|
|
|
|
#ifdef PPS_SYNC
|
|
|
|
/*
|
|
|
|
* The following variables are used only if the PPS signal discipline
|
|
|
|
* is configured in the kernel.
|
|
|
|
*/
|
|
|
|
extern int pps_shift; /* interval duration (s) (shift) */
|
|
|
|
extern long pps_freq; /* pps frequency offset (scaled ppm) */
|
|
|
|
extern long pps_jitter; /* pps jitter (us) */
|
|
|
|
extern long pps_stabil; /* pps stability (scaled ppm) */
|
|
|
|
extern long pps_jitcnt; /* jitter limit exceeded */
|
|
|
|
extern long pps_calcnt; /* calibration intervals */
|
|
|
|
extern long pps_errcnt; /* calibration errors */
|
|
|
|
extern long pps_stbcnt; /* stability limit exceeded */
|
|
|
|
#endif /* PPS_SYNC */
|
|
|
|
|
1995-11-14 09:07:14 +00:00
|
|
|
static int
|
|
|
|
ntp_sysctl SYSCTL_HANDLER_ARGS
|
1994-09-18 20:40:01 +00:00
|
|
|
{
|
|
|
|
struct timeval atv;
|
|
|
|
struct ntptimeval ntv;
|
|
|
|
int s;
|
|
|
|
|
|
|
|
s = splclock();
|
|
|
|
#ifdef EXT_CLOCK
|
|
|
|
/*
|
|
|
|
* The microtime() external clock routine returns a
|
|
|
|
* status code. If less than zero, we declare an error
|
|
|
|
* in the clock status word and return the kernel
|
|
|
|
* (software) time variable. While there are other
|
|
|
|
* places that call microtime(), this is the only place
|
|
|
|
* that matters from an application point of view.
|
|
|
|
*/
|
|
|
|
if (microtime(&atv) < 0) {
|
|
|
|
time_status |= STA_CLOCKERR;
|
|
|
|
ntv.time = time;
|
|
|
|
} else {
|
|
|
|
time_status &= ~STA_CLOCKERR;
|
|
|
|
}
|
|
|
|
#else /* EXT_CLOCK */
|
|
|
|
microtime(&atv);
|
|
|
|
#endif /* EXT_CLOCK */
|
|
|
|
ntv.time = atv;
|
|
|
|
ntv.maxerror = time_maxerror;
|
|
|
|
ntv.esterror = time_esterror;
|
|
|
|
splx(s);
|
1995-05-30 08:16:23 +00:00
|
|
|
|
1994-09-18 20:40:01 +00:00
|
|
|
ntv.time_state = time_state;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Status word error decode. If any of these conditions
|
|
|
|
* occur, an error is returned, instead of the status
|
|
|
|
* word. Most applications will care only about the fact
|
|
|
|
* the system clock may not be trusted, not about the
|
|
|
|
* details.
|
|
|
|
*
|
|
|
|
* Hardware or software error
|
|
|
|
*/
|
|
|
|
if (time_status & (STA_UNSYNC | STA_CLOCKERR)) {
|
|
|
|
ntv.time_state = TIME_ERROR;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* PPS signal lost when either time or frequency
|
|
|
|
* synchronization requested
|
|
|
|
*/
|
|
|
|
if (time_status & (STA_PPSFREQ | STA_PPSTIME) &&
|
|
|
|
!(time_status & STA_PPSSIGNAL)) {
|
|
|
|
ntv.time_state = TIME_ERROR;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* PPS jitter exceeded when time synchronization
|
|
|
|
* requested
|
|
|
|
*/
|
|
|
|
if (time_status & STA_PPSTIME &&
|
|
|
|
time_status & STA_PPSJITTER) {
|
|
|
|
ntv.time_state = TIME_ERROR;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* PPS wander exceeded or calibration error when
|
|
|
|
* frequency synchronization requested
|
|
|
|
*/
|
|
|
|
if (time_status & STA_PPSFREQ &&
|
|
|
|
time_status & (STA_PPSWANDER | STA_PPSERROR)) {
|
|
|
|
ntv.time_state = TIME_ERROR;
|
|
|
|
}
|
1995-11-14 09:07:14 +00:00
|
|
|
return (sysctl_handle_opaque(oidp, &ntv, sizeof ntv, req));
|
1994-09-18 20:40:01 +00:00
|
|
|
}
|
|
|
|
|
1995-11-14 09:07:14 +00:00
|
|
|
SYSCTL_NODE(_kern, KERN_NTP_PLL, ntp_pll, CTLFLAG_RW, 0,
|
|
|
|
"NTP kernel PLL related stuff");
|
|
|
|
SYSCTL_PROC(_kern_ntp_pll, NTP_PLL_GETTIME, gettime, CTLTYPE_OPAQUE|CTLFLAG_RD,
|
1995-12-04 16:48:58 +00:00
|
|
|
0, sizeof(struct ntptimeval) , ntp_sysctl, "S,ntptimeval", "");
|
1995-11-14 09:07:14 +00:00
|
|
|
|
1994-09-18 20:40:01 +00:00
|
|
|
/*
|
|
|
|
* ntp_adjtime() - NTP daemon application interface
|
|
|
|
*/
|
1995-11-12 06:43:28 +00:00
|
|
|
#ifndef _SYS_SYSPROTO_H_
|
1994-09-18 20:40:01 +00:00
|
|
|
struct ntp_adjtime_args {
|
|
|
|
struct timex *tp;
|
|
|
|
};
|
1995-11-12 06:43:28 +00:00
|
|
|
#endif
|
1994-09-18 20:40:01 +00:00
|
|
|
|
|
|
|
int
|
1997-11-06 19:29:57 +00:00
|
|
|
ntp_adjtime(struct proc *p, struct ntp_adjtime_args *uap)
|
1994-09-18 20:40:01 +00:00
|
|
|
{
|
|
|
|
struct timex ntv;
|
|
|
|
int modes;
|
|
|
|
int s;
|
|
|
|
int error;
|
|
|
|
|
|
|
|
error = copyin((caddr_t)uap->tp, (caddr_t)&ntv, sizeof(ntv));
|
|
|
|
if (error)
|
|
|
|
return error;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Update selected clock variables - only the superuser can
|
|
|
|
* change anything. Note that there is no error checking here on
|
|
|
|
* the assumption the superuser should know what it is doing.
|
|
|
|
*/
|
|
|
|
modes = ntv.modes;
|
|
|
|
if ((modes != 0)
|
|
|
|
&& (error = suser(p->p_cred->pc_ucred, &p->p_acflag)))
|
|
|
|
return error;
|
|
|
|
|
|
|
|
s = splclock();
|
|
|
|
if (modes & MOD_FREQUENCY)
|
|
|
|
#ifdef PPS_SYNC
|
|
|
|
time_freq = ntv.freq - pps_freq;
|
|
|
|
#else /* PPS_SYNC */
|
|
|
|
time_freq = ntv.freq;
|
|
|
|
#endif /* PPS_SYNC */
|
|
|
|
if (modes & MOD_MAXERROR)
|
|
|
|
time_maxerror = ntv.maxerror;
|
|
|
|
if (modes & MOD_ESTERROR)
|
|
|
|
time_esterror = ntv.esterror;
|
|
|
|
if (modes & MOD_STATUS) {
|
|
|
|
time_status &= STA_RONLY;
|
|
|
|
time_status |= ntv.status & ~STA_RONLY;
|
|
|
|
}
|
|
|
|
if (modes & MOD_TIMECONST)
|
|
|
|
time_constant = ntv.constant;
|
|
|
|
if (modes & MOD_OFFSET)
|
|
|
|
hardupdate(ntv.offset);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Retrieve all clock variables
|
|
|
|
*/
|
|
|
|
if (time_offset < 0)
|
|
|
|
ntv.offset = -(-time_offset >> SHIFT_UPDATE);
|
|
|
|
else
|
|
|
|
ntv.offset = time_offset >> SHIFT_UPDATE;
|
|
|
|
#ifdef PPS_SYNC
|
|
|
|
ntv.freq = time_freq + pps_freq;
|
|
|
|
#else /* PPS_SYNC */
|
|
|
|
ntv.freq = time_freq;
|
|
|
|
#endif /* PPS_SYNC */
|
|
|
|
ntv.maxerror = time_maxerror;
|
|
|
|
ntv.esterror = time_esterror;
|
|
|
|
ntv.status = time_status;
|
|
|
|
ntv.constant = time_constant;
|
|
|
|
ntv.precision = time_precision;
|
|
|
|
ntv.tolerance = time_tolerance;
|
|
|
|
#ifdef PPS_SYNC
|
|
|
|
ntv.shift = pps_shift;
|
|
|
|
ntv.ppsfreq = pps_freq;
|
|
|
|
ntv.jitter = pps_jitter >> PPS_AVG;
|
|
|
|
ntv.stabil = pps_stabil;
|
|
|
|
ntv.calcnt = pps_calcnt;
|
|
|
|
ntv.errcnt = pps_errcnt;
|
|
|
|
ntv.jitcnt = pps_jitcnt;
|
|
|
|
ntv.stbcnt = pps_stbcnt;
|
|
|
|
#endif /* PPS_SYNC */
|
|
|
|
(void)splx(s);
|
|
|
|
|
|
|
|
error = copyout((caddr_t)&ntv, (caddr_t)uap->tp, sizeof(ntv));
|
|
|
|
if (!error) {
|
|
|
|
/*
|
|
|
|
* Status word error decode. See comments in
|
|
|
|
* ntp_gettime() routine.
|
|
|
|
*/
|
1997-11-06 19:29:57 +00:00
|
|
|
p->p_retval[0] = time_state;
|
1994-09-18 20:40:01 +00:00
|
|
|
if (time_status & (STA_UNSYNC | STA_CLOCKERR))
|
1997-11-06 19:29:57 +00:00
|
|
|
p->p_retval[0] = TIME_ERROR;
|
1994-09-18 20:40:01 +00:00
|
|
|
if (time_status & (STA_PPSFREQ | STA_PPSTIME) &&
|
|
|
|
!(time_status & STA_PPSSIGNAL))
|
1997-11-06 19:29:57 +00:00
|
|
|
p->p_retval[0] = TIME_ERROR;
|
1994-09-18 20:40:01 +00:00
|
|
|
if (time_status & STA_PPSTIME &&
|
|
|
|
time_status & STA_PPSJITTER)
|
1997-11-06 19:29:57 +00:00
|
|
|
p->p_retval[0] = TIME_ERROR;
|
1994-09-18 20:40:01 +00:00
|
|
|
if (time_status & STA_PPSFREQ &&
|
|
|
|
time_status & (STA_PPSWANDER | STA_PPSERROR))
|
1997-11-06 19:29:57 +00:00
|
|
|
p->p_retval[0] = TIME_ERROR;
|
1994-09-18 20:40:01 +00:00
|
|
|
}
|
|
|
|
return error;
|
|
|
|
}
|
|
|
|
|
|
|
|
|