selinux/libsemanage/man/man3/semanage_count.3
Manoj Srivastava a6700ba05f libsemanage: Fix the format of the NAME lines
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>
2009-11-27 12:51:57 -05:00

41 lines
1.2 KiB
Groff

.TH semanage_count 3 "16 March 2006" "ivg2@cornell.edu" "Libsemanage API documentation"
.SH "NAME"
semanage_count \- SELinux Management API
.SH "SYNOPSIS"
The following count function is supported for any semanage record.
.br
Replace the function and object name as necessary.
.B extern int COUNT_FUNCTION (
.br
.BI " semanage_handle_t *" handle ","
.br
.BI " unsigned int* " response ");"
.SH "DESCRIPTION"
.TP
.B Behavior:
The count function will return the number of all 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 number of objects will be stored at the location poined by
.I response.
.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), "