Find a file
Benjamin Berg fc65055279 device: Always report selected finger if there is only one
If the user specified "any" finger, then we would mirror this back even
if there is only one finger available. Change it so that we act as if
that finger was passed explicitly, meaning we use the "verify" method
and also send the signal for the selected finger accordingly.
2021-09-15 15:00:14 +00:00
data device.policy: Fix permission dialogue titles 2021-09-02 17:14:07 +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 (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: Always report selected finger if there is only one 2021-09-15 15:00:14 +00:00
tests device: Always report selected finger if there is only one 2021-09-15 15:00:14 +00: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: Add patch to dependencies 2021-09-15 16:48:54 +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`.