2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH PICL_FIND_NODE 3PICL "Feb 5, 2004"
8 picl_find_node \- find node with given property and value
12 cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-l\fR [ \fIlibrary\fR\&.\|.\|. ]
15 \fBint\fR \fBpicl_find_node\fR(\fBpicl_nodehdl_t\fR\fIrooth\fR, \fBchar *\fR\fIpname\fR,
16 \fBpicl_prop_type_t\fR \fIptype\fR, \fBvoid *\fR\fIpval\fR, \fBsize_t\fR \fIvalsize\fR,
17 \fBpicl_nodehdl_t *\fR\fIretnodeh\fR);
23 The \fBpicl_find_node()\fR function visits the nodes in the subtree under the
24 node specified by \fIrooth\fR. The handle of the node that has the property
25 whose name, type, and value matches the name, type, and value specified in
26 \fIpname\fR, \fIptype\fR, and \fIpval\fR respectively, is returned in the
27 location given by \fIretnodeh\fR. The \fIvalsize\fR argument specifies the size
28 of the value in \fIpval\fR. The first \fIvalsize\fR number of bytes of the
29 property value is compared with \fIpval\fR.
33 Upon successful completion, 0 is returned. Otherwise a non-negative integer is
34 returned to indicate an error.
37 The value \fBPICL_NODENOTFOUND\fR is returned if no node that matches the
38 property criteria can be found.
43 \fB\fBPICL_FAILURE\fR\fR
46 General system failure
52 \fB\fBPICL_INVALIDHANDLE\fR\fR
61 \fB\fBPICL_NODENOTFOUND\fR\fR
70 \fB\fBPICL_NOTNODE\fR\fR
79 \fB\fBPICL_STALEHANDLE\fR\fR
88 See \fBattributes\fR(5) for descriptions of the following attributes:
96 ATTRIBUTE TYPE ATTRIBUTE VALUE
98 Interface Stability Evolving
106 \fBpicl_get_propinfo\fR(3PICL), \fBpicl_get_propval\fR(3PICL),
107 \fBpicl_get_propval_by_name\fR(3PICL), \fBpicl_get_prop_by_name\fR(3PICL),