Find a file
Benjamin Berg e4c155d5b8 tests: Give fprintd some more time to be ready
While the delay inhibitor is grabbed almost immediately, this can be
slow enough to not have happened immediately after the bus name has been
registered. Add a generous timeout to prevent issues.
2021-08-25 15:27:26 +02:00
data data: Allow access to hidraw devices 2021-08-20 13:59:06 +00: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 (Indonesian) 2021-08-17 04:04:53 +02:00
scripts scripts: Add uncrustify scripts for reformatting fprintd source code 2020-12-07 18:41:45 +01:00
src device: Remove local storage prints if they've been removed from device 2021-08-19 18:22:36 +02:00
tests tests: Give fprintd some more time to be ready 2021-08-25 15:27:26 +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 device: Re-define polkit auto-pointer funcs if not defined 2020-11-27 18:21:29 +01:00
COPYING Fix warnings during docs build 2008-12-10 00:54:27 +00:00
meson.build Release 1.94.0 2021-08-20 13:59:06 +00:00
meson_options.txt build: make systemd dependency optional 2020-12-11 15:01:24 +01:00
NEWS Release 1.94.0 2021-08-20 13:59:06 +00: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`.