ntp.c File Reference

Network Time Protocol. More...

#include <stdint.h>
#include <string.h>
#include <errno.h>
#include <time.h>
#include <ipxe/malloc.h>
#include <ipxe/refcnt.h>
#include <ipxe/iobuf.h>
#include <ipxe/xfer.h>
#include <ipxe/open.h>
#include <ipxe/retry.h>
#include <ipxe/timer.h>
#include <ipxe/time.h>
#include <ipxe/tcpip.h>
#include <ipxe/dhcp.h>
#include <ipxe/settings.h>
#include <ipxe/ntp.h>

Go to the source code of this file.

Data Structures
struct	ntp_client
	An NTP client. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	ntp_close (struct ntp_client *ntp, int rc)
	Close NTP client.
static int	ntp_request (struct ntp_client *ntp)
	Send NTP request.
static int	ntp_deliver (struct ntp_client *ntp, struct io_buffer *iobuf, struct xfer_metadata *meta)
	Handle NTP response.
static void	ntp_window_changed (struct ntp_client *ntp)
	Handle data transfer window change.
static void	ntp_expired (struct retry_timer *timer, int fail)
	Handle NTP timer expiry.
int	start_ntp (struct interface *job, const char *hostname)
	Start NTP client.
const struct setting ntp_setting	__setting (SETTING_IP4_EXTRA, ntp)
	IPv4 NTP server setting.

Variables
static struct interface_operation	ntp_xfer_op []
	Data transfer interface operations.
static struct interface_descriptor	ntp_xfer_desc
	Data transfer interface descriptor.
static struct interface_operation	ntp_job_op []
	Job control interface operations.
static struct interface_descriptor	ntp_job_desc
	Job control interface descriptor.

Detailed Description

Network Time Protocol.

Definition in file ntp.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

ntp_close()

void ntp_close ( struct ntp_client * ntp, int rc )

static

Close NTP client.

Parameters

ntp	NTP client
rc	Reason for close

Definition at line 68 of file ntp.c.

                                                         {
 
        /* Stop timer */
        stop_timer ( &ntp->timer );
 
        /* Shut down interfaces */
        intf_shutdown ( &ntp->xfer, rc );
        intf_shutdown ( &ntp->job, rc );
}

References intf_shutdown(), ntp(), rc, and stop_timer().

Referenced by ntp_deliver(), ntp_expired(), and start_ntp().

ntp_request()

int ntp_request ( struct ntp_client * ntp )

static

Send NTP request.

Parameters

ntp	NTP client

Return values

rc	Return status code

Definition at line 84 of file ntp.c.

                                                  {
        struct ntp_header hdr;
        int rc;
 
        DBGC ( ntp, "NTP %p sending request\n", ntp );
 
        /* Construct header */
        memset ( &hdr, 0, sizeof ( hdr ) );
        hdr.flags = ( NTP_FL_LI_UNKNOWN | NTP_FL_VN_1 | NTP_FL_MODE_CLIENT );
        hdr.transmit.seconds = htonl ( time ( NULL ) + NTP_EPOCH );
        hdr.transmit.fraction = htonl ( NTP_FRACTION_MAGIC );
 
        /* Send request */
        if ( ( rc = xfer_deliver_raw ( &ntp->xfer, &hdr,
                                       sizeof ( hdr ) ) ) != 0 ) {
                DBGC ( ntp, "NTP %p could not send request: %s\n",
                       ntp, strerror ( rc ) );
                return rc;
        }
 
        return 0;
}

References DBGC, hdr, htonl, memset(), ntp(), NTP_EPOCH, NTP_FL_LI_UNKNOWN, NTP_FL_MODE_CLIENT, NTP_FL_VN_1, NTP_FRACTION_MAGIC, NULL, rc, strerror(), and xfer_deliver_raw().

Referenced by ntp_expired().

ntp_deliver()

int ntp_deliver ( struct ntp_client * ntp, struct io_buffer * iobuf, struct xfer_metadata * meta )

static

Handle NTP response.

Parameters

ntp	NTP client
iobuf	I/O buffer
meta	Data transfer metadata

Return values

rc	Return status code

Definition at line 115 of file ntp.c.

                                                      {
        struct ntp_header *hdr;
        struct sockaddr_tcpip *st_src;
        int32_t delta;
        int rc;
 
        /* Check source port */
        st_src = ( ( struct sockaddr_tcpip * ) meta->src );
        if ( st_src->st_port != htons ( NTP_PORT ) ) {
                DBGC ( ntp, "NTP %p received non-NTP packet:\n", ntp );
                DBGC_HDA ( ntp, 0, iobuf->data, iob_len ( iobuf ) );
                goto ignore;
        }
 
        /* Check packet length */
        if ( iob_len ( iobuf ) < sizeof ( *hdr ) ) {
                DBGC ( ntp, "NTP %p received malformed packet:\n", ntp );
                DBGC_HDA ( ntp, 0, iobuf->data, iob_len ( iobuf ) );
                goto ignore;
        }
        hdr = iobuf->data;
 
        /* Check mode */
        if ( ( hdr->flags & NTP_FL_MODE_MASK ) != NTP_FL_MODE_SERVER ) {
                DBGC ( ntp, "NTP %p received non-server packet:\n", ntp );
                DBGC_HDA ( ntp, 0, iobuf->data, iob_len ( iobuf ) );
                goto ignore;
        }
 
        /* Check magic value */
        if ( hdr->originate.fraction != htonl ( NTP_FRACTION_MAGIC ) ) {
                DBGC ( ntp, "NTP %p received unrecognised packet:\n", ntp );
                DBGC_HDA ( ntp, 0, iobuf->data, iob_len ( iobuf ) );
                goto ignore;
        }
 
        /* Check for Kiss-o'-Death packets */
        if ( ! hdr->stratum ) {
                DBGC ( ntp, "NTP %p received kiss-o'-death:\n", ntp );
                DBGC_HDA ( ntp, 0, iobuf->data, iob_len ( iobuf ) );
                rc = -EPROTO;
                goto close;
        }
 
        /* Calculate clock delta */
        delta = ( ntohl ( hdr->receive.seconds ) -
                  ntohl ( hdr->originate.seconds ) );
        DBGC ( ntp, "NTP %p delta %d seconds\n", ntp, delta );
 
        /* Adjust system clock */
        time_adjust ( delta );
 
        /* Success */
        rc = 0;
 
 close:
        ntp_close ( ntp, rc );
 ignore:
        free_iob ( iobuf );
        return 0;
}

References close, io_buffer::data, DBGC, DBGC_HDA, EPROTO, free_iob(), hdr, htonl, htons, iob_len(), meta, ntohl, ntp(), ntp_close(), NTP_FL_MODE_MASK, NTP_FL_MODE_SERVER, NTP_FRACTION_MAGIC, NTP_PORT, rc, and sockaddr_tcpip::st_port.

ntp_window_changed()

void ntp_window_changed ( struct ntp_client * ntp )

static

Handle data transfer window change.

Parameters

ntp	NTP client

Definition at line 183 of file ntp.c.

                                                          {
 
        /* Start timer to send initial request */
        start_timer_nodelay ( &ntp->timer );
}

References ntp(), and start_timer_nodelay().

ntp_expired()

void ntp_expired ( struct retry_timer * timer, int fail )

static

Handle NTP timer expiry.

Parameters

timer	Retransmission timer
fail	Failure indicator

Definition at line 216 of file ntp.c.

                                                                {
        struct ntp_client *ntp =
                container_of ( timer, struct ntp_client, timer );
 
        /* Shut down client if we have failed */
        if ( fail ) {
                ntp_close ( ntp, -ETIMEDOUT );
                return;
        }
 
        /* Otherwise, restart timer and (re)transmit request */
        start_timer ( &ntp->timer );
        ntp_request ( ntp );
}

References container_of, ETIMEDOUT, ntp(), ntp_close(), ntp_request(), and start_timer().

Referenced by start_ntp().

start_ntp()

int start_ntp	(	struct interface *	job,
		const char *	hostname )

Start NTP client.

Parameters

job	Job control interface
hostname	NTP server

Return values

rc	Return status code

Definition at line 238 of file ntp.c.

                                                              {
        struct ntp_client *ntp;
        union {
                struct sockaddr_tcpip st;
                struct sockaddr sa;
        } server;
        int rc;
 
        /* Allocate and initialise structure*/
        ntp = zalloc ( sizeof ( *ntp ) );
        if ( ! ntp ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        ref_init ( &ntp->refcnt, NULL );
        intf_init ( &ntp->job, &ntp_job_desc, &ntp->refcnt );
        intf_init ( &ntp->xfer, &ntp_xfer_desc, &ntp->refcnt );
        timer_init ( &ntp->timer, ntp_expired, &ntp->refcnt );
        set_timer_limits ( &ntp->timer, NTP_MIN_TIMEOUT, NTP_MAX_TIMEOUT );
 
        /* Open socket */
        memset ( &server, 0, sizeof ( server ) );
        server.st.st_port = htons ( NTP_PORT );
        if ( ( rc = xfer_open_named_socket ( &ntp->xfer, SOCK_DGRAM, &server.sa,
                                             hostname, NULL ) ) != 0 ) {
                DBGC ( ntp, "NTP %p could not open socket: %s\n",
                       ntp, strerror ( rc ) );
                goto err_open;
        }
 
        /* Attach parent interface, mortalise self, and return */
        intf_plug_plug ( &ntp->job, job );
        ref_put ( &ntp->refcnt );
        return 0;
 
 err_open:
        ntp_close ( ntp, rc );
        ref_put ( &ntp->refcnt );
 err_alloc:
        return rc;
}

References DBGC, ENOMEM, htons, intf_init(), intf_plug_plug(), memset(), ntp(), ntp_close(), ntp_expired(), ntp_job_desc, NTP_MAX_TIMEOUT, NTP_MIN_TIMEOUT, NTP_PORT, ntp_xfer_desc, NULL, rc, ref_init, ref_put, sa, SOCK_DGRAM, st, strerror(), xfer_open_named_socket(), and zalloc().

Referenced by ntp().

__setting()

const struct setting ntp_setting __setting	(	SETTING_IP4_EXTRA	,
		ntp	)

IPv4 NTP server setting.

References __setting, DHCP_NTP_SERVERS, ntp(), and SETTING_IP4_EXTRA.

Variable Documentation

ntp_xfer_op

struct interface_operation ntp_xfer_op[]

static

Initial value:

= {
        INTF_OP ( xfer_deliver, struct ntp_client *, ntp_deliver ),
        INTF_OP ( xfer_window_changed, struct ntp_client *,
                  ntp_window_changed ),
        INTF_OP ( intf_close, struct ntp_client *, ntp_close ),
}

Data transfer interface operations.

Definition at line 190 of file ntp.c.

                                                  {
        INTF_OP ( xfer_deliver, struct ntp_client *, ntp_deliver ),
        INTF_OP ( xfer_window_changed, struct ntp_client *,
                  ntp_window_changed ),
        INTF_OP ( intf_close, struct ntp_client *, ntp_close ),
};

ntp_xfer_desc

struct interface_descriptor ntp_xfer_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct ntp_client, xfer, ntp_xfer_op, job )

Data transfer interface descriptor.

Definition at line 198 of file ntp.c.

Referenced by start_ntp().

ntp_job_op

struct interface_operation ntp_job_op[]

static

Initial value:

= {
        INTF_OP ( intf_close, struct ntp_client *, ntp_close ),
}

Job control interface operations.

Definition at line 202 of file ntp.c.

                                                 {
        INTF_OP ( intf_close, struct ntp_client *, ntp_close ),
};

ntp_job_desc

struct interface_descriptor ntp_job_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct ntp_client, job, ntp_job_op, xfer )

Job control interface descriptor.

Definition at line 207 of file ntp.c.

Referenced by start_ntp().