SETKEY(3) Library Functions Manual SETKEY(3)

setkey — set encoding key (CRYPT)

#include <stdlib.h>

void setkey(const char *key);

The setkey() function provides (rather primitive) access to an implementation-dependent encoding algorithm. The argument of setkey() is an array of length 64 bytes containing only the bytes with numerical value of 0 and 1. If this string is divided into groups of 8, the low-order bit in each group is ignored; this gives a 56-bit key which is used by the algorithm. This is the key that will be used with the algorithm to encode a string block passed to encrypt(3) .

The function will not change the setting of if successful.

This interface need not be reentrant.

No values are returned.

The setkey() function will fail if:

The functionality is not supported on this implementation.

None.

Decoding need not be implemented in all environments. This is related to U.S. Government restrictions on encryption and decryption routines: the DES decryption algorithm cannot be exported outside the U.S.A. Historical practice has been to ship a different version of the encryption library without the decryption feature in the routines supplied. Thus the exported version of encrypt(3) does encoding but not decoding.

None.

crypt(3) , encrypt(3) , <stdlib.h> .

Derived from Issue 1 of the SVID.

February 1997 posix.fail