Ntimed -- Network Time Synchronization
======================================

Introduction
~~~~~~~~~~~~

Ntimed is a network time synchronization client for the Amiga. It is based on the Ntimed free and open-source software by Poul-Henning Kamp, sponsored by the Linux Foundation.

It uses the NTP protocol to synchronize the local Amiga clock to a set of network servers. Public available NTP servers are reachable through the Internet. Ntimed for the Amiga conforms only to IPv4 networks.

Time servers operate using GMT. Ntimed supports the Amiga Time Zone Database. Local GMT offset will be used if no time zone is selected.

Reference
~~~~~~~~~

Format
  NTIMED [PARAM <parameter>] [TRACEFILE <file>] {servers} [SYNC] [SAVE] [SHOW] [QUIET]

Template
  P=PARAM/K,T=TRACEFILE/K,SERVERS/M/A,SYNC/S,SAVE/S,SHOW/S,QUIET/S

PARAM are used to show and set internal Ntimed parameters. A list of parameters will be shown when using question mark. TRACEFILE can be specified to write a full blow-by-blow trace file for analysis and debugging. {servers} is a list of NTP time servers.

SYNC will tell Ntimed to spent 5-10 seconds synchronizing and then exit. If SAVE is specified, time will be save to the real-time clock (RTC) upon exit. SHOW will display extended debugging information in the shell.

NTIMED can be stopped with CTRL C.

Synchronize to NTP servers
	NTIMED ntp1.example.com ntp2.example.com

Synchronize to single NTP server and put trace in RAM:
	NTIMED TRACEFILE=RAM:trace ntp1.example.com

Synchronize to single NTP server with modified parameters and put trace in T:
	NTIMED P "foo=20,poll_rate=25" T T:trace ntp7.example.com

Synchronize 10 seconds to single NTP server and save result to RTC
	NTIMED ntp4.example.com SYNC SAVE

Public available timeservers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

A list of public available timeservers from ntp.org:
http://support.ntp.org/bin/view/Servers/StratumTwoTimeServers

Instructions on how to use NTP pool servers are at:
http://www.pool.ntp.org/

How to compile
~~~~~~~~~~~~~~

Pull the source code over to the machine you want to play on, and::

	sh configure AMIGA (or sh configure AROS)
	make

Ntimed Project
~~~~~~~~~~~~~~

Ntimed Project page at Network Time Foundation:
http://nwtime.org/projects/ntimed-project