RTIME(3) Library Functions Manual RTIME(3)

# [NAME](#NAME)

`rtime` — get remote time

# [SYNOPSIS](#SYNOPSIS)

`#include <sys/types.h>`  
`#include <sys/time.h>`  
`#include <netinet/in.h>`

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

# [DESCRIPTION](#DESCRIPTION)

The [`rtime`](#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` argument 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.

# [RETURN VALUES](#RETURN_VALUES)

The `rtime`() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable `errno` is set to indicate the error.

# [AVAILABILITY](#AVAILABILITY)

The `rtime`() function is part of libtirpc.

November 22, 1987 Linux 4.19.0-gvisor

---

Document: rtime(3t) from libtirpc-nokrb 1.3.8-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/libtirpc/libtirpc/1.3.8/libtirpc-1.3.8.tar.bz2