1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/netwerk/srtp/src/crypto/include/rand_source.h Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,91 @@
1.4 +/*
1.5 + * rand_source.h
1.6 + *
1.7 + * implements a random source based on /dev/random
1.8 + *
1.9 + * David A. McGrew
1.10 + * Cisco Systems, Inc.
1.11 + */
1.12 +/*
1.13 + *
1.14 + * Copyright(c) 2001-2006 Cisco Systems, Inc.
1.15 + * All rights reserved.
1.16 + *
1.17 + * Redistribution and use in source and binary forms, with or without
1.18 + * modification, are permitted provided that the following conditions
1.19 + * are met:
1.20 + *
1.21 + * Redistributions of source code must retain the above copyright
1.22 + * notice, this list of conditions and the following disclaimer.
1.23 + *
1.24 + * Redistributions in binary form must reproduce the above
1.25 + * copyright notice, this list of conditions and the following
1.26 + * disclaimer in the documentation and/or other materials provided
1.27 + * with the distribution.
1.28 + *
1.29 + * Neither the name of the Cisco Systems, Inc. nor the names of its
1.30 + * contributors may be used to endorse or promote products derived
1.31 + * from this software without specific prior written permission.
1.32 + *
1.33 + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
1.34 + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
1.35 + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
1.36 + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
1.37 + * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
1.38 + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
1.39 + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
1.40 + * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
1.41 + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
1.42 + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
1.43 + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
1.44 + * OF THE POSSIBILITY OF SUCH DAMAGE.
1.45 + *
1.46 + */
1.47 +
1.48 +
1.49 +#ifndef RAND_SOURCE
1.50 +#define RAND_SOURCE
1.51 +
1.52 +#include "err.h"
1.53 +#include "datatypes.h"
1.54 +
1.55 +err_status_t
1.56 +rand_source_init(void);
1.57 +
1.58 +/*
1.59 + * rand_source_get_octet_string() writes a random octet string.
1.60 + *
1.61 + * The function call rand_source_get_octet_string(dest, len) writes
1.62 + * len octets of random data to the location to which dest points,
1.63 + * and returns an error code. This error code should be checked,
1.64 + * and if a failure is reported, the data in the buffer MUST NOT
1.65 + * be used.
1.66 + *
1.67 + * warning: If the return code is not checked, then non-random
1.68 + * data may inadvertently be used.
1.69 + *
1.70 + * returns:
1.71 + * - err_status_ok if no problems occured.
1.72 + * - [other] a problem occured, and no assumptions should
1.73 + * be made about the contents of the destination
1.74 + * buffer.
1.75 + */
1.76 +
1.77 +err_status_t
1.78 +rand_source_get_octet_string(void *dest, uint32_t length);
1.79 +
1.80 +err_status_t
1.81 +rand_source_deinit(void);
1.82 +
1.83 +/*
1.84 + * function prototype for a random source function
1.85 + *
1.86 + * A rand_source_func_t writes num_octets at the location indicated by
1.87 + * dest and returns err_status_ok. Any other return value indicates
1.88 + * failure.
1.89 + */
1.90 +
1.91 +typedef err_status_t (*rand_source_func_t)
1.92 + (void *dest, uint32_t num_octets);
1.93 +
1.94 +#endif /* RAND_SOURCE */
