xcrypt(3) — Linux manual page


XCRYPT(3)               Library Functions Manual               XCRYPT(3)

NAME         top

       xencrypt, xdecrypt, passwd2des - RFS password encryption

LIBRARY         top

       Standard C library (libc, -lc)

SYNOPSIS         top

       #include <rpc/des_crypt.h>

       void passwd2des(char *passwd, char *key);

       int xencrypt(char *secret, char *passwd);
       int xdecrypt(char *secret, char *passwd);

DESCRIPTION         top

       WARNING: Do not use these functions in new code.  They do not
       achieve any type of acceptable cryptographic security guarantees.

       The function passwd2des() takes a character string passwd of
       arbitrary length and fills a character array key of length 8.
       The array key is suitable for use as DES key.  It has odd parity
       set in bit 0 of each byte.  Both other functions described here
       use this function to turn their argument passwd into a DES key.

       The xencrypt() function takes the ASCII character string secret
       given in hex, which must have a length that is a multiple of 16,
       encrypts it using the DES key derived from passwd by
       passwd2des(), and outputs the result again in secret as a hex
       string of the same length.

       The xdecrypt() function performs the converse operation.

RETURN VALUE         top

       The functions xencrypt() and xdecrypt() return 1 on success and 0
       on error.

ATTRIBUTES         top

       For an explanation of the terms used in this section, see

       │Interface                             Attribute     Value   │
       │passwd2des(), xencrypt(), xdecrypt()  │ Thread safety │ MT-Safe │

VERSIONS         top

       These functions are available since glibc 2.1.

BUGS         top

       The prototypes are missing from the abovementioned include file.

SEE ALSO         top


Linux man-pages 6.04           2023-03-17                      XCRYPT(3)

Pages that refer to this page: des_crypt(3)