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

NAME

6       picl_get_propinfo - get the information about a property
7

SYNOPSIS

9       cc [ flag... ] file... -lpicl [ library... ]
10       #include <picl.h>
11
12       int picl_get_propinfo(picl_prophdl_t proph,
13            picl_propinfo_t *pinfo);
14
15

DESCRIPTION

17       The  picl_get_propinfo()  function gets the information about the prop‐
18       erty specified by handle proph and copies it into the  location  speci‐
19       fied  by  pinfo.   The property information includes the property type,
20       access mode, size, and  the  name  of  the  property  as  described  on
21       libpicl(3PICL) manual page.
22
23
24       The maximum size of a property value is specified by PICL_PROPSIZE_MAX.
25       It is currently set to 512KB.
26

RETURN VALUES

28       Upon successful completion, 0 is returned. On failure,  a  non-negative
29       integer is returned to indicate an error.
30
31
32       PICL_STALEHANDLE  is  returned  if  the handle is no longer valid. This
33       occurs if the PICL tree was refreshed or reinitialized.
34
35
36       PICL_INVALIDHANDLE is returned if the specified handle  never  existed.
37       This  error may be returned for a previously valid handle if the daemon
38       was brought down and restarted. When this occurs a client must  revali‐
39       date any saved handles.
40

ERRORS

42       PICL_NOTINITIALIZED    Session not initialized
43
44
45       PICL_NORESPONSE        Daemon not responding
46
47
48       PICL_NOTPROP           Not a property
49
50
51       PICL_INVALIDHANDLE     Invalid handle specified
52
53
54       PICL_STALEHANDLE       Stale handle specifie
55
56
57       PICL_FAILURE           General system failure
58
59

ATTRIBUTES

61       See attributes(5) for descriptions of the following attributes:
62
63
64
65
66       ┌─────────────────────────────┬─────────────────────────────┐
67       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
68       ├─────────────────────────────┼─────────────────────────────┤
69       │MT-Level                     │MT-Safe                      │
70       └─────────────────────────────┴─────────────────────────────┘
71

SEE ALSO

73       libpicl(3PICL),         picl_get_propval(3PICL),         picl_get_prop‐
74       val_by_name(3PICL), attributes(5)
75
76
77
78SunOS 5.11                        28 Mar 2000         picl_get_propinfo(3PICL)
Impressum