Chapter 10

Time and Daytime

Many Unix hosts provide a RFC 867 Daytime service which sends the current date and time as a human-readable character string. The daytime service is typically served on port 13 as both TCP and UDP.

The RFC 868 Time protocol provides a site-independent, machine readable date and time. The Time service is typically served on port 37 as TCP and UDP. The idea is that you can confirm your system's idea of the time by polling several independent sites on the network.

10.1  Daytime

The rfc867 structure contains an interface to Daytime protocol.

(rfc867-daytime/tcp host)     --->     string         (procedure) 
(rfc867-daytime/udp host [timeout-or-#f])     --->     string-or-#f         (procedure) 
These procedures asks host about the current daytime and return the host's answer (e.g., ``Thursday, April 4, 2'').

Rfc867-daytime/tcp uses the TCP variant of the protocol. Rfc867-daytime/udp uses UDP and sends a single request to the server. It allows the specification of an optional timeout; if not specified or #f, Rfc867-daytime/udp will wait indefinitely for an answer. If the answer from the server doesn't arrive within the specified time, rfc867-daytime/udp returns #f.

10.2  Time

The rfc868 structure contains an interface to the Time protocol.

(rfc868-time/tcp host)     --->     string         (procedure) 
(rfc868-time/udp host [timeout-or-#f])     --->     string-or-#f         (procedure) 
These procedures asks host about the current time and return the host's answer. This is the number of second since 1970, just as with scsh's time procedure.

rfc868-time/tcp uses the TCP variant of the protocol. rfc868-time/udp uses UDP and sends a single request to the server. It allows the specification of an optional timeout; if not specified or #f, rfc868-time/udp will wait indefinitely for an answer. If the answer from the server doesn't arrive within the specified time, rfc868-time/udp returns #f.