ntptime(n) ntp ntptime(n)

NAME
       ntptime - Tcl Time Service Client

SYNOPSIS
       package require TTccll  88..22

       package require ttiimmee  ??11..00..33??

       ::::ttiimmee::::ggeettttiimmee ?options? timeserver ?port?

       ::::ttiimmee::::ccoonnffiigguurree ?options?

       ::::ttiimmee::::ccggeett name

       ::::ttiimmee::::uunniixxttiimmee token

       ::::ttiimmee::::ssttaattuuss token

       ::::ttiimmee::::eerrrroorr token

       ::::ttiimmee::::rreesseett token ?reason?

       ::::ttiimmee::::wwaaiitt token

       ::::ttiimmee::::cclleeaannuupp token



DESCRIPTION
       This  package  implements  a  client  for  the  RFC  868  TIME protocol
       (http://www.rfc-editor.org/rfc/rfc868.txt).    This   simple   protocol
       returns  the  time in seconds since 1 January 1900 to either tcp or udp
       clients.

CCOOMMMMAANNDDSS
       ::::ttiimmee::::ggeettttiimmee ?options? timeserver ?port?
              Get the time from timeserver. You may specify any of the options
              listed  for  the  ccoonnffiigguurree command here. This command returns a
              token which must then be used with  the  remaining  commands  in
              this  package. Once you have finished, you should use cclleeaannuupp to
              release all resources.

       ::::ttiimmee::::ccoonnffiigguurree ?options?
              Called with no arguments this command returns  all  the  current
              configuration  options and values. Otherwise it should be called
              with pairs of option name and value.

              -pprroottooccooll number
                     Set the default network protocol. This defaults to udp if
                     the  tcludp  package  is available. Otherwise it will use
                     tcp.

              -ppoorrtt number
                     Set the default port to use. RFC 868 uses port 37.

              -ttiimmeeoouutt number
                     Set  the  default  timeout  value  in  milliseconds.  The
                     default is 10 seconds.

              -ccoommmmaanndd number
                     Set  a  command  procedure  to  be  run  when  a reply is
                     received. The procedure is called  with  the  time  token
                     appended to the argument list.

              -lloogglleevveell number
                     Set the logging level. The default is 'warning'.

       ::::ttiimmee::::ccggeett name
              Get the current value for the named configuration option.

       ::::ttiimmee::::uunniixxttiimmee token
              Format  the  returned  time  for  the  unix  epoch. RFC 868 time
              defines time 0 as 1 Jan 1900, while unix time defines time 0  as
              1 Jan 1970. This command converts the reply to unix time.

       ::::ttiimmee::::ssttaattuuss token
              Returns the status flag. For a successfully completed query this
              will  be  ok.  May  be  error  or  timeout  or  eof.   See  also
              ::::ttiimmee::::eerrrroorr

       ::::ttiimmee::::eerrrroorr token
              Returns  the error message provided for requests whose status is
              error.  If there is no error message then  an  empty  string  is
              returned.

       ::::ttiimmee::::rreesseett token ?reason?
              Reset  or  cancel  the  query optionally specfying the reason to
              record for the eerrrroorr command.

       ::::ttiimmee::::wwaaiitt token
              Wait for a query to complete and return the status upon  comple-
              tion.

       ::::ttiimmee::::cclleeaannuupp token
              Remove all state variables associated with the request.
              % set tok [::time::gettime ntp2a.mcc.ac.uk]
              % set t [::time::unixtime $tok]
              % ::time::cleanup $tok

AUTHORS       Pat Thoyts

SEE ALSO
       ntp

KKEEYYWWOORRDDSS
       NTP, rfc 868, time

COPYRIGHT       Copyright (c) 2002, Pat Thoyts 



ntp                                  1.0.3                         ntptime(n)