random.c 3.37 KB
Newer Older
1 2 3
/*
 * This file is part of the Nice GLib ICE library.
 *
4
 * (C) 2006-2008 Collabora Ltd.
5
 *  Contact: Dafydd Harries
6
 * (C) 2006-2008 Nokia Corporation. All rights reserved.
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
 *  Contact: Kai Vehmanen
 *
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is the Nice GLib ICE library.
 *
 * The Initial Developers of the Original Code are Collabora Ltd and Nokia
 * Corporation. All Rights Reserved.
 *
 * Contributors:
 *   Dafydd Harries, Collabora Ltd.
26
 *   Youness Alaoui, Collabora Ltd.
27
 *   Kai Vehmanen, Nokia
28 29 30 31 32 33 34 35 36 37 38
 *
 * Alternatively, the contents of this file may be used under the terms of the
 * the GNU Lesser General Public License Version 2.1 (the "LGPL"), in which
 * case the provisions of LGPL are applicable instead of those above. If you
 * wish to allow use of your version of this file only under the terms of the
 * LGPL and not to allow others to use your version of this file under the
 * MPL, indicate your decision by deleting the provisions above and replace
 * them with the notice and other provisions required by the LGPL. If you do
 * not delete the provisions above, a recipient may use your version of this
 * file under either the MPL or the LGPL.
 */
39 40 41 42 43
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif

#include <string.h>
44 45 46 47

#include "random.h"
#include "random-glib.h"

48 49
static NiceRNG * (*nice_rng_new_func) (void) = NULL;

50
/* 
51 52
 * Creates a new random number generator instance.
 */
53
NiceRNG *
54
nice_rng_new (void)
55
{
56 57 58 59 60
  if (nice_rng_new_func == NULL)
    return nice_rng_glib_new ();
  else
    return nice_rng_new_func ();
}
61

62
/*
63 64
 * Sets a new generator function.
 */
65
void
66 67 68
nice_rng_set_new_func (NiceRNG * (*func) (void))
{
  nice_rng_new_func = func;
69 70
}

71
/*
72 73 74 75
 * Frees the random number generator instance.
 *
 * @param rng context
 */
76
void
Dafydd Harries's avatar
Dafydd Harries committed
77 78 79 80 81
nice_rng_free (NiceRNG *rng)
{
  rng->free (rng);
}

82
/*
83 84 85 86 87 88
 * Generates random octets.
 *
 * @param rng context
 * @param len number of octets to product
 * @param buf buffer to store the results
 */
89
void
90 91 92 93 94
nice_rng_generate_bytes (NiceRNG *rng, guint len, gchar *buf)
{
  rng->generate_bytes (rng, len, buf);
}

95
/*
96 97 98 99 100 101
 * Generates a random unsigned integer.
 * 
 * @param rng context
 * @param low closed lower bound
 * @param high open upper bound
 */
102
guint
103 104 105 106 107
nice_rng_generate_int (NiceRNG *rng, guint low, guint high)
{
  return rng->generate_int (rng, low, high);
}

108
/*
109 110 111 112 113 114 115 116 117 118
 * Generates a stream of octets containing only characters
 * with ASCII codecs of 0x41-5A (A-Z), 0x61-7A (a-z), 
 * 0x30-39 (0-9), 0x2b (+) and 0x2f (/). This matches 
 * the definition of 'ice-char' in ICE Ispecification,
 * section 15.1 (ID-16).
 *
 * @param rng context
 * @param len number of octets to product
 * @param buf buffer to store the results
 */
119
void
120 121 122
nice_rng_generate_bytes_print (NiceRNG *rng, guint len, gchar *buf)
{
  guint i;
123
  const gchar *chars =
124 125
    "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
    "abcdefghijklmnopqrstuvwxyz"
126 127
    "0123456789"
    "+/";
128 129

  for (i = 0; i < len; i++)
130
    buf[i] = chars[nice_rng_generate_int (rng, 0, strlen (chars))];
131 132
}