d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
1b51e5d0ce
freebsd-dev/lib/libc/rpc/des_crypt.3

124 lines
2.6 KiB
Groff
Raw Normal View History

Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
.\" @(#)des_crypt.3 2.1 88/08/11 4.0 RPCSRC; from 1.16 88/03/02 SMI;
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Add $Id$, to make it simpler for members of the translation teams to track. The $Id$ line is normally at the bottom of the main comment block in the man page, separated from the rest of the manpage by an empty comment, like so; .\" $Id$ .\" If the immediately preceding comment is a @(#) format ID marker than the the $Id$ will line up underneath it with no intervening blank lines. Otherwise, an additional blank line is inserted. Approved by: bde
1999-07-12 20:50:10 +00:00
.\"
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dd October 6, 1987
.Dt DES_CRYPT 3
.Os
.Sh NAME
.Nm des_crypt , ecb_crypt , cbc_crypt , des_setparity
.Nd "fast DES encryption"
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.Fd "#include <rpc/des_crypt.h>"
.Ft int
.Fn ecb_crypt "char *key" "char *data" "unsigned datalen" "unsigned mode"
.Ft int
.Fn cbc_crypt "char *key" "char *data" "unsigned datalen" "unsigned mode" "char *ivec"
.Ft void
.Fn des_setparity "char *key"
.Sh DESCRIPTION
.Fn ecb_crypt
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
and
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn cbc_crypt
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
implement the
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn NBS
.Tn DES
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
(Data Encryption Standard).
These routines are faster and more general purpose than
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Xr crypt 3 .
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
They also are able to utilize
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn DES
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
hardware if it is available.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn ecb_crypt
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
encrypts in
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn ECB
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
(Electronic Code Book)
mode, which encrypts blocks of data independently.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn cbc_crypt
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
encrypts in
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn CBC
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
(Cipher Block Chaining)
mode, which chains together
successive blocks.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn CBC
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
mode protects against insertions, deletions and
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
substitutions of blocks.
Also, regularities in the clear text will
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
not appear in the cipher text.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Pp
Here is how to use these routines.
The first parameter,
.Fa key ,
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is the 8-byte encryption key with parity.
To set the key's parity, which for
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Tn DES
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is in the low bit of each byte, use
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn des_setparity .
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
The second parameter,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa data ,
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-02 09:14:21 +00:00
contains the data to be encrypted or decrypted.
The
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
third parameter,
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa datalen ,
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is the length in bytes of
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa data ,
which must be a multiple of 8.
The fourth parameter,
.Fa mode ,
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is formed by
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Em OR Ns 'ing
together some things.
For the encryption direction
.Em OR
in either
.Dv DES_ENCRYPT
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
or
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv DES_DECRYPT .
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
For software versus hardware
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
encryption,
.Em OR
in either
.Dv DES_HW
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
or
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv DES_SW .
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
If
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Dv DES_HW
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is specified, and there is no hardware, then the encryption is performed
in software and the routine returns
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Er DESERR_NOHWDEVICE .
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
For
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn cbc_crypt ,
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
the parameter
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fa ivec
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is the the 8-byte initialization
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
vector for the chaining.
It is updated to the next initialization
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
vector upon return.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Sh ERRORS
.Bl -tag -width [DESERR_NOHWDEVICE] -compact
.It Bq Er DESERR_NONE
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
No error.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.It Bq Er DESERR_NOHWDEVICE
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
Encryption succeeded, but done in software instead of the requested hardware.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.It Bq Er DESERR_HWERR
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
An error occurred in the hardware or driver.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.It Bq Er DESERR_BADPARAM
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
Bad parameter to routine.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.El
.Pp
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
Given a result status
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Va stat ,
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
the macro
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Fn DES_FAILED stat
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
is false only for the first two statuses.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
.Sh SEE ALSO
.\" .Xr des 1 ,
.Xr crypt 3
.Sh RESTRICTIONS
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
These routines are not available in RPCSRC 4.0.
man(7) -> mdoc(7).
2001-01-17 18:26:21 +00:00
This information is provided to describe the
.Tn DES
interface expected by
Now the biggest step: import the changes to the main RPC code. Note: you'll need to rinstalkl all your includes before compiling libc the next time you update your sources in order for all this to work. Reviewed by: Mark Murray
1997-05-28 05:00:11 +00:00
Secure RPC.
Reference in New Issue Copy Permalink