1 files changed, 69 insertions, 0 deletions
diff --git a/man3/xcrypt.3 b/man3/xcrypt.3
new file mode 100644
index 000000000..ae0efada1
--- /dev/null
+++ b/man3/xcrypt.3
@@ -0,0 +1,69 @@
+.\"  Copyright 2003 walter harms (walter.harms@informatik.uni-oldenburg.de)
+.\"  Distributed under GPL
+.\"  this is the 3rd type of interface for cryptographic routines
+.\"  1. encrypt() expects a bitfield
+.\"  2. cbc_crypt() byte values
+.\"  3. xencrypt() a hexstring
+.\"  to bad to be true :(
+.\"
+.TH  xcrypt 3 2003-04-04 "" "RPC cryptography" 
+.SH NAME
+xencrypt, xdecrypt, passwd2des \- RFS password encryption
+.SH SYNOPSIS
+.sp
+.B "#include <rpc/des_crypt.h>"
+.sp
+.BR "void passwd2des (char " *passwd ", char *" key ");"
+.sp
+.BR "int xencrypt (char " *secret ", char *" passwd ");"
+.sp
+.BR "int xdecrypt (char " *secret ", char *" passwd ");"
+.sp
+.SH DESCRIPTION
+The function
+.B passwd2des()
+takes a character string
+.I passwd
+of arbitrary length and fills a character array
+.I key
+of length 8. The array
+.I 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
+.I passwd
+into a DES key.
+.LP
+The 
+.B xencrypt()
+function takes the ASCII character string
+.I secret
+given in hex,
+.\" (over the alphabet 0123456789abcdefABCDEF),
+which must have a length that is a multiple of 16,
+encrypts it using the DES key derived from
+.I passwd
+by
+.BR passwd2des() ,
+and outputs the result again in
+.I secret
+as a hex string
+.\" (over the alphabet 0123456789abcdef)
+of the same length.
+.LP
+The
+.B xdecrypt()
+function performs the converse operation.
+.SH "RETURN VALUE"
+The functions
+.B xencrypt()
+and
+.B xdecrypt()
+return 1 on success and 0 on error.
+.SH AVAILABILITY
+These routines are present in libc 4.6.27 and later, and in
+glibc 2.1 and later.
+.SH BUGS
+The prototypes are missing from the abovementioned include file.
+.SH "SEE ALSO"
+.BR cbc_crypt (3)