bdflib

此库提供读取和写入二进制字典格式（bdf）文件的方法，这些文件可以用来表示彩虹表。

使用方法

读取

use bdf::io::BDFReader;
use std::fs::File;
use std::io::BufReader;

fn main() {
    let f = File::open("dictionary.bdf").unwrap();
    let mut bdf_reader = BDFReader::new(f);
    bdf_reader.read_metadata().unwrap();
    let lookup_table = bdf_reader.read_lookup_table().unwrap();
    let lookup_table = lookup_table.clone();
    while let Ok(next_chunk) = &mut bdf_reader.next_chunk() {
        if let Ok(entries) = next_chunk.data_entries(&lookup_table) {
            println!("{:?}", entries);
        }
    }
}

写入

use bdf::chunks::{DataEntry, HashEntry};
use bdf::io::BDFWriter;
use std::fs::File;
use std::io::BufWriter;
use std::convert::Into;

fn main() {
    let f = File::create("dictionary.bdf").unwrap();
    let entry_count = 1;
    let mut bdf_writer = BDFWriter::new(f, entry_count, false);
    bdf_writer.add_lookup_entry(HashEntry::new("fakehash".into(), 3)).unwrap();
    let mut entry = DataEntry::new("foo".into());
    entry.add_hash_value("fakehash".into(), vec![0, 2, 3]);
    bdf_writer.add_data_entry(entry).unwrap();
    bdf_writer.finish().unwrap();
    println!("Finished writing!");
}

二进制字典文件格式（bdf）

<BDF> = <Header><Chunk(META)><Chunk(HTBL)>[<Chunk(DTBL)>]

所有 u8 格式都是无符号大端数。

头部

原始（十六进制） 42 44 46 01 52 41 49 4e 42 4f 57

数据块

元数据块

元数据块内部数据的格式。数据对于文件的解析是必需的，且该块应该是文件中的第一个块。

数据行

DTBL 块内部的数据格式。一个块包含多个数据行。

哈希条目

HTBL块内部的格式。与DataRow一样，HashEntry在块中多次包含。