Table of Contents

Get time and date via NTP

Synopsis

  ntp <host>

Examples

Get time and date from pool.ntp.org

  ntp pool.ntp.org

Description

Get the time and date from a Network Time Protocol (NTP) server.

This will affect only the time and date as used by iPXE. The underlying hardware clock will not be updated.

Command status

Success The time and date was successfully updated
Failure The time and date was not successfully updated

See also

Build options

This command is available only when the build option NTP_CMD is enabled.

Notes

You can use the unixtime setting to obtain the current UTC time after running the ntp command.

iPXE uses the time and date primarily for validating X.509 certificates. If your system clock is inaccurate, then iPXE may erroneously decide that a valid certificate has expired. You can use the ntp command to work around this problem, by fetching the time and date from an external NTP server. You should be aware that there is no security or authentication used for NTP, and so using the ntp command is effectively equivalent to ignoring the validity period of any X.509 certificates.

The NTP protocol requires that the system clock is already set within 34 years of the correct date. If the system clock is inaccurate by more than 34 years, then the ntp command will not be able to determine the current time and date.