Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
Utilities & Libraries
Devctl and Ioctl Commands
DCMD_PTPD_*
DCMD_PTPD_STATUS
Get the error status for the Precision Time Protocol

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX Tool Suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
- Graphics
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
  - C Library Reference
  - Devctl and Ioctl Commands
    - BIOC*
    - CAN_DEVCTL_*
    - DCMD_ALL_*
    - DCMD_BLK_*
    - DCMD_CAM_*
    - DCMD_CHR_*
    - DCMD_DUMPER_*
    - DCMD_F3S_*
    - DCMD_FSYS_*
    - DCMD_IP_*
    - DCMD_MEMMGR_*
    - DCMD_MISC_*
    - DCMD_MMCSD_*
    - DCMD_PROC_*
    - DCMD_PROF_*
    - DCMD_PTPD_*
      - DCMD_PTPD_DELAYMS
        Get the master-to-slave delay
      - DCMD_PTPD_DELAYSM
        Get the slave-to-master delay
      - DCMD_PTPD_GET_PDELAY_INTERVAL
        Get the pdelay interval
      - DCMD_PTPD_GET_TAI_UTC_OFFSET
        Get the offset from TAI to UTC
      - DCMD_PTPD_GET_TIME
        Get the current time
      - DCMD_PTPD_INFO
        Get the peer delay and neighbor rate ratio
      - DCMD_PTPD_SEND_SIGNALING_MSG
        Send a signaling message
      - DCMD_PTPD_SET_PDELAY_INTERVAL
        Set the pdelay interval
      - DCMD_PTPD_STATUS
        Get the error status for the Precision Time Protocol
    - DCMD_SDIO_*
    - DCMD_SDMMC_*
    - DCMD_SPI_*
    - PTP_*
    - FIO*
    - TC*
    - TIOC*
  - JSON Library Reference
  - PAM Reference
  - QNX Helpers Developer's Guide
    These libraries provide QNX helpers, including helpers that assist with logging, string conversion, and number and type sizes.
  - SPI Framework Technote
  - QNX Cryptography Library
    The QNX Cryptography Library (qcrypto) is a flexible cryptography framework that allows you to choose which cryptography provider responds to requests on a per-process basis.
  - QNX devcrypto Service
  - Utilities Reference
  - WPA Control Interface Reference
    This document provides a reference for the Wi-Fi Protected Access (WPA) control interface, which provides a C API for the WPA/IEEE 802.11i protocols in Wi-Fi client stations. Application developers who want to control WPA operations and get associated status and event data should read this reference.
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX OS in the Amazon cloud environment.
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
QNX Hypervisor User's Guide
This User's Guide explains the QNX hypervisor architecture and provides instructions for installing and running a QNX Hypervisor system, changing system components and configuration, and using hypervisor features such as virtual devices (vdevs).
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

DCMD_PTPD_STATUS

QNX SDP8.0Devctl and Ioctl CommandsDeveloper

Get the error status for the Precision Time Protocol

Synopsis:

#include <dcmd_ptpd.h>

#define DCMD_PTPD_STATUS   __DIOF(_DCMD_NET, 12, MyStatusInternal )

Arguments to devctl():


Argument	Value
`filedes`	A file descriptor that you obtained by opening /dev/ptpd
`dcmd`	DCMD_PTPD_STATUS
`dev_data_ptr`	A pointer to a MyStatusInternal
`n_bytes`	`sizeof(MyStatusInternal)`
`dev_info_ptr`	NULL

Description:

This command gets the status of the Precision Time Protocol.

Note:

To use this command, you must specify the -K option when you start ptpd2.

Input:

None.

Output:

A filled-in MyStatusInternal, which is defined in <dcmd_ptpd.h> as follows:

typedef uint32_t   MyStatusInternal;

The status is one of the following:

PTPD_STATUS_NO_ERROR: No error.
PTPD_STATUS_LINK_DOWN: The link is down.
PTPD_STATUS_GRANDMASTER_FAILURE: The root timing reference (the clock that all other clocks sychronize themselves to) failed.

Example:

See DCMD_PTPD_DELAYMS

See also:

DCMD_PTPD_DELAYMS, DCMD_PTPD_DELAYSM, DCMD_PTPD_GET_PDELAY_INTERVAL, DCMD_PTPD_GET_TAI_UTC_OFFSET, DCMD_PTPD_GET_TIME, DCMD_PTPD_INFO, DCMD_PTPD_SEND_SIGNALING_MSG, DCMD_PTPD_SET_PDELAY_INTERVAL

devctl() in the QNX OS C Library Reference

ptpd2 in the Utilities Reference

Page updated: August 11, 2025