1semanage_list(3)      SELinux managent API documentation      semanage_list(3)
2
3
4

NAME

6       semanage_list - SELinux Lists Management API
7
8

SYNOPSIS

10       The  following  list  function  is  supported  for any SELinux managent
11       record.
12       Replace the function and object name as necessary.
13
14       extern int LIST_FUNCTION (
15            semanage_handle_t *handle,
16            semanage_OBJECT_t ***objects,
17            unsigned int* count);
18
19

DESCRIPTION

21       Behavior:
22              The list function will return an array of all the objects in the
23              selected location.
24
25
26       Parameters:
27              The  handle  is  used  to track persistent state across semanage
28              calls, and for error reporting. The function will  allocate  and
29              populate  the  array  of  objects,  and store it at the location
30              pointed by objects.  It will write the number of objects at  the
31              location  pointed  by  count.   The  array,  and all its objects
32              become property of the caller. Each object must  be  freed  with
33              semanage_OBJECT_free.
34
35
36       Requirements:
37              This  function requires an semanage connection to be established
38              (see semanage_connect(3) )
39
40

RETURN VALUE

42       In case of failure, -1 is returned, and the semanage error callback  is
43       invoked,  describing  the  error.   Otherwise a non-negative integer is
44       returned (a commit number). The same number will  be  returned  by  all
45       other semanage object read calls until the next commit.
46
47

SEE ALSO

49       semanage_handle_create(3), semanage_connect(3),
50
51
52
53ivg2@cornell.edu                 16 March 2006                semanage_list(3)