ENCRYPT

Section: Manuel du programmeur Linux (3)
Updated: 21 juillet 2003
Index


NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉES
ERREURS
EXEMPLE
NOTE
CONFORMITÉ
VOIR AUSSI
TRADUCTION

NOM

encrypt, setkey, encrypt_r, setkey_r - Crypter des messages de 64 bits.

SYNOPSIS

#define _XOPEN_SOURCE
#include <unistd.h>
void encrypt(char block[64], int edflag);
#define _XOPEN_SOURCE
#include <stdlib.h>
void setkey(const char *key);
#define _GNU_SOURCE
#include <crypt.h>
void setkey_r (const char *key, struct crypt_data *data);
void encrypt_r (char *block, int edflag, struct crypt_data *data);
Édition des liens avec -lcrypt.

DESCRIPTION

Ces fonction cryptent et décryptent des messages de 64 bits. La fonction setkey() permet de fournir la clé à utiliser pour encrypt(). Le paramètre key est une table d'octets, chacun ayant la valeur 0 ou 1. L'octet key[n] où n=8*q-1 est ignoré, ce qui ramène la clé à 56 bits effectifs.
La fonction encrypt() modifie le buffer transmis, en le cryptant si le paramètre edflag vaut 0, et en le décryptant s'il vaut 1. Le paramètre block est, comme le paramètre key, une représentation de la valeur à encoder sous forme de vecteur de bits. Le résultat est renvoyé dans le même vecteur.
Ces fonctions ne sont pas réentrantes, c'est-à-dire que la clé est stockée dans une zone de stockage statique. Les fonctions setkey_r () et encrypt_r () sont des versions réentrantes. Elles utilisent la structure suivante pour contenir la clé :
struct crypt_data {
      char keysched[16 * 8];
      char sb0[32768];
      char sb1[32768];
      char sb2[32768];
      char sb3[32768];
      char crypt_3_buf[14];
      char current_salt[2];
      long int current_saltbits;
      int  direction, initialized;
};

VALEUR RENVOYÉES

Ces routines ne renvoient pas de valeur.

ERREURS

Mettez errno à zéro avant d'appeler les routines ci-dessus. Si elles réussissent, il n'est pas modifié. Sinon, il peut valoir :
ENOSYS
La fonction n'est pas disponible. (Par exemple à cause des restrictions américaines sur l'exportation de routines cryptographiques...)

EXEMPLE

Avec la GlibC 2.2, il faudra lier cet exemple avec la bibliothèque libcrypt. Pour servir à quelque chose, les tables key[] et txt[] devraient être remplies avec des zones significatives. Notez que l'en-tête <crypt.h> donne toujours les prototypes de setkey() et encrypt().
#include <crypt.h>

main() {
  char key[64];      /* bit pattern for key */
  char txt[64];      /* bit pattern for messages */
  setkey(key);
  encrypt(txt, 0);   /* encode */
  encrypt(txt, 1);   /* decode */
}

NOTE

Dans la GlibC 2.2, ces fonctions utilisent l'algorithme DES.

CONFORMITÉ

Les fonctions encrypt() et setkey() sont conformes ) SVID, SUSv2, et POSIX 1003.1-2001. Les fonctions encrypt_r() et setkey_r() sont des extensions GNU.

VOIR AUSSI

TRADUCTION

Christophe Blaess, 2000-2003.