rtime(3)

rtime3

Get remote time

Usage

#include <sys/types.h>

#include <sys/time.h>

#include <netinet/in.h>

int

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

Library

Standard C Library (libc, -lc)

Overview

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

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.

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 40 times.

  1. 3.0–3.4
  2. 3.5–3.5.1
  3. 4.0–4.2
  4. 4.3–4.4
  5. 4.5–4.11
  6. 5.0
  7. 5.1–6.3
  8. 6.4
  9. 7.0
  10. 7.1
  11. 7.2
  12. 7.3
  13. 7.4
  14. 8.0
  15. 8.1
  16. 8.2
  17. 8.3
  18. 8.4
  19. 9.0
  20. 9.1
  21. 9.2
  22. 9.3
  23. 10.0
  24. 10.1
  25. 10.2
  26. 10.3
  27. 10.4
  28. 11.0
  29. 11.1
  30. 11.2
  31. 11.3
  32. 11.4
  33. 12.0
  34. 12.1
  35. 12.2
  36. 12.3
  37. 12.4
  38. 13.0–13.1
  39. 13.2
  40. 13.3–14.5
  41. 15.0–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.