encrypt(3c) [sunos man page]

encrypt(3C)						   Standard C Library Functions 					       encrypt(3C)

NAME

       encrypt - encoding function

SYNOPSIS

       #include <crypt.h>

       void encrypt(char block[64], int edflag);

   Standard conforming
       #include <unistd.h>

       void encrypt(char block[64], int edflag);

DESCRIPTION

       The encrypt() function provides (rather primitive) access to the hashing algorithm employed by the crypt(3C) function. The key generated by
       setkey(3C) is used to encrypt the string block with encrypt().

       The block argument to encrypt() is an array of length 64 bytes containing only the bytes with numerical value of 0 and 1. The array is mod-
       ified  in  place to a similar array using the key set by setkey(3C). If edflag is 0, the argument is encoded.  If edflag is 1, the argument
       may be decoded (see the USAGE section below); if the argument is not decoded, errno will be set to ENOSYS.

RETURN VALUES

       The encrypt() function returns no value.

ERRORS

       The encrypt() function will fail if:

       ENOSYS	       The functionality is not supported on this implementation.

USAGE

       In some environments, decoding may not be implemented.  This is related to U.S. Government restrictions on encryption and  decryption  rou-
       tines:  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() does	encoding  but  not
       decoding.

       Because	encrypt() does not return a value, applications wishing to check for errors should set errno to 0, call encrypt(), then test errno
       and, if it is non-zero, assume an error has occurred.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       crypt(3C), setkey(3C), attributes(5)

SunOS 5.10							    2 May 2001							       encrypt(3C)

crypt(3)						     Library Functions Manual							  crypt(3)

Name
       crypt, crypt16, setkey, encrypt - DES encryption

Syntax
       char *crypt(key, salt)
       char *key, *salt;

       char *crypt16(key, salt)
       char *key, *salt;

       void setkey(key)
       char *key;

Description
       The  subroutine is the password encryption routine.  It is based on the NBS Data Encryption Standard, with variations intended to frustrate
       use of hardware implementations of the DES for key search.

       The first argument to is normally a user's typed password.  The second is a 2-character string chosen from the set [a-zA-Z0-9./].  The salt
       string  is  used to perturb the DES algorithm in one of 4096 different ways, after which the password is used as the key to encrypt repeat-
       edly a constant string.	The returned value points to the encrypted password, in the same alphabet as the salt.	The first  two	characters
       are the salt itself.

       The subroutine is identical to the function except that it will accept a password up to sixteen characters in length. It generates a longer
       encrypted password for use with enhanced security features.

       The other entries provide primitive access to the actual DES algorithm.	The argument of is a character array of length 64 containing  only
       the characters with numerical value 0 and 1.  If this string is divided into groups of 8, the low-order bit in each group is ignored, lead-
       ing to a 56-bit key which is set into the machine.

       The argument to the entry is likewise a character array of length 64 containing 0s and 1s.  The argument array is modified in  place  to  a
       similar	array  representing the bits of the argument after having been subjected to the DES algorithm using the key set by If edflag is 0,
       the argument is encrypted; if non-zero, it is decrypted.

Restrictions
       The return values from and point to static data areas whose content is overwritten by each call.

Environment
   Default Environment
       In the default environment on systems that do not have the optional encryption software installed the function expects  exactly	one  argu-
       ment,  the data to be encrypted. The edflag argument is not supplied and there is no way to decrypt data.  If the optional encryption soft-
       ware is installed the function behaves as it does in the POSIX environment.  The syntax for the default environment follows:
	    void encrypt(block)
	    char *block;

   POSIX Environment
       In the POSIX environment the encrypt function always expects two arguments.  The function will set errno to ENOSYS and return if edflag	is
       non-zero and the optional encryption software is not present.  The syntax for the POSIX environment follows:
	    void encrypt(block, edflag)
	    char *block;
	    int edflag;

       In all cases the function will set errno to ENOSYS and return if the optional encryption software is not present.

See Also
       login(1), passwd(1), yppasswd(1yp), getpass(3), auth(5), passwd(5), passwd(5yp)
       ULTRIX Security Guide for Users and Programmers

																	  crypt(3)