• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

open-quantum-safe / liboqs / 42703200544
80%

Build:
DEFAULT BRANCH: main
Ran 09 Nov 2026 09:42PM UTC
Jobs 3
Files 2177
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

09 Nov 2026 09:30PM UTC coverage: 79.771% (+0.03%) from 79.744%
42703200544

push

github

web-flow
doc(kem): document caller length check responsibilities for FIPS 203 (#2647) (#2688)

* Document input buffer length requirements for KEM and signature APIs

The KEM, signature and stateful signature functions take keys, ciphertexts
and seeds as pointers without lengths, and implementations read exactly the
corresponding length_* bytes. The doc comments only described sizing the
output buffers, so nothing told callers that inputs must also be exactly the
documented length, or what happens if they are not: a shorter buffer is read
out of bounds, and an input of the wrong length (such as a key for a
different parameter set) may not be detected.

Document this for each affected input:
- KEM: public_key (encaps, encaps_derand), ciphertext and secret_key
  (decaps), seed (keypair_derand, encaps_derand)
- SIG: secret_key (sign, sign_with_ctx_str), public_key (verify,
  verify_with_ctx_str)
- SIG_STFL: public_key (verify). The stateful secret key is passed as an
  object, not a buffer, so sign is unaffected.

Also fix a typo ("signnature") in the OQS_SIG_sign comment.

Reported in #2647.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Douglas Stebila <dstebila@uwaterloo.ca>

* Note caller's FIPS 203 input type checks in ML-KEM datasheet

FIPS 203 Sections 7.2 and 7.3 require checking that the encapsulation key,
ciphertext and decapsulation key have the lengths specified for the
parameter set. The liboqs KEM API does not take input lengths, so these
checks fall to the caller. Add an advisory to the ML-KEM datasheet saying
so. It also notes that the mlkem-native implementations do perform the
other input checks (the modulus check on the encapsulation key and the hash
check on the decapsulation key) and return OQS_ERROR if they fail.

ml_kem.md regenerated with scripts/update_docs_from_yaml.py.

See #2647.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Douglas Stebila <dstebila@uwaterloo.ca>

---------

Signed-of... (continued)

170002 of 213112 relevant lines covered (79.77%)

5713535.19 hits per line

Coverage Regressions

Lines Coverage ∆ File
64
0.0
-100.0% src/kem/bike/additional_r4/decode_avx2.c
63
0.91
-19.09% src/common/sha3/xkcp_low/KeccakP-1600times4/avx2/KeccakP-1600-times4-SIMD256.c
46
0.0
-100.0% src/kem/bike/additional_r4/gf2x_mul_avx2.c
44
0.0
-100.0% src/kem/bike/additional_r4/gf2x_ksqr_avx2.c
22
0.0
-100.0% src/kem/bike/additional_r4/sampling_avx2.c
13
94.62
0.36% src/sig/sqisign/the-sqisign_sqisign_common/qlapoty.c
5
88.89
-7.94% src/kem/ml_kem/mlkem-native_ml-kem-768_ref/mlkem/src/sampling.c
3
96.44
-0.27% src/sig/falcon/pqclean_falcon-padded-1024_aarch64/keygen.c
3
96.44
-0.27% src/sig/falcon/pqclean_falcon-1024_aarch64/keygen.c
2
64.35
-0.46% src/sig/ml_dsa/mldsa-native_ml-dsa-44_ref/mldsa/src/sign.c
2
64.98
-0.46% src/sig/ml_dsa/mldsa-native_ml-dsa-87_aarch64/mldsa/src/sign.c
2
66.67
-33.33% src/kem/bike/additional_r4/cpu_features.h
1
96.49
-1.75% src/sig/ml_dsa/mldsa-native_ml-dsa-65_aarch64/mldsa/src/packing.c
1
76.99
0.88% src/kem/hqc/pqc-hqc_hqc-5_ref/vector.c
1
95.53
-0.09% src/sig/falcon/pqclean_falcon-padded-512_avx2/keygen.c
1
98.59
-1.41% usr/lib/gcc/x86_64-linux-gnu/15/include/avx2intrin.h
1
94.74
-1.75% src/sig/ml_dsa/mldsa-native_ml-dsa-87_x86_64/mldsa/src/packing.c
Jobs
ID Job ID Ran Files Coverage
1 x64-generic - 42703200544.1 09 Nov 2026 09:52PM UTC 1013
84.31
GitHub Action Run
2 x64-distbuild - 42703200544.2 09 Nov 2026 09:42PM UTC 1749
53.29
GitHub Action Run
3 arm64-distbuild - 42703200544.3 09 Nov 2026 09:49PM UTC 1433
59.87
GitHub Action Run
Source Files on build 42703200544
  • Tree
  • List 2177
  • Changed 42
  • Source Changed 0
  • Coverage Changed 42
Coverage ∆ File Lines Relevant Covered Missed Hits/Line
  • Back to Repo
  • Github Actions Build #42703200544
  • f1887f0d on github
  • Prev Build on main (#42703022149)
  • Next Build on main (#42725440927)
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE TRIAL · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc