returns the phandle value of the first child of the

Zero is returned if there are no child nodes.

returns the phandle for the parent of the

.Fa node .

Zero is returned if

returns the phandle value of the next sibling of the

Zero is returned if there is no sibling node.

When a device tree node references another node, the driver may

need to get the device associated with the referenced node.

For instance, an Ethernet driver accessing a PHY device.

To make this possible, the kernel maintains a table that

adds a map entry from the effective phandle

If a mapping entry for

already exists, it is replaced with the new one.

returns a device_t instance associated with the effective phandle

returns the effective phandle associated with the device

If no such mapping exists, the function returns 0.

returns the phandle for the node specified by the

Returns -1 if the path cannot be found in the tree.

The return value should only be checked with equality

operators (equal to, not equal to) and not relational comparison

(less than, greater than).
There is a discrepancy between the IEEE 1275 standard and

the
.Fx Ns 's
internal representation of a phandle: IEEE 1275

requires the return value of this function to be -1 if the path

is not found.
But phandle_t is an unsigned type, so it cannot

be relationally compared with -1 or 0, which

Device nodes can have associated properties.

Properties consist of a name and a value.

A value is an array of zero or more bytes that encode certain

values or any combination of these types.

Properties with a zero-byte length value usually represent boolean

Properties with a zero-length value usually represent boolean

A byte array is encoded as a sequence of bytes and represents

A text string is a sequence of n printable characters.
It is

characters represented as bytes plus a terminating null character.

or 0 if the property exists but has no associated value.

If
.Fa propname
does not exist, -1 is returned.

copies a maximum of

The function returns the actual size of the value or -1 if the

copies a maximum of

then converts cell values from big-endian to host byte order.

The function returns the actual size of the value in bytes, or -1

must be a multiple of 4.

has a property specified by

or zero if the property does not exist.

If the property is found, the function copies a maximum of

The function returns the actual size in bytes of the value,

or -1 if the property does not exist.

If the property is found, the function copies a maximum of

then converts cell values from big-endian to host byte order.

The function returns the actual size in bytes of the value,

or -1 if the property does not exist.

allocates memory large enough to hold the

The function returns the actual size of the value and stores the

address of the allocated memory in

If the property has a zero-sized value,

The function returns -1 if the property does not exist or

The function might sleep when allocating memory.

allocates enough memory to hold the

The actual size of the value is returned and the

address of allocated memory is stored in

If the property has a zero-length value,

is set to NULL.

The function returns -1 if the property does not exist or

The function might sleep when allocating memory.

that was allocated by

or

copies a maximum of

.Fn OF_nextprop
copies
.Fa size
bytes of the name of the property following
.Fa propname

If the property does not exist, the function tries to create

For instance, a framebuffer controller may refer to a GPIO

For such implementations, the phandle is used by the kernel to

identify the node does not match the value of the cell property that

Otherwise, the effective phandle is equal to the kernel phandle.

returns the kernel phandle for the effective phandle

If one cannot be found or the OpenFirmware implementation

the input value.

returns the effective phandle for the kernel phandle

If one cannot be found or the OpenFirmware implementation

the input value.

bytes of the fully qualified path to the device tree node