ntp

Documentation

Index

• Constants
• type NTP
  • func NewNTPClient(opts ...Option) (*NTP, error)
  • func (n *NTP) Daemon() (err error)
  • func (n *NTP) GetTime() time.Time
  • func (n *NTP) Query() (resp *ntp.Response, err error)
  • func (n *NTP) QueryAndSetTime() (err error)
  • func (n *NTP) Ready() bool
• type Option
  • func WithMaxPoll(o int) Option
  • func WithMinPoll(o int) Option
  • func WithServer(o string) Option

Constants

const (
	// MaxAllowablePoll is the 'recommended' interval for querying a time server
	MaxAllowablePoll = 1024
	// MinAllowablePoll is the minimum time allowed for a client to query a time server
	MinAllowablePoll = 4
	// AdjustTimeLimit is a maximum time drift to compensate via adjtimex()
	AdjustTimeLimit = 128 * time.Millisecond
)

Types

type NTP

type NTP struct {
	Server  string
	MinPoll time.Duration
	MaxPoll time.Duration
	// contains filtered or unexported fields
}

NTP contains a server address.

func NewNTPClient

func NewNTPClient(opts ...Option) (*NTP, error)

NewNTPClient instantiates a new ntp client for the specified server.

func (*NTP) Daemon

func (n *NTP) Daemon() (err error)

Daemon runs the control loop for query and set time We dont ever want the daemon to stop, so we only log errors.

func (*NTP) GetTime

func (n *NTP) GetTime() time.Time

GetTime returns the current system time.

func (*NTP) Query

func (n *NTP) Query() (resp *ntp.Response, err error)

Query polls the ntp server and verifies a successful response.

func (*NTP) QueryAndSetTime

func (n *NTP) QueryAndSetTime() (err error)

QueryAndSetTime queries the NTP server and sets the time.

func (*NTP) Ready

func (n *NTP) Ready() bool

Ready checks whether initial time sync has already happened.

type Option

type Option func(*NTP) error

Option allows for the configuration of the ntp client.

func WithMaxPoll

func WithMaxPoll(o int) Option

WithMaxPoll configures the ntp client MaxPoll interval.

func WithMinPoll

func WithMinPoll(o int) Option

WithMinPoll configures the ntp client MinPoll interval.

func WithServer

func WithServer(o string) Option

WithServer configures the ntp client to use the specified server.