[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

kgettickd Kernel Service

Purpose

Retrieves the current status of the systemwide time-of-day timer-adjustment values.

Syntax

#include <sys/types.h>
int kgettickd (timed, tickd, time_adjusted)
int *timed;
int *tickd;
int *time_adjusted;

Parameters

timed Specifies the current amount of time adjustment in microseconds remaining to be applied to the systemwide timer.
tickd Specifies the time-adjustment rate in microseconds.
time_adjusted Indicates if the systemwide timer has been adjusted. A value of True indicates that the timer has been adjusted by a call to the adjtime or settimer subroutine. A value of False indicates that it has not. The use of the ksettimer kernel service has no effect on this flag. This flag can be changed by the ksettickd kernel service.

Description

The kgettickd kernel service provides kernel extensions with the capability to determine if the adjtime or settimer subroutine has adjusted or changed the systemwide timer.

The kgettickd kernel service is typically used only by kernel extensions providing time synchronization functions. This includes coordinated network time (which is the periodic synchronization of all system clocks to a common time by a time server or set of time servers on a network), where use of the adjtime subroutine is insufficient.

Execution Environment

The kgettickd kernel service can be called from either the process or interrupt environment.

Return Values

The kgettickd service always returns a value of 0.

Implementation Specifics

The kgettickd kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The ksettimer kernel service.

The adjtime subroutine, settimer subroutine.

Timer and Time-of-Day Kernel Services and Using Fine Granularity Timer Services and Structures in AIX Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]