summaryrefslogtreecommitdiff
path: root/lib/libc/rpc/rtime.3
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/rpc/rtime.3')
-rw-r--r--lib/libc/rpc/rtime.367
1 files changed, 34 insertions, 33 deletions
diff --git a/lib/libc/rpc/rtime.3 b/lib/libc/rpc/rtime.3
index 6847e1502a38..3897fc82991c 100644
--- a/lib/libc/rpc/rtime.3
+++ b/lib/libc/rpc/rtime.3
@@ -1,47 +1,48 @@
.\" @(#)rtime.3n 2.1 88/08/08 4.0 RPCSRC; from 1.5 88/02/08 SMI
.\" $FreeBSD$
.\"
-.TH RTIME 3 "22 November 1987"
-.SH NAME
-rtime \- get remote time
-.SH SYNOPSIS
-.nf
-.B #include <sys/types.h>
-.B #include <sys/time.h>
-.B #include <netinet/in.h>
-.LP
-.B int rtime(addrp, timep, timeout)
-.B struct sockaddr_in \(**addrp;
-.B struct timeval \(**timep;
-.B struct timeval \(**timeout;
-.fi
-.SH DESCRIPTION
-.B rtime(\|)
+.Dd November 22, 1987
+.Dt RTIME 3
+.Os
+.Sh NAME
+.Nm rtime
+.Nd "get remote time"
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.Fd "#include <sys/types.h>"
+.Fd "#include <sys/time.h>"
+.Fd "#include <netinet/in.h>"
+.Ft int
+.Fo rtime
+.Fa "struct sockaddr_in *addrp"
+.Fa "struct timeval *timep"
+.Fa "struct timeval *timeout"
+.Fc
+.Sh DESCRIPTION
+.Fn rtime
consults the Internet Time Server at the address pointed to by
-.I addrp
+.Fa addrp
and returns the remote time in the
-.B timeval
+.Vt timeval
struct pointed to by
-.IR timep .
+.Fa timep .
Normally, the
-.SM UDP
+.Tn UDP
protocol is used when consulting the Time Server.
The
-.I timeout
+.Fa timeout
parameter specifies how long the
routine should wait before giving
-up when waiting for a reply. If
-.I timeout
+up when waiting for a reply.
+If
+.Fa timeout
is specified as
-.SM NULL\s0,
+.Dv NULL ,
however, the routine will instead use
-.SM TCP
+.Tn TCP
and block until a reply is received from the time server.
-.LP
-The routine returns 0 if it is successful.
-Otherwise,
-it returns \-1 and
-.B errno
-is set to reflect the cause of the error.
-.SH "SEE ALSO"
-.BR timed (8c)
+.Sh RETURN VALUES
+.Rv -std rtime
+.Sh SEE ALSO
+.Xr timed 8