fprintd-verify
Verify a fingerprint against enrolled fingerprints
TLDR
Verify all stored fingerprints for the current user
Verify a specific fingerprint for the current user
Verify fingerprints for a specific user
Verify a specific fingerprint for a specific user
Fail the process if a fingerprint doesn't match with ones stored in the database for the current user
Display help
SYNOPSIS
fprintd-verify [--finger FINGER] [--check-only]
PARAMETERS
-f, --finger FINGER
Verify only the specified finger (e.g., right-index-finger). See fprintd-enroll(1) for names.
--check-only
No prompting: exit 0 if verify possible, 1 otherwise.
DESCRIPTION
fprintd-verify is a command-line tool for the fprintd fingerprint authentication daemon on Linux. It verifies the current user's fingerprint by comparing scans from a connected reader against enrolled templates in the fprintd database.
By default, it interactively prompts the user to scan their finger one or more times until a match succeeds or the user aborts with Ctrl+C. This supports authentication workflows, such as PAM integration for login, sudo, or screen unlocking.
Key features include finger selection for precise verification and a non-interactive mode for scripts. Success relies on hardware compatibility, enrolled prints (via fprintd-enroll), and the daemon running as a system service.
Common in distributions like Fedora and Ubuntu with fingerprint support, it enhances biometric security where supported.
CAVEATS
Requires fprintd service active, enrolled prints, and compatible reader. May need multiple scans; fails silently on unsupported hardware.
EXIT STATUS
0: verified
1: failed/no match
2: user cancelled
USAGE EXAMPLE
fprintd-verify --finger left-index-finger
or fprintd-verify --check-only for scripts.
HISTORY
Part of libfprint/fprintd project since ~2010. Evolved for modern readers; integrated in major distros post-2015.
SEE ALSO
fprintd-enroll(1), fprintd-list(1), fprintd-delete(1), pam_fprintd(8)


