Macros

Macros

#define ECDSA_STATUS_SUCCESS   (0)
 Successful status code. More...
 
#define ECDSA_STATUS_ERROR   (-1)
 Generic error status code. More...
 
#define ECDSA_STATUS_UNDEFINEDCMD   (-2)
 An error status code returned by ECDSA_control() for undefined command codes. More...
 
#define ECDSA_STATUS_RESOURCE_UNAVAILABLE   (-3)
 An error status code returned if the hardware or software resource is currently unavailable. More...
 
#define ECDSA_STATUS_RESULT_INVALID_PMSN   (-4)
 The PMSN passed into the the call is invalid. More...
 
#define ECDSA_STATUS_RESULT_R_LARGER_THAN_ORDER   (-5)
 The private key passed in is larger than the order of the curve. More...
 
#define ECDSA_STATUS_RESULT_S_LARGER_THAN_ORDER   (-5)
 The private key passed in is larger than the order of the curve. More...
 
#define ECDSA_STATUS_RESULT_PUBLIC_KEY_NOT_ON_CURVE   (-7)
 The public key of the other party does not lie upon the curve. More...
 

Detailed Description

ECDSA_STATUS_* macros are general status codes returned by ECDSA functions

Macro Definition Documentation

§ ECDSA_STATUS_SUCCESS

#define ECDSA_STATUS_SUCCESS   (0)

Successful status code.

Function return ECDSA_STATUS_SUCCESS if the control code was executed successfully.

§ ECDSA_STATUS_ERROR

#define ECDSA_STATUS_ERROR   (-1)

Generic error status code.

Functions return ECDSA_STATUS_ERROR if the control code was not executed successfully.

§ ECDSA_STATUS_UNDEFINEDCMD

#define ECDSA_STATUS_UNDEFINEDCMD   (-2)

An error status code returned by ECDSA_control() for undefined command codes.

ECDSA_control() returns ECDSA_STATUS_UNDEFINEDCMD if the control code is not recognized by the driver implementation.

§ ECDSA_STATUS_RESOURCE_UNAVAILABLE

#define ECDSA_STATUS_RESOURCE_UNAVAILABLE   (-3)

An error status code returned if the hardware or software resource is currently unavailable.

ECDSA driver implementations may have hardware or software limitations on how many clients can simultaneously perform operations. This status code is returned if the mutual exclusion mechanism signals that an operation cannot currently be performed.

§ ECDSA_STATUS_RESULT_INVALID_PMSN

#define ECDSA_STATUS_RESULT_INVALID_PMSN   (-4)

The PMSN passed into the the call is invalid.

This only occurs when the PMSN is zero. Any values larger than the order will be taken modulo the order. That only leaves zero as an invalid PMSN value.

§ ECDSA_STATUS_RESULT_R_LARGER_THAN_ORDER

#define ECDSA_STATUS_RESULT_R_LARGER_THAN_ORDER   (-5)

The private key passed in is larger than the order of the curve.

Private keys must be integers in the interval [1, n - 1], where n is the order of the curve.

§ ECDSA_STATUS_RESULT_S_LARGER_THAN_ORDER

#define ECDSA_STATUS_RESULT_S_LARGER_THAN_ORDER   (-5)

The private key passed in is larger than the order of the curve.

Private keys must be integers in the interval [1, n - 1], where n is the order of the curve.

§ ECDSA_STATUS_RESULT_PUBLIC_KEY_NOT_ON_CURVE

#define ECDSA_STATUS_RESULT_PUBLIC_KEY_NOT_ON_CURVE   (-7)

The public key of the other party does not lie upon the curve.

The public key received from the other party does not lie upon the agreed upon curve.

Copyright 2017, Texas Instruments Incorporated