semanage_list(3) SELinux managent API documentation semanage_list(3)NAME
SELinux Lists Management API
SYNOPSIS
The following list function is supported for any SELinux managent
record.
Replace the function and object name as necessary.
extern int LIST_FUNCTION (
semanage_handle_t *handle,
semanage_OBJECT_t ***objects,
unsigned int* count);
DESCRIPTION
Behavior:
The list function will return an array of all the objects in the
selected location.
Parameters:
The handle is used to track persistent state across semanage
calls, and for error reporting. The function will allocate and
populate the the array of objects, and store it at the location
pointed by objects. It will write the number of objects at the
location pointed by count. The array, and all its objects
become property of the caller. Each object must be freed with
semanage_OBJECT_free.
Requirements:
This function requires an semanage connection to be established
(see semanage_connect(3) )
RETURN VALUE
In case of failure, -1 is returned, and the semanage error callback is
invoked, describing the error. Otherwise a non-negative integer is
returned (a commit number). The same number will be returned by all
other semanage object read calls until the next commit.
SEE ALSOsemanage_handle_create(3), semanage_connect(3),
ivg2@cornell.edu 16 March 2006 semanage_list(3)
