crypto.h File Reference

Cryptographic API. More...

#include <stdint.h>
#include <stddef.h>

Go to the source code of this file.

Data Structures
struct	digest_algorithm
	A message digest algorithm. More...
struct	cipher_algorithm
	A cipher algorithm. More...
struct	pubkey_algorithm
	A public key algorithm. More...
Defines
#define	cipher_encrypt(cipher, ctx, src, dst, len)
#define	cipher_decrypt(cipher, ctx, src, dst, len)
Functions
	FILE_LICENCE (GPL2_OR_LATER)
static void	digest_init (struct digest_algorithm *digest, void *ctx)
static void	digest_update (struct digest_algorithm *digest, void *ctx, const void *data, size_t len)
static void	digest_final (struct digest_algorithm *digest, void *ctx, void *out)
static int	cipher_setkey (struct cipher_algorithm *cipher, void *ctx, const void *key, size_t keylen)
static void	cipher_setiv (struct cipher_algorithm *cipher, void *ctx, const void *iv)
static void	cipher_encrypt (struct cipher_algorithm *cipher, void *ctx, const void *src, void *dst, size_t len)
static void	cipher_decrypt (struct cipher_algorithm *cipher, void *ctx, const void *src, void *dst, size_t len)
static int	is_stream_cipher (struct cipher_algorithm *cipher)
void	get_random_bytes (void *buf, size_t len)
	Get cryptographically strong random bytes.
Variables
struct digest_algorithm	digest_null
struct cipher_algorithm	cipher_null
struct pubkey_algorithm	pubkey_null

---

Detailed Description

Cryptographic API.

Definition in file crypto.h.

---

Define Documentation

#define cipher_encrypt	(	cipher,
		ctx,
		src,
		dst,
		len		)

Value:

do {            \
        assert ( ( (len) & ( (cipher)->blocksize - 1 ) ) == 0 );        \
        cipher_encrypt ( (cipher), (ctx), (src), (dst), (len) );        \
        } while ( 0 )

Definition at line 131 of file crypto.h.

Referenced by aes_wrap(), cbc_encrypt(), ccmp_cbc_mac(), ccmp_ctr_xor(), ccmp_feed_cbc_mac(), tkip_encrypt(), tls_send_plaintext(), and wep_encrypt().

#define cipher_decrypt	(	cipher,
		ctx,
		src,
		dst,
		len		)

Value:

do {            \
        assert ( ( (len) & ( (cipher)->blocksize - 1 ) ) == 0 );        \
        cipher_decrypt ( (cipher), (ctx), (src), (dst), (len) );        \
        } while ( 0 )

Definition at line 141 of file crypto.h.

Referenced by aes_unwrap(), cbc_decrypt(), tkip_decrypt(), tls_new_ciphertext(), and wep_decrypt().

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

static void digest_init	(	struct digest_algorithm *	digest,
		void *	ctx
	)			[inline, static]

Definition at line 101 of file crypto.h.

References digest_algorithm::init.

Referenced by add_tls(), chap_init(), digest_exec(), hmac_final(), hmac_init(), and hmac_reduce_key().

                                             {
        digest->init ( ctx );
}

static void digest_update	(	struct digest_algorithm *	digest,
		void *	ctx,
		const void *	data,
		size_t	len
	)			[inline, static]

Definition at line 106 of file crypto.h.

References digest_algorithm::update.

Referenced by chap_update(), digest_exec(), hmac_final(), hmac_init(), hmac_reduce_key(), hmac_update(), and tls_add_handshake().

                                                                             {
        digest->update ( ctx, data, len );
}

static void digest_final	(	struct digest_algorithm *	digest,
		void *	ctx,
		void *	out
	)			[inline, static]

Definition at line 111 of file crypto.h.

References digest_algorithm::final.

Referenced by chap_respond(), digest_exec(), hmac_final(), hmac_reduce_key(), and tls_verify_handshake().

                                                         {
        digest->final ( ctx, out );
}

static int cipher_setkey	(	struct cipher_algorithm *	cipher,
		void *	ctx,
		const void *	key,
		size_t	keylen
	)			[inline, static]

Definition at line 116 of file crypto.h.

References cipher_algorithm::setkey.

Referenced by aes_unwrap(), aes_wrap(), cbc_setkey(), ccmp_init(), tkip_decrypt(), tkip_encrypt(), tls_generate_keys(), wep_decrypt(), and wep_encrypt().

                                                                              {
        return cipher->setkey ( ctx, key, keylen );
}

static void cipher_setiv	(	struct cipher_algorithm *	cipher,
		void *	ctx,
		const void *	iv
	)			[inline, static]

Definition at line 121 of file crypto.h.

References cipher_algorithm::setiv.

Referenced by tls_generate_keys().

                                                              {
        cipher->setiv ( ctx, iv );
}

static void cipher_encrypt	(	struct cipher_algorithm *	cipher,
		void *	ctx,
		const void *	src,
		void *	dst,
		size_t	len
	)			[inline, static]

Definition at line 126 of file crypto.h.

References cipher_algorithm::encrypt.

                                                 {
        cipher->encrypt ( ctx, src, dst, len );
}

static void cipher_decrypt	(	struct cipher_algorithm *	cipher,
		void *	ctx,
		const void *	src,
		void *	dst,
		size_t	len
	)			[inline, static]

Definition at line 136 of file crypto.h.

References cipher_algorithm::decrypt.

                                                 {
        cipher->decrypt ( ctx, src, dst, len );
}

static int is_stream_cipher

(

struct cipher_algorithm *

cipher

)

[inline, static]

Definition at line 146 of file crypto.h.

References cipher_algorithm::blocksize.

Referenced by tls_new_ciphertext(), and tls_send_plaintext().

                                                                       {
        return ( cipher->blocksize == 1 );
}

void get_random_bytes	(	void *	buf,
		size_t	len
	)

Get cryptographically strong random bytes.

Parameters:

	buf	Buffer in which to store random bytes
	len	Number of random bytes to generate

WARNING: This function is currently underimplemented, and does not give numbers any stronger than random()!

Definition at line 41 of file crandom.c.

References random(), and u8.

Referenced by forcedeth_probe(), and wpa_handle_1_of_4().

{
        u8 *bufp = buf;

        /*
         * Somewhat arbitrarily, choose the 0x00FF0000-masked byte
         * returned by random() as having good entropy. PRNGs often
         * don't provide good entropy in lower bits, and the top byte
         * might show a pattern because of sign issues.
         */

        while ( len-- ) {
                *bufp++ = ( random() >> 16 ) & 0xFF;
        }
}

---

Variable Documentation

struct digest_algorithm digest_null

Definition at line 43 of file crypto_null.c.

Referenced by tls_change_cipher(), tls_clear_cipher(), and tls_select_cipher().

struct cipher_algorithm cipher_null

Definition at line 74 of file crypto_null.c.

Referenced by tls_change_cipher(), tls_clear_cipher(), and tls_select_cipher().

struct pubkey_algorithm pubkey_null

Definition at line 84 of file crypto_null.c.

Referenced by tls_clear_cipher(), and tls_select_cipher().