1.\" @(#)rtime.3n 2.1 88/08/08 4.0 RPCSRC; from 1.5 88/02/08 SMI
2.\" $FreeBSD: head/lib/libc/rpc/rtime.3 57686 2000-03-02 09:14:21Z sheldonh $
3.\"
4.TH RTIME 3 "22 November 1987"
5.SH NAME
6rtime \- get remote time
7.SH SYNOPSIS
8.nf
9.B #include <sys/types.h>
10.B #include <sys/time.h>
--- 9 unchanged lines hidden (view full) ---
20consults the Internet Time Server at the address pointed to by
21.I addrp
22and returns the remote time in the
23.B timeval
24struct pointed to by
25.IR timep .
26Normally, the
27.SM UDP
28protocol is used when consulting the Time Server.
29The
30.I timeout
31parameter specifies how long the
32routine should wait before giving
33up when waiting for a reply. If
34.I timeout
35is specified as
36.SM NULL\s0,
37however, the routine will instead use
38.SM TCP
39and block until a reply is received from the time server.
40.LP
41The routine returns 0 if it is successful.
42Otherwise,
43it returns \-1 and
44.B errno
45is set to reflect the cause of the error.
46.SH "SEE ALSO"
47.BR timed (8c)
2.\" $FreeBSD: head/lib/libc/rpc/rtime.3 57686 2000-03-02 09:14:21Z sheldonh $
3.\"
4.TH RTIME 3 "22 November 1987"
5.SH NAME
6rtime \- get remote time
7.SH SYNOPSIS
8.nf
9.B #include <sys/types.h>
10.B #include <sys/time.h>
--- 9 unchanged lines hidden (view full) ---
20consults the Internet Time Server at the address pointed to by
21.I addrp
22and returns the remote time in the
23.B timeval
24struct pointed to by
25.IR timep .
26Normally, the
27.SM UDP
28protocol is used when consulting the Time Server.
29The
30.I timeout
31parameter specifies how long the
32routine should wait before giving
33up when waiting for a reply. If
34.I timeout
35is specified as
36.SM NULL\s0,
37however, the routine will instead use
38.SM TCP
39and block until a reply is received from the time server.
40.LP
41The routine returns 0 if it is successful.
42Otherwise,
43it returns \-1 and
44.B errno
45is set to reflect the cause of the error.
46.SH "SEE ALSO"
47.BR timed (8c)