fprintd-list
List enrolled fingerprint devices and prints
TLDR
List enrolled fingerprints for a specific user
List enrolled fingerprints for one or more users
Display help
SYNOPSIS
fprintd-list [username]
PARAMETERS
username
The username whose fingerprints are to be listed. If omitted, defaults to the currently logged-in user.
DESCRIPTION
The `fprintd-list` command is a utility provided by the fprintd (Fingerprint Authentication Daemon) project. Its primary function is to display a list of fingerprint identifiers enrolled for a particular user on the system. This allows administrators and users to verify which fingerprints are currently registered for authentication purposes. The output typically consists of a string identifying each stored fingerprint, which can be used in other fprintd commands. It's crucial for managing fingerprint authentication and ensuring the system accurately recognizes enrolled users.
Using fprintd-list helps troubleshoot fingerprint authentication issues by allowing users to confirm which fingerprints are valid and ready for use. If a fingerprint is not listed, it has not been correctly enrolled and fingerprint authentication will fail. This command is typically run in a terminal and requires the `fprintd` service to be running. It simplifies the process of determining which fingerprints are actively in use, facilitating troubleshooting and management of user authentication through fingerprint biometrics.
CAVEATS
Requires the `fprintd` service to be running and properly configured. Results depend on the installed fingerprint reader and enrollment status.
RETURN CODES
The command returns 0 on success and a non-zero value on failure. Failures can occur if the `fprintd` service is not running, the user does not have any enrolled fingerprints, or if there are issues communicating with the fingerprint reader.
HISTORY
The `fprintd` project was created to provide a standardized way to access fingerprint readers across different Linux distributions. `fprintd-list` is a component of this project, designed to allow users and administrators to manage enrolled fingerprints. The development aimed to provide a reliable and consistent way to identify existing fingerprints without exposing the raw fingerprint data.
SEE ALSO
fprintd-enroll(1), fprintd-verify(1)