1sysevent_get_attr_list(3SSYySsEtVeEmNTE)vent Library Fsuynscetvieonnts_get_attr_list(3SYSEVENT)
2
3
4

NAME

6       sysevent_get_attr_list - get attribute list pointer
7

SYNOPSIS

9       cc [flag ...]  file... -lsysevent  -lnvpair  [library ...]
10       #include <libsysevent.h>
11       #include <libnvpair.h>
12
13       int sysevent_get_attr_list(sysevent_t *ev, nvlist_t **attr_list);
14
15

PARAMETERS

17       ev           handle to a system event
18
19
20       attr_list    address of a pointer to attribute list (nvlist_t)
21
22

DESCRIPTION

24       The  sysevent_get_attr_list()  function updates attr_list to point to a
25       searchable name-value pair list associated with the sysevent event, ev.
26       The  interface  manages the allocation of the attribute list, but it is
27       up to the caller to free the list when it is no longer  needed  with  a
28       call to nvlist_free(). See nvlist_alloc(3NVPAIR).
29

RETURN VALUES

31       The  sysevent_get_attr_list()  function returns 0 if the attribute list
32       for ev is found to be valid. Otherwise it returns −1 and sets errno  to
33       indicate the error.
34

ERRORS

36       The sysevent_get_attr_list() function will fail if:
37
38       ENOMEM    Insufficient memory available to allocate an nvlist.
39
40
41       EINVAL    Invalid sysevent event attribute list.
42
43

ATTRIBUTES

45       See attributes(5) for descriptions of the following attributes:
46
47
48
49
50       ┌─────────────────────────────┬─────────────────────────────┐
51       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
52       ├─────────────────────────────┼─────────────────────────────┤
53       │Interface Stability          │Committed                    │
54       ├─────────────────────────────┼─────────────────────────────┤
55       │MT-Level                     │MT-Safe                      │
56       └─────────────────────────────┴─────────────────────────────┘
57

SEE ALSO

59       syseventd(1M),  nvlist_alloc(3NVPAIR),  nvlist_lookup_boolean(3NVPAIR),
60       attributes(5)
61

NOTES

63       The libsysevent interfaces do not work at all in non-global zones.
64
65
66
67SunOS 5.11                        24 Jul 2009sysevent_get_attr_list(3SYSEVENT)
Impressum