Home
QNX Hypervisor
The QNX Hypervisor allows you to run multiple OSs on a target system so you can separate critical and non-critical functions, support a wide variety of applications, and reduce hardware costs.
QNX Hypervisor for Safety Virtual Device Developer's API Reference
vdev-core.h
Definitions for vdevs
vdev_get_vdevpeer()
Retrieve or create the vdevpeer object associated with a vdev

QNX Momentics IDE User's Guide
This User's Guide describes version 7.1 of the Integrated Development Environment (IDE) that's part of the QNX Momentics 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 QNX Neutrino 7.1.
QNX Hypervisor
The QNX Hypervisor allows you to run multiple OSs on a target system so you can separate critical and non-critical functions, support a wide variety of applications, and reduce hardware costs.
- QNX Hypervisor for Safety User's Guide
- QNX Hypervisor for Safety Virtual Device Developer's Guide
- QNX Hypervisor for Safety Virtual Device Developer's API Reference
  - Function Safety
    This section provides an overview of the restrictions that may apply when using the functions in this API.
  - aarch64/vmid.h
    Definitions to access a guest's VMID (ARM)
  - abi.h
    Application binary interface (ABI) version of the vdev API
  - cdev.h
    Functions to create virtual character devices for guests
  - firmware.h
    Functions for working with the firmware components of the VM presented to the guest
  - gasp.h
    Functions for working in guest address spaces
  - guest.h
    Definitions for manipulating a guest system
  - hpci.h
    Host PCI interface for vdevs
  - hw_pci.h
    PCI support for vdevs
  - outpipe.h
    Definitions for the output pipe (outpipe)
  - types.h
    vdev API base types
  - utils.h
    Miscellaneous utility functions
  - vdev.h
    Source compatibility header file
  - vdev-core.h
    Definitions for vdevs
    - Definitions in vdev-core.h
      Preprocessor macro definitions for the vdev-core.h header file
    - guest_cpu_to_vrs()
      Convert an error from a vCPU read or a vCPU write into a status value
    - vdev_ctrl_assign_flags
      Flags for the VDEV_CTRL_ASSIGN operation
    - vdev_factory
      Data structure used for creating new vdev instances
    - vdev_factory_flags
      Flags controlling vdev creation
    - vdev_get_vdevpeer()
      Retrieve or create the vdevpeer object associated with a vdev
    - vdev_path()
      Fill in a PATH_MAX-sized buffer with a path identifying a vdev
    - vdev_pic_functions
      Extra information for PIC vdevs
    - vdev_pulse()
      Fill in a sigevent structure to invoke a vdev pulse routine on event delivery
    - vdev_ref_status
      Return status from the vdev_factory vread and vwrite functions, and with guest_instr_callback_func_t
    - vdev_register_factory()
      Add a virtual device (vdev) factory to the list of available vdev factories
    - vdev_register_for_system_pulse()
      Register a virtual device (vdev) to receive the specified pulse
    - vdev_s
      Virtual device (vdev) information
    - VDEV_SAFETY_* enum
      Specify if the vdev is a safety variant, and if so the safety variant version
    - vdev_string()
      Build a human-readable name for a vdev
    - vdev_thread_create()
      Create a thread for a vdev
    - vdev_thread_setname()
      Set the name of a thread associated to a vdev
    - vdev_verify_unique()
      Check whether a vdev of the same type already exists
  - vio.h
    Definitions for VIRTIO vdevs
  - vpci.h
    Definitions for virtual PCI devices
  - wdog.h
    Definitions to support virtual watchdog devices
  - x86_64/apic.h
    Definitions for the virtual APIC bus (x86)
- QNX Hypervisor User's Guide
QNX Software in the Cloud
QNX Software in the Cloud enables developers to use the QNX software in Amazon Web Services (AWS) and Microsoft Azure (Azure).
QNX Advanced Virtualization Frameworks User's Guide
This User's Guide is aimed at all systems integrators and developers who want to design and build embedded systems using the QNX Advanced Virtualization Frameworks.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation and explains how to obtain technical support.

vdev_get_vdevpeer()

Retrieve or create the vdevpeer object associated with a vdev

Synopsis:

#include <qvm/vdev-core.h>

qvm_vdevpeer_t* vdev_get_vdevpeer(vdev_t *vdp,
                                  const char *peer_path,
                                  unsigned flags)

Arguments:

vdp: A pointer to a vdev.
peer_path: A pointer to the path to the remote peer.
flags: Flags for the vdevpeer object's channel.

Returns:

A pointer to a vdevpeer object, or NULL in case of error.

Page updated: March 12, 2026