diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
| commit | 96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c (patch) | |
| tree | 70686b943e33a6e939ad265acb7ddfef70b91f32 /man/man3/des_crypt.3 | |
| parent | 8f4ed6463206e8ede815c72085c7305dafc2e4fc (diff) | |
| download | man-pages-96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c.tar.gz | |
Revert "src.mk, All pages: Move man* to man/"
This reverts commit 70ac1c4785fc1e158ab2349a962dba2526bf4fbc.
Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/>
Reported-by: Petr Vorel <pvorel@suse.cz>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man/man3/des_crypt.3')
| -rw-r--r-- | man/man3/des_crypt.3 | 167 |
1 files changed, 0 insertions, 167 deletions
diff --git a/man/man3/des_crypt.3 b/man/man3/des_crypt.3 deleted file mode 100644 index 90ce308b90..0000000000 --- a/man/man3/des_crypt.3 +++ /dev/null @@ -1,167 +0,0 @@ -.\" @(#)des_crypt.3 2.1 88/08/11 4.0 RPCSRC; from 1.16 88/03/02 SMI; -.\" -.\" Taken from libc4 sources, which say: -.\" Copyright (C) 1993 Eric Young - can be distributed under GPL. -.\" -.\" However, the above header line suggests that this file in fact is -.\" Copyright Sun Microsystems, Inc (and is provided for unrestricted use, -.\" see other Sun RPC sources). -.\" -.\" SPDX-License-Identifier: GPL-1.0-or-later -.\" -.TH DES_CRYPT 3 2021-03-22 "Linux man-pages (unreleased)" -.SH NAME -des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- fast -DES encryption -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.\" Sun version -.\" .B #include <des_crypt.h> -.B #include <rpc/des_crypt.h> -.PP -.BI "int ecb_crypt(char *" key ", char *" data ", unsigned int " datalen , -.BI " unsigned int " mode ); -.BI "int cbc_crypt(char *" key ", char *" data ", unsigned int " datalen , -.BI " unsigned int " mode ", char *" ivec ); -.PP -.BI "void des_setparity(char *" key ); -.PP -.BI "int DES_FAILED(int " status ); -.fi -.SH DESCRIPTION -.BR ecb_crypt () -and -.BR cbc_crypt () -implement the -NBS -DES -(Data Encryption Standard). -These routines are faster and more general purpose than -.BR crypt (3). -They also are able to utilize -DES -hardware if it is available. -.BR ecb_crypt () -encrypts in -ECB -(Electronic Code Book) -mode, which encrypts blocks of data independently. -.BR cbc_crypt () -encrypts in -CBC -(Cipher Block Chaining) -mode, which chains together -successive blocks. -CBC -mode protects against insertions, deletions, and -substitutions of blocks. -Also, regularities in the clear text will -not appear in the cipher text. -.PP -Here is how to use these routines. -The first argument, -.IR key , -is the 8-byte encryption key with parity. -To set the key's parity, which for -DES -is in the low bit of each byte, use -.BR des_setparity (). -The second argument, -.IR data , -contains the data to be encrypted or decrypted. -The -third argument, -.IR datalen , -is the length in bytes of -.IR data , -which must be a multiple of 8. -The fourth argument, -.IR mode , -is formed by ORing together some things. -For the encryption direction OR in either -.B DES_ENCRYPT -or -.BR DES_DECRYPT . -For software versus hardware -encryption, OR in either -.B DES_HW -or -.BR DES_SW . -If -.B DES_HW -is specified, and there is no hardware, then the encryption is performed -in software and the routine returns -.BR DESERR_NOHWDEVICE . -For -.BR cbc_crypt (), -the argument -.I ivec -is the 8-byte initialization -vector for the chaining. -It is updated to the next initialization -vector upon return. -.SH RETURN VALUE -.TP -.B DESERR_NONE -No error. -.TP -.B DESERR_NOHWDEVICE -Encryption succeeded, but done in software instead of the requested hardware. -.TP -.B DESERR_HWERROR -An error occurred in the hardware or driver. -.TP -.B DESERR_BADPARAM -Bad argument to routine. -.PP -Given a result status -.IR stat , -the macro -.\" .BR DES_FAILED\c -.\" .BR ( stat ) -.BI DES_FAILED( stat ) -is false only for the first two statuses. -.\" So far the Sun page -.\" Some additions - aeb -.SH VERSIONS -These functions were added to glibc in version 2.1. -.PP -Because they employ the DES block cipher, -which is no longer considered secure, -.BR ecb_crypt (), -.BR ecb_crypt (), -.BR crypt_r (), -and -.BR des_setparity () -were removed in glibc 2.28. -Applications should switch to a modern cryptography library, such as -.BR libgcrypt . -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.ad l -.nh -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.BR ecb_crypt (), -.BR cbc_crypt (), -.BR des_setparity () -T} Thread safety MT-Safe -.TE -.hy -.ad -.sp 1 -.SH STANDARDS -4.3BSD. -Not in POSIX.1. -.SH SEE ALSO -.BR des (1), -.BR crypt (3), -.BR xcrypt (3) |