NAME    [Toc]    [Back]

       rtime - Get remote time

SYNOPSIS    [Toc]    [Back]

       #include   <sys/types.h>  #include  <sys/time.h>  #include
       <netinet/in.h>

       int rtime(
               struct sockaddr_in *addrp,
               struct timeval *timep,
               struct timeval *timeout );

DESCRIPTION    [Toc]    [Back]

       The rtime() function consults the Internet Time Server  at
       the  address  pointed  to  by addrp and returns the remote
       time in the timeval struct pointed to by timep.  Normally,
       the  UDP protocol is used when consulting the Time Server.
       The timeout  parameter  specifies  how  long  the  routine
       should  wait before giving up when waiting for a reply. If
       timeout is specified as NULL, however,  the  routine  will
       instead  use  TCP and block until a reply is received from
       the time server.

RETURN VALUES    [Toc]    [Back]

       The routine returns 0 if it is successful.  Otherwise,  it
       returns  -1  and  errno is set to reflect the cause of the
       error.

SEE ALSO    [Toc]    [Back]

       Commands: timed(8), timedc(8)



                                                         rtime(3)