System Event Library Functions syseventgetattrlist(3SYSEVENT)
NAME
syseventgetattrlist - get attribute list pointer
SYNOPSIS
cc [flag ...] file ... -lsysevent -lnvpair [library ...]
#include
#include
int syseventgetattrlist(syseventt *ev, nvlistt **attrlist);
PARAMETERS
ev handle to a system event
attrlist address of a pointer to attribute list
(nvlistt)
DESCRIPTION
The syseventgetattrlist() function updates attrlist to
point to a searchable name-value pair list associated with
the sysevent event, ev. The interface manages the alloca-
tion of the attribute list, but it is up to the caller to
free the list when it is no longer needed with a call to
nvlistfree(). See nvlistalloc(3NVPAIR).
RETURN VALUES
The syseventgetattrlist() function returns 0 if the
attribute list for ev is found to be valid. Otherwise it
returns -1 and sets errno to indicate the error.
ERORS
The syseventgetattrlist() function will fail if:
ENOMEM Insufficient memory available to allocate an
nvlist.
EINVAL Invalid sysevent event attribute list.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 12 Sep 2000 1
System Event Library Functions syseventgetattrlist(3SYSEVENT)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Evolving
MT-Level MT-Safe
SEE ALSO
syseventd(1M), nvlistalloc(3NVPAIR),
nvlistlookupboolean(3NVPAIR), attributes(5)
SunOS 5.11 Last change: 12 Sep 2000 2
|