ENCRYPT

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
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);
Effectuez l'édition des liens avec l'option -lcrypt.

DESCRIPTION

Ces fonctions cryptent et décryptent des messages de 64 bits. La fonction setkey() permet de fournir la clef à utiliser pour encrypt(). L'argument key est une table de 64 octets, chacun ayant la valeur 0 ou 1. L'octet key[n] où n=8*i-1 est ignoré, ce qui ramène la clef à 56 bits effectifs.
La fonction encrypt() modifie le tampon transmis, en l'encodant si l'argument edflag vaut 0, et en le décodant s'il vaut 1. L'argument block est, comme l'argument 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 clef 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 clef :

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;
};

Avant d'appeler setkey_r(), définissez data->initialized à zéro.

VALEUR RENVOYÉE

Ces routines ne renvoient pas de valeur.

ERREURS

Définisez errno à zéro avant d'appeler les fonctions ci-dessus. Si elles réussissent, errno n'est pas modifiée.

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 valeurs significatives. Notez que le fichier d'en-tête <crypt.h> fournit 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 à SVr4, SUSv2, et POSIX.1-2001. Les fonctions encrypt_r() et setkey_r() sont des extensions GNU.

VOIR AUSSI

cbc_crypt(3), crypt(3), ecb_crypt(3), fcrypt(3), feature_test_macros(7)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».

Création : octobre 2007