semanage\_list(3) SELinux managent API documentation semanage\_list(3)

# [NAME](#NAME)

semanage\_list - SELinux Lists Management API

# [SYNOPSIS](#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](#DESCRIPTION)

[**Behavior:**](#Behavior:)

The list function will return an array of all the objects in the selected location.

[**Parameters:**](#Parameters:)

The *handle* is used to track persistent state across semanage calls, and for error reporting. The function will allocate and populate 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:**](#Requirements:)

This function requires an semanage connection to be established (see [**semanage\_connect**(3)](/man/os/libsemanage/semanage_connect.3) )

# [RETURN VALUE](#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](#SEE_ALSO)

[**semanage\_handle\_create**(3)](/man/os/libsemanage/semanage_handle_create.3), [**semanage\_connect**(3)](/man/os/libsemanage/semanage_connect.3),

16 March 2006 ivg2@cornell.edu

---

Document: semanage_bool_list(3) from libsemanage 3.11-r3 (Chainguard OS)
Source: https://github.com/SELinuxProject/selinux.git