.TH "matchpathcon_checkmatches" "3" "21 November 2009" "sds@tycho.nsa.gov" "SELinux API documentation"
.SH "NAME"
matchpathcon_checkmatches, matchpathcon_filespec_add, matchpathcon_filespec_destroy, matchpathcon_filespec_eval \- check and report whether any specification index has no matches with any inode. Maintenance and statistics on inode associations
.
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>
.sp
.BI "void matchpathcon_checkmatches(char *" str ");"
.sp
.BI "int matchpathcon_filespec_add(ino_t " ino ", int " specind ", const char *" file ");"
.sp
.BI "void matchpathcon_filespec_destroy(void);"
.sp
.BI "void matchpathcon_filespec_eval(void);"
.
.SH "DESCRIPTION"
.BR matchpathcon_checkmatches ()
checks whether any specification has no matches and reports them.
The
.I str
argument is used as a prefix for any warning messages.
.sp
.BR matchpathcon_filespec_add ()
maintains an association between an inode
.I ino
and a specification index
.IR specind ,
and checks whether a conflicting specification is already associated
with the same inode (e.g. due to multiple hard links). If so, then
it uses the latter of the two specifications based on their order in the 
.I file
context configuration. Returns the specification index used or \-1 on
error.
.sp
.BR matchpathcon_filespec_destroy ()
destroys any inode associations that have been added, e.g. to restart
for a new filesystem.
.sp
.BR matchpathcon_filespec_eval ()
displays statistics on the hash table usage for the inode associations.
.
.SH "RETURN VALUE"
Returns zero on success or \-1 otherwise.
.
.SH "SEE ALSO"
.ad l
.nh
.BR selinux "(8), " matchpathcon "(3), " matchpathcon_index "(3), " freecon "(3), " setfilecon "(3), " setfscreatecon "(3)"