ECCTK (Elliptic Curve Cryptographic ToolKit): Information & Divers

# Information & Divers
[Algorithmes Asymétriques]

## Macros
#define | ECCTK_COMPRESS_ON 0x01
#define | ECCTK_COMPRESS_OFF 0x02
#define | ECCTK_ECC_SECRET_SHARING_SECRET_MAX_SIZE 63
## Fonctions
s2byte | SecureReadPassword (s1byte *Buffer, u2byte Size)
| Permet de lire de manière sécurisé un password sur une console.
void | EcctkEccInfo (char *Information, u2byte Size)
| Permet d'obtenir des informations sur la librairie.
s2byte | InitializeEcctkGf2m ()
| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(2^m).
void | FreeEcctkGf2m ()
| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(2^m).
s2byte | InitializeEcctkGfp ()
| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(p).
void | FreeEcctkGfp ()
| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(p).
s2byte | InitializeEcctkAll ()
| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(2^m) & GF(p).
void | FreeEcctkAll ()
| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(2^m) & GF(p).

## Documentation des macro

#define ECCTK_COMPRESS_ON 0x01

| Compression/décompression des données avant/après chiffrement/déchiffrement

#define ECCTK_COMPRESS_OFF 0x02

| Pas de compression/décompression des données avant/après chiffrement/déchiffrement

#define ECCTK_ECC_SECRET_SHARING_SECRET_MAX_SIZE 63

| Taille maximal (en octets) d'un secret pouvant être partagé

## Documentation des fonctions

s2byte SecureReadPassword | ( | s1byte * | Buffer,
|  | u2byte | Size
| ) |

  | Permet de lire de manière sécurisé un password sur une console. Paramètres:
  | Buffer | : buffer de sortie du mot de passe lu.
  | Size | : taille en octet du buffer.
Renvoie: la taille du mot de passe, ou -1 en cas d'erreur.

void EcctkEccInfo | ( | char * | Information,
|  | u2byte | Size
| ) |

  | Permet d'obtenir des informations sur la librairie. Paramètres:
  | Information | est le buffer dans lequel sont placées les informations sur la librairie
  | Size | est la taille du buffer Information
Remarques: si Size n'est pas assez grand, les informations sont tronquées

s2byte InitializeEcctkGf2m | ( |  | ) |

| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(2^m). Avertissement: les fonctions utilisant les courbes définies sur GF(2^m) ne fonctionne pas si cette fonction n'est pas appelée au préalable Renvoie: code d'erreur de la fonction.

void FreeEcctkGf2m | ( |  | ) |

| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(2^m).

s2byte InitializeEcctkGfp | ( |  | ) |

| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(p). Avertissement: les fonctions utilisant les courbes définies sur GF(p) ne fonctionne pas si cette fonction n'est pas appelée au préalable Renvoie: code d'erreur de la fonction.

void FreeEcctkGfp | ( |  | ) |

| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(p).

s2byte InitializeEcctkAll | ( |  | ) |

| Permet de mettre en place les paramètres nécessaires aux opérations sur GF(2^m) & GF(p). Remarques: cette fonction appelle les deux fonctions InitializeEcctkGf2m & InitializeEcctkGfp Renvoie: code d'erreur de la fonction. Exemples: decrypt_file_asym.cpp, decrypt_stream_asym.cpp, encrypt_file_asym.cpp, encrypt_stream_asym.cpp, generate_keypair.cpp, key_agreement.cpp, sign_file.cpp, sign_stream.cpp, verify_file.cpp, et verify_stream.cpp.

void FreeEcctkAll | ( |  | ) |

| Permet de libérer la mémoire utilisée par les paramètres nécessaires aux opérations sur GF(2^m) & GF(p). Remarques: cette fonction appelle les deux fonctions FreeEcctkGf2m & FreeEcctkGfp Exemples: generate_keypair.cpp, sign_file.cpp, et sign_stream.cpp.