Merge branch 'ubuntu24'

Author: gfiumara

elft_1_x/include/elft.h

@@ -1201,6 +1201,17 @@ namespace ELFT
 		 * The files pointed to by `referenceTemplates` **will not
 		 * exist** when SearchInterface is instantiated.
 		 *
+		 * @attention
+		 * Implementations may not write more than 1000 **total** files.
+		 *
+		 * @attention
+		 * Writing many files is detrimental to the performance of the
+		 * file system during this evaluation. It is strongly encouraged
+		 * to write a small number of large files to store the reference
+		 * database. *NIST reserves the right to reject the
+		 * implementation based on the file system requirements of the
+		 * reference database scheme employed.*
+		 *
 		 * @note
 		 * This method may use more than one thread.
 		 *
@@ -1298,6 +1309,10 @@ namespace ELFT
 		 * @return
 		 * Information about the result of executing the method.
 		 *
+		 * @attention
+		 * You should confirm that your database is fully loaded and all
+		 * files expected are present before returning.
+		 *
 		 * @warning
 		 * This method will be called after construction and should
 		 * **not** be called from an implementation's constructor. This
@@ -1308,7 +1323,6 @@ namespace ELFT
 		 * *after* this method returns! After calling this method, the
 		 * test application may `fork()`, allowing calls to search() to
 		 * share the contents of memory using copy-on-write semantics.
-
 		 *
 		 * @warning
 		 * **DO NOT MODIFY** the contents of the database on disk at any
@@ -1480,7 +1494,6 @@ namespace ELFT
 		 * call getIdentification() prior to creating an enrollment
 		 * database.
 		 *
-		 *
 		 * @note
 		 * A possible implementation might be:
 		 * `return (std::make_shared<SearchImplementation>(

elft_1_x/libelft/CMakeLists.txt

@@ -6,11 +6,11 @@
 # its use by other parties, and makes no guarantees, expressed or implied,
 # about its quality, reliability, or any other characteristic.
 
-cmake_minimum_required(VERSION 3.11)
+cmake_minimum_required(VERSION 3.28.3)
 
 project(elft_library)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
 add_library(elft SHARED)

elft_1_x/libelft_output/CMakeLists.txt

@@ -6,11 +6,11 @@
 # its use by other parties, and makes no guarantees, expressed or implied,
 # about its quality, reliability, or any other characteristic.
 
-cmake_minimum_required(VERSION 3.11)
+cmake_minimum_required(VERSION 3.28.3)
 
 project(elft_output_library)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
 add_library(elft_output SHARED)

elft_1_x/nullimpl/CMakeLists.txt

@@ -6,11 +6,11 @@
 # its use by other parties, and makes no guarantees, expressed or implied,
 # about its quality, reliability, or any other characteristic.
 
-cmake_minimum_required(VERSION 3.11)
+cmake_minimum_required(VERSION 3.28.3)
 
 project(elft_nullimpl)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
 # Discover name and version

elft_1_x/randimpl/CMakeLists.txt

@@ -6,11 +6,11 @@
 # its use by other parties, and makes no guarantees, expressed or implied,
 # about its quality, reliability, or any other characteristic.
 
-cmake_minimum_required(VERSION 3.11)
+cmake_minimum_required(VERSION 3.28.3)
 
 project(elft_randimpl)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
 # Discover name and version

elft_1_x/randimpl/elft_randimpl.cpp

@@ -143,7 +143,7 @@ ELFT::RandomImplementation::Util::readTemplate(
 	file.seekg(std::ifstream::beg);
 	file.read(reinterpret_cast<char*>(buf.data()), size);
 
-	return {{}, buf};
+	return {ReturnStatus{}, buf};
 }
 
 ELFT::ReturnStatus

elft_1_x/validation/CHECKSUMS

@@ -0,0 +1,8 @@
+SHA256 (../libelft/libelft.cpp) = 8ed0d1d2fdde0d959c187f1af4883c3408ba534dee66796416292e9d6858bed2
+SHA256 (../include/elft.h) = 638d3fd1b5bc80ba9ed05010faa3d44cf8794d8243ad9fd25f685ca419436930
+SHA256 (src/CMakeLists.txt) = 1e73c02ec694e1db65f533d45d0ca66d61b9c161b56d7d4b0f8bb3a5c7bd988c
+SHA256 (src/elft_validation.cpp) = de7d3812bf5a93ffa077b5ea3a5020549688ced0a9d5e70ad13304dc7addc9cc
+SHA256 (src/elft_validation.h) = 5de1a9f6c1b79539907131fc969dbff723248c7032b63807bc669847088419bd
+SHA256 (src/elft_validation_data.h) = 98dd1ac2b25f31c06ae68e92136e1441b157696dda78f643c0165426f8d4bdbd
+SHA256 (src/elft_validation_utils.h) = 7e7b8126c756e904877ffcf25901b1de8843adbbee9b9a13d0c626a8104f53e0
+SHA256 (validate) = 99f8ffb59391ee7b9fba9d408e03bda1261e579c48a1ab323d4c13ff2f4b1132

elft_1_x/validation/README.md

@@ -39,10 +39,11 @@ Requirements
    - Because organizations must agree to NIST Special Database terms and
      conditions, the required fingerprint imagery is not included in this GitHub
      repository. Request and download the data from our [requests website].
- * Ubuntu Server 20.04.03 LTS
+ * Ubuntu Server 24.04.3 LTS
    - Even if this is not the latest version of Ubuntu Server, it will be the
-     version used to run the evaluation. [Direct downloads] are available from
-     the [Ubuntu Mirrors] and directly from the [NIST Image Group].
+     version used to run the evaluation. Direct downloads are available from the
+     [Ubuntu Mirrors] ([🇺🇸 USA], [🇪🇺 Europe]) and directly from the [NIST
+     Image Group].
    - We **highly suggest** matching the exact versions of packages installed in
      our environment. A link to the names and versions of these pacakages is
      available.
@@ -102,14 +103,14 @@ $ export ELFT_REUSE_REFERENCE_TEMPLATES=NO
 $ export ELFT_REUSE_ENROLLMENT_DATABASES=NO
 $ ./validate
 ================================================================================
-|     ELFT Validation | Version 202201261021 | 26 Jan 2022 | 15:22:59 UTC      |
+|     ELFT Validation | Version 202508071622 | 07 Aug 2025 | 16:22:40 EDT      |
 ================================================================================
 Checking for required packages... [OKAY]
 Checking for previous validation attempts... [OKAY]
-Checking validation version... (connection failure) [SKIP]
-Checking OS and version... (Ubuntu Server 20.04.3 LTS (Focal Fossa)) [OKAY]
+Checking validation version... (202508071622) [OKAY]
+Checking OS and version... (Ubuntu Server 24.04.3 LTS (Noble Numbat)) [OKAY]
 Checking for unexpanded validation image tarballs... [DEFER]
- -> Expanding "elft_validation_images-202103120958.tar.xz"... [OKAY]
+ -> Expanding "elft_validation_images-202310021336.tar.xz"... [OKAY]
 Checking for unexpanded validation image tarballs... [OKAY]
 Looking for core library... (libelft_nullimpl_0001.so) [OKAY]
 Checking for known environment variables... [SHOW]
@@ -119,19 +120,21 @@ Checking for known environment variables... [SHOW]
 Checking for known environment variables... [OKAY]
 Building... [OKAY]
 Checking API version... [OKAY]
+Checking library name... [OKAY]
 Testing ExtractionInterface (probe)... [OKAY]
 Checking probe extraction logs... [WARN]
 
 ================================================================================
-| There are some (117) zero-byte probe templates. Please review:               |
+| There are some (117) unexpected zero-byte probe templates. Please review:    |
 | output/driver/extractionCreate-0.log                                         |
 ================================================================================
 Still checking probe extraction logs... [OKAY]
 Testing ExtractionInterface (reference)... [OKAY]
 Checking reference extraction logs... [WARN]
 
 ================================================================================
-| There are some (55) zero-byte reference templates. Please review:            |
+| There are some (55) unexpected zero-byte reference templates. Please         |
+| review:                                                                      |
 | output/driver/extractionCreate-1.log                                         |
 ================================================================================
 Still checking reference extraction logs... [OKAY]
@@ -140,10 +143,10 @@ Testing SearchInterface... [OKAY]
 Checking search logs (candidates)... [WARN]
 
 ================================================================================
-| There are some (117) searches that returned successfully, but did not        |
-| produce any candidates. Please review:                                       |
-| /mnt/hgfs/git/elft_public/elft_1_x/validation/output/driver/searchCandidates |
-| .log                                                                         |
+| There are some (124) searches that returned successfully, but did not        |
+| produce any candidates. This situation is converted to a failure to search   |
+| during analysis. Please review:                                              |
+| output/driver/searchCandidates.log                                           |
 ================================================================================
 Still checking search logs... [OKAY]
 Creating validation submission... (elft_validation_nullimpl_0001.tar.xz) [OKAY]
@@ -176,28 +179,16 @@ Creating validation submission... (elft_validation_nullimpl_0001.tar.xz) [OKAY]
 | Search Algorithm CBEFF Identifier = 0x0101                                   |
 ================================================================================
 
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-+ This script could not check online to ensure there are no updates            +
-+ available. NIST requires that ELFT submissions always use the latest         +
-+ version. Retrieve the latest version number by visiting the URL below and    +
-+ be sure it matches this version: 202201261021.                               +
-+                                                                              +
-+ https://github.com/usnistgov/elft/tree/master/elft_1_x/validation/VERSION    +
-+                                                                              +
-+ If these numbers don't match, visit our website to retrieve the latest       +
-+ version.                                                                     +
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-
 ================================================================================
 | You have successfully completed your part of ELFT validation. Please sign    |
 | and encrypt the file listed below (run './validate encrypt' for an example). |
 |                                                                              |
 |                     elft_validation_nullimpl_0001.tar.xz                     |
 |                                                                              |
-| Please attach both elft_validation_nullimpl_0001.tar.xz.asc and your public  |
-| key to an email addressed to elft@nist.gov.                                  |
+| Please upload both elft_validation_nullimpl_0001.tar.xz.asc and your public  |
+| key via https://pages.nist.gov/elft/upload                                   |
 ================================================================================
-Completed: 26 Jan 2022 | 15:23:44 UTC (Runtime: 45s)
+Completed: 07 Aug 2025 | 16:22:48 EDT (Runtime: 8s)
 ```
 </details>
 
@@ -291,8 +282,9 @@ The items in this repository are released in the public domain. See the
 
 [API]: https://pages.nist.gov/elft/elft_1_x/doc/api/
 [Ubuntu Mirrors]: https://launchpad.net/ubuntu/+cdmirrors
-[Direct downloads]: https://old-releases.ubuntu.com/releases/20.04.3/ubuntu-20.04.3-live-server-amd64.iso
-[NIST Image Group]: https://nigos.nist.gov/evaluations/ubuntu-20.04.3-live-server-amd64.iso
+[🇺🇸 USA]: https://mirror.math.princeton.edu/pub/ubuntu-iso/noble/ubuntu-24.04.3-live-server-amd64.iso
+[🇪🇺 Europe]: http://mirror.init7.net/ubuntu-releases/noble/ubuntu-24.04.3-live-server-amd64.iso
+[NIST Image Group]: https://nigos.nist.gov/evaluations/ubuntu-24.04.3-live-server-amd64.iso
 [lib/]: https://github.com/usnistgov/elft/blob/master/elft_1_x/validation/lib
 [../libelft/]: https://github.com/usnistgov/elft/blob/master/elft_1_x/libelft
 [../include/elft.h]: https://github.com/usnistgov/elft/blob/master/elft_1_x/include/elft.h

elft_1_x/validation/VERSION

@@ -1 +1 @@
-202404051110
+202508071622

elft_1_x/validation/src/CMakeLists.txt

@@ -6,12 +6,12 @@
 # its use by other parties, and makes no guarantees, expressed or implied,
 # about its quality, reliability, or any other characteristic.
 
-cmake_minimum_required(VERSION 3.11)
+cmake_minimum_required(VERSION 3.28.3)
 
 project(elft_validation)
 include(GNUInstallDirs)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 
 add_executable(elft_validation)