// Copyright (C) 2011, Kenneth Skovhede
// http://www.hexad.dk, opensource@hexad.dk
//
// This library is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as
// published by the Free Software Foundation; either version 2.1 of the
// License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
using System;
using System.Collections.Generic;
namespace Duplicati.Library.Main.Database
{
///
/// Possible results from a hash lookup.
///
public enum HashLookupResult
{
///
/// The entry was not found with certainty
///
NotFound,
///
/// The entry was found with certainty
///
Found,
///
/// Nothing could be said about the entry
///
Uncertain
}
///
/// Provides a hash map, similar to a bloom filter,
/// but takes advantage of the fact that the input values are
/// already high quality hashes and thus equally distributed
///
internal class HashPrefixLookup : IDisposable
{
private const long MAX_MEMORY = 32 * 1024 * 1024; //32mb
///
/// The lookup table with all values
///
private ulong[] m_lookup;
///
/// The number of bits used for the prefix
///
private ulong m_bits;
///
/// Constructs a new HashPrefixLookup
///
/// The maximum number of bytes to allocate for storage table
/// Data to prepoulate the table with
public HashPrefixLookup(ulong memorylimit = MAX_MEMORY)
{
m_bits = Math.Max(1024, memorylimit * 8);
//Allocate as a large boolean/bit array
m_lookup = new ulong[m_bits / 64];
}
///
/// Adds a hash to the table
///
/// The bytes representing the hash
public void AddHash(ulong data)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = data % m_bits;
m_lookup[bit >> 6] |= 1uL << (ushort)(bit & 0x3f);
}
///
/// Queries the table to see if a hash exists.
/// A false result value is definitive, a true result value should be interpreted as maybe.
///
/// The bytes representing the hash
/// True if the hash was found, false otherwise
public bool HashExists(ulong data)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = data % m_bits;
return (m_lookup[bit >> 6] & (1uL << (ushort)(bit & 0x3f))) != 0;
}
///
/// Calculates the number of bits used
///
public ulong BitsUsed
{
get
{
ulong c = 0;
foreach (var e in m_lookup)
if (e != 0)
for (var i = 0; i < 64; i++)
if ((e & (1uL << i)) != 0)
c++;
return c;
}
}
///
/// Gets a value between 0 and 1 descring how
/// many entries are used
///
public double TableUsageRatio
{
get
{
return (this.BitsUsed / (double)m_bits);
}
}
#region IDisposable implementation
public void Dispose ()
{
m_lookup = null;
m_bits = 0;
}
#endregion
///
/// Hex digit ASCII lookup table
///
private static readonly byte[] HEXTB = new byte[128];
///
/// Base64 digit ASCII lookup table
///
private static readonly byte[] BAS64TB = new byte[128];
///
/// Initializes the lookup
///
static HashPrefixLookup()
{
for(byte i = 0; i < 10; i++)
HEXTB['0' + i] = i;
for (byte i = 0; i < 6; i++)
{
//Case insensitive support
HEXTB['A' + i] = (byte)(i + 10);
HEXTB['a' + i] = (byte)(i + 10);
}
for (byte i = 0; i < 26; i++)
BAS64TB['A' + i] = i;
for (byte i = 0; i < 26; i++)
BAS64TB['a' + i] = (byte)(i + 26);
for (byte i = 0; i < 10; i++)
BAS64TB['0' + i] = (byte)(i + 52);
BAS64TB['+'] = 62;
BAS64TB['/'] = 63;
//Base64 URL support
BAS64TB['-'] = 62;
BAS64TB['_'] = 63;
}
///
/// Debug help function to compare values
///
/// The value to convert
/// The converted value
public static ulong ConvertEndianness(ulong value)
{
return
((value << 56) & 0xff00000000000000uL) |
((value << 40) & 0x00ff000000000000uL) |
((value << 24) & 0x0000ff0000000000uL) |
((value << 8) & 0x000000ff00000000uL) |
((value >> 8) & 0x00000000ff000000uL) |
((value >> 24) & 0x0000000000ff0000uL) |
((value >> 40) & 0x000000000000ff00uL) |
((value >> 56) & 0x00000000000000ffuL);
}
//Faster internal hex decoder, assumes valid hex string of at least 16 chars and no extended chars
public static ulong DecodeHexHash(string hash)
{
return
(ulong)HEXTB[hash[0]] << 60 |
(ulong)HEXTB[hash[1]] << 56 |
(ulong)HEXTB[hash[2]] << 52 |
(ulong)HEXTB[hash[3]] << 48 |
(ulong)HEXTB[hash[4]] << 44 |
(ulong)HEXTB[hash[5]] << 40 |
(ulong)HEXTB[hash[6]] << 36 |
(ulong)HEXTB[hash[7]] << 32 |
(ulong)HEXTB[hash[8]] << 28 |
(ulong)HEXTB[hash[9]] << 24 |
(ulong)HEXTB[hash[10]] << 20 |
(ulong)HEXTB[hash[11]] << 16 |
(ulong)HEXTB[hash[12]] << 12 |
(ulong)HEXTB[hash[13]] << 8 |
(ulong)HEXTB[hash[14]] << 4 |
(ulong)HEXTB[hash[15]] << 0;
}
//Faster internal base64 decoder, assumes valid hex string of at least 11 chars and no extended chars
public static ulong DecodeBase64Hash(string hash)
{
return
(ulong)BAS64TB[hash[0]] << 58 |
(ulong)BAS64TB[hash[1]] << 52 |
(ulong)BAS64TB[hash[2]] << 46 |
(ulong)BAS64TB[hash[3]] << 40 |
(ulong)BAS64TB[hash[4]] << 34 |
(ulong)BAS64TB[hash[5]] << 28 |
(ulong)BAS64TB[hash[6]] << 22 |
(ulong)BAS64TB[hash[7]] << 16 |
(ulong)BAS64TB[hash[8]] << 10 |
(ulong)BAS64TB[hash[9]] << 4 |
(((ulong)BAS64TB[hash[10]] >> 2) & 0x0f);
}
}
///
/// Provides a simple hash-table like lookup,
/// similar to a MRU cache
///
internal class HashLookup : IDisposable
{
private const long DEFAULT_MEMORY = 32 * 1024 * 1024; //32mb
///
/// The lookup table with all values
///
private T[] m_lookup;
///
/// Typecasted size of table
///
private ulong m_modulo;
public HashLookup(uint elementsize, ulong memorylimit = DEFAULT_MEMORY)
{
//Allocate as a large boolean/bit array
m_lookup = new T[Math.Max(32, Math.Max(1024, memorylimit) / elementsize)];
m_modulo = (ulong)m_lookup.Length;
}
///
/// Adds a hash to the table
///
/// The hash key
/// The actual hash data
public void AddHash(ulong key, T value)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = key % m_modulo;
m_lookup[bit] = value;
}
///
/// Queries the table to see if a hash exists.
/// A true result value is definitive, a false result value should be interpreted as maybe.
///
/// The hash key
/// The actual hash data
/// True if the hash was found, false otherwise
public bool HashExists(ulong key, T value)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = key % m_modulo;
return object.Equals(m_lookup[bit], value);
}
///
/// Calculates number of used entries in the table
///
public ulong Entries
{
get
{
ulong c = 0;
foreach (var x in m_lookup)
if (!object.Equals(x, default(T)))
c++;
return c;
}
}
///
/// Gets a value between 0 and 1 descring how
/// many entries are used
///
public double TableUsageRatio
{
get
{
return Entries / (double)m_lookup.Length;
}
}
#region IDisposable implementation
public void Dispose ()
{
m_lookup = null;
m_modulo = 0;
}
#endregion
}
///
/// Provides a simple hash-table like lookup,
/// similar to a MRU cache
///
internal class HashLookupWithData : IDisposable
{
private const long DEFAULT_MEMORY = 32 * 1024 * 1024; //32mb
///
/// The lookup table with all values
///
private KeyValuePair[] m_lookup;
///
/// Typecasted size of table
///
private ulong m_modulo;
public HashLookupWithData(uint elementsize, ulong memorylimit = DEFAULT_MEMORY)
{
//Allocate as a large boolean/bit array
m_lookup = new KeyValuePair[Math.Max(32, Math.Max(1024, memorylimit) / elementsize)];
m_modulo = (ulong)m_lookup.Length;
}
///
/// Adds a hash to the table
///
/// The hash key
/// The actual hash data
public void AddHash(ulong key, TKey value, TValue data)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = key % m_modulo;
m_lookup[bit] = new KeyValuePair(value, data);
}
///
/// Queries the table to see if a hash exists.
/// A true result value is definitive, a false result value should be interpreted as maybe.
///
/// The hash key
/// The actual hash data
/// True if the hash was found, false otherwise
public bool HashExists(ulong key, TKey value, out TValue data)
{
//Textbox hashing, the value modulo number of entries
// works because the input is high quality random data
var bit = key % m_modulo;
var el = m_lookup[bit];
if (object.Equals(el.Key, value))
{
data = el.Value;
return true;
}
else
{
data = default(TValue);
return false;
}
}
///
/// Calculates number of used entries in the table
///
public ulong Entries
{
get
{
ulong c = 0;
foreach (var x in m_lookup)
if (!object.Equals(x.Key, default(TKey)))
c++;
return c;
}
}
///
/// Gets a value between 0 and 1 descring how
/// many entries are used
///
public double TableUsageRatio
{
get
{
return Entries / (double)m_lookup.Length;
}
}
#region IDisposable implementation
public void Dispose ()
{
m_lookup = null;
m_modulo = 0;
}
#endregion
}
///
/// Provides a hash-based lookup system that is able to quickly determine,
/// if a given entry is found in the database, with some probability
/// for returning an undetermined answer
///
public class HashDatabaseProtector : IDisposable
{
private const long DEFAULT_MEMORY = 64 * 1024 * 1024; //64mb
private HashPrefixLookup m_certainMissing;
private HashLookupWithData m_certainFound;
public long PositiveMisses { get; set; }
public long NegativeMisses { get; set; }
public HashDatabaseProtector(uint elementsize, ulong memory = DEFAULT_MEMORY)
{
m_certainMissing = new HashPrefixLookup(memory / 2);
m_certainFound = new HashLookupWithData(elementsize, memory / 2);
}
public void Add(ulong hash, TKey key, TValue value)
{
m_certainMissing.AddHash(hash);
m_certainFound.AddHash(hash, key, value);
}
public HashLookupResult HasValue (ulong hash, TKey key, out TValue value)
{
if (!m_certainMissing.HashExists(hash))
{
value = default(TValue);
return HashLookupResult.NotFound;
}
if (m_certainFound.HashExists(hash, key, out value))
return HashLookupResult.Found;
return HashLookupResult.Uncertain;
}
public ulong PrefixBits { get { return m_certainMissing.BitsUsed; } }
public ulong FullEntries { get { return m_certainFound.Entries; } }
public double PrefixUsageRatio { get { return m_certainMissing.TableUsageRatio; } }
public double FullUsageRatio { get { return m_certainFound.TableUsageRatio; } }
#region IDisposable implementation
public void Dispose ()
{
if (m_certainFound != null)
try { m_certainFound.Dispose(); }
finally { m_certainFound = null; }
if (m_certainMissing != null)
try { m_certainMissing.Dispose(); }
finally { m_certainMissing = null; }
}
#endregion
}
///
/// Provides a hash-based lookup system that is able to quickly determine,
/// if a given entry is found in the database, with some probability
/// for returning an undetermined answer
///
public class HashDatabaseProtector : IDisposable
{
private const long DEFAULT_MEMORY = 64 * 1024 * 1024; //64mb
private HashPrefixLookup m_certainMissing;
private HashLookup m_certainFound;
public long PositiveMisses { get; set; }
public long NegativeMisses { get; set; }
public HashDatabaseProtector(uint elementsize, ulong memory = DEFAULT_MEMORY)
{
m_certainMissing = new HashPrefixLookup(memory / 2);
m_certainFound = new HashLookup(elementsize, memory / 2);
}
public void Add(ulong hash, TKey key)
{
m_certainMissing.AddHash(hash);
m_certainFound.AddHash(hash, key);
}
public HashLookupResult HasValue (ulong hash, TKey key)
{
if (!m_certainMissing.HashExists(hash))
return HashLookupResult.NotFound;
if (m_certainFound.HashExists(hash, key))
return HashLookupResult.Found;
return HashLookupResult.Uncertain;
}
public ulong PrefixBits { get { return m_certainMissing.BitsUsed; } }
public ulong FullEntries { get { return m_certainFound.Entries; } }
public double PrefixUsageRatio { get { return m_certainMissing.TableUsageRatio; } }
public double FullUsageRatio { get { return m_certainFound.TableUsageRatio; } }
#region IDisposable implementation
public void Dispose ()
{
if (m_certainFound != null)
try { m_certainFound.Dispose(); }
finally { m_certainFound = null; }
if (m_certainMissing != null)
try { m_certainMissing.Dispose(); }
finally { m_certainMissing = null; }
}
#endregion
}
}