Skip to content

Decouple BIGNUM from OSSL_FN in the design doc#31847

Open
levitte wants to merge 1 commit into
openssl:feature/ossl_fnfrom
levitte:feature/ossl_fn+2018+design-doc
Open

Decouple BIGNUM from OSSL_FN in the design doc#31847
levitte wants to merge 1 commit into
openssl:feature/ossl_fnfrom
levitte:feature/ossl_fn+2018+design-doc

Conversation

@levitte

@levitte levitte commented Jul 3, 2026

Copy link
Copy Markdown
Member

Update doc/designs/fixed-size-large-numbers.md to reflect the
decision in openssl/project#2018 to stop wrapping BN_ operator
functions around OSSL_FN_ operator functions
:

  • BN functions keep their current behaviour (size manipulation is
    fine within the BN "bubble").
  • BIGNUMOSSL_FN conversion now happens at top-level crypto call
    sites, where the embedded OSSL_FN is acquired and passed to
    OSSL_FN functions; the OSSL_FN size is immutable for the
    duration of those calls.
  • Removed the Wrapping an OSSL_FN function with a BIGNUM function
    section (the BN_add wrapper example) and related prose.
  • Dropped the Dropping top from BIGNUM section and the associated
    timing claim, since top will stay in BIGNUM.
  • Removed the now-stale TODO(FIXNUM) field-removal comments in
    crypto/bn (top/d/dmax/neg are not going away).

Doc-only by intent; the actual removal of existing BN_* wrapper code
is tracked separately under openssl/project#2020.

Parent decision: openssl/project#2018
Sub-issue: openssl/project#2019

Reflect the decision (openssl/project#2018) to stop wrapping BN_
operator functions around OSSL_FN_ operator functions: BN functions
keep their current behaviour, and BIGNUM<->OSSL_FN conversion
happens at top-level crypto call sites.  Also drop the "Dropping
top from BIGNUM" section and the stale TODO(FIXNUM) field-removal
comments, since `top` stays in BIGNUM.

Refs: openssl/project#2019
Assisted-by: Pi:z-ai/glm-5.2
Signed-off-by: Richard Levitte <levitte@openssl.foundation>
@levitte levitte force-pushed the feature/ossl_fn+2018+design-doc branch from 45a76ed to a14fb5d Compare July 3, 2026 16:06
@openssl-machine openssl-machine added the approval: review pending This pull request needs review by a committer label Jul 3, 2026
@levitte levitte added branch: feature The issue or PR is relevant only to one of the feature branches. no_news_changes_needed skip checks for the recommendation to add NEWS.md/CHANGES.md entries labels Jul 3, 2026
@levitte levitte moved this to Waiting Review in Development Board Jul 3, 2026
@levitte levitte closed this Jul 3, 2026
@github-project-automation github-project-automation Bot moved this from Waiting Review to Done in Development Board Jul 3, 2026
@levitte levitte reopened this Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approval: review pending This pull request needs review by a committer branch: feature The issue or PR is relevant only to one of the feature branches. no_news_changes_needed skip checks for the recommendation to add NEWS.md/CHANGES.md entries

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

OSSL_FN: stop wrapping BN functions around OSSL_FN - Update doc/designs/fixed-size-large-numbers.md

2 participants