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

# matchpathcon\_filespec\_add(3)

check and report whether any specification index has no matches with any inode. Maintenance and statistics on inode associations

Part of [matchpathcon\_checkmatches(3)](/matchpathcon_checkmatches/3.md).

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

## SYNOPSIS

**#include \<selinux/selinux.h\>**

**void matchpathcon\_checkmatches(char \****str***);**

**int matchpathcon\_filespec\_add(ino\_t** *ino***, int** *specind***, const char \****file***);**

**void matchpathcon\_filespec\_destroy(void);**

**void matchpathcon\_filespec\_eval(void);**

## DESCRIPTION

**matchpathcon\_checkmatches**() checks whether any specification has no matches and reports them. The *str* argument is used as a prefix for any warning messages.

**matchpathcon\_filespec\_add**() maintains an association between an inode *ino* and a specification index *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 *file* context configuration. Returns the specification index used or -1 on error.

**matchpathcon\_filespec\_destroy**() destroys any inode associations that have been added, e.g., to restart for a new filesystem.

**matchpathcon\_filespec\_eval**() displays statistics on the hash table usage for the inode associations.

## RETURN VALUE

Returns zero on success or -1 otherwise.

## SEE ALSO

[**selinux**(8)](/selinux/8.md), [**matchpathcon**(3)](/matchpathcon/3.md), [**matchpathcon\_index**(3)](/matchpathcon_index/3.md), [**freecon**(3)](/freecon/3.md), [**setfilecon**(3)](/setfilecon/3.md), [**setfscreatecon**(3)](/setfscreatecon/3.md)