Return to crypt.3 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/crypt.3, revision 1.1.1.1

1.1       root        1: .TH CRYPT 3  "25 February 1983"
                      2: .SH NAME
                      3: crypt, setkey, encrypt \- DES encryption
                      4: .SH SYNOPSIS
                      5: .nf
                      6: .B char *crypt(key, salt)
                      7: .B char *key, *salt;
                      8: .PP
                      9: .B setkey(key)
                     10: .B char *key;
                     11: .PP
                     12: .B encrypt(block, edflag)
                     13: .B char *block;
                     14: .fi
                     15: .SH DESCRIPTION
                     16: .I Crypt
                     17: is the password encryption routine.
                     18: It is based on the NBS Data Encryption Standard, with
                     19: variations intended (among other things) to frustrate use of hardware
                     20: implementations of the DES for key search.
                     21: .PP
                     22: The first argument to
                     23: .I crypt
                     24: is normally a user's typed password.
                     25: The second is a 2-character string chosen from the
                     26: set [a-zA-Z0-9./].
                     27: The
                     28: .I salt
                     29: string is used to perturb the DES algorithm in one of 4096
                     30: different ways, after which the password
                     31: is used as the key to encrypt repeatedly a constant string.
                     32: The returned value points to the encrypted password,
                     33: in the same alphabet as the salt.
                     34: The first two characters are the salt itself.
                     35: .PP
                     36: The other entries provide (rather primitive)
                     37: access to the actual DES algorithm.
                     38: The argument of
                     39: .I setkey
                     40: is a character array of length 64 containing only the characters
                     41: with numerical value 0 and 1.
                     42: If this string is divided into groups of 8,
                     43: the low-order bit in each group is ignored,
                     44: leading to a 56-bit key which is set into the machine.
                     45: .PP
                     46: The argument to the
                     47: .I encrypt
                     48: entry is likewise a character array of length 64
                     49: containing 0's and 1's.
                     50: The argument array is modified in place
                     51: to a similar array
                     52: representing the bits of the argument after having been
                     53: subjected to the DES algorithm using the key set by
                     54: .I setkey.
                     55: If
                     56: .I edflag
                     57: is 0, the argument is encrypted;
                     58: if non-zero,
                     59: it is decrypted.
                     60: .SH "SEE ALSO"
                     61: passwd(1), passwd(5), login(1), getpass(3)
                     62: .SH BUGS
                     63: The return value
                     64: points to static data whose content is overwritten
                     65: by each call.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.