---
name: "semanage_bool_list"
section: "3"
platform: "linux"
package: "libsemanage-dev"
version: "3.8.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/semanage_list"
---

# semanage\_bool\_list(3)

SELinux Lists Management API

Part of [semanage\_list(3)](/semanage_list/3.md).

## 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 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),