NAME

     rtime — get remote time

SYNOPSIS

     #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

     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 argument 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

     The rtime() function returns the value 0 if successful; otherwise the value -1 is returned
     and the global variable errno is set to indicate the error.

AVAILABILITY

     The rtime() function is part of libtirpc.