Find a file
Benjamin Berg 53db534514 Create private copy of libfprint executable pages
This protects against side-channel attacks by evicting the libfprint
executable code from the CPU caches.
2021-08-16 14:11:44 +02:00
data Create private copy of libfprint executable pages 2021-08-16 14:11:44 +02:00
doc build: Add some linefeeds to generated XML files 2020-08-17 15:21:27 +02:00
pam pam: Immediately return verify-match/verify-no-match 2021-08-02 13:00:43 +02:00
po Translated using Weblate (French) 2021-07-25 14:04:40 +02:00
scripts scripts: Add uncrustify scripts for reformatting fprintd source code 2020-12-07 18:41:45 +01:00
src Create private copy of libfprint executable pages 2021-08-16 14:11:44 +02:00
tests Implement suspend/resume handling 2021-08-09 13:25:11 +02:00
utils utils/delete: Add ability to delete single user fingerprints by finger name 2021-03-03 19:51:07 +01:00
.git-blame-ignore-revs .git-blame-ignore-revs: Ignore formatting commit and add hint how to use it 2020-12-07 18:42:22 +01:00
.gitignore build: Remove autotools support 2020-02-05 16:54:54 +01:00
.gitlab-ci.yml ci: Conveniently expose coverage report 2021-07-31 11:53:33 +02:00
AUTHORS Add myself to the authors 2008-11-02 11:16:13 +00:00
code-of-conduct.md Add code of conduct document 2019-07-25 12:07:27 +02:00
config.h.in Create private copy of libfprint executable pages 2021-08-16 14:11:44 +02:00
COPYING Fix warnings during docs build 2008-12-10 00:54:27 +00:00
meson.build Create private copy of libfprint executable pages 2021-08-16 14:11:44 +02:00
meson_options.txt Create private copy of libfprint executable pages 2021-08-16 14:11:44 +02:00
NEWS Update for 1.92.0 2021-07-01 13:06:08 +02:00
README Switch to the Fedora weblate instance for translations 2021-07-01 13:11:20 +02:00
TODO TODO: Remove image transfer support 2018-05-31 17:28:19 +02:00

fprintd
=======

https://fprint.freedesktop.org/

Daemon to offer libfprint functionality over D-Bus
Might eat your kangaroo.

Written in C.

Licensed under the GPL version 2 or any later version (see COPYING).

A PAM login module is included in the 'pam' directory.

Translating
===========

fprintd and pam_fprintd are translated using weblate. Please visit
https://translate.fedoraproject.org/projects/fprintd/ to contribute
translations.

API use cases
=============

- User wants to use the fingerprint reader, and enroll
  his fingerprints, or remove some fingerprints from the database

- Administrator wants to enroll fingerprints for a particular user,
  or remove fingerprints for a particular user

- Laptop/desktop authentication:
  * Check for fingerprint devices
  * Check whether a particular user has any fingerprints enrolled
  * Verify a fingerprint for a particular user, or, if the device
  supports it, verify that the fingerprint matches against
  any of the fingerprints enrolled

- Point Of Sale authentication (in a bar, the fingerprint reader is
  used to see who accesses a particular point of sale/till, in place
  of PIN code authentication and/or tokens)
  * Given a list of users, verify which one has scanned their finger

Debugging
=========

To enable debug output run `systemctl edit fprintd.service` then enter:
```
[Service]
Environment=G_MESSAGES_DEBUG=all
```
Save the result and restart fprintd using `systemctl restart fprintd.service`.

After that, you can grab the logs using `journalctl -u fprintd.service`.