oqs-sys 0.11.0+liboqs-0.13.0

Bindings to liboqs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

/* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * SPDX-License-Identifier: Apache-2.0"
 *
 * Written by Nir Drucker, Shay Gueron and Dusan Kostic,
 * AWS Cryptographic Algorithms Group.
 */

#pragma once

#include "cpu_features.h"
#include "defs.h"
#include "types.h"

// Rotate right the first R_BITS of a syndrome.
// At input, the syndrome is stored as three R_BITS triplicate.
// (this makes rotation easier to implement)
// For the output: the output syndrome has only one R_BITS rotation, the remaining
// (2 * R_BITS) bits are undefined.
void rotate_right_port(OUT syndrome_t *out,
                       IN const syndrome_t *in,
                       IN uint32_t          bitscount);
void dup_port(IN OUT syndrome_t *s);
void bit_sliced_adder_port(OUT upc_t *upc,
                           IN OUT syndrome_t *rotated_syndrome,
                           IN const size_t    num_of_slices);
void bit_slice_full_subtract_port(OUT upc_t *upc, IN uint8_t val);

#if defined(X86_64)
void rotate_right_avx2(OUT syndrome_t *out,
                       IN const syndrome_t *in,
                       IN uint32_t          bitscount);
void rotate_right_avx512(OUT syndrome_t *out,
                         IN const syndrome_t *in,
                         IN uint32_t          bitscount);
void dup_avx2(IN OUT syndrome_t *s);
void dup_avx512(IN OUT syndrome_t *s);

void bit_sliced_adder_avx2(OUT upc_t *upc,
                           IN OUT syndrome_t *rotated_syndrome,
                           IN const size_t    num_of_slices);
void bit_sliced_adder_avx512(OUT upc_t *upc,
                             IN OUT syndrome_t *rotated_syndrome,
                             IN const size_t    num_of_slices);

void bit_slice_full_subtract_avx2(OUT upc_t *upc, IN uint8_t val);
void bit_slice_full_subtract_avx512(OUT upc_t *upc, IN uint8_t val);
#endif

// Decode methods struct
typedef struct decode_ctx_st {
  void (*rotate_right)(OUT syndrome_t *out,
                       IN const syndrome_t *in,
                       IN uint32_t          bitscount);
  void (*dup)(IN OUT syndrome_t *s);
  void (*bit_sliced_adder)(OUT upc_t *upc,
                           IN OUT syndrome_t *rotated_syndrom,
                           IN const size_t    num_of_slices);
  void (*bit_slice_full_subtract)(OUT upc_t *upc, IN uint8_t val);
} decode_ctx;

_INLINE_ void decode_ctx_init(decode_ctx *ctx)
{
#if defined(X86_64)
#if defined(OQS_DIST_X86_64_BUILD) || defined(OQS_USE_AVX512_INSTRUCTIONS)
  if(is_avx512_enabled()) {
    ctx->rotate_right            = rotate_right_avx512;
    ctx->dup                     = dup_avx512;
    ctx->bit_sliced_adder        = bit_sliced_adder_avx512;
    ctx->bit_slice_full_subtract = bit_slice_full_subtract_avx512;
  } else 
#endif
#if defined(OQS_DIST_X86_64_BUILD) || defined(OQS_USE_AVX2_INSTRUCTIONS)
  if(is_avx2_enabled()) {
    ctx->rotate_right            = rotate_right_avx2;
    ctx->dup                     = dup_avx2;
    ctx->bit_sliced_adder        = bit_sliced_adder_avx2;
    ctx->bit_slice_full_subtract = bit_slice_full_subtract_avx2;
  } else
#endif
#endif
  {
    ctx->rotate_right            = rotate_right_port;
    ctx->dup                     = dup_port;
    ctx->bit_sliced_adder        = bit_sliced_adder_port;
    ctx->bit_slice_full_subtract = bit_slice_full_subtract_port;
  }
}