1picl_find_node(3PICL)       PICL Library Functions       picl_find_node(3PICL)
2
3
4

NAME

6       picl_find_node - find node with given property and value
7

SYNOPSIS

9       cc [ flag... ] file... -l [ library... ]
10       #include <picl.h>
11
12       int picl_find_node(picl_nodehdl_trooth, char *pname,
13            picl_prop_type_t ptype, void *pval, size_t valsize,
14            picl_nodehdl_t *retnodeh);
15
16

DESCRIPTION

18       The picl_find_node() function visits the nodes in the subtree under the
19       node specified by rooth. The handle of the node that has  the  property
20       whose name, type, and value matches the name, type, and value specified
21       in pname, ptype, and pval respectively, is  returned  in  the  location
22       given by retnodeh. The valsize argument specifies the size of the value
23       in pval. The first valsize number of bytes of  the  property  value  is
24       compared with pval.
25

RETURN VALUES

27       Upon  successful  completion,  0  is returned. Otherwise a non-negative
28       integer is returned to indicate an error.
29
30
31       The value PICL_NODENOTFOUND is returned if no  node  that  matches  the
32       property criteria can be found.
33

ERRORS

35       PICL_FAILURE          General system failure
36
37
38       PICL_INVALIDHANDLE    Invalid handle
39
40
41       PICL_NODENOTFOUND     Node not found
42
43
44       PICL_NOTNODE          Not a node
45
46
47       PICL_STALEHANDLE      Stale handle
48
49

ATTRIBUTES

51       See attributes(5) for descriptions of the following attributes:
52
53
54
55
56       ┌─────────────────────────────┬─────────────────────────────┐
57       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
58       ├─────────────────────────────┼─────────────────────────────┤
59       │Interface Stability          │Evolving                     │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │MT-Level                     │MT-Safe                      │
62       └─────────────────────────────┴─────────────────────────────┘
63

SEE ALSO

65       picl_get_propinfo(3PICL),    picl_get_propval(3PICL),    picl_get_prop‐
66       val_by_name(3PICL), picl_get_prop_by_name(3PICL), attributes(5)
67
68
69
70SunOS 5.11                        5 Feb 2004             picl_find_node(3PICL)
Impressum