xcrypt(3) — Linux manual page

XCRYPT(3)               Library Functions Manual               XCRYPT(3)

NAME

       xencrypt, xdecrypt, passwd2des - RFS password encryption

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <rpc/des_crypt.h>

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

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

DESCRIPTION

       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

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

ATTRIBUTES

       For an explanation of the terms used in this section, see
       attributes(7).
       ┌─────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                           │ Attribute     │ Value   │
       ├─────────────────────────────────────┼───────────────┼─────────┤
       │ passwd2des(), xencrypt(),           │ Thread safety │ MT-Safe │
       │ xdecrypt()                          │               │         │
       └─────────────────────────────────────┴───────────────┴─────────┘

VERSIONS

       These functions are available since glibc 2.1.

BUGS

       The prototypes are missing from the abovementioned include file.

SEE ALSO

       cbc_crypt(3)

COLOPHON

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.9.1.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2024-06-26.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

Linux man-pages 6.9.1          2024-05-02                      XCRYPT(3)

Pages that refer to this page: des_crypt(3)

---