xref: /freebsd/lib/libc/rpc/rtime.3 (revision e8636dfd57b1bc6a19328606214e847c0d9eb1aa)
@(#)rtime.3n 2.1 88/08/08 4.0 RPCSRC; from 1.5 88/02/08 SMI
RTIME 3 "22 November 1987"
NAME
rtime - get remote time
SYNOPSIS
 #include <sys/types.h>  #include <sys/time.h>  #include <netinet/in.h> 

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

DESCRIPTION
rtime(\|) 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\s0, however, the routine will instead use TCP and block until a reply is received from the time server.

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"
timed (8c)