1.\" @(#)rtime.3n 2.1 88/08/08 4.0 RPCSRC; from 1.5 88/02/08 SMI 2.\" $FreeBSD$ 3.\" 4.Dd November 22, 1987 5.Dt RTIME 3 6.Os 7.Sh NAME 8.Nm rtime 9.Nd "get remote time" 10.Sh LIBRARY 11.Lb libc 12.Sh SYNOPSIS 13.Fd "#include <sys/types.h>" 14.Fd "#include <sys/time.h>" 15.Fd "#include <netinet/in.h>" 16.Ft int 17.Fo rtime 18.Fa "struct sockaddr_in *addrp" 19.Fa "struct timeval *timep" 20.Fa "struct timeval *timeout" 21.Fc 22.Sh DESCRIPTION 23.Fn rtime 24consults the Internet Time Server at the address pointed to by 25.Fa addrp 26and returns the remote time in the 27.Vt timeval 28struct pointed to by 29.Fa timep . 30Normally, the 31.Tn UDP 32protocol is used when consulting the Time Server. 33The 34.Fa timeout 35parameter specifies how long the 36routine should wait before giving 37up when waiting for a reply. 38If 39.Fa timeout 40is specified as 41.Dv NULL , 42however, the routine will instead use 43.Tn TCP 44and block until a reply is received from the time server. 45.Sh RETURN VALUES 46.Rv -std rtime 47.Sh SEE ALSO 48.Xr timed 8 49