Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ rtime(3) — Digital UNIX 3.2c

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

timed(8)

timedc(8)

rtime(3)  —  Subroutines

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

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 parameter 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. 

The routine returns 0 if it is successful. Otherwise, it returns −1 and errno is set to reflect the cause of the error. 

RELATED INFORMATION

timed(8), timedc(8)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026