- Random123-1.09 Documentation

Classes | Defines | Typedefs | Enumerations | Functions

# ARS and AESNI Classes and Typedefs

## Classes
struct | aesni1xm128i_key_t
class | r123::AESNI1xm128i
class | r123::AESNI1xm128i_R< ROUNDS >
class | r123::ARS1xm128i_R< ROUNDS >
class | r123::ARS4x32_R< ROUNDS >
## Defines
#define | aesni4x32(c, k) aesni4x32_R(aesni4x32_rounds, c, k)
#define | ars1xm128i(c, k) ars1xm128i_R(ars1xm128i_rounds, c, k)
#define | ars4x32(c, k) ars4x32_R(ars4x32_rounds, c, k)
## Typedefs
typedef struct r123array1xm128i | aesni1xm128i_ctr_t
typedef struct r123array1xm128i | aesni1xm128i_ukey_t
typedef struct r123array4x32 | aesni4x32_ukey_t
typedef struct r123array4x32 | aesni4x32_ctr_t
typedef aesni1xm128i_key_t | aesni4x32_key_t
typedef struct r123array1xm128i | ars1xm128i_ctr_t
typedef struct r123array1xm128i | ars1xm128i_key_t
typedef struct r123array1xm128i | ars1xm128i_ukey_t
typedef struct r123array4x32 | ars4x32_ctr_t
typedef struct r123array4x32 | ars4x32_key_t
typedef struct r123array4x32 | ars4x32_ukey_t
## Enumerations
enum | r123_enum_aesni1xm128i { aesni1xm128i_rounds = 10 }
enum | r123_enum_aesni4x32 { aesni4x32_rounds = 10 }
enum | r123_enum_ars1xm128i { ars1xm128i_rounds = 7 }
enum | r123_enum_ars4x32 { ars4x32_rounds = 7 }
## Functions
static aesni1xm128i_ctr_t | aesni1xm128i (aesni1xm128i_ctr_t in, aesni1xm128i_key_t k)
static aesni1xm128i_ctr_t | aesni1xm128i_R (unsigned R, aesni1xm128i_ctr_t in, aesni1xm128i_key_t k)
static aesni4x32_key_t | aesni4x32keyinit (aesni4x32_ukey_t uk)
static aesni4x32_ctr_t | aesni4x32_R (unsigned int Nrounds, aesni4x32_ctr_t c, aesni4x32_key_t k)
static ars1xm128i_key_t | ars1xm128ikeyinit (ars1xm128i_ukey_t uk)
static ars1xm128i_ctr_t | ars1xm128i_R (unsigned int Nrounds, ars1xm128i_ctr_t in, ars1xm128i_key_t k)
static ars4x32_key_t | ars4x32keyinit (ars4x32_ukey_t uk)
static ars4x32_ctr_t | ars4x32_R (unsigned int Nrounds, ars4x32_ctr_t c, ars4x32_key_t k)

## Detailed Description

The ARS4x32, ARS1xm128i, AESNI4x32 and AESNI1xm128i classes export the member functions, typedefs and operator overloads required by a CBRNG class.

ARS1xm128i and AESNI1xm128i are based on the AES block cipher and rely on the AES-NI hardware instructions available on some some new (2011) CPUs.

The ARS1xm128i CBRNG and the use of AES for random number generation are described in Parallel Random Numbers: As Easy as 1, 2, 3 . Although it uses some cryptographic primitives, ARS1xm128i uses a cryptographically weak key schedule and is not suitable for cryptographic use.

## Define Documentation

#define aesni4x32 | ( |  | c,
|  |  | k |
| ) |  |  | aesni4x32_R(aesni4x32_rounds, c, k)

The aesni4x32 macro provides a C API to the AESNI CBRNG, uses the default number of rounds i.e. `aesni4x32_rounds`

#define ars1xm128i | ( |  | c,
|  |  | k |
| ) |  |  | ars1xm128i_R(ars1xm128i_rounds, c, k)

The ars1mx128i macro provides a C API interface to the ARS CBRNG with the default number of rounds i.e. `ars1xm128i_rounds`

#define ars4x32 | ( |  | c,
|  |  | k |
| ) |  |  | ars4x32_R(ars4x32_rounds, c, k)

The ars4x32 macro provides a C API interface to the ARS CBRNG with the default number of rounds i.e. `ars4x32_rounds`

## Typedef Documentation

typedef struct r123array1xm128i aesni1xm128i_ctr_t

typedef struct r123array1xm128i aesni1xm128i_ukey_t

typedef struct r123array4x32 aesni4x32_ctr_t

typedef aesni1xm128i_key_t aesni4x32_key_t

typedef struct r123array4x32 aesni4x32_ukey_t

typedef struct r123array1xm128i ars1xm128i_ctr_t

typedef struct r123array1xm128i ars1xm128i_key_t

typedef struct r123array1xm128i ars1xm128i_ukey_t

typedef struct r123array4x32 ars4x32_ctr_t

typedef struct r123array4x32 ars4x32_key_t

typedef struct r123array4x32 ars4x32_ukey_t

## Enumeration Type Documentation

enum r123_enum_aesni1xm128i

Enumerator:

  aesni1xm128i_rounds |

enum r123_enum_aesni4x32

Enumerator:

  aesni4x32_rounds |

enum r123_enum_ars1xm128i

Enumerator:

  ars1xm128i_rounds |

enum r123_enum_ars4x32

Enumerator:

  ars4x32_rounds |

## Function Documentation

static aesni1xm128i_ctr_t aesni1xm128i | ( | aesni1xm128i_ctr_t | in,
|  | aesni1xm128i_key_t | k |
| ) |  |  | `[inline, static]`

static aesni1xm128i_ctr_t aesni1xm128i_R | ( | unsigned | R,
|  | aesni1xm128i_ctr_t | in,
|  | aesni1xm128i_key_t | k |
| ) |  |  | `[inline, static]`

static aesni4x32_ctr_t aesni4x32_R | ( | unsigned int | Nrounds,
|  | aesni4x32_ctr_t | c,
|  | aesni4x32_key_t | k |
| ) |  |  | `[inline, static]`

The aesni4x32_R function provides a C API to the AESNI CBRNG, allowing the number of rounds to be specified explicitly

static aesni4x32_key_t aesni4x32keyinit | ( | aesni4x32_ukey_t | uk | ) | `[inline, static]`

static ars1xm128i_ctr_t ars1xm128i_R | ( | unsigned int | Nrounds,
|  | ars1xm128i_ctr_t | in,
|  | ars1xm128i_key_t | k |
| ) |  |  | `[inline, static]`

static ars1xm128i_key_t ars1xm128ikeyinit | ( | ars1xm128i_ukey_t | uk | ) | `[inline, static]`

static ars4x32_ctr_t ars4x32_R | ( | unsigned int | Nrounds,
|  | ars4x32_ctr_t | c,
|  | ars4x32_key_t | k |
| ) |  |  | `[inline, static]`

static ars4x32_key_t ars4x32keyinit | ( | ars4x32_ukey_t | uk | ) | `[inline, static]`

All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines