NAME¶
semanage_list - 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 ALSO¶
semanage_handle_create(3),
semanage_connect(3),