/home/dko/projects/mobilec/trunk/src/security/xyssl-0.9/include/xyssl/dhm.h File Reference

#include "bignum.h"

Go to the source code of this file.

Data Structures

struct dhm_context

Defines

#define XYSSL_ERR_DHM_BAD_INPUT_DATA -0x0480

#define XYSSL_ERR_DHM_READ_PARAMS_FAILED -0x0490

#define XYSSL_ERR_DHM_MAKE_PARAMS_FAILED -0x04A0

#define XYSSL_ERR_DHM_READ_PUBLIC_FAILED -0x04B0

#define XYSSL_ERR_DHM_MAKE_PUBLIC_FAILED -0x04C0

#define XYSSL_ERR_DHM_CALC_SECRET_FAILED -0x04D0

Functions

int dhm_read_params (dhm_context *ctx, unsigned char **p, unsigned char *end)

Parse the ServerKeyExchange parameters.

int dhm_make_params (dhm_context *ctx, int s_size, unsigned char *output, int *olen, int(*f_rng)(void *), void *p_rng)

Setup and write the ServerKeyExchange parameters.

int dhm_read_public (dhm_context *ctx, unsigned char *input, int ilen)

Import the peer's public value G^Y.

int dhm_make_public (dhm_context *ctx, int s_size, unsigned char *output, int olen, int(*f_rng)(void *), void *p_rng)

Create own private value X and export G^X.

int dhm_calc_secret (dhm_context *ctx, unsigned char *output, int *olen)

Derive and export the shared secret (G^Y)^X mod P.

void dhm_free (dhm_context *ctx)

int dhm_self_test (int verbose)

Checkup routine.

Detailed Description

Definition in file dhm.h.

Define Documentation

#define XYSSL_ERR_DHM_BAD_INPUT_DATA -0x0480

Definition at line 9 of file dhm.h.

#define XYSSL_ERR_DHM_CALC_SECRET_FAILED -0x04D0

Definition at line 14 of file dhm.h.

#define XYSSL_ERR_DHM_MAKE_PARAMS_FAILED -0x04A0

Definition at line 11 of file dhm.h.

#define XYSSL_ERR_DHM_MAKE_PUBLIC_FAILED -0x04C0

Definition at line 13 of file dhm.h.

#define XYSSL_ERR_DHM_READ_PARAMS_FAILED -0x0490

Definition at line 10 of file dhm.h.

#define XYSSL_ERR_DHM_READ_PUBLIC_FAILED -0x04B0

Definition at line 12 of file dhm.h.

Function Documentation

int dhm_calc_secret ( dhm_context * ctx,

unsigned char * output,

int * olen

)

Derive and export the shared secret (G^Y)^X mod P.

Parameters:: ctx DHM context

output destination buffer

olen number of chars written

Returns:: 0 if successful, or an XYSSL_ERR_DHM_XXX error code

Referenced by main().

void dhm_free ( dhm_context * ctx )

Referenced by main().

int dhm_make_params ( dhm_context * ctx,

int s_size,

unsigned char * output,

int * olen,

int(*)(void *) f_rng,

void * p_rng

)

Setup and write the ServerKeyExchange parameters.

Parameters:: ctx DHM context

x_size private value size in bits

output destination buffer

olen number of chars written

f_rng RNG function

p_rng RNG parameter

Note:: This function assumes that ctx->P and ctx->G have already been properly set (for example using mpi_read_string or mpi_read_binary).

Returns:: 0 if successful, or an XYSSL_ERR_DHM_XXX error code

Referenced by main().

int dhm_make_public ( dhm_context * ctx,

int s_size,

unsigned char * output,

int olen,

int(*)(void *) f_rng,

void * p_rng

)

Create own private value X and export G^X.

Parameters:: ctx DHM context

x_size private value size in bits

output destination buffer

olen must be equal to ctx->P.len

f_rng RNG function

p_rng RNG parameter

Returns:: 0 if successful, or an XYSSL_ERR_DHM_XXX error code

Referenced by main().

int dhm_read_params ( dhm_context * ctx,

unsigned char ** p,

unsigned char * end

)

Parse the ServerKeyExchange parameters.

Parameters:: ctx DHM context

p &(start of input buffer)

end end of buffer

Returns:: 0 if successful, or an XYSSL_ERR_DHM_XXX error code

Referenced by main().

int dhm_read_public ( dhm_context * ctx,

unsigned char * input,

int ilen

)

Import the peer's public value G^Y.

Parameters:: ctx DHM context

input input buffer

ilen size of buffer

Returns:: 0 if successful, or an XYSSL_ERR_DHM_XXX error code

Referenced by main().

int dhm_self_test ( int verbose )

Checkup routine.

Returns:: 0 if successful, or 1 if the test failed

Generated on Tue Oct 28 17:03:24 2008 for Mobile-C by doxygen 1.5.5