Home | History | Annotate | Download | only in openssl
      1 /* Copyright (C) 1995-1998 Eric Young (eay (at) cryptsoft.com)
      2  * All rights reserved.
      3  *
      4  * This package is an SSL implementation written
      5  * by Eric Young (eay (at) cryptsoft.com).
      6  * The implementation was written so as to conform with Netscapes SSL.
      7  *
      8  * This library is free for commercial and non-commercial use as long as
      9  * the following conditions are aheared to.  The following conditions
     10  * apply to all code found in this distribution, be it the RC4, RSA,
     11  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
     12  * included with this distribution is covered by the same copyright terms
     13  * except that the holder is Tim Hudson (tjh (at) cryptsoft.com).
     14  *
     15  * Copyright remains Eric Young's, and as such any Copyright notices in
     16  * the code are not to be removed.
     17  * If this package is used in a product, Eric Young should be given attribution
     18  * as the author of the parts of the library used.
     19  * This can be in the form of a textual message at program startup or
     20  * in documentation (online or textual) provided with the package.
     21  *
     22  * Redistribution and use in source and binary forms, with or without
     23  * modification, are permitted provided that the following conditions
     24  * are met:
     25  * 1. Redistributions of source code must retain the copyright
     26  *    notice, this list of conditions and the following disclaimer.
     27  * 2. Redistributions in binary form must reproduce the above copyright
     28  *    notice, this list of conditions and the following disclaimer in the
     29  *    documentation and/or other materials provided with the distribution.
     30  * 3. All advertising materials mentioning features or use of this software
     31  *    must display the following acknowledgement:
     32  *    "This product includes cryptographic software written by
     33  *     Eric Young (eay (at) cryptsoft.com)"
     34  *    The word 'cryptographic' can be left out if the rouines from the library
     35  *    being used are not cryptographic related :-).
     36  * 4. If you include any Windows specific code (or a derivative thereof) from
     37  *    the apps directory (application code) you must include an acknowledgement:
     38  *    "This product includes software written by Tim Hudson (tjh (at) cryptsoft.com)"
     39  *
     40  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
     41  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     42  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     43  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
     44  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     45  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     46  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     48  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     49  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     50  * SUCH DAMAGE.
     51  *
     52  * The licence and distribution terms for any publically available version or
     53  * derivative of this code cannot be changed.  i.e. this code cannot simply be
     54  * copied and put under another distribution licence
     55  * [including the GNU Public Licence.] */
     56 
     57 #ifndef OPENSSL_HEADER_DES_H
     58 #define OPENSSL_HEADER_DES_H
     59 
     60 #include <openssl/base.h>
     61 
     62 #if defined(__cplusplus)
     63 extern "C" {
     64 #endif
     65 
     66 
     67 typedef struct DES_cblock_st {
     68   uint8_t bytes[8];
     69 } DES_cblock;
     70 
     71 typedef struct DES_ks {
     72   union {
     73     DES_cblock cblock;
     74     /* make sure things are correct size on machines with
     75      * 8 byte longs */
     76     uint32_t deslong[2];
     77   } ks[16];
     78 } DES_key_schedule;
     79 
     80 
     81 #define DES_KEY_SZ (sizeof(DES_cblock))
     82 #define DES_SCHEDULE_SZ (sizeof(DES_key_schedule))
     83 
     84 #define DES_ENCRYPT 1
     85 #define DES_DECRYPT 0
     86 
     87 #define DES_CBC_MODE 0
     88 #define DES_PCBC_MODE 1
     89 
     90 /* DES_set_key performs a key schedule and initialises |schedule| with |key|. */
     91 OPENSSL_EXPORT void DES_set_key(const DES_cblock *key,
     92                                 DES_key_schedule *schedule);
     93 
     94 /* DES_ecb_encrypt encrypts (or decrypts, if |is_encrypt| is |DES_DECRYPT|) a
     95  * single DES block (8 bytes) from in to out, using the key configured in
     96  * |schedule|. */
     97 OPENSSL_EXPORT void DES_ecb_encrypt(const DES_cblock *in, DES_cblock *out,
     98                                     const DES_key_schedule *schedule,
     99                                     int is_encrypt);
    100 
    101 /* DES_ncbc_encrypt encrypts (or decrypts, if |enc| is |DES_DECRYPT|) |len|
    102  * bytes from |in| to |out| with DES in CBC mode. */
    103 OPENSSL_EXPORT void DES_ncbc_encrypt(const uint8_t *in, uint8_t *out,
    104                                      size_t len,
    105                                      const DES_key_schedule *schedule,
    106                                      DES_cblock *ivec, int enc);
    107 
    108 /* DES_ede3_cbc_encrypt encrypts (or decrypts, if |enc| is |DES_DECRYPT|) |len|
    109  * bytes from |in| to |out| with 3DES in CBC mode. 3DES uses three keys, thus
    110  * the function takes three different |DES_key_schedule|s. */
    111 OPENSSL_EXPORT void DES_ede3_cbc_encrypt(const uint8_t *in, uint8_t *out,
    112                                          size_t len,
    113                                          const DES_key_schedule *ks1,
    114                                          const DES_key_schedule *ks2,
    115                                          const DES_key_schedule *ks3,
    116                                          DES_cblock *ivec, int enc);
    117 
    118 
    119 #if defined(__cplusplus)
    120 }  /* extern C */
    121 #endif
    122 
    123 #endif  /* OPENSSL_HEADER_DES_H */
    124