mirror of
https://github.com/SELinuxProject/selinux
synced 2025-01-19 11:50:42 +00:00
a6700ba05f
Each manual page should start with a "NAME" section, which lists the name and a brief description of the page separated by "\-". These sections are parsed by "mandb" and stored in a database for the use of "apropos" and "whatis", so they must be in a certain format. These manual pages apparently use the wrong format and cannot be parsed by "mandb". This commit fixes that. Signed-off-by: Manoj Srivastava <srivasta@debian.org> Signed-off-by: Joshua Brindle <method@manicmethod.com>
47 lines
1.4 KiB
Groff
47 lines
1.4 KiB
Groff
.TH semanage_list 3 "16 March 2006" "ivg2@cornell.edu" "SELinux managent API documentation"
|
|
|
|
.SH "NAME"
|
|
semanage_list \- SELinux Lists Management API
|
|
|
|
.SH "SYNOPSIS"
|
|
The following list function is supported for any SELinux managent record.
|
|
.br
|
|
Replace the function and object name as necessary.
|
|
|
|
.B extern int LIST_FUNCTION (
|
|
.br
|
|
.BI " semanage_handle_t *" handle ","
|
|
.br
|
|
.BI " semanage_OBJECT_t ***" objects ","
|
|
.br
|
|
.BI " unsigned int* " count ");"
|
|
|
|
.SH "DESCRIPTION"
|
|
.TP
|
|
.B Behavior:
|
|
The list function will return an array of all the objects in the selected location.
|
|
|
|
.TP
|
|
.B Parameters:
|
|
The
|
|
.I 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
|
|
.I objects.
|
|
It will write the number of objects at the location pointed by
|
|
.I count.
|
|
The array, and all its objects become property of the caller. Each object must be freed with
|
|
.B semanage_OBJECT_free.
|
|
|
|
.TP
|
|
.B Requirements:
|
|
This function requires an semanage connection to be established (see
|
|
.BR semanage_connect "(3)"
|
|
)
|
|
|
|
.SH "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.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR semanage_handle_create "(3), " semanage_connect "(3), "
|