ofw_bus_status_okay(9)

ofw_bus_status_okay9

Check status of the device tree node

Usage

#include <dev/ofw/openfirm.h>

#include <dev/ofw/ofw_bus.h>

#include <dev/ofw/ofw_bus_subr.h>

const char *

ofw_bus_get_status(device_t dev);

int

ofw_bus_status_okay(device_t dev);

int

ofw_bus_node_status_okay(phandle_t node);

Overview

The "status" property of the device tree node indicates whether the device is enabled or not. Multiple hardware versions might be built using the same base System-on-Chip but with a different set of blocks enabled. It is common to use SoC device tree and only enable/disable device nodes for the derivative boards. The device tree node is considered enabled only if it has "status" property with the value set to either "ok" or "okay".

ofw_bus_get_status() returns the value of the "status" property of the device tree node associated with the device dev. If the node does not have "status" property or there is no node associated with the device the function returns NULL.

ofw_bus_status_okay() returns 1 if the device tree node associated with the device dev has "status" property and its value is either "ok" or "okay".

ofw_bus_node_status_okay() returns 1 if the device tree node node has "status" property and its value is either "ok" or "okay".

Releases

20 releases since FreeBSD 12.0-RELEASE; the text changed 6 times.

  1. 12.0
  2. 12.1
  3. 12.2
  4. 12.3
  5. 12.4
  6. 13.0–13.2
  7. 13.3–16.0

Authors

This manual page was written by Oleksandr Tymoshenko.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.