freebsd/sys/i386/include/clock.h

/*
 * Kernel interface to machine-dependent clock driver.
 * Garrett Wollman, September 1994.
 * This file is in the public domain.
 *
 * $FreeBSD$
 */

#ifndef _MACHINE_CLOCK_H_
#define	_MACHINE_CLOCK_H_

#ifdef _KERNEL
/*
 * i386 to clock driver interface.
 * XXX large parts of the driver and its interface are misplaced.
 */
extern int	adjkerntz;
extern int	disable_rtc_set;
extern int	statclock_disable;
extern u_int	timer_freq;
extern int	timer0_max_count;
extern u_int	tsc_freq;
extern int	tsc_is_broken;
extern int	wall_cmos_clock;
#ifdef APIC_IO
extern int	apic_8254_intr;
#endif

/*
 * Driver to clock driver interface.
 */
struct clockframe;

void	DELAY __P((int usec));
int	acquire_timer0 __P((int rate,
			    void (*function)(struct clockframe *frame)));
int	acquire_timer2 __P((int mode));
int	release_timer0 __P((void));
int	release_timer2 __P((void));
#ifndef PC98
int	rtcin __P((int val));
#else
int	acquire_timer1 __P((int mode));
int	release_timer1 __P((void));
#endif
int	sysbeep __P((int pitch, int period));
void	i8254_restore __P((void));

#endif /* _KERNEL */

#endif /* !_MACHINE_CLOCK_H_ */
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00			`/*`
			`* Kernel interface to machine-dependent clock driver.`
			`* Garrett Wollman, September 1994.`
			`* This file is in the public domain.`
Fix Pentium CPU rate diagnosis: - Don't print out meaningless iCOMP numbers, those are for droids. - Use a shorter wait to determine clock rate to avoid deficiencies in DELAY(). - Use a fixed-point representation with 8 bits of fraction to store the rate and rationalize the variable name. It would be possible to use even more fraction if it turns out to be worthwhile (I rather doubt it). The question of source code arrangement remains unaddressed. 1995-11-29 19:57:22 +00:00			`*`
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`* $FreeBSD$`
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00			`*/`

			`#ifndef _MACHINE_CLOCK_H_`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`#define _MACHINE_CLOCK_H_`
Redo Kernel NTP PLL support, kernel side. This code is mostly taken from the 1.1 port (which was in turn taken from Dave Mills's kern.tar.Z example). A few significant differences: 1) ntp_gettime() is now a MIB variable rather than a system call. A few fiddles are done in libc to make it behave the same. 2) mono_time does not participate in the PLL adjustments. 3) A new interface has been defined (in <machine/clock.h>) for doing possibly machine-dependent things around the time of the clock update. This is used in Pentium kernels to disable interrupts, set `time', and reset the CPU cycle counter as quickly as possible to avoid jitter in microtime(). Measurements show an apparent resolution of a bit more than 8.14usec, which is reasonable given system-call overhead. 1994-09-18 20:40:01 +00:00
Change #ifdef KERNEL to #ifdef _KERNEL in the public headers. "KERNEL" is an application space macro and the applications are supposed to be free to use it as they please (but cannot). This is consistant with the other BSD's who made this change quite some time ago. More commits to come. 1999-12-29 04:46:21 +00:00			`#ifdef _KERNEL`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`/*`
			`* i386 to clock driver interface.`
Removed vestiges of previous microtime() implementation. 1998-02-25 02:20:30 +00:00			`* XXX large parts of the driver and its interface are misplaced.`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`*/`
			`extern int adjkerntz;`
			`extern int disable_rtc_set;`
wash, sort and put in order various nits from the i586_ctr -> tsc commit. Pointed out by: bde 1997-12-28 13:36:09 +00:00			`extern int statclock_disable;`
			`extern u_int timer_freq;`
			`extern int timer0_max_count;`
Rename "i586_ctr" to "tsc" (both upper and lower case instances). Fix a couple of printfs too. Warning: This changes the names of a couple of kernel options! 1997-12-26 20:42:37 +00:00			`extern u_int tsc_freq;`
Stop the TSC from being used as timecounter on K5/step0 machines. 1999-05-29 06:57:55 +00:00			`extern int tsc_is_broken;`
Added missing extern declaration of timer_freq. Sorted declarations of scalars. 1996-10-17 17:31:25 +00:00			`extern int wall_cmos_clock;`
Remove special handling for resuming clock interrupt when using APIC_IO. The `generic' vector stubs do the right thing. 1998-03-05 21:45:53 +00:00			`#ifdef APIC_IO`
			`extern int apic_8254_intr;`
			`#endif`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
			`/*`
			`* Driver to clock driver interface.`
			`*/`
Improved biasing of i586 clock by adjusting for hardclock() latency. I decided to do this for every hardclock() call instead of lazily in microtime(). The lazy method is simpler but has more overhead if microtime() is called a lot. CPU_THISTICKLEN() is now a no-op and should probably go away. Previously it did nothing directly but had the side effect of setting i586_last_tick for CPU_CLOCKUPDATE() and i586_avg_tick for debugging. CPU_CLOCKUPDATE() now uses a better method and i586_avg_tick is too much trouble to maintain. Reduced nesting of #includes in the usual case. Increased nesting of #includes when CLOCK_HAIR is defined. This is a kludge to get typedefs for inline functions only when the inline functions are used. Normally only kern_clock.c defines this. kern_clock.c can't include the i386 headers directly. Removed unused LOCORE support. 1996-10-25 13:01:56 +00:00			`struct clockframe;`

Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`void DELAY __P((int usec));`
			`int acquire_timer0 __P((int rate,`
			`void (function)(struct clockframe frame)));`
			`int acquire_timer2 __P((int mode));`
			`int release_timer0 __P((void));`
			`int release_timer2 __P((void));`
The Great PC98 Merge. All new code is "#ifdef PC98"ed so this should make no difference to PC/AT (and its clones) users. Ok'd by: core Submitted by: FreeBSD(98) development team 1996-06-14 11:02:28 +00:00			`#ifndef PC98`
Moved rtcin() to clock.c. Always delay using one inb(0x84) after each i/o in rtcin() - don't do this conditional on the bogus option DUMMY_NOPS not being defined. If you want an optionally slightly faster rtcin() again, then inline it and use a better named option or sysctl variable. It only needs to be fast in rtcintr(). 1996-03-31 04:05:36 +00:00			`int rtcin __P((int val));`
The Great PC98 Merge. All new code is "#ifdef PC98"ed so this should make no difference to PC/AT (and its clones) users. Ok'd by: core Submitted by: FreeBSD(98) development team 1996-06-14 11:02:28 +00:00			`#else`
			`int acquire_timer1 __P((int mode));`
			`int release_timer1 __P((void));`
			`#endif`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00			`int sysbeep __P((int pitch, int period));`
i8254_restore is called from apm_default_resume() to reload the countdown register. this should not be necessary but there are broken laptops that do not restore the countdown register on resume. when it happnes, it messes up the hardclock interval and system clock, which leads to the infamous "calcru: negative time" problem. Submitted by: kjc, iwasaki Reviewed by: Steve O'Hara-Smith <steveo@eircom.net> and committers. Obtained from: PAO3 1999-10-30 14:56:01 +00:00			`void i8254_restore __P((void));`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
Change #ifdef KERNEL to #ifdef _KERNEL in the public headers. "KERNEL" is an application space macro and the applications are supposed to be free to use it as they please (but cannot). This is consistant with the other BSD's who made this change quite some time ago. More commits to come. 1999-12-29 04:46:21 +00:00			`#endif /* _KERNEL */`
Declare the full uglyness of the interfaces to the clock driver (except things declared in machine-independent files). 1994-11-05 22:51:17 +00:00
			`#endif /* !_MACHINE_CLOCK_H_ */`