Find a file
Leonardo Francisco f35dd0322a validity: externalize proprietary blob data to runtime-loaded files
Remove ~400KB of compiled-in .inc blob files and replace with a runtime
data loader that reads HMAC-SHA256 verified .bin files from disk at
device open time.

New components:
- validity_data.h/c: Runtime data file loader with HMAC-SHA256 integrity
  verification. Searches /usr/share/libfprint/validity/ and
  /usr/local/share/libfprint/validity/ for per-device and common data
  files. Skipped entirely in emulation mode.

Changes to existing code:
- validity.c: New OPEN_LOAD_DATA SSM state loads device and common data
  files between firmware info reception and init sequence. Populates TLS
  key pointers from loaded data. Frees data stores on close.
- validity_hal.h/c: Simplified device_table to vid/pid/flash_layout only
  (all blob pointers and partition_sig removed from structs).
- validity_pair.c/h: Updated make_cert, build_partition_flash_cmd,
  build_tls_flash to take data parameters instead of using compiled-in
  arrays. Reset/DBE blob accessors use data store.
- validity_tls.c/h: Removed 4 static key arrays, added pointer fields
  to ValidityTlsState populated from loaded data.
- validity_db.c/h, validity_fwext.c/h: Updated get_write_enable_blob
  to take FpiDeviceValidity* and access data store.
- validity_enroll.c: Updated all 5 callers for new signatures.

Deleted files:
- validity_blobs_0090.inc, validity_blobs_0097.inc,
  validity_blobs_009a.inc, validity_blobs_009d.inc (~400KB)
- validity_pair_constants.inc (~6KB)

Tests (171 total, all passing):
- 15 data loader tests covering: empty store, double-free safety,
  valid/corrupt/too-small/nonexistent file loading, tag enum,
  load_device with missing dir/missing mandatory file/valid files/
  corrupt HMAC, load_common with missing/valid files, enroll
  db_write_enable accessor with empty and populated stores.
- All existing unit and integration tests updated and passing.

The data files are distributed separately via the
libfprint-validity-data package.
2026-04-22 03:06:34 +00:00
.ci ci: Add ABI check 2019-08-05 20:05:13 +02:00
.gitlab-ci ci: Add PyGObject symbols 2026-02-10 06:33:00 +01:00
data validity: Add new driver for Validity/Synaptics VCSFW sensors 2026-04-22 03:06:34 +00:00
demo scripts/uncrustify: Use 2-spaces indentation for defines too 2025-02-20 15:50:46 +00:00
doc build: Stop using deprecated dep.get_pkgconfig_variable() method 2024-02-20 01:02:00 +01:00
examples examples/clear-storage: Remove local storage for devices without storage 2025-02-20 16:37:11 +01:00
libfprint validity: externalize proprietary blob data to runtime-loaded files 2026-04-22 03:06:34 +00:00
scripts scripts/uncrustify: Use 2-spaces indentation for defines too 2025-02-20 15:50:46 +00:00
tests validity: externalize proprietary blob data to runtime-loaded files 2026-04-22 03:06:34 +00:00
.git-blame-ignore-revs .git-blame-ignore-revs: Ignore formatting commit and add hint how to use it 2020-12-07 19:01:10 +01:00
.gitignore Revert "validity: uncrustify" 2026-04-22 03:06:34 +00:00
.gitlab-ci.yml ci: Make jobs interrumpible 2026-02-10 06:35:26 +01:00
AUTHORS AUTHORS: Update 2012-12-14 13:17:24 +01:00
code-of-conduct.md Add code of conduct document 2019-07-25 12:04:39 +02:00
COPYING upekts relicensing 2007-11-15 09:54:35 +00:00
gcovr.cfg gcovr: Add gcovr project configuration 2025-08-01 01:42:01 +02:00
HACKING.md HACKING: Clarify the intent of the license 2019-08-05 13:37:28 +02:00
INSTALL INSTALL: Update for Meson 2018-05-18 01:16:30 +02:00
MAINTAINERS Add MAINTAINERS file 2020-05-22 15:00:11 +02:00
meson.build validity: Add TLS session management (Iteration 2) 2026-04-22 03:06:34 +00:00
meson_options.txt tests: Add support for installed tests 2023-06-28 16:35:16 +02:00
NEWS Release 1.94.10 2026-02-10 03:18:14 +01:00
README.md README: Add contact information 2024-05-03 15:35:11 +02:00
THANKS Thanks to Greg and Martin from AuthenTec 2012-11-29 09:51:55 +01:00

LibFPrint

LibFPrint is part of the FPrint project.


Button Website Button Documentation

Button Supported Button Unsupported

Button Contribute Button Contributors

History

LibFPrint was originally developed as part of an academic project at the University Of Manchester.

It aimed to hide the differences between consumer fingerprint scanners and provide a single uniform API to application developers.

Goal

The ultimate goal of the FPrint project is to make fingerprint scanners widely and easily usable under common Linux environments.

License

Section 6 of the license states that for compiled works that use this library, such works must include LibFPrint copyright notices alongside the copyright notices for the other parts of the work.

LibFPrint includes code from NIST's NBIS software distribution.

We include Bozorth3 from the US Export Controlled distribution, which we have determined to be fine being shipped in an open source project.

Get in touch

  • IRC - #fprint @ irc.oftc.net
  • Matrix - #fprint:matrix.org bridged to the IRC channel
  • MailingList - low traffic, not much used these days

Badge License