scalar_4x64_impl.h File Reference

Go to the source code of this file.

Macros
#define	SECP256K1_N_0   ((uint64_t)0xBFD25E8CD0364141ULL)
#define	SECP256K1_N_1   ((uint64_t)0xBAAEDCE6AF48A03BULL)
#define	SECP256K1_N_2   ((uint64_t)0xFFFFFFFFFFFFFFFEULL)
#define	SECP256K1_N_3   ((uint64_t)0xFFFFFFFFFFFFFFFFULL)
#define	SECP256K1_N_C_0   (~SECP256K1_N_0 + 1)
#define	SECP256K1_N_C_1   (~SECP256K1_N_1)
#define	SECP256K1_N_C_2   (1)
#define	SECP256K1_N_H_0   ((uint64_t)0xDFE92F46681B20A0ULL)
#define	SECP256K1_N_H_1   ((uint64_t)0x5D576E7357A4501DULL)
#define	SECP256K1_N_H_2   ((uint64_t)0xFFFFFFFFFFFFFFFFULL)
#define	SECP256K1_N_H_3   ((uint64_t)0x7FFFFFFFFFFFFFFFULL)
#define	muladd(a, b)
	Add a*b to the number defined by (c0,c1,c2). More...
#define	muladd_fast(a, b)
	Add a*b to the number defined by (c0,c1). More...
#define	muladd2(a, b)
	Add 2*a*b to the number defined by (c0,c1,c2). More...
#define	sumadd(a)
	Add a to the number defined by (c0,c1,c2). More...
#define	sumadd_fast(a)
	Add a to the number defined by (c0,c1). More...
#define	extract(n)
	Extract the lowest 64 bits of (c0,c1,c2) into n, and left shift the number 64 bits. More...
#define	extract_fast(n)
	Extract the lowest 64 bits of (c0,c1,c2) into n, and left shift the number 64 bits. More...

Macro Definition Documentation

#define extract

(

n

)

Value:

{ \
    (n) = c0; \
    c0 = c1; \
    c1 = c2; \
    c2 = 0; \
}

Extract the lowest 64 bits of (c0,c1,c2) into n, and left shift the number 64 bits.

Definition at line 255 of file scalar_4x64_impl.h.

#define extract_fast

(

n

)

Value:

{ \
    (n) = c0; \
    c0 = c1; \
    c1 = 0; \
    VERIFY_CHECK(c2 == 0); \
}

Extract the lowest 64 bits of (c0,c1,c2) into n, and left shift the number 64 bits.

c2 is required to be zero.

Definition at line 263 of file scalar_4x64_impl.h.

#define muladd	(		a,
			b
	)

Value:

{ \
    uint64_t tl, th; \
    { \
        uint128_t t = (uint128_t)a * b; \
        th = t >> 64;         /* at most 0xFFFFFFFFFFFFFFFE */ \
        tl = t; \
    } \
    c0 += tl;                 /* overflow is handled on the next line */ \
    th += (c0 < tl) ? 1 : 0;  /* at most 0xFFFFFFFFFFFFFFFF */ \
    c1 += th;                 /* overflow is handled on the next line */ \
    c2 += (c1 < th) ? 1 : 0;  /* never overflows by contract (verified in the next line) */ \
    VERIFY_CHECK((c1 >= th) || (c2 != 0)); \
}

Add a*b to the number defined by (c0,c1,c2).

c2 must never overflow.

Definition at line 187 of file scalar_4x64_impl.h.

#define muladd2	(		a,
			b
	)

Value:

{ \
    uint64_t tl, th, th2, tl2; \
    { \
        uint128_t t = (uint128_t)a * b; \
        th = t >> 64;               /* at most 0xFFFFFFFFFFFFFFFE */ \
        tl = t; \
    } \
    th2 = th + th;                  /* at most 0xFFFFFFFFFFFFFFFE (in case th was 0x7FFFFFFFFFFFFFFF) */ \
    c2 += (th2 < th) ? 1 : 0;       /* never overflows by contract (verified the next line) */ \
    VERIFY_CHECK((th2 >= th) || (c2 != 0)); \
    tl2 = tl + tl;                  /* at most 0xFFFFFFFFFFFFFFFE (in case the lowest 63 bits of tl were 0x7FFFFFFFFFFFFFFF) */ \
    th2 += (tl2 < tl) ? 1 : 0;      /* at most 0xFFFFFFFFFFFFFFFF */ \
    c0 += tl2;                      /* overflow is handled on the next line */ \
    th2 += (c0 < tl2) ? 1 : 0;      /* second overflow is handled on the next line */ \
    c2 += (c0 < tl2) & (th2 == 0);  /* never overflows by contract (verified the next line) */ \
    VERIFY_CHECK((c0 >= tl2) || (th2 != 0) || (c2 != 0)); \
    c1 += th2;                      /* overflow is handled on the next line */ \
    c2 += (c1 < th2) ? 1 : 0;       /* never overflows by contract (verified the next line) */ \
    VERIFY_CHECK((c1 >= th2) || (c2 != 0)); \
}

Add 2*a*b to the number defined by (c0,c1,c2).

c2 must never overflow.

Definition at line 216 of file scalar_4x64_impl.h.

#define muladd_fast	(		a,
			b
	)

Value:

{ \
    uint64_t tl, th; \
    { \
        uint128_t t = (uint128_t)a * b; \
        th = t >> 64;         /* at most 0xFFFFFFFFFFFFFFFE */ \
        tl = t; \
    } \
    c0 += tl;                 /* overflow is handled on the next line */ \
    th += (c0 < tl) ? 1 : 0;  /* at most 0xFFFFFFFFFFFFFFFF */ \
    c1 += th;                 /* never overflows by contract (verified in the next line) */ \
    VERIFY_CHECK(c1 >= th); \
}

Add a*b to the number defined by (c0,c1).

c1 must never overflow.

Definition at line 202 of file scalar_4x64_impl.h.

#define SECP256K1_N_0   ((uint64_t)0xBFD25E8CD0364141ULL)

Definition at line 11 of file scalar_4x64_impl.h.

#define SECP256K1_N_1   ((uint64_t)0xBAAEDCE6AF48A03BULL)

Definition at line 12 of file scalar_4x64_impl.h.

#define SECP256K1_N_2   ((uint64_t)0xFFFFFFFFFFFFFFFEULL)

Definition at line 13 of file scalar_4x64_impl.h.

#define SECP256K1_N_3   ((uint64_t)0xFFFFFFFFFFFFFFFFULL)

Definition at line 14 of file scalar_4x64_impl.h.

#define SECP256K1_N_C_0   (~SECP256K1_N_0 + 1)

Definition at line 17 of file scalar_4x64_impl.h.

#define SECP256K1_N_C_1   (~SECP256K1_N_1)

Definition at line 18 of file scalar_4x64_impl.h.

#define SECP256K1_N_C_2   (1)

Definition at line 19 of file scalar_4x64_impl.h.

#define SECP256K1_N_H_0   ((uint64_t)0xDFE92F46681B20A0ULL)

Definition at line 22 of file scalar_4x64_impl.h.

#define SECP256K1_N_H_1   ((uint64_t)0x5D576E7357A4501DULL)

Definition at line 23 of file scalar_4x64_impl.h.

#define SECP256K1_N_H_2   ((uint64_t)0xFFFFFFFFFFFFFFFFULL)

Definition at line 24 of file scalar_4x64_impl.h.

#define SECP256K1_N_H_3   ((uint64_t)0x7FFFFFFFFFFFFFFFULL)

Definition at line 25 of file scalar_4x64_impl.h.

#define sumadd

(

a

)

Value:

{ \
    unsigned int over; \
    c0 += (a);                  /* overflow is handled on the next line */ \
    over = (c0 < (a)) ? 1 : 0; \
    c1 += over;                 /* overflow is handled on the next line */ \
    c2 += (c1 < over) ? 1 : 0;  /* never overflows by contract */ \
}

Add a to the number defined by (c0,c1,c2).

c2 must never overflow.

Definition at line 238 of file scalar_4x64_impl.h.

#define sumadd_fast

(

a

)

Value:

{ \
    c0 += (a);                 /* overflow is handled on the next line */ \
    c1 += (c0 < (a)) ? 1 : 0;  /* never overflows by contract (verified the next line) */ \
    VERIFY_CHECK((c1 != 0) | (c0 >= (a))); \
    VERIFY_CHECK(c2 == 0); \
}

Add a to the number defined by (c0,c1).

c1 must never overflow, c2 must be zero.

Definition at line 247 of file scalar_4x64_impl.h.