Find a file
Benjamin Berg ca00118fc7 scripts: Update uncrustify configuration
The mod_full_brace_if_chain option needs an integer (we want method 1)
rather than a boolean.
2022-06-09 15:39:26 +02:00
data pam_fprintd: Support setting infinite max_tries 2022-02-24 16:11:13 +00:00
doc remove pointless copying of files into build directory 2022-01-11 21:27:30 -05:00
pam pam_fprintd: Support setting infinite max_tries 2022-02-24 16:11:13 +00:00
po Translated using Weblate (Chinese (Simplified) (zh_CN)) 2022-05-24 16:57:24 +02:00
scripts scripts: Update uncrustify configuration 2022-06-09 15:39:26 +02:00
src Don't try to clear storage on devices without internal storage 2022-05-01 00:37:01 +02:00
tests Permit build without pam_wrapper 2022-05-24 16:00:02 +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: Reference image directly for forks 2021-09-15 17:20:14 +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 Permit build without pam_wrapper 2022-05-24 16:00:02 +02:00
meson_options.txt meson: Add option to use libelogind for DBus 2022-05-24 15:39:07 +02:00
NEWS Release 1.94.2 2022-02-24 17:19:57 +01: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`.