amiga-ntimed/README.md

60 lines
2.2 KiB
Markdown
Raw Permalink Normal View History

2014-12-21 22:31:18 +00:00
Ntimed -- Network Time Synchronization
======================================
2016-08-19 19:06:37 +00:00
### Introduction
2015-03-12 21:48:56 +00:00
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.
2015-03-12 21:48:56 +00:00
2015-07-12 19:25:17 +00:00
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.
2015-03-12 21:48:56 +00:00
2015-07-11 08:43:59 +00:00
Time servers operate using GMT. Ntimed supports the Amiga Time Zone Database. Local GMT offset will be used if no time zone is selected.
2016-08-19 19:06:37 +00:00
### Reference
2015-03-12 21:48:56 +00:00
2016-08-19 19:06:37 +00:00
#### Format
2015-03-12 21:48:56 +00:00
2016-08-19 19:06:37 +00:00
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
2014-12-21 22:31:18 +00:00
2015-07-11 08:43:59 +00:00
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.
2014-12-21 22:31:18 +00:00
2015-07-11 08:43:59 +00:00
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.
2015-03-16 22:26:05 +00:00
NTIMED can be stopped with CTRL C.
2014-12-21 22:31:18 +00:00
2016-08-19 19:06:37 +00:00
#### Synchronize to NTP servers
2015-03-12 22:05:47 +00:00
NTIMED ntp1.example.com ntp2.example.com
2014-12-21 22:31:18 +00:00
2016-08-19 19:06:37 +00:00
#### Synchronize to single NTP server and put trace in RAM:
2015-07-11 08:43:59 +00:00
NTIMED TRACEFILE=RAM:trace ntp1.example.com
2014-12-21 22:31:18 +00:00
2016-08-19 19:06:37 +00:00
#### Synchronize to single NTP server with modified parameters and put trace in T:
2015-03-12 22:13:23 +00:00
NTIMED P "foo=20,poll_rate=25" T T:trace ntp7.example.com
2014-12-21 22:31:18 +00:00
2016-08-19 19:06:37 +00:00
#### Synchronize 10 seconds to single NTP server and save result to RTC
2015-07-11 08:43:59 +00:00
NTIMED ntp4.example.com SYNC SAVE
2014-12-21 22:31:18 +00:00
2016-08-19 19:06:37 +00:00
### Public available timeservers
2014-12-21 22:31:18 +00:00
2016-08-19 19:04:15 +00:00
A list of public available timeservers from [support.ntp.org](http://support.ntp.org/bin/view/Servers/StratumTwoTimeServers)
2014-12-21 22:31:18 +00:00
2016-08-19 19:04:15 +00:00
Instructions on how to use NTP pool servers are at [www.pool.ntp.org](http://www.pool.ntp.org/)
2015-03-12 21:48:56 +00:00
2016-08-19 19:06:37 +00:00
### How to compile
2014-12-21 22:31:18 +00:00
2015-03-12 21:59:00 +00:00
Pull the source code over to the machine you want to play on, and::
2014-12-21 22:31:18 +00:00
2015-03-11 21:10:43 +00:00
sh configure AMIGA (or sh configure AROS)
2014-12-21 22:31:18 +00:00
make
2015-07-13 21:18:48 +00:00
2016-08-19 19:06:37 +00:00
### Ntimed Project
2015-07-13 21:18:48 +00:00
2016-08-19 19:04:15 +00:00
The official Ntimed project is hosted by [Network Time Foundation](http://nwtime.org/projects/ntimed)