|
Device Information Library Functions | di_prom_prop_lookup_bytes(3DEVINFO) |
| di_prom_prop_lookup_bytes, di_prom_prop_lookup_ints, di_prom_prop_lookup_strings - search for a PROM property |
SYNOPSIS
|
cc [ flag... ] file... -ldevinfo [ library... ]
#include <libdevinfo.h> int di_prom_prop_lookup_bytes(di_prom_handle_t ph, di_node_t node, const char *prop_name, uchar_t **prop_data); |
| int di_prom_prop_lookup_ints(di_prom_handle_t ph, di_node_t node, const char *prop_name, int **prop_data); |
| int di_prom_prop_lookup_strings(di_prom_handle_t ph, di_node_t node, const char *prop_name, char **prop_data); |
|
-
node
- Handle to device node in snapshot created by di_init(3DEVINFO).
-
ph
- Handle returned by di_prom_init(3DEVINFO).
-
prop_data
- For di_prom_prop_lookup_bytes(), the address of a pointer to an array of unsigned characters.
For di_prom_prop_lookup_ints(), the address of a pointer to an integer.
For di_prom_prop_lookup_strings(), the address of pointer to a buffer.
-
prop_name
- The name of the property being searched.
|
|
These functions return the value of a known PROM property name and value type and update the prop_data pointer to reference memory that contains the property value. All memory allocated by these functions is managed by the library and must not be freed by
the caller.
|
|
If the property is found, the number of entries in prop_data is returned. If the property is a boolean type, 0 is returned and the existence of this property indicates the value is true. Otherwise, -1 is returned and errno is set to indicate the error.
For di_prom_prop_lookup_bytes(), the number of entries is the number of unsigned characters contained in the buffer pointed to by prop_data.
For di_prom_prop_lookup_ints(), the number of entries is the number of integers contained in the buffer pointed to by prop_data.
For di_prom_prop_lookup_strings(), the number of entries is the number of null-terminated strings contained in the buffer. The strings are stored in a concatenated format in the buffer.
|
|
These functions will fail if::
-
EINVAL
- Invalid argument.
-
ENXIO
- The property does not exist.
|
|
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Interface Stability | Evolving |
MT-Level | Safe |
|
| |