ntp_common.h File Reference

Definitions common to NTP client and server. More...

#include "core/net.h"

Go to the source code of this file.

Macros

#define NTP_PORT   123
 
#define NTP_MAX_MSG_SIZE   68
 
#define NTP_UNIX_EPOCH   2208988800U
 
#define NTP_KISS_CODE(a, b, c, d)   (((a) << 24) | ((b) << 16) | ((c) << 8) | (d))
 

Enumerations

enum  NtpLeapIndicator { NTP_LI_NO_WARNING = 0 , NTP_LI_LAST_MIN_HAS_61_SECS = 1 , NTP_LI_LAST_MIN_HAS_59_SECS = 2 , NTP_LI_ALARM_CONDITION = 3 }
 Leap indicator. More...
 
enum  NtpVersion { NTP_VERSION_1 = 1 , NTP_VERSION_2 = 2 , NTP_VERSION_3 = 3 , NTP_VERSION_4 = 4 }
 NTP version numbers. More...
 
enum  NtpMode {
  NTP_MODE_SYMMETRIC_ACTIVE = 1 , NTP_MODE_SYMMETRIC_PASSIVE = 2 , NTP_MODE_CLIENT = 3 , NTP_MODE_SERVER = 4 ,
  NTP_MODE_BROADCAST = 5
}
 Protocol modes. More...
 
enum  NtpKissCode {
  NTP_KISS_CODE_ACST = NTP_KISS_CODE('A', 'C', 'S', 'T') , NTP_KISS_CODE_AUTH = NTP_KISS_CODE('A', 'U', 'T', 'H') , NTP_KISS_CODE_AUTO = NTP_KISS_CODE('A', 'U', 'T', 'O') , NTP_KISS_CODE_BCST = NTP_KISS_CODE('B', 'C', 'S', 'T') ,
  NTP_KISS_CODE_CRYP = NTP_KISS_CODE('C', 'R', 'Y', 'P') , NTP_KISS_CODE_DENY = NTP_KISS_CODE('D', 'E', 'N', 'Y') , NTP_KISS_CODE_DROP = NTP_KISS_CODE('D', 'R', 'O', 'P') , NTP_KISS_CODE_RSTR = NTP_KISS_CODE('R', 'S', 'T', 'R') ,
  NTP_KISS_CODE_INIT = NTP_KISS_CODE('I', 'N', 'I', 'T') , NTP_KISS_CODE_MCST = NTP_KISS_CODE('M', 'C', 'S', 'T') , NTP_KISS_CODE_NKEY = NTP_KISS_CODE('N', 'K', 'E', 'Y') , NTP_KISS_CODE_RATE = NTP_KISS_CODE('R', 'A', 'T', 'E') ,
  NTP_KISS_CODE_RMOT = NTP_KISS_CODE('R', 'M', 'O', 'T') , NTP_KISS_CODE_STEP = NTP_KISS_CODE('S', 'T', 'E', 'P')
}
 Kiss codes. More...
 

Variables

typedef __packed_struct
 NTP timestamp representation. More...
 
uint32_t fraction
 
 NtpTimestamp
 
uint8_t vn
 
uint8_t li
 
uint8_t stratum
 
uint8_t poll
 
int8_t precision
 
uint32_t rootDelay
 
uint32_t rootDispersion
 
uint32_t referenceId
 
NtpTimestamp referenceTimestamp
 
NtpTimestamp originateTimestamp
 
NtpTimestamp receiveTimestamp
 
NtpTimestamp transmitTimestamp
 
 NtpHeader
 
uint8_t messageDigest [16]
 
 NtpAuthenticator
 

Detailed Description

Definitions common to NTP client and server.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
2.4.0

Definition in file ntp_common.h.

Macro Definition Documentation

◆ NTP_KISS_CODE

#define NTP_KISS_CODE (   a,
  b,
  c,
 
)    (((a) << 24) | ((b) << 16) | ((c) << 8) | (d))

Definition at line 45 of file ntp_common.h.

◆ NTP_MAX_MSG_SIZE

#define NTP_MAX_MSG_SIZE   68

Definition at line 40 of file ntp_common.h.

◆ NTP_PORT

#define NTP_PORT   123

Definition at line 38 of file ntp_common.h.

◆ NTP_UNIX_EPOCH

#define NTP_UNIX_EPOCH   2208988800U

Definition at line 42 of file ntp_common.h.

Enumeration Type Documentation

◆ NtpKissCode

Kiss codes.

The kiss codes can provide useful information for an intelligent client. These codes are encoded in four-character ASCII strings left justified and zero filled

Enumerator
NTP_KISS_CODE_ACST 

The association belongs to a anycast server.

NTP_KISS_CODE_AUTH 

Server authentication failed.

NTP_KISS_CODE_AUTO 

Autokey sequence failed.

NTP_KISS_CODE_BCST 

The association belongs to a broadcast server.

NTP_KISS_CODE_CRYP 

Cryptographic authentication or identification failed.

NTP_KISS_CODE_DENY 

Access denied by remote server.

NTP_KISS_CODE_DROP 

Lost peer in symmetric mode.

NTP_KISS_CODE_RSTR 

Access denied due to local policy.

NTP_KISS_CODE_INIT 

The association has not yet synchronized for the first time.

NTP_KISS_CODE_MCST 

The association belongs to a manycast server.

NTP_KISS_CODE_NKEY 

No key found.

NTP_KISS_CODE_RATE 

Rate exceeded.

NTP_KISS_CODE_RMOT 

Somebody is tinkering with the association from a remote host running ntpdc.

NTP_KISS_CODE_STEP 

A step change in system time has occurred.

Definition at line 102 of file ntp_common.h.

◆ NtpLeapIndicator

Leap indicator.

Enumerator
NTP_LI_NO_WARNING 
NTP_LI_LAST_MIN_HAS_61_SECS 
NTP_LI_LAST_MIN_HAS_59_SECS 
NTP_LI_ALARM_CONDITION 

Definition at line 57 of file ntp_common.h.

◆ NtpMode

enum NtpMode

Protocol modes.

Enumerator
NTP_MODE_SYMMETRIC_ACTIVE 
NTP_MODE_SYMMETRIC_PASSIVE 
NTP_MODE_CLIENT 
NTP_MODE_SERVER 
NTP_MODE_BROADCAST 

Definition at line 83 of file ntp_common.h.

◆ NtpVersion

enum NtpVersion

NTP version numbers.

Enumerator
NTP_VERSION_1 
NTP_VERSION_2 
NTP_VERSION_3 
NTP_VERSION_4 

Definition at line 70 of file ntp_common.h.

Variable Documentation

◆ __packed_struct

typedef __packed_struct
Initial value:
{
uint32_t seconds

NTP timestamp representation.

NTP authenticator.

NTP packet header.

Definition at line 133 of file ntp_common.h.

◆ fraction

uint32_t fraction

Definition at line 136 of file ntp_common.h.

◆ li

uint8_t li

Definition at line 153 of file ntp_common.h.

◆ messageDigest

uint8_t messageDigest[16]

Definition at line 175 of file ntp_common.h.

◆ NtpAuthenticator

NtpAuthenticator

Definition at line 176 of file ntp_common.h.

◆ NtpHeader

NtpHeader

Definition at line 165 of file ntp_common.h.

◆ NtpTimestamp

NtpTimestamp

Definition at line 137 of file ntp_common.h.

◆ originateTimestamp

NtpTimestamp originateTimestamp

Definition at line 162 of file ntp_common.h.

◆ poll

uint8_t poll

Definition at line 156 of file ntp_common.h.

◆ precision

int8_t precision

Definition at line 157 of file ntp_common.h.

◆ receiveTimestamp

NtpTimestamp receiveTimestamp

Definition at line 163 of file ntp_common.h.

◆ referenceId

uint32_t referenceId

Definition at line 160 of file ntp_common.h.

◆ referenceTimestamp

NtpTimestamp referenceTimestamp

Definition at line 161 of file ntp_common.h.

◆ rootDelay

uint32_t rootDelay

Definition at line 158 of file ntp_common.h.

◆ rootDispersion

uint32_t rootDispersion

Definition at line 159 of file ntp_common.h.

◆ stratum

uint8_t stratum

Definition at line 155 of file ntp_common.h.

◆ transmitTimestamp

NtpTimestamp transmitTimestamp

Definition at line 164 of file ntp_common.h.

◆ vn

uint8_t vn

Definition at line 152 of file ntp_common.h.