1ptree_get_node_by_path(3PPIICCLLTRPElEu)g-In Library Fputnrcetei_ognest_node_by_path(3PICLTREE)
2
3
4

NAME

6       ptree_get_node_by_path - get handle of node specified by PICL tree path
7

SYNOPSIS

9       cc [ flag... ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_get_node_by_path(const char *ptreepath,
13            picl_nodehdl_t *nodeh);
14
15

DESCRIPTION

17       The  ptree_get_node_by_path() function copies the handle of the node in
18       the PICL tree specified by the path given in ptreepath into  the  loca‐
19       tion nodeh.
20
21
22       The syntax of a PICL tree path is:
23
24         [def_propname:]/[def_propval[match_cond] ... ]
25
26
27
28       where  def_propname  prefix is a shorthand notation to specify the name
29       of the property whose  value  is  specified  in  def_propval,  and  the
30       match_cond  expression specifies the matching criteria for that node in
31       the form of one or more pairs of property names and values such as
32
33         [@address][?prop_name[=prop_val] ... ]
34
35
36
37       where '@' is a shorthand notation to refer to the device address, which
38       is  followed  by  the device addres value address. The address value is
39       matched with the value of the property "bus-addr" if it exists.  If  no
40       "bus-addr"  property  exists,  then it is matched with the value of the
41       property "UnitAddress". Use the '?' notation to  limit  explicitly  the
42       comparison  to  "bus-addr"  or  "UnitAddress" property.  The expression
43       following '?' specifies matching property name and value  pairs,  where
44       prop_name gives the property name and prop_val gives the property value
45       for non PICL_PTYPE_VOID properties. The values for properties  of  type
46       PICL_PTYPE_TABLE, PICL_PTYPE_BYTEARRAY, and PICL_PTYPE_REFERENCE cannot
47       be specified in the match_cond expression.
48
49
50       A "_class" property value of "picl" may be used to match nodes  of  all
51       PICL classes.
52
53
54       All valid paths must start at the root node denoted by '/'.
55
56
57       If no prefix is specified for the path, then the prefix defaults to the
58       "name" property.
59

RETURN VALUES

61       Upon successful completion, 0 is returned. On failure,  a  non-negative
62       integer is returned to indicate an error.
63
64
65       PICL_NOTNODE is returned if there is no node corresponding to the spec‐
66       ified path.
67

ERRORS

69       PICL_INVALIDARG    Invalid argument
70
71
72       PICL_NOTNODE       Not a node
73
74
75       PICL_FAILURE       General system failure
76
77

ATTRIBUTES

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

SEE ALSO

93       ptree_get_propval_by_name(3PICLTREE), attributes(5)
94
95
96
97SunOS 5.11                        1 Aug 2000 ptree_get_node_by_path(3PICLTREE)
Impressum