1picl_get_prop_by_name(3PICL)PICL Library Functionspicl_get_prop_by_name(3PICL)
2
3
4

NAME

6       picl_get_prop_by_name - get the handle of the property by name
7

SYNOPSIS

9       cc [ flag... ] file... -lpicl [ library... ]
10       #include <picl.h>
11
12       int picl_get_prop_by_name(picl_nodehdl_t nodeh, char *name,
13            picl_prophdl_t *proph);
14
15

DESCRIPTION

17       The picl_get_prop_by_name() function gets the handle of the property of
18       node nodeh whose name is specified in name. The handle is  copied  into
19       the location specified by proph.
20

RETURN VALUES

22       Upon  successful  completion, 0 is returned. On failure, a non-negative
23       integer is returned to indicate an error.
24
25
26       PICL_PROPNOTFOUND is returned if the property  of  the  specified  name
27       does not exist.
28
29
30       PICL_RESERVEDNAME  is returned if the property name specified is one of
31       the reserved property names.
32
33
34       PICL_STALEHANDLE is returned if the handle is  no  longer  valid.  This
35       occurs if the PICL tree was refreshed or reinitialized.
36
37
38       PICL_INVALIDHANDLE  is  returned if the specified handle never existed.
39       This error may be returned for a previously valid handle if the  daemon
40       was  brought down and restarted. When this occurs a client must revali‐
41       date any saved handles.
42

ERRORS

44       PICL_NOTINITIALIZED    Session not initialized
45
46
47       PICL_NORESPONSE        Daemon not responding
48
49
50       PICL_NOTNODE           Not a node
51
52
53       PICL_PROPNOTFOUND      Property not found
54
55
56       PICL_RESERVEDNAME      Reserved property name specified
57
58
59       PICL_INVALIDHANDLE     Invalid handle
60
61
62       PICL_STALEHANDLE       Stale handle
63
64
65       PICL_FAILURE           General system failure
66
67

ATTRIBUTES

69       See attributes(5) for descriptions of the following attributes:
70
71
72
73
74       ┌─────────────────────────────┬─────────────────────────────┐
75       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │MT-Level                     │MT-Safe                      │
78       └─────────────────────────────┴─────────────────────────────┘
79

SEE ALSO

81       attributes(5)
82
83
84
85SunOS 5.11                        28 Mar 2000     picl_get_prop_by_name(3PICL)
Impressum