di_prom_prop_data(3devinfo)

1di_prom_prop_data(3DEVDIeNvFiOc)e Information Library Funcdtii_opnrsom_prop_data(3DEVINFO)
2
3
4

NAME

6       di_prom_prop_data,  di_prom_prop_next,  di_prom_prop_name - access PROM
7       device information
8

SYNOPSIS

10       cc [ flag... ] file... -ldevinfo [ library... ]
11       #include <libdevinfo.h>
12
13       di_prom_prop_t di_prom_prop_next(di_prom_handle_t ph, di_node_t node,
14            di_prom_prop_t prom_prop);
15
16
17       char *di_prom_prop_name(di_prom_prop_t prom_prop);
18
19
20       int di_prom_prop_data(di_prom_prop_t prom_prop, uchar_t **prop_data);
21
22

PARAMETERS

24       node         Handle to a device node in the snapshot of  kernel  device
25                    tree.
26
27
28       ph           PROM handle
29
30
31       prom_prop    Handle to a PROM property.
32
33
34       prop_data    Address of a pointer.
35
36

DESCRIPTION

38       The  di_prom_prop_next() function obtains a handle to the next property
39       on the PROM  property  list  associated  with  node.  If  prom_prop  is
40       DI_PROM_PROP_NIL, the first property associated with node is returned.
41
42
43       The  di_prom_prop_name()  function  returns  the  name of the prom_prop
44       property.
45
46
47       The di_prom_prop_data() function returns the  value  of  the  prom_prop
48       property.  The  return  value  is a non-negative integer specifying the
49       size in number of bytes in prop_data.
50
51
52       All memory allocated by these functions is managed by the  library  and
53       must not be freed by the caller.
54

RETURN VALUES

56       The  di_prom_prop_data()  function  returns  the  number  of  bytes  in
57       prop_data and prop_data is updated to point to a byte array  containing
58       the  property value. If  0 is returned, the property is a boolean prop‐
59       erty and the existence of this property indicates the value is true.
60
61
62       The di_prom_prop_name() function returns a pointer  to  a  string  that
63       contains the name of prom_prop.
64
65
66       The  di_prom_prop_next()  function  returns  a  handle to the next PROM
67       property. DI_PROM_PROP_NIL is  returned  if  no  additional  properties
68       exist.
69

ERRORS

71       See openprom(7D) for a description of possible errors.
72

ATTRIBUTES

74       See attributes(5) for descriptions of the following attributes:
75
76
77
78
79       ┌─────────────────────────────┬─────────────────────────────┐
80       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
81       ├─────────────────────────────┼─────────────────────────────┤
82       │Interface Stability          │Evolving                     │
83       ├─────────────────────────────┼─────────────────────────────┤
84       │MT-Level                     │Safe                         │
85       └─────────────────────────────┴─────────────────────────────┘
86