sleeping_kangaroo12 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e4aacaa549cb9d7beeef6977f03383868f29fb143cb35820a02fdbb8fa408ab1
+  data.tar.gz: e8c27359938bac4abebe69f71de89b4dcfad1880263c5f701af519e9c6a59741
+SHA512:
+  metadata.gz: e857ff9f05810ffb2f3ec55ef881f839563c7fe856f973075295b4ecd2cfa14ff864d32aaaadf4142a0fbea5fbef353077ef3a0cf8c58414bbed1eb81caee445
+  data.tar.gz: 7fa8d7a961a56d25aedd0371e75db9c24874c1812bafc43495084171762d93cc21ae3435fe68ce0f2aaa6caa6f38afb512b1ec7cd276202c372c62e1e44a1e62

data/README.md

@@ -0,0 +1,127 @@
+# SleepingKangaroo12
+
+## What is it?
+
+SleepingKangaroo12 is a Ruby binding of [KangarooTwelve](https://keccak.team/kangarootwelve.html), a fast cryptographic
+hash function by the team behind SHA-3.
+
+## Why not SHA-3?
+
+SHA-3 is relatively slow without special function hardware, partly due to [NIST](https://www.nist.gov/), the organizer
+of the SHA-3 competition, requested for a huge security margin from the candidates.
+
+[The team behind Keccak](https://keccak.team/), the winner of the SHA-3 competition, feels that SHA-3 is not at the
+sweet spot between trade-offs; they release a more performant, one-size-fit-all hash algorithm building on top of SHA-3
+primitives, the KangarooTwelve.
+
+Instead of making the function tunable like Keccak, they opinionatedly select the parameter for KangarooTwelve, so there
+is one and only one KangarooTwelve variant.
+
+## Why Sleeping?
+
+Other Ruby bindings existed before mine; I added the adjective to distinguish mine. Furthermore, I wrote this binding in
+pajamas, and I don't expect that I'll have the need to update this gem. From your perspective, it might look as if the
+gem is sleeping. :-D
+
+## What are specials?
+
+Many!  
+Just take a peek at the code, you'll notice that:
+
+- It builds on top of the [eXtended Keccak Code Package (XKCP)](https://github.com/XKCP/XKCP), an easy-to-use and highly
+  optimized library maintained by the Keccak team themselves.
+- The binding auto-select and detects CPU features on installation, it supports `AVX512`, `AVX2`, and `SSSE3`
+  instruction sets out of the box. And able to run on a machine without special instruction sets.
+- Thin and stable binding; designed by a proper software architect
+- Not limited to [Matz's Ruby Interpreter (MRI)](https://en.wikipedia.org/wiki/Ruby_MRI), this is due to the gem opting
+  for [Ruby-FFI](https://github.com/ffi/ffi) instead of native extensions.
+  (I only tested on MRI, though.)
+- Compared to other hash functions, this binding actually shipped with the optimized implementation. Some
+  other hash function might looks more performant on benchmarks, this may or may not translated to real-world
+  performance.
+
+## Prerequisites
+
+In order to install the gem, your machine should be ready to build the XKCP package. Which mean you should prepare:
+
+- GCC, the GNU Compiler Collection; our favorite
+- GNU make
+- xsltproc executable, normally comes with libxslt package
+- And for the sake of completeness: Ruby, Bundler, and Ruby related stuffs
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+~~~ruby
+gem 'sleeping_kangaroo12'
+~~~
+
+And then execute:
+
+    $ bundle install
+
+## Usage Examples
+
+Test vectors stolen
+from [konsolebox/digest-kangarootwelve-ruby](https://github.com/konsolebox/digest-kangarootwelve-ruby), another Ruby
+binding.
+
+~~~ruby
+# Shortcuts
+#
+::SleepingKangaroo12::Digest.digest('abc')
+# Output: "\xAB\x17O2\x8CU\xA5Q\v\v \x97\x91\xBF\x8B`\xE8\x01\xA7\xCF\xC2\xAAB\x04-\xCB\x8FT\x7F\xBE:}"
+#
+::SleepingKangaroo12::Digest.hexdigest('abc')
+# Output: "ab174f328c55a5510b0b209791bf8b60e801a7cfc2aa42042dcb8f547fbe3a7d"
+
+# Multiple updates
+#
+digest = ::SleepingKangaroo12::Digest.new
+digest.update('a')
+digest.update('b')
+digest.update('c')
+digest.hexdigest
+# Output: "ab174f328c55a5510b0b209791bf8b60e801a7cfc2aa42042dcb8f547fbe3a7d"
+
+# Hashing with a key, similar to HMAC
+# KangarooTwelve call the key "customization", it is the same thing, FYI
+#
+digest = ::SleepingKangaroo12::Digest.new(key: 'secret')
+digest << 'abc' # alternate form of update method
+digest.hexdigest
+# Output: "dc1fd53f85402e2b34fa92bd87593dd9c3fe6cc49d9db6c05dc0cf26c6a7e03f"
+# HMAC requires 2 parses of hashing, the customization is definitely faster
+
+# You can control the output length too
+#
+digest = ::SleepingKangaroo12::Digest.new(key: 'secret', output_length: 5)
+digest << 'abc'
+digest.hexdigest
+# Output: "dc1fd53f85"
+# This is marginally faster than truncating the output yourself.
+#
+digest = ::SleepingKangaroo12::Digest.new(key: 'secret', output_length: 64)
+digest << 'abc'
+digest.hexdigest
+# Output: "dc1fd53f85402e2b34fa92bd87593dd9c3fe6cc49d9db6c05dc0cf26c6a7e03fc4b18c621b57dbb8967094b160dbf22ee42402d7e3d45ecab4b02ef0db14b105"
+# The output is longer now, but the security claim is still the same.
+# (as 256-bit output length, which translated to the security level of 128-bit)
+
+# Weird parameters
+#
+digest = ::SleepingKangaroo12::Digest.new(key: 'secret', output_length: 1_000_000_000_000)
+# This will error; I arbitrary set the limit at 1MiB - 1 bytes as a safety measure. Same for length <= 0
+# If you have a use case for something out of range, feel free to discuss.
+# You are probably looking for a stream cipher instead of a hash function, though.
+
+# The options work with shortcuts too
+# 
+::SleepingKangaroo12::Digest.hexdigest('abc', key: 'secret')
+# Output: "dc1fd53f85402e2b34fa92bd87593dd9c3fe6cc49d9db6c05dc0cf26c6a7e03f"
+~~~
+
+## License
+
+SleepingKangaroo12 is released under the [BSD 3-Clause License](LICENSE.md). :tada:

data/ext/Rakefile

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'posix-spawn'
+require 'set'
+require_relative '../lib/sleeping_kangaroo12/build'
+
+platform = ::SleepingKangaroo12::Build::Platform.instance
+out_dir = "#{platform.arch}-#{platform.os}"
+lib_name = ::File.join(out_dir, platform.map_library_name('SleepingKangaroo12'))
+
+feature_set = ::POSIX::Spawn::Child.new('gcc -march=native -dM -E - < /dev/null').then(&:out).then do |output|
+  output.lines.select do |line|
+    line.include?('AVX') || line.include?('SSE') || line.include?('64')
+  end
+end.each_with_object(::Set.new) do |line, accumulator|
+  matched = /(\S+)\s+1\s*\z/.match(line)
+  next unless matched
+  accumulator << matched[1]
+end
+
+static_target = if feature_set.include?('__AVX512F__') && feature_set.include?('__AVX512VL__')
+  'libK12-avx512.a'
+elsif feature_set.include?('__AVX2__') && feature_set.include?('__SSSE3__')
+  'libK12-avx2-ssse3.a'
+elsif feature_set.include?('__AVX2__')
+  'libK12-avx2.a'
+elsif feature_set.include?('__LP64__') && feature_set.include?('__SSSE3__')
+  'libK12-ssse3-64.a'
+elsif feature_set.include?('__LP64__')
+  'libK12-generic-64.a'
+elsif feature_set.include?('__SSSE3__')
+  'libK12-ssse3.a'
+else
+  'libK12-generic.a'
+end
+
+xkcp_static_target = "xkcp/bin/#{static_target}"
+
+task default: [lib_name]
+
+file lib_name => FileList['bin/.build/sleeping_kangaroo12.o', xkcp_static_target] do |t|
+  ::FileUtils.mkdir_p(::File.dirname(t.name))
+  static_lib = t.prerequisites.last
+  static_lib_dir = ::File.dirname(static_lib)
+  static_lib_file = ::File.basename(static_lib)
+  sh "gcc -shared -o #{t.name} #{t.prerequisites.first} -L#{static_lib_dir} -l:#{static_lib_file} -lm -lc"
+end
+
+file 'bin/.build/sleeping_kangaroo12.o' => FileList['binding/sleeping_kangaroo12.c', xkcp_static_target] do |t|
+  sh "gcc -Wall -Wa,-adhln -O3 -march=native -I./xkcp/bin -c #{t.prerequisites.first} -o #{t.name}"
+end
+
+file xkcp_static_target => FileList['bin/.build/Makefile'] do |t|
+  file_name = ::File.basename(t.name)
+  sh "cd xkcp && make -f ../#{t.prerequisites.first} #{file_name}"
+end
+
+desc 'Generate XKCP\'s Makefile'
+file 'bin/.build/Makefile' => FileList['bin/.build/Makefile.expanded'] do |t|
+  ::FileUtils.mkdir_p(::File.dirname(t.name))
+  sh "cd xkcp && xsltproc --xinclude -o ../#{t.name} support/Build/ToGlobalMakefile.xsl ../#{t.prerequisites.last}"
+  # rewrite Makefile path
+  original_make = ::File.read(t.name)
+  modified_make = original_make.gsub(%r{(\s+)(bin/.build/Makefile)}, '\1../\2')
+  ::File.write(t.name, modified_make, mode: 'wb')
+end
+
+desc 'Expand XKCP\'s Makefile'
+file 'bin/.build/Makefile.expanded' => FileList['config/xkcp.build'] do |t|
+  ::FileUtils.mkdir_p(::File.dirname(t.name))
+  sh "cd xkcp && xsltproc --xinclude -o ../#{t.name} support/Build/ExpandProducts.xsl ../#{t.prerequisites.last}"
+end

data/ext/binding/sleeping_kangaroo12.c

@@ -0,0 +1,39 @@
+#if defined(__AVX512F__) && defined(__AVX512VL__)
+  #include "libK12-avx512.a.headers/KangarooTwelve.h"
+#elif defined(__AVX2__) && defined(__SSSE3__)
+  #include "libK12-avx2-ssse3.a.headers/KangarooTwelve.h"
+#elif defined(__AVX2__)
+  #include "libK12-avx2.a.headers/KangarooTwelve.h"
+#elif defined(__LP64__) && defined(__SSSE3__)
+  #include "libK12-ssse3-64.a.headers/KangarooTwelve.h"
+#elif defined(__LP64__)
+  #include "libK12-generic-64.a.headers/KangarooTwelve.h"
+#elif defined(__SSSE3__)
+  #include "libK12-ssse3.a.headers/KangarooTwelve.h"
+#else
+  #include "libK12-generic.a.headers/KangarooTwelve.h"
+#endif
+
+#include <stdlib.h>
+
+void * SleepingKangaroo12_Init(int outputLength) {
+  KangarooTwelve_Instance *retVal = malloc(sizeof (KangarooTwelve_Instance)); // TODO: check result
+  KangarooTwelve_Initialize(retVal, outputLength); // TODO: check result
+  return retVal;
+}
+
+int SleepingKangaroo12_Update(void *instance, const unsigned char *input, size_t inputByteLen) {
+  return KangarooTwelve_Update((KangarooTwelve_Instance *)instance, input, inputByteLen);
+}
+
+int SleepingKangaroo12_Final(void *instance, unsigned char *output, const unsigned char *customization, size_t customByteLen) {
+  return KangarooTwelve_Final((KangarooTwelve_Instance *)instance, output, customization, customByteLen);
+}
+
+int SleepingKangaroo12_Squeeze(void *instance, unsigned char *output, size_t customByteLen) {
+  return KangarooTwelve_Squeeze((KangarooTwelve_Instance *)instance, output, customByteLen);
+}
+
+void SleepingKangaroo12_Destroy(void *instance) {
+  free(instance);
+}

data/ext/config/xkcp.build

@@ -0,0 +1,17 @@
+<build all="all" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <xi:include href="../xkcp/lib/HighLevel.build"/>
+    <xi:include href="../xkcp/lib/LowLevel.build"/>
+
+    <fragment name="common">
+        <h>../xkcp/lib/common/align.h</h>
+        <h>../xkcp/lib/common/brg_endian.h</h>
+    </fragment>
+
+   <target name="libK12-generic.a" inherits="KangarooTwelve K1600-compact"/>
+   <target name="libK12-generic-64.a" inherits="KangarooTwelve K1600-plain-64bits-u6"/>
+   <target name="libK12-ssse3.a" inherits="KangarooTwelve K1600-compact K1600x2-SSSE3-u2"/>
+   <target name="libK12-ssse3-64.a" inherits="KangarooTwelve K1600-plain-64bits-u6 K1600x2-SSSE3-u2"/>
+   <target name="libK12-avx2.a" inherits="KangarooTwelve K1600-AVX2 K1600x4-AVX2-u12"/>
+   <target name="libK12-avx2-ssse3.a" inherits="KangarooTwelve K1600-AVX2 K1600x2-SSSE3-u2 K1600x4-AVX2-u12"/>
+   <target name="libK12-avx512.a" inherits="KangarooTwelve K1600-AVX512 K1600x2-AVX512-u12 K1600x4-AVX512-u12 K1600x8-AVX512-u12"/>
+</build>

data/ext/xkcp/LICENSE

@@ -0,0 +1 @@
+See in file README.markdown, after the line starting with "# Under which license is the KCP distributed?".

data/ext/xkcp/Makefile

@@ -0,0 +1,15 @@
+_list: Makefile.build support/Build/ToGlobalMakefile.xsl
+
+bin/.build/Makefile: bin/.build/Makefile.expanded
+	mkdir -p $(dir $@)
+	xsltproc --xinclude -o $@ support/Build/ToGlobalMakefile.xsl $<
+
+bin/.build/Makefile.expanded: Makefile.build
+	mkdir -p $(dir $@)
+	xsltproc --xinclude -o $@ support/Build/ExpandProducts.xsl $<
+
+-include bin/.build/Makefile
+
+.PHONY: clean
+clean:
+	rm -rf bin/

data/ext/xkcp/Makefile.build

@@ -0,0 +1,200 @@
+<?xml version="1.0"?>
+<!--
+The eXtended Keccak Code Package (XKCP)
+https://github.com/XKCP/XKCP
+
+Implementation by Gilles Van Assche and Ronny Van Keer, hereby denoted as "the implementer".
+
+For more information, feedback or questions, please refer to the Keccak Team website:
+https://keccak.team/
+
+To the extent possible under law, the implementer has waived all copyright
+and related or neighboring rights to the source code in this file.
+http://creativecommons.org/publicdomain/zero/1.0/
+-->
+<build all="all" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+    <xi:include href="lib/HighLevel.build"/>
+    <xi:include href="lib/LowLevel.build"/>
+    <xi:include href="tests/SUPERCOP/SUPERCOP.build"/>
+    <xi:include href="tests/NIST_LWC/NIST_LWC.build"/>
+    <xi:include href="doc/HOWTO-customize.build"/>
+
+    <!-- For the name of the targets, please see the end of this file. -->
+
+    <fragment name="common">
+        <h>lib/common/align.h</h>
+        <h>lib/common/brg_endian.h</h>
+    </fragment>
+
+    <!-- *** Utilities *** -->
+
+    <!-- The unit tests -->
+    <fragment name="UT" inherits="common">
+        <c>tests/UnitTests/main.c</c>
+        <c>tests/UnitTests/UT.c</c>
+        <h>tests/UnitTests/UT.h</h>
+        <c>tests/UnitTests/testPermutations.c</c>
+        <h>tests/UnitTests/testPermutations.h</h>
+        <inc>tests/UnitTests/testSnP.inc</inc>
+        <inc>tests/UnitTests/testPlSnP.inc</inc>
+        <c>tests/UnitTests/testSponge.c</c>
+        <inc>tests/UnitTests/testSponge.inc</inc>
+        <h>tests/UnitTests/testSponge.h</h>
+        <c>tests/UnitTests/testDuplex.c</c>
+        <inc>tests/UnitTests/testDuplex.inc</inc>
+        <h>tests/UnitTests/testDuplex.h</h>
+        <c>tests/UnitTests/testMotorist.c</c>
+        <inc>tests/UnitTests/testMotorist.inc</inc>
+        <h>tests/UnitTests/testMotorist.h</h>
+        <c>tests/UnitTests/testKeyakv2.c</c>
+        <inc>tests/UnitTests/testKeyakv2.inc</inc>
+        <h>tests/UnitTests/testKeyakv2.h</h>
+        <c>tests/UnitTests/testKetjev2.c</c>
+        <h>tests/UnitTests/testKetjev2.h</h>
+        <inc>tests/UnitTests/testKetjev2.inc</inc>
+        <c>tests/UnitTests/genKAT.c</c>
+        <h>tests/UnitTests/genKAT.h</h>
+        <c>tests/UnitTests/testPRG.c</c>
+        <inc>tests/UnitTests/testPRG.inc</inc>
+        <h>tests/UnitTests/testPRG.h</h>
+        <c>tests/UnitTests/testKangarooTwelve.c</c>
+        <h>tests/UnitTests/testKangarooTwelve.h</h>
+        <c>tests/UnitTests/testKravatte.c</c>
+        <h>tests/UnitTests/testKravatte.h</h>
+        <c>tests/UnitTests/testKravatteModes.c</c>
+        <h>tests/UnitTests/testKravatteModes.h</h>
+        <c>tests/UnitTests/testSP800-185.c</c>
+        <h>tests/UnitTests/testSP800-185.h</h>
+        <c>tests/UnitTests/testXoofff.c</c>
+        <h>tests/UnitTests/testXoofff.h</h>
+        <c>tests/UnitTests/testXoofffModes.c</c>
+        <h>tests/UnitTests/testXoofffModes.h</h>
+        <c>tests/UnitTests/testXoodyak.c</c>
+        <h>tests/UnitTests/testXoodyak.h</h>
+    </fragment>
+
+    <fragment name="UnitTests" inherits="All UT"/>
+
+
+    <!-- The benchmarking tool -->
+
+    <fragment name="BM" inherits="common">
+        <c>tests/Benchmarks/main.c</c>
+        <c>tests/Benchmarks/testPerformance.c</c>
+        <c>tests/Benchmarks/timing.c</c>
+        <h>tests/Benchmarks/timing.h</h>
+        <h>tests/Benchmarks/testPerformance.h</h>
+        <inc>tests/Benchmarks/timingSnP.inc</inc>
+        <inc>tests/Benchmarks/timingPlSnP.inc</inc>
+        <inc>tests/Benchmarks/timingSponge.inc</inc>
+        <inc>tests/Benchmarks/timingKeyak.inc</inc>
+        <c>tests/Benchmarks/testXooPerformance.c</c>
+        <h>tests/Benchmarks/testXooPerformance.h</h>
+        <inc>tests/Benchmarks/timingXooSnP.inc</inc>
+        <inc>tests/Benchmarks/timingXooPlSnP.inc</inc>
+        <gcc>-lm</gcc>
+    </fragment>
+
+    <fragment name="Benchmarks" inherits="All BM"/>
+
+    <!-- To compute a hash of a file -->
+    <fragment name="KeccakSum" inherits="FIPS202 SP800-185 KangarooTwelve">
+        <c>util/KeccakSum/KeccakSum.c</c>
+        <c>util/KeccakSum/base64.c</c>
+        <h>util/KeccakSum/base64.h</h>
+    </fragment>
+
+    <!-- To make a library -->
+    <fragment name="libXKCP.a" inherits="All"/>
+    <fragment name="libXKCP.so" inherits="All"/>
+
+    <!-- *** CAESAR-related targets *** -->
+
+    <fragment name="crypto_aead_test">
+        <h>tests/SUPERCOP/test_crypto_aead.h</h>
+        <c>tests/SUPERCOP/test_crypto_aead.c</c>
+    </fragment>
+
+    <!-- *** Targets *** -->
+
+    <fragment name="serial-fallbacks" inherits="K1600x2-on1 K1600x4-on1 K1600x8-on1 Xoodoox4-on1 Xoodoox8-on1 Xoodoox16-on1"/>
+
+    <!-- Reference implementations -->
+    <fragment name="reference" inherits="K200-ref K400-ref K800-ref K1600-ref-64bits serial-fallbacks Ket-SnP Xoodoo-ref">
+        <c>tests/UnitTests/displayIntermediateValues.c</c>
+        <h>tests/UnitTests/displayIntermediateValues.h</h>
+        <define>KeccakReference</define>
+        <gcc>-O</gcc>
+    </fragment>
+
+    <!-- Reference implementations dedicated to 32-bit platforms
+        (i.e., featuring bit interleaving for Keccak-p[1600]) -->
+    <fragment name="reference32bits" inherits="K200-ref K400-ref K800-ref K1600-ref-32bits serial-fallbacks Ket-SnP Xoodoo-ref">
+        <c>tests/UnitTests/displayIntermediateValues.c</c>
+        <h>tests/UnitTests/displayIntermediateValues.h</h>
+        <define>KeccakReference</define>
+        <define>KeccakReference32BI</define>
+        <gcc>-O</gcc>
+    </fragment>
+
+    <!-- Compact implementations -->
+    <fragment name="compact" inherits="K200-compact K400-ref K800-compact K1600-compact serial-fallbacks Ket-SnP Xoodoo-plain-ua"/>
+
+    <!-- Generically optimized 32-bit implementations -->
+    <fragment name="generic32" inherits="K200-ref K400-ref K800-plain-u2 K1600-plain-32bits-inplace serial-fallbacks Ket-SnP Xoodoo-plain-ua"/>
+    <!-- Generically optimized 32-bit implementations, featuring lane complementing -->
+    <fragment name="generic32lc" inherits="K200-ref K400-ref K800-plain-lcu2 K1600-plain-32bits-inplace serial-fallbacks Ket-SnP Xoodoo-plain-ua"/>
+
+    <!-- Generically optimized 64-bit implementations -->
+    <fragment name="generic64" inherits="K200-ref K400-ref K800-plain-ua K1600-plain-64bits-ua serial-fallbacks Ket-SnP Xoodoo-plain-ua"/>
+    <!-- Generically optimized 64-bit implementations, featuring lane complementing -->
+    <fragment name="generic64lc" inherits="K200-ref K400-ref K800-plain-lcua K1600-plain-64bits-lcua serial-fallbacks Ket-SnP Xoodoo-plain-ua"/>
+
+    <!-- Implementations selected for the processors that support the SSSE3 instruction set -->
+    <fragment name="SSSE3" inherits="K200-ref K400-ref K800-plain-lcua K1600-plain-64bits-lcua K1600x2-SSSE3-u2 K1600x4-on2 K1600x8-on2 Ket-SnP Xoodoo-SSE2 Xoodoox4-SSSE3 Xoodoox8-on1 Xoodoox16-on1"/>
+
+	<!-- Implementations selected for processors that support the AVX instruction set (e.g., Sandy Bridge microarchitectures) -->
+    <fragment name="AVX" inherits="K200-ref K400-ref K800-plain-lcua K1600-plain-64bits-lcua-shld K1600x2-SSSE3-ua K1600x4-on2 K1600x8-on2 Ket-SnP Xoodoo-SSE2 Xoodoox4-SSSE3 Xoodoox8-on1 Xoodoox16-on1">
+        <msvc>/arch:AVX</msvc>
+    </fragment>
+    <!-- Implementations selected for processors that support the XOP instruction set (e.g., Bulldozer microarchitecture) -->
+    <fragment name="XOP" inherits="K200-ref K400-ref K800-plain-lcua K1600-XOP-ua K1600x2-XOP-ua K1600x4-on2 K1600x8-on2 Ket-SnP Xoodoo-SSE2 Xoodoox4-SSSE3 Xoodoox8-on1 Xoodoox16-on1"/>
+    <!-- Implementations selected for processors that support the AVX2 instruction set (e.g., Haswell and Skylake microarchitectures) -->
+    <fragment name="AVX2" inherits="K200-ref K400-ref K800-plain-ua K1600-AVX2 K1600x2-SSSE3-u2 K1600x4-AVX2-u12 K1600x8-on4 Ket-SnP Xoodoo-SSE2 Xoodoox4-SSSE3 Xoodoox8-AVX2 Xoodoox16-on1"/>
+    <!-- Same, but without the assembly file (for MS Visual Studio) -->
+    <fragment name="AVX2noAsm" inherits="K200-ref K400-ref K800-plain-ua K1600-plain-64bits-ua K1600x2-SSSE3-u2 K1600x4-AVX2-u12 K1600x8-on4 Ket-SnP Xoodoo-SSE2 Xoodoox4-SSSE3 Xoodoox8-AVX2 Xoodoox16-on1">
+        <msvc>/arch:AVX2</msvc>
+    </fragment>
+
+    <!-- Implementations selected for the processors that support the AVX-512 instruction set (e.g., SkylakeX microarchitecture) -->
+    <fragment name="AVX512"  inherits="K200-ref K400-ref K800-plain-ua K1600-AVX512 K1600x2-AVX512-u12 K1600x4-AVX512-u12 K1600x8-AVX512-u12 Ket-SnP Xoodoo-AVX512 Xoodoox4-AVX512 Xoodoox8-AVX512 Xoodoox16-AVX512"/>
+    <!-- Same, but without the assembly file (for MS Visual Studio) -->
+    <fragment name="AVX512noAsm"  inherits="K200-ref K400-ref K800-plain-ua K1600-AVX512-C K1600x2-AVX512-u12 K1600x4-AVX512-u12 K1600x8-AVX512-u12 Ket-SnP Xoodoo-AVX512 Xoodoox4-AVX512 Xoodoox8-AVX512 Xoodoox16-AVX512">
+        <msvc>/arch:AVX512</msvc>
+    </fragment>
+
+    <!-- Implementations selected for ARMv6 -->
+    <fragment name="ARMv6" inherits="K200-ARMv6M K400-ARMv6M K800-ARMv6M-u2 K1600-ARMv6M-u2 serial-fallbacks Ket-SnP Xoodoo-ARMv6"/>
+    <!-- Implementations selected for ARMv6M -->
+    <fragment name="ARMv6M" inherits="K200-ARMv6M K400-ARMv6M K800-ARMv6M-u2 K1600-ARMv6M-u2 serial-fallbacks Ket-SnP Xoodoo-ARMv6M"/>
+    <!-- Implementations selected for ARMv7M -->
+    <fragment name="ARMv7M" inherits="K200-ARMv7M K400-ARMv7M K800-ARMv7M-u2 K1600-ARMv7M-inplace serial-fallbacks Ket-ARMv7M Xoodoo-ARMv7M"/>
+    <!-- Implementations selected for ARMv7A -->
+    <fragment name="ARMv7A" inherits="K200-ref K400-ref K800-ARMv7A-u2 K1600-ARMv7A-NEON K1600x2-ARMv7A-NEON K1600x4-on2 K1600x8-on2 Ket-optimizedLE Xoodoo-ARMv7A-NEON Xoodoox4-ARMv7A-NEON Xoodoox8-on1 Xoodoox16-on1"/>
+
+    <!-- Implementations selected for ARMv8A -->
+    <fragment name="ARMv8A" inherits="K200-ref K400-ref K800-plain-ua K1600-plain-64bits-ua serial-fallbacks Ket-optimizedLE Xoodoo-plain-ua"/>
+
+    <!-- Implementations selected for 8-bit AVR -->
+    <fragment name="AVR8" inherits="K200-AVR8 K400-AVR8 K800-AVR8 K1600-AVR8 serial-fallbacks Ket-SnP Xoodoo-AVR8"/>
+
+    <!-- Target names are of the form x/y where x is taken from the first set and y from the second set. -->
+    <group all="XKCP">
+        <product delimiter="/">
+            <factor set="reference reference32bits compact generic32 generic32lc generic64 generic64lc SSSE3 AVX XOP AVX2 AVX2noAsm AVX512 AVX512noAsm ARMv6 ARMv6M ARMv7M ARMv7A ARMv8A AVR8"/>
+            <factor set="UnitTests Benchmarks KeccakSum libXKCP.a libXKCP.so libXKCP.dylib"/>
+        </product>
+    </group>
+
+</build>