Short:        SNTP time client for Amiga
Uploader:     biuro@cdlabel.info (Pawel Juen Nowak)
Author:       Juen/Project R3D+Appendix+Nah-Kolor
Type:         comm/tcp
Version:      1.2
Architecture: m68k-amigaos >= 2.0.0

 A lightweight SNTP time synchronization client for classic Amiga
 computers.

 REQUIREMENTS:

 - MC68000 or better
 - Kickstart 2.0 or higher
 - A TCP/IP stack with bsdsocket.library (AmiTCP, Roadshow, Miami, etc.)

 FEATURES:

 - SNTP protocol (RFC 4330, UDP port 123)
 - Query NTP servers for current time
 - Timezone support with -z option (e.g. -z +1 for CET)
 - Auto-detects timezone from ENV:TZ or Locale/GMToffset
 - Optionally set Amiga system clock (-s flag)
 - NTP epoch (1900) to Amiga epoch (1978) conversion
 - Verbose mode shows NTP stratum and raw timestamps
 - Pure MC68000 code - no 68020+ instructions

 USAGE:

 From CLI:

   AveNTP                          ; query pool.ntp.org (UTC)
   AveNTP -z +1                    ; show time in CET
   AveNTP -s -z +2 pool.ntp.org    ; set clock to CEST
   AveNTP -v -s time.google.com    ; verbose + set clock

 OPTIONS:

   -s            Set system clock from NTP response
   -z <offset>   Timezone offset from UTC (e.g. +1, -5, +5:30)
                 Auto-detected from ENV:TZ or Locale if omitted
   -v            Verbose output (show NTP details)
   -h            Show help

 NOTES:

 - Clock setting uses AmigaDOS Date command internally.
 - Timezone is auto-detected from ENV:TZ (POSIX format) or
   Locale/GMToffset. Use -z to override.
 - Without -z and no auto-detection, time is shown in UTC.
   A warning is shown if you use -s without timezone.
 - NTP packet is 48 bytes (minimal network overhead).

 CHANGELOG:

 v1.2 (10.06.2026)
  - Added full POSIX TZ string parsing support
  
 v1.1 (28.03.2026)
  - Fix: proper socket cleanup using CloseSocket() instead of close()

 LICENSE:

 Freeware. Use at your own risk.

 CONTACT:

 Pawel "Juen" Nowak
 Project R3D + Appendix + Nah-Kolor
 biuro@cdlabel.info
