summaryrefslogtreecommitdiffstats
path: root/lib/libssl/src/doc/crypto/acss.pod
blob: 022a803be5987da23a430cbece23f5df4dae7289 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
=pod

=head1 NAME

acss, acss_setkey - ACSS encryption

=head1 SYNOPSIS

 #include <openssl/acss.h>

 void acss_setkey(ACSS_KEY *key, const unsigned char *data, int enc,
         int mode);

 void acss(ACSS_KEY *key, unsigned long len, const unsigned char *in,
         unsigned char *out);

=head1 DESCRIPTION

This library implements the Alleged Content Scrambling System.  It is believed
to be interoperable with CSS of the DVD Copy Control Association.

ACSS is a stream cipher with a fixed key length of 40 bit (5 byte).

ACSS consists of a key setup phase and the actual encryption or decryption
phase.

acss_setkey() sets up the B<ACSS_KEY> B<key> using the 40 bit key at B<data>.
If the flag B<enc> is set to B<1> B<key> will be used for encryption,
otherwise for decryption.  The integer B<mode> denotes the mode to use.
Acceptible values are B<0> to B<3>.  For any other value mode B<0> is used.

acss() encrypts or decrypts the B<len> bytes of B<in> using B<key> and places
the result at B<out>.

Applications should use the higher level functions
L<EVP_EncryptInit(3)|EVP_EncryptInit(3)> etc.  instead of calling the acss
functions directly.

=head1 RETURN VALUES

None of the functions presented here return any value.

=head1 NOTE

ACSS is considered as an insecure cipher.  Therefore, use of ACSS is
discouraged.

=head1 SEE ALSO

RC4(3), arc4random(3)

=head1 History

A proprietary algorithm called CSS can be licensed from the DVD Copy Control
Association (DVD CCA).  CSS is considered a trade secret and is not patented.
In October 1999 source code for CSS was posted anonymously to the LiViD
mailing list.  Since then, several implementations and mathematical
descriptions of CSS are available and CSS has been subject to cryptanalysis.
The DVD CCA has repeatedly failed to sue individuals for publishing such
information about CSS.

ACSS is a stream cipher written from scratch and believed to be interoperable
with CSS.

=cut